This is a list of some of the more important functions organized by site circuit. It provides a good overview of how the site is structured and helps explain the available functionality.
HOME
The site's root (default) circuit
- Welcome (default) - index.cfm
The site's home page.
- Admin - index.cfm?fuseaction=home.admin
The main administration menu for the site. This menu can also be accessed automatically with the url www.sitename.com/admin. All the individual circuits admin menu options (listed in the various section below) are compiled in this single menu along with the following overall site definition pages:
ACCESS
Access refers to the functions that control the locking and access to site content. Categories and Features can be "locked" with an Access Key and only logged in members who possess the key will gain access to the content.
CATEGORY
Categories provide a hierarchal structure to the site. A Category consists of a header section followed by a listing of content such as sub-categories or Products or Features. In fact, Sub-Categories, Features and Products can all be listed on a single Category page.
-
Display Category - index.cfm?fuseaction=category.display&category_id=*
Displays the detail page of the requested category.
-
Top Categories Menu -
index.cfm?fuseaction=category.topcatmenu
Called as a custom tag on the layout page to insert a menu of top categories. Can be oriented horizontally or vertically using images or forced to text only.
-
-
Related Categories List - index.cfm?fuseaction=category.related...
Called as a custom tag on detail pages. It will list out all the categories that a product is listed in on the bottom of the product page and the categories that a feature is listed in on the feature page.
-
FEATURE
By Feature we mean "Feature Articles" or text content pages. Features can be assigned to Categories just like Products or be linked to a Product.
PAGE
Site Pages provide editing and menu for the Shopping Cart, My Account, Search, Contact Us, Home and other "non-content" functions of the site.
PRODUCT
Goods and services for sale on the site.
-
Product List -
index.cfm?fuseaction=product.listProducts are usually listed in one or more Category and located by the browsing of Categories. However, this link can be called directly or as a Custom Tag on template pages to produce a list of Products. This page also provides the results for Product Searches.
- Product Search - index.cfm?fuseaction=product.search
Provides a search form to search Products.
- Display Product - index.cfm?fuseaction=product.display&product_id=*
Displays the detail page of the requested product.
- Related Products List - index.cfm?fuseaction=product.related
Called as a custom tag. This is used on the Product and Feature detail pages and Shopping Cart to list related products.
- Product of the Day - index.cfm?fuseaction=product.productofday
Usually called as a custom tag to insert the Product of the Day.
- Product Teaser - index.cfm?fuseaction=product.tease
Called as a custom tag to insert a highlight box of products such as products on sale in a particular site category, etc.
-
SHOPPING
Store shopping cart and check-out functionality.
USERS
Store customers and accounts.
-
-
-
Password Help -
index.cfm?fuseaction=users.forgot
Provides a form where users can enter the email address they registered with and have their username and password emailed to them. This link is provided on the login form.
-
-
User Manager -
index.cfm?fuseaction=users.managerThe My Account page which provides a user with all their user information and allows them to check their orders, update their information and create affiliate accounts.
-
Address Book -
index.cfm?fuseaction=users.addressbook
Users can create multiple addresses. The address book lists all the users' addresses and allow the user to define which address will be used as the default shipping, billing and account address.
-
-
-
-
User RegistrationThere are 3 different user registration forms available depending on the type of store. The REGISTER type (
users.register) is the standard registration process of creaing a login, adding billing and shipping information and optional account information. The MEMBER registration (
users.member) is used for membership sites that don't require shipping address information and provides all the registration information on a single page. The ACCOUNT registration (
users.account) provides a single sign-up page for users opening up an Account.
-
Verify Email Address -
index.cfm?fuseaction=users.unlock The user registration process can be set to automatically verify a user's email address. Used primarily for membership sites. An automated "unlock key" is emailed to a user and the user must enter the key into this form to complete the registration process.
-
-
Kill -
index.cfm?fuseaction=users.kill
A useful command when developing and testing the shopping cart. Users.kill will REALLY log you out completely and delete the store cookies.
-
AFFILIATE
Affiliate functionality allows users to sign up as a store Affiliate and earn commission on sales that come from users who are referred by them from their web site.
SITE SEARCH
Site-wide search functionality is provided as a standard site Page and can be listed in the Page menu. Search results will include categories, features, and products.
EMAIL FUNCTIONS
The site provides the following email functions:
-
Contact Us Form - A "contact us" email form is included as a standard Page and as a catcore file that can be assigned to a category. The form allows users to enter a message that is automatically emailed to the site editor.
-
Tell A Friend and Email the Editor pop-up window - A link to the email/index.cfm page can be used on template pages to pop-up a window to either send an email to a friend or to the editor. See details on the page. This link is used at the bottom of the Feature page to "email page".
ERRORS
A customizable default error handling page is included that will allow the user to email the error information to the site editor.
SITE SET-UP
To set the site up you simply need to do the following:
-
Set up your datasource on the server pointing to the database file in the database directory.
-
Update the database/database.cfm page with the name of your datasource.
-
Log into the store with the default Administrator username and password ("admin" for both) and go to Site Settings in the Admin menu. Update the site's url and other information.
CUSTOM TAGS
The site uses a few custom tags worthy of mentioning. These tags are referenced relationally and do NOT need to be "installed".
-
FCKeditor - The site uses the FCKeditor on the administrative pages. The documentation is included in the Custom Tags folder.
-
CF_aVarTree Versioin 1.61 - This custom tag prints out all the appliation, client, cookie, request, session and URL variables for debugging purposes. The sample default layout includes the tag at the bottom of the template. Appending "&debug=1" to any url will activate the tag IF you are logged on with Administrator privileges.
-
QForms - The site uses QForms to produce javascript form field error processing. The full Qforms information and documentation will be found in the Includes directory.