Help Version: 2.12
Last Update: 01/12/01

HTML Form Code Overview

HTML based stores are designed using standard HTML coding. However, you must create a "form" within your HTML coding to be able to send the item data to the Quikstore Program. 

This type of store does not require a database file like the one created for database type stores. It is critical however, that certain information be present and that calls by your pages to the Quikstore program follow a specific format.

To assist you with this process, Quikstore uses a program called the QuikCode Wizard which should have been installed on your PC when you installed the software from the download or CD-Rom. If for some reason you don't have it, or would like an updated copy, you can find QuikCode at:

http://www.quikstore.com/download/quikcode/

Form Code Details:

The QuikCode Wizard helps you to create HTML form code similar to the following:

<FORM METHOD="POST" ACTION="http://www.yoursite.com/cgi-bin/quikstore.cgi">

<INPUT TYPE="text" NAME="item-ZZ101|14.95|Candy|NA|1" size="3">

<INPUT TYPE="hidden" NAME="store_type" VALUE="html">

<INPUT TYPE="hidden" NAME="page" VALUE="products1.html">

<INPUT TYPE="submit" NAME="add_to_cart" VALUE="Add to Cart">

</FORM>

  1. The first line is the opens the <form> and sets the method and action for the form. The "Method" should be POST and the "Action" should be set to the URL where the "quikstore.cgi" program is located on your server.
     

  2. The second line in this example identifies the product and all of its' parameters. These parameters include product id, unit price, product name, size, and weight variables separated by pipes (|). This line is also the Quantity Box where the user selects a specified quantity to purchase.
     

  3. Line number three tells the Quikstore program what type of store (store_type) is adding the item to the cart. This is so we can properly direct the user back to where they came from. The "store_type" variable is only required in HTML based stores. 
     

  4. Line number four tells the Quikstore program what the name of the page is that you are adding to the cart from. This page name is then used by the program to return the customer to the page they came from after they have added an item to their cart.
     
    This page value MUST be the name of the current page. If you have this page in a subdirectory of the document root, you need to add the subdirectory name in front of the page name like this:  VALUE="subdirectory/pagename.html" otherwise you will get a security check error when you try to add something to the cart.
     
    DO NOT add a forward slash to the beginning of the page value like this:  VALUE="/subdirectory/pagename.html". That will not work properly.
     

  5. Line five is simply the Add To Cart button.

  6. Line six closes the form tag.

At minimum, each <form> must contain the values listed above. 

If you want more than one item on a page, and you would like to be able to add multiple items at one time, you would repeat ONLY the item specific lines above like this:

<FORM METHOD="POST" ACTION="http://www.yoursite.com/cgi-bin/quikstore.cgi">

<INPUT TYPE="hidden" NAME="store_type" VALUE="html">
<INPUT TYPE="hidden" NAME="page" VALUE="products1.html">

<P>Candy:

<INPUT TYPE="text" NAME="item-ZZ101|14.95|Candy|NA|1" size="3">
<INPUT TYPE="submit" NAME="add_to_cart" VALUE="Add to Cart"></p>

<P>Toy:

<INPUT TYPE="text" NAME="item-ZZ102|14.95|Toy|NA|1" size="3">
<INPUT TYPE="submit" NAME="add_to_cart" VALUE="Add to Cart"></p>

</FORM>

Each item must be identified individually. You may use more than one Add to Cart button or simply have one at the bottom of the form. Just continue to add additional lines as shown above, for each new item.  There is no need to repeat the hidden "page" and "store_type" tags.

The example below is a complete basic HTML page and will place four input boxes on one page with an "Add to Cart" button at the bottom. Each item has different information and should be accompanied by the necessary pictures, graphics and text to assist the customer in making a choice. Based on the choice selected and the quantity input by the customer, the required parameters will be passed to the "quikstore.cgi" program by the "form" which is executed when the customer presses the "Add to Cart" button.

<HTML>
<HEAD>
<TITLE>Enter your title here.</TITLE>
</HEAD>
<BODY>

<FORM METHOD="POST" ACTION="http://www.yoursite.com/cgi-bin/quikstore.cgi">
<INPUT TYPE="hidden" NAME="page" VALUE="products.html">
<INPUT TYPE="hidden" NAME="store_type" VALUE="html">

<P>Candy
<INPUT TYPE="text" NAME="item-ZZ101|14.95|Candy|NA|1" SIZE="3"></P>

<P>More Candy
<INPUT TYPE="text" NAME="item-ZZ102|18.95|More Candy|NA|1" SIZE="3"></P>

<P>Alot of Candy
<INPUT TYPE="text" NAME="item-ZZ103|24.95|Alot Of Candy|NA|1" SIZE="3"></P>

<P><INPUT TYPE="submit" NAME="add_to_cart" VALUE="Add to Cart">

</FORM>
</BODY>
</HTML>

Each page can be as simple or complex as your situation requires, as long as you provide the information outlined here in the format required by QuikStore. 

NOTE: Once you are done creating a product page, save it into the C:\Quikstore\server_files directory on your hard drive so that you can later publish these product pages to the server using the Installation Wizard.

For more information about using the QuikCode Wizard, see the QuikCode section of this help file. This section also has information about adding Options to your products.


Copyright 1997-2003 iSoft-Solutions, inc.