Solutions : Ecommerce : Shopping Cart

Shopping Cart
Installation and Usage

FILENAME: sc.html

DEPENDENCIES:

ec.pl - Ecommerce configuration and common logic modules (see: ec.html)
jhzcs.pl - JHZ-CS configuration and common logic modules (see: jhzcs.html)
IID (Item Information Dataset)
dbmparms.txt (SQL RDBMS IID mapping component)
dbmtabs.pl (SQL RDBMS IID mapping component)
unacc_edomains.pl (email domain exclude list component)
unacc_edomains.txt (email domain exclude list component)

REQUIREMENTS:

Logic Modules

sc.pl - common configuration and logic module
add.cgi - add item to cart
cart.cgi - display cart CGI
cart.pl - display cart logic module
chg.cgi - change cart item quantity (and remove item qty=0)
ckouta.cgi - check out process step 1
ckoutb.cgi - check out process step 2
ckoutb.pl - check out process step 2 (logic module)
ckoutc.cgi - check out process step 3
del.cgi - delete cart
order.cgi - offline ordering (FAX, CHECK, PHONE & P.O. orders)
cadmin.cgi - back-end cart administration

Static Pages

closed.html - shopping closed page
ns.html - browser not supported page

Page Templates

nocart.htm - empty cart
cart.htm - shopping cart page
ckout.htm - online check out page 1 (enter check out area)
entry.htm - online check out page 2 (customer info entry)
confirm.htm - online check out page 3 (confirm order)
success.htm - online check out page 4 (completed)
fax.htm - FAX order form
check.htm - check order form
po.htm - P.O. (purchase order) order form

E-mail Templates

aemail.txt - back-end administrative sales notification
cemail.txt - front-end customer sales confirmation

Optional:

Support for Item Search and Banner Rotator System requires those components to be installed and configured according to their specifications. Inclusion of Special Template markup supporting those components must also be included within templates to be supported by this product.

PACKING (PARTS) LIST

INSTALLATION:

Set Configuration in sc.pl; see embedded instructions for:

• Use Database (for SQL RDBMS IID)
• SALE TAX
• SHIPPING
• "Check Out" Error Messages (modify as desired)

For SSL check out, first install all components outside the SSL server space and verify installation. Following successful verification of installation:

1. Install copies of "sc.pl", "ckoutb.pl", "ckoutb.cgi" and "ckoutc.cgi" to the SSL server space's CGI directory, then authorize them as executable
2. Verify the copied version of "sc.pl" configuration variables point to the directory file paths in the SSL area
3. Install a copies of template directories to the SSL server space
4. If the SSL server space is resident on the same server, data may remain in the non-SSL server space. If the SSL server space is resident on a different server, data will not be accessible and a copy of the IID must also be installed and maintained in on the SSL server.

NOTE: Most FTP applications support automatic creation of directories and subdirectories when uploading a directory. Use this method to speed up the installation process. USE CAUTION - assure that common (shared) modules are fully configured prior to using this method to avoid overwriting a previously configured module with non-configured settings.

TEMPLATES:

Customize templates for content and appearance as desired:

cart.htm - online shopping cart
nocart.htm
ckout.htm - online checkout step 1 (enter check out area)
entry.htm - online checkout step 2 (customer info entry)
confirm.htm - online checkout step 3 (confirm info)
success.htm - online checkout step 4 (completed)
cemail.txt - customer email
aemail.txt - administrative email
check.htm - payment by check orders
fax.htm - order by fax orders
po.htm - payment by P.O. (Purchase Order) orders

Any variable contained in the IID may be referenced using the variables (column header names) wrapped in less than greater than pairs:

	<<variable-name>>

Variable names cannot contain spaces.

Special Mark-up Directives within Shopping Cart Templates indicate repeating cart items.

	<!-- REPEAT START -->

	<!-- REPEAT END -->

Two special keywords are available for use when using a variable reference within web page anchor names, anchor references and CGI URL parameters. This allows use of referenced variables that equate to an item values containing spaces. The use of these special keywords causes spaces to be translated or escaped using the required character sequences.

The special keywords are:

ANCHOR 

PARAM

EXAMPLE:

c.cgi?c=<<category PARAM>> 

<a href="#<<category ANCHOR>>"> 

<a name="<<category ANCHOR>>">

TEST:

Test installation and configuration by invoking the various Shopping Cart functions from a web browser.

• view empty cart
• add item (BUY)
• delete cart
• change quantity > 0
• delete item (quantity = 0)
• check out (online credit card)
  1. enter check out area
  2. customer info entry w/errors
     use: MC 3434 3434 3434 3434 (for testing)
  3. customer confirmation
  4. completion
  5. view customer and admin e-mails
• FAX order
• Check order
• P.O. order

CUSTOMIZATION:

Following successful installation and test, customize static pages (*.html), page templates (*.htm) and e-mail templates (*.txt) as desired.

JHZ-CS page generator solutions that display product item lists and detail pages dynamically generate "BUY" (add item to order) links with the appropriate parameters defined to the IID (Item Information Dataset). Static pages may be enhanced to include "BUY" (add item to order) links.

Add "Shopping Cart" (view shopping cart) and "Check Out" links to static pages and templates as desired.

USAGE:

Shopping Carts - a customer specific shopping cart file is created in the "carts" directory when the first item is added to an order. A cookie is set identifying the customer with a unique ID and is maintained in the carts index.

Online Credit Card Orders - a customer specific order file is created in the "orders" directory when the order is completed. The customer is sent an email containing the order information. An administrative notification email is sent announcing the order. FTP download the order file for fulfillment processing.

Other Order Types - customers complete the online forms, then print and either mail, telephone or fax their order according to instructions you have specified (contained within the check out type specific page templates).

Customer History - a customer specific history file is created in the "cust" directory when an order is completed. A cookie is set identifying the customer. This information is used to prime the customer information page with their last entered values the next time they check out.