Application Systems Design, Development, Training, Support & Support Services
Ready-made Customizable Solutions
Solutions: Ecommerce : Shopping Cart: Install & Use
Shopping Cart - Installation and Use
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)
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
closed.html - shopping closed page
ns.html - browser not supported page
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
aemail.txt - back-end administrative sales notification
cemail.txt - front-end customer sales confirmation
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
PRODUCT ID: SC
*AUTH - Authorization/permissions octal equilvalents where:
7=RWX, 6=RW, 5=RX, 4=R (R=Read W=Write X=Executable)
1 char indicates Octal number
2 char Owner
3 char Group
4 char All Others
It is recommended that you read the entire installation process steps prior to performing installation. Each solution has specific instructions.
- Download solution to desktop
- Expand installation package (use any standard archive application; such as WinZip®, StuffIt Expander® or TAR command)
- Set configuration settings
- Upload components to server
- Set file permissions
- Test installation
- Customize Templates as desired
- Test customizations
Modify Logic Components
Modify all logic components "*.cgi" and "*.pl" logic modules as follows:
- First line of code (#!) correctly points to the PERL executable binary on the server (use command "which perl" or consult your server administrator)
- All PERL "requires" statements contained in "*.cgi" and "*.pl" logic modules must use "absolute" directory paths (beginning with a forward slash "/")
Set Configuration in sc.pl; see embedded instructions for:
- Use Database (for SQL RDBMS IID)
- SALE TAX
- "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:
- 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
- Verify the copied version of "sc.pl" configuration variables point to the directory file paths in the SSL area
- Install a copies of template directories to the SSL server space
- 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.
Customize templates for content and appearance as desired:
cart.htm - online shopping cart
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 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:
c.cgi?c=<<category%20PARAM>> <a href="#<<category%20ANCHOR>>"> <a name="<<category%20ANCHOR>>">
Uploading to Web Server
All dependent and required components must be successfully installed and configured. All components, with the exception of images, must be FTP uploaded as TEXT. Images must be FTP uploaded as BINARY.
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)
- enter check out area
customer info entry w/errors
use: MC 3434 3434 3434 3434 (for testing)
- customer confirmation
- view customer and admin e-mails
- FAX order
- Check order
- P.O. order
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.
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.
JHZ-CS Solutions are offered exclusively under the terms and conditions of the JHZ-CS Software License Agreement.