ShopPlus
Instructions
Before setting us your cart, please
email us so we can enable the program for you. You can send an Official
Request for that purpose asking for the shopplus to be enabled.
The
ShopPlus system is a sophisticated cgi program that will help you effectively
sell your products and/or services via the internet. Since the products must be
added to the cart, prices calulated automatically and your customer's purchases
tracked by the program, all your html pages must be linked dynamicaly. This is
commonly referenced as "carrying the cart". Dynamic referencing is
done very easily with the ShopPlus, but it is an important concept to
understand.
For example, to link pages to each other, you would normally
use:
<A
HREF="/path_from_root_of_web_site/pagename.html">
Using
the ShopPlus, you would link as follow:
<A
HREF="/scripts/shopplus.cgi?DN=domainname.com&CARTID=%cartid%&FILE=/path_from_root_of_web_site/pagename.html">
In the examples to follow these instructions, we will
assume that your domain name is "abcd.com" and that all your web pages
for your site's shopping area are in a directory called
"Shopping".
Preliminary Shopping Area Pages
Create as many
preliminary pages as you wish. This could be your shopping area's main entrance
page, a page that shows all your product categories, a page that shows a listing
of all products in a product category and so on. Just make sure you link each
according to the standard ShopPlus dynamic referencing, as explained above.
For example, to link a page to another page called
"product1.html" inside a directory called "Shopping", you
would normally use:
<A
HREF="/Shopping/product1.html">
Using the ShopPlus,
you would link as follow:
<A
HREF="/scripts/shopplus.cgi?DN=abcd.com&CARTID=%cartid%&FILE=/Shopping/product1.html">
Product(s)
Create as
many products pages as you want. You can put one or multiple products on each
products page. For each product, a set of values are attached in the form of
hidden HTML tags. These values are price, product description, product id,
shipping costs, etc...
- Since each product needs a quantity field for specifying the quantity
ordered, a <FORM> tag must be included in
the page, right after the <BODY> tag. The
action of the <FORM> tag must specify the
location of the review page.
<FORM
METHOD="post"
ACTION="/scripts/shopplus.cgi?DN=abcd.com&CARTID=%cartid%">
- Next, put products on this page. Format your products on the page any
way you want. You might want to add graphics, product name, model #,
description, etc.. However, you also want to add FORM elements like text
boxes, pull-down menus, radio buttons or checkboxes so that your customer
can select the quantity and options of products they are purchasing. Before
starting with any product, choose a unique id for that product. In our following examples, we have chosen "jeans" as our
id.
- QUANTITY (required)
you can use any FORM elements you want, like
radio buttons, checkboxes, text fields, pull-down menus, etc... Just
make sure your field NAME is equal to QUANTITY|jeans
For example,
for a text field with ITEMID jeans, this would be:
<INPUT TYPE="text"
NAME="QUANTITY|jeans" VALUE="">
- PRICE (required)
you must use a hidden field for the price. If
the products price was $45.00, you would use:
<INPUT TYPE="hidden"
NAME="PRICE|jeans" VALUE="45.00">
- DESCRIPTION (optional)
you can define a short description for
this product so that the ShopPlus cart can present it when your
customers are reviewing their orders. This is a hidden field,
like:
<INPUT TYPE="hidden"
NAME="DESCRIPTION|jeans" VALUE="Washed Denim
Jeans">
- TAX (optional)
you can choose whether this product is a taxable
item or not. This defines whether your appropriate tax rates will be
applied to this product. If you do not use this, it is taxable by
default. If you do, use the following:
<INPUT
TYPE="hidden" NAME="TAX|jeans"
VALUE="no">
- SHIPPING (optional)
each product can have two shipping charges
associated with it, a initial product shipping charge, and one
associated with each instance of that product. For example, a t-shirt
has an initial product shipping of $4.00 and a shipping charge of $1.00
with each t-shirt purchased. If 3 t-shirts are purchased, an initial
charge of $4.00 is applied as well as 3 charges of $1.00, so the
shipping for those 3 t-shirts only would be $7.00 ($4.00 + (3 * 1.00)).
If you do not include this tag, the defaults of $0 initial shipping and
$0 shipping charges per instance of that product will be applied for
that product. If you do, use the following:
<INPUT TYPE="hidden"
NAME="SHIPPING|jeans"
VALUE="4.00|1.00">
- DISCOUNT (optional)
discounts are used when the product is
purchased in large quantities. You can set as many discount ranges as
you want (e.g. 5 to 20 products at $20.00, 21 to 100 products at $19.00,
101 and more at $18.00). You can have two different kind of discounts:
- Price DISCOUNT: a discount schedule based on price reductions
off the default product PRICE.
<INPUT
TYPE=hidden NAME="DISCOUNT|jeans"
VALUE="1-9=0.00|10-19=5.00|20-*=10.00">
- Percent DISCOUNT: a discount schedule based on percent
reductions off the total product PRICE.
<INPUT TYPE=hidden NAME="DISCOUNT|jeans"
VALUE="1-9=0%|10-19=10%|20-*=20%">
- OPTIONS (optional)
options are used when different attributes are
attached to a product. The attributes can be a list that your customer
chooses from (color, size, etc...) or can be typed in a text box. In
addition to being able to add an unlimited amount of options, options
can also affect the product price if desired. Since you can have as many
option categories and options within the category, each option category
must be given a unique name (to differentiate it from other option
categories). Here is an example code for an "color" option
category in a pull down menu:
<SELECT
NAME="OPTION|jeans|color">
<OPTION
VALUE="blue|-$4.00">Blue color (subtract
$4.00)
<OPTION VALUE="black|+$5.00">Black color (add
$5.00)
</SELECT>