Downloading and installing the free shopping cart files

Step Two:
Unzip the cart.zip file on your machine and transfer all the files and directories (except the "cartimages" directory) to your web server's cgi bin. Make sure and create the same directories that are contained in the zip file. It is critical that you upload the files in ascii mode or you will have problems.

Step Three:
Upload the cartimages directory to the directory of your homepage or any directory under the one where your homepage is located. It is important that you upload the files in binary mode or they will not appear..

Step Four:
If you do not already know, verify with your hosting company wether your web site is running on a UNIX or Windows NT machine. Note: Linux and Unix instructions are the same.
If you are hosted on a UNIX machine set the permissions of the cart.cgi and cartmanager.cgi script to rwxr_xr_x (i.e. telnet command chmod 755 cart.cgi ).

If you are on an Windows Machine, write or call your hosting company and ask them to make the following directories under the cgi-bin directory writeable by the script/http server (they should understand what you are asking):

• Admin_files
• Data_files
• Library
• User_carts

Setting up the Store Manager

Setting the cart.cgi System Settings

Adding your Header, Footer, and Frontpage

Step One:
Create your header HTML and save it in a file called store_header.inc. Upload this file and place it in the directory /cgi-bin/Html/headers.

Step Two:
Create your footer HTML and save it in a file called store_footer.inc. Upload this file and place it in the directory /cgi-bin/Html/footers.

Step Three:
Create your Frontpage HTML and save it in a file called frontpage.htm. Upload this file and place it in the directory /cgi-bin/Html.

Creating Links for your store

Example One: Search Box

<!--Begin search table-->
<CENTER>
<FORM METHOD=POST ACTION=/cgi-bin/cart.cgi>
<TABLE BORDER=1 CELLPADDING=3 CELLSPACING=0 WIDTH="500">
<TR>

<TD WIDTH=200 BORDER=1>
<CENTER>
<IMG SRC=/cartimages/search_store.gif>
</CENTER>
</TD>

<TD WIDTH=300 ALIGN=RIGHT BGCOLOR=WHEAT>
<CENTER>
<INPUT TYPE="text" NAME="keywords" SIZE="20" MAXLENGTH="60">&nbsp;&nbsp;
<INPUT TYPE="submit" NAME="search_request_button"
VALUE=" Submit ">
</CENTER>
</TD>

</TR>
</TABLE>
</FORM>
</CENTER>
<!--End Search Table-->

Example Two: Category Link You may link to category pages within your store. These pages are created on the fly (dynamically) and display all products within a particular category.

<a href=/cgi-bin/cart.cgi?product=NAME>Link to Category NAME</a>

where NAME is the name of the category to be displayed.

Example Three: Links to Static HTML pages You may create and link to static HTML pages within your store. These pages would be uploaded to the /cgi-bin/Html/Products directory, and linked as follows:

<a href=/cgi-bin/cart.cgi?page=mypage.html>Link to My Page</a>

Adding, Editing, and Deleting products

Managing your store's inventory is a snap with the Store Manager. Use these links to:

Add Products http://PutYourSiteHere/cgi-bin/cartmanager.cgi?add_screen=yes

Edit Products http://PutYourSiteHere/cgi-bin/cartmanager.cgi?edit_screen=yes

Delete Products http://PutYourSiteHere/cgi-bin/cartmanager.cgi?delete_screen=yes

Note: the above link assumes your cgi bin is accessed from your site as /cgi-bin and that you changed PutYourSiteHere to your sites location, it will not work if that is not the case.

Option files

Option files allow you to associate your products with certain options. For example, if you sell t-shirts, you will need to allow the customer to select the size. Option files are simple HTML, but they do follow a specific format. YOU MUST FOLLOW THIS FORMAT! Here is an example:

<P>
<B>Gift Options<B>
<br>
<SELECT NAME = "option|1|%%PRODUCT_ID%%">
<OPTION VALUE = "None|">Select Here
<OPTION VALUE = "Gift Card|1.00">Gift Card (+ $1.00)
<OPTION VALUE = "Gift Wrap|2.50">Gift Wrap (+ $2.50)
<OPTION VALUE = "Gift Box|3.50">Gift Box (+ $3.50)
</SELECT>
</FORM>

Option files are placed in the /cgi-bin/Html/Options directory

Adding images to your store

Images can be added to any dircetory, in your demo store they are in the /cartimages directory. Because all pages within the store are displayed through the script, all images links are relative to the cart.cgi script itself. For example:

<IMG SRC=/cartimages/front_footer.gif BORDER=0>

Tech Support