shopping_basket icon

Instructions for the installation of shopping_basket release 2



General Overview

The shopping_basket release 2 package comes in seven pieces (newindex2.html, basket2.html, ordering2.html, adjust2.html, view2.html, howmany2.html and example.html). Six of these are basically just dropped into where you keep your HTML's for your site.

The seventh (example.html) is actually an example of the changes needed for those HTML pages that you wish to connect to the shopping_basket. The changes are trivial (copy and paste) and do not change how your website currently operates, with the obvious exception of added shopping_basket functionality.

We designed this package to be as totally generic and as easily expandable and installable as possible.

Before installing, you should test the demonstration package. To test, simply open demo with your browser and cruise around. We recommend playing with this demonstration a bit to familiarize yourself with the way it works.


Assuming the demonstration worked fine, you're ready to install.

Instructions

Step 1:

Click on each of these hyperlinks and save the source to your disk
(this entire download is only 48K bytes)



Step 2:

Add newindex2.html, basket2.html, adjust2.html, view2.html, howmany2.html and ordering2.html to your directory or folder containing your other html's for your website. The files adjust2.html, view2.html, and ordering2.html must be changed to reference add2.js from a current reference to add1.js. See the comments in these files for details.

Step 3:

Update ordering2.html to correctly reference your form/email CGI script. The instructions for this step are included as comments in ordering2.html. If you have trouble with this step, contact the WebMaster of your Web service provider.

Follow all of the other instructions in ordering2.html, as well.

Step 4:

Follow all of the instructions in example.html to update each page that you wish to directly connect to the shopping_basket. These are the pages that present your products.

Basically you will be adding a JavaScript reference to the head section of your HTML pages that present products. Then you will add a JavaScript to the body section of that HTML. And finally you add button(s) ("add to my shopping basket" and "View contents of my shopping basket"), and a hyperlink button to ordering2.html ("Go to Order Desk with my Shopping Basket") . The wording for both of these is entirely up to you and is customizable for each product and page presented. This can all be accomplished by using copy-and-paste in a simple text editor.

NOTE: You need to make these changes to only those pages that present products.

Step 5:

To insert newindex2.html and basket2.html into your site follow the instructions below, exactly:

rename your current index.html to realindex.html

rename newindex2.html to index.html

Since both newindex2.html (now named index.html) and basket2.html are invisible, there will be no noticeable difference to the way your site looks.

NOTE: Once Steps 1 through 5 are completed for at least one product presentation Web page, you might be tempted to test that updated page. For testing to be successful, you must be on-line and the updated page must be "approached" through index.html and the other intervening hyperlinks to the updated page. Failure to do so will generate "Mid-Site Visit" warnings.

ALSO NOTE: Once Steps 1 through 5 are completed for at least one product presentation Web page, you might be tempted to test that updated page. For testing to be successful, you must be on-line.

Optional Step 6:

If you anticipate more than 20 different products will be ordered during any single customer visit to your site, then basket2.html needs to be updated. Follow the instructions at the end of basket2.html if this is the case. For 20 or less products, no changes need to be made.

That's all there is to it. The installation is now complete. As one of our official sites, we look forward to your questions, comments, suggestions, and whatever. Don't forget to register with us for future updates and enhancements.
To register simply email us your name, email address, and web site address.

Assumptions and Caveats

It is assumed that shopping_basket will be installed on a retail/catalog Website offering multiple products. This software is designed to aid such a Website.

It is assumed that the installer of this software has some knowledge of HTML and knows how to copy-and-paste in a simple text editor.

It is assumed that each Web page of the Website has a clearly defined HTML head section and body section.

It is assumed that the Website has access to a CGI form/email script. We highly recommend Matt Wright's FormMail.pl available for free at Matt's Script Archive.

* Failure to follow the above installation instructions will lead to unspecified results.

* Use of the hyperlink/frames directive, target = "_top", will cause the current contents of shopping_basket to be emptied.
The use of target = "realindex" is recommended instead.

* Suggestions for enhancements and improvements should be sent to pongken@loxinfo.co.th

* Site-specific customizations can be made by the installer of this software. Other site-specific customizations are also available from PongKen Software. Contact pongken@loxinfo.co.th for a price quote.

shopping_basket release 2 by PongKen Software
© copyright PongKen Software 1999-2002
All rights reserved. Use of this software is by permission only from PongKen Software. Permission can be obtained via email from
pongken@loxinfo.co.th