Tango E-Commerce Demo

The Tango E-Commerce demo is designed to give you a head start in creating production quality e-commerce solutions. Whether you are creating an online shopping solution or a business-to-business supply-chain management solution, you will hopefully find the source code for this demo useful in your development efforts.

This demo is not a production-quality online shopping solution. It was not designed as a template or off-the-shelf commerce solution. It was designed as a development aid only. Since the application files were created by experienced Tango developers, understanding the source code requires at least intermediate knowledge of programming in Tango. If your goal is to use the code from this demo to create an online shopping solution, and you are new to Tango, it is recommended that you start with the Tango tutorials before attempting to customize this demo. You may also want to take a Tango training course to supercharge the learning process. Check the Pervasive Web site for information regarding upcoming Tango training courses at a city near you.

The following describes some setup issues and a very brief overview of what each file in the commerce project is for.

Requirements

This demo requires the use of Netscape Navigator or Internet Explorer 3.0 or above.

Setup

If you want automatic deletion of expired orders you'll need to create a reference to the order_deletion.taf in the crontabFile.

If you want to use e-mail notification make sure you have the address of an SMTP server in your MAILSERVER setting and that MAILSWITCH=on in your t3server.ini file.

Admin Files

The following files control the administration features of the demo.

File Name Description
adminerror.html Displays admin error page (unrecoverable errors).
adminfooter.html Displays footer text for admin tafs.
adminheader.html Sets variables related to page appearance in admin tafs.
adminindexframe.html Creates admin menu frame.
admin.taf Initial module for administration functions.
admin_cat.taf Used to maintain the Category codes used in the shopping basket.
admin_cust.taf Used to modify/delete/report customer information that was originally entered through shopping basket.
admin_item.taf Used to maintain inventory items used in the shopping basket.
admin_order.taf Used to update/delete orders entered in the shopping basket.
admin_rates.taf Used to modify/delete/insert shipping rate records that will be used in shopping basket. Note: From and To fields can refer to sales total, items total or total weight.
admin_store_setup.taf Used to maintain the company table, which controls the basic functionality of the store.
admin_taxes.taf Used to enter/modify/delete the tax codes used by the shopping basket.
admin_zones.taf Used to enter/modify/delete the shipping zone codes used by the shopping basket.

 

Shopping Files

The following files control the shopping functionality of the demo.

File Name Description
AdminScripts.txt General error checking routines and state abbreviation validation.
CheckCreditCard.txt Validate credit card number and expiration date.
CheckEmail.txt Validate email address string.
CheckInteger.txt Numeric validation routines.
CheckLogin.txt Password and E-mail address string validation.
Customer.txt Customer form validation.
ScriptEnd.txt Common code to end JavaScript routine in Tango.
ScriptStart.txt Common code to begin JavaScript routine in Tango.
Index.html Product index page.
CardImages.html Credit card images.
CatalogBody.html Catalog page.
CatalogHeader.html Catalog page header.
Checkout1.html Order Checkout page – Billing and Shipping info.
Checkout2.html Order Checkout page – Order Summary info.
Checkout3.html Order Checkout page – Payment info.
Countries.html Pull-down countries list.
CustomerBillTo.html Add/Update Customer Bill-To address.
CustomerHeader.html Add/Update Customer info header.
CustomerShipTo.html Add/Update Customer Ship-To address.
Error.html Shopping basket error page (unrecoverable error).
Footer.html Display Search button and control Footer2.html.
Footer2.html Standard Shopping Basket footer.
Forgotten.html Password error message.
Header.html General header appearing on all pages that do not have a specific header.
IncactiveCust.html Inactive Customer message.
ItemFooterMsg1.html Item footer.
ItemFooterMsg2.html Item Page footer.
ItemFooterMsg3.html Item Page footer.
ItemHeader.html Header for both Single Item and Variable Item pages (all instances).
LoginBody.html Pre-checkout html showing customer choices for checking out.
MailCust.html Email confirmation message.
OrderPlaced.html Body html for the order placed page.
ReviewBody1.html Review page items header.
ReviewBody2.html Review page body.
ReviewBody3.html Review page items footer.
ReviewHeader.html Review page header.
SearchBody.html Product Search page.
SearchResult.html Product Search Results page.
SecurityModeFooter.html SSL security message footer.
SecurityModeHeader.html SSL security features.
SecurityModeMsg.html SSL security message.
Shipping.html Shipping order message.
ShippingOptions.html Shipping zone/method and Payment method.
SingleItemBody.html Body html for dynamic single items.
States.html Pull-down states list.
SubCatalogBody.html Body html used with dynamic catalogs with subcategories turned on.
VarItemBody.html Body html used with dynamic variable items.
authorize.taf Used in the credit card authorization function of the shopping basket.
catalog.taf Displays the product index, category/subcategory index and category items pages in the shopping basket.
checkout.taf Displays the checkout screen and processes placement of an order.
common.taf Consists of a number of common functions that are called by tafs throughout the shopping basket.
cust.taf Creates the customer entry page used in the shopping basket.
init.taf Sets the system global variables for the shopping basket.
item.taf Used in the shopping basket to create the item page, which displays detail information about an item and allows a specified quantity to be added to the current shopping basket.
login.taf Allows shopping basket log-in (pre-checkout page).
order_deletion.taf Used to automatically delete expired orders. Functionality dependent on the "Order Deletion" and "Baskets Expire" options in Store Setup. Note: In order to use this taf, it needs to be referenced in the crontabFile.
orders.taf The main module in the shopping basket for processing order items (insert, update, delete, compute sales and tax totals).
review.taf Creates the review page, which displays the current shopping basket.
search.taf Provides the capability of performing searches for specific items in inventory. Note: Enable Product Search option must be selected in Store Setup.