Thank you for evaluating QuickEStore v.5.x by John Kim Hoarty. 

This versatile and easy to use Cold Fusion(tm) code will have you doing business on the 
Internet within minutes. Simply create a "store" directory under your web server's root 
directory and move the unzipped QuickEStore files into it, keeping the directory structure 
of your QuickEStore files intact (i.e., move the "orders" and "images" directories there, too). 
Set up the enclosed Microsoft Access database as a datasource in Cold Fusion Administrator 
(or get your ISP to do so). Then copy your logo or graphic file to the "images" directory under 
your "store" directory. Finally, password-protect the "orders" directory. Then, open the file 
setup.cfm in your browser and answer a few simple questions using the interactive web-based 
form. Refer to this document for help answering the quesitons.

Note: You are responsible for securing the "orders directory" which will contain credit card 
information! An online store is only as secure as you make it. QuickEStore was designed to 
run on a secure server which is capable of invoking SSL upon checkout. 

QuickEStore is fully compatible with the CFX_CyberCash tag for full integration with the 
CyberCash(TM) internet transaction processing service. This tag is available at the 
Allaire Website (www.allaire.com). The CyberCash integration template is not included with 
this evaluation verison of QuickEStore.

STORE SETUP ROUTINE:

Step 1: Enter datasource name.
Action: Type a name for your datasource. The datasource must already be set up in Cold Fusion 
Administrator before proceeding.

Step 2: Enter store name. 
Action: Type a name for your store. 

Step 3: Use Customer Self-Service?. 
Action: Select Yes or No. 

Step 4: Charge shipping according to Price Threshhold or Weight. 
Action: QuickEStore supports either method for calculating shipping costs. Whichever method 
you choose, you will later be prompted to enter the various 'threshholds' at which shipping 
charges will increase. If you won't be charging shipping, just choose either one and click 
"Next". This is also where you indicate how you want orders saved--they can be written to an 
html file for viewing in a browser, or they can be 
e-mailed to you.

Step 5: Enter the state(s) for which sales tax will be charged and the applicable tax 
rate.

Action: Here you have the opportunity to enter a state for which purchases will be 
charged a sales tax. You may enter as many states as you want. Upon entering 
the last state and tax rate, you may either click "Add Another State" or 
"Continue". Enter tax rate percentages as whole numbers (i.e., 5.5, 6, etc.)


Step 6: Enter E-Mail address for order notification.
Action: This is the e-mail address where notifications of orders placed will be sent 
and where orders are sent if that option is chosen.


Step 7: Enter path to order directory.
Action: This should be a directory with read and write permissions. Orders will be written 
to this directory. Enter logical path (i.e., C:\InetPub\wwwroot\orders). Please note that this 
should be a password protected directory and not available to the browsing public!! Security 
is your responsibility. Credit card information will be kept here.


Step 8: Enter URL to order directory as shown. 
Action: Enter the fully qualfied domain address of the 
order directory. This is so the application can create links to this directory. 
Should start with "https:" assuming you have access to a secure server.


Step 9: Enter path to store.
Action: Enter the directory path to the store. I.e., "C:\InetPub\wwwroot\store".
Step 10: Enter URL to store.
Action: Enter the URL of the store. i.e., 
"http://www.mystore.com/store". Do not include a "/" at the end.


Step 11:Enter secure URL for checkout.cfm, i.e., 
https://www.mystore.com/store
Action: This will cause the application to invoke SSL for the checkout action. If you do not 
have access to SSL, DO NOT INCLUDE THE "S" IN "HTTPS". 

Step 12: Enter the name of a graphic file here. 
It can be a gif or jpg file and will be placed at the top of your product, product detail, 
and checkout pages. Optional. Graphic needs to be in a directory called "images" under 
your store directory.

Step 13: Enter a password that you will use 
to secure access to your store's administrative pages. 

Then, click on "Set Up Shipping Charges". If you do not wish to charge any 
shipping, just click "Set Up Shipping Charges" and then click "Finish" without entering any 
shipping information. If you do set up shipping, the first rate corresponds to the amount of 
shipping charged to an order that is equal to or less than the first thresshold, etc. Your 
first entry should be a zero in each field. Your last entry should simply be an arbitrarily 
large number, like 10000, and your maximum shipping charge.

Congratulations! You should now see a message that reads, "Congratulations! You have 
successfully setup your QuickEStore! Simply go to Store Manager to add products and categories. 

If you will be using product attributes, such as color and size, you will need to set those up 
now. Simply click the bottom link on this results page. 

A WORD ABOUT ATTRIBUTES:

Product attributes are supported beginning with QuickEStore version 3.1. In version 4, you are 
given the opportunity to set unlimited global product attributes. You get to decide what to 
call them, so they can be anything you want, i.e., "size", "color", "height" and "width", etc. 
You may also choose to use just one product attribute.  

After setting up the attribute tables, they will be available on the "Add Products" page as 
selectable drop-down menus. First you select one or two of your attribute types, then you will 
be prompted to indicate the values that should apply to that product for each selected 
attribute type. These drop-down menus are "multiples", meaning you can hold down your CTRL key 
and select as many as are appropriate for a particular product when adding new products. If you 
don't highlight any attribute types on the "Add Products" page, this item won't have atrributes, 
in which case the product detail page will not display the attribute menu(s). 

Note: This setup procedure writes an "application.cfm" file to the store directory. It will 
overwrite any application.cfm file already there! Also, you may get an error upon subsequent 
setups if there is already an application.cfm file in that directory. Simply delete that file 
to begin setting up your store with different parameters (like new shipping rates). 

After configuring your attribute tables, there will be a link to "Store Manager" (manage.cfm) 
on the results page. Click it to begin to add categories and products. Remeber, the "manage.cfm"  
file should be in a directory called "orders". This is also the page where you will go to "View 
Orders". Again, this should be a password-protected directory so that others cannot read your 
order information. Ask your ISP or Webmaster to help you with this. 

Add categories first, then sub-categories (optional). Then add products to categories. 
Optionally upload pictures--it is recommended that you keep image files relatively small for 
asthetic reasons and so pages load quickly. Optionally insert descriptions. In the "live" 
store, your Item Names will link to these descriptions and pictures. All that remains is for 
you to provide a link from your homepage to the file, "prodpage.cfm" and you are in 
business ... e-business!

Order notifications will be sent to the E-Mail address you provided. These are sent in HTML 
format and include a link to "Store Manager". Optionally, orders can be sent here as well, but 
this is only recommended if your e-mail account and web site are on the same server for reasons 
of security.		

USING THUMBNAILS (DISABLED):

To have thumbnails displayed on your product page, you will need to use the "prodthumbs.cfm" 
template in place of "prodpage.cfm". Rename "prodpage.cfm" to "prodpage.old" and rename 
"prodthumbs.cfm" to "prodpage.cfm". Name all of your thumbnail images the exact same as your 
full-size images but add "th_" to the front. Thus, "product1.jpg" becomes "th_product1.jpg". 
That's all there is to it! Your prodpage will now display the product's thumbnail image and 
name. All products must have a thumbnail to use this feature. 

PRODUCT LAYOUT TEMPLATES:

When adding or editing products, you will see four radio buttons indocated your desired product 
page display for that product. You can choose from "image left, description right", "image 
right, description left", "image top, description bottom", or "image bottom, description top". 
You may want to try different displays for different products just to jazz up your site, or to 
accommodate odd sized product pictures.   

SHIPPING ADDRESS:

QuickEStore now has a "shipping address" option. On the checkout page, a checkbox can be 
deselected to indicate that the desired shipping address differs from the purchaser's address. 
When unchecked, the subsequent page will prompt for shipping information.    

RETAIN RETURN CUSTOMER CREDIT CARD INFO:

QuickEStore now supports the retention of customer credit card information. On the checkout 
(cart) page, a checkbox indicating that credit card information will be retained is by default 
selected. Upon subsequent visits to the site, the customer's last-used credit card information 
will prepopulate the credit card information part of the customer information form. The 
information retained includes: customer credit card name, credit card type, card number and 
expiration date. In order to use this feature, the customer's browser must support cookies.

INTEGRATING WITH CYBERCASH (DISABLED):

If you want to integrate CyberCash online payment processing, go to http://www.allaire.com and 
download the free custom tag, CFX_CyberCash and install it on your web server or check with 
your ISP to see if it is installed. Then, rename your "writeorder.cfm" file to "writeorder.old" 
and rename "writeorder_cyberchas.cfm" to "writeorder.cfm". Scan your new "writeorder.cfm" 
template and locate the attributes in the custom tag where missing values are indicated. 
Insert the values for your CyberCash account ID, etc., where indicated.    

CUSTOMER SELF-SERVICE:

QuickEStore now offers an exciting optional feature called "Customer Self-Service". Upon 
completion of their order, customers may now receive an e-mail receipt that includes a link to 
the self-service page of your site. By simply clicking this link, the customer can check the 
status of their order. The status defaults to "Processing Order", although this default is 
easily modified. 

The merchant (you) still gets an e-mail order notification, of course, but now it includes a 
link to "Advanced Order Processing" where you can set the order status to any of: "Processing 
Order", "Assembled", "Backordered", "Ret'd for Refund", "Ret'd for Exchange", or "Order 
Shipped". If "Order Shipped" is chosen, the ship date defaults to the current date unless a 
date is manually entered in the "Ship Date" field of the form.



Support is available by e-mail at support@quickestore.com.
Frequently asked questions are posted at http://www.quickestore.com/faq.html
