uShop Reference - uShopOrderBasicCGI.class

uShopOrderBasicCGI.class

The uShopOrderBasicCGI applet is an order form which collects the customer's personal and payment information and then securely sends the information to your secure server. It is identical to the uShopOrderCGI applet, except this applet does not have any text boxes for entering credit card information. It is ideal for stores that do not accept credit card payments. To use this applet, you must have configured the ushop_cgiscript.pl in your cgi directory on your secure server. See also ushop_cgiscript.pl. In addition, this applet also allows you to setup shipping, tax, and payment options as described below.

Parameters

scriptpath - The full path to the ushop_cgiscript.pl on your server. Example: "http://www.mystore.com/cgi-bin/ushop_cgiscript.pl".
payment - This parameter lets you specify a list of payment methods that you accept. Separate each method with a comma. Example: "Check, Money Order, COD, Call Me" would allow customers to choose to pay by Check, Money Order, COD, or to have the store owner contact them for the payment information.
taxrate - The default tax rate. Specify this as a value 0.00 through 1.00 (ie. "0.06" or "0.07") - DO NOT use a percent (%) sign.
taxtable - This parameter allows you to override the default tax rate for customers from specified states. That is, in this parameter you can specify special tax rates for specific states. The format should be "&ltstate>=&lttaxrate>,&ltstate>=&lttaxrate>,...". You can specify as many states as you want. Example: "FL=0.06,FLORIDA=0.06, TX=0.07,TEXAS=0.07" would charge customers from Florida and Texas tax rates of 6% and 7%, respectively.
shipping - This parameter allows you to specify what shipping methods are available and how to calculate the shipping for each method. See the page on shipping setup for additional information on setting up Shipping.
handling - This parameter allows you to specify a default handling fee that will be added to all orders. Example: "$2.00" would charge customers an additional $2.00 per order.
handlingtable - This parameter allows you to override the default handling rate for customers from specified countries. That is, in this parameter you can specify special handling fees for specific countries. The format should be "&ltcountry>=&lthandlingfee>, &ltcountry>=&lthandlingfee>,...". You can specify as many countries as you want. Example: "USA=$1.00,United States=$1.00,U.S.A.=$1.00, US=$1.00,CANADA=$1.00" would charge customers who live in the US or Canada a $1.00 handling fee.
message - An optional message that will be included on the bottom of the order receipt that is sent to the customer.
return_url - This parameter lets you specify a URL to be used as a "BACK" link on the order receipt page. That is, if you specify a full URL here, uShop will add a "BACK" link on the bottom of the order receipt page to link to the specified URL. Example: "http://www.uburst.com".
thankyou_url - Instead of letting uShop create an order receipt page after an order is placed, this parameter lets you specify a URL of a custom thankyou page (or any web page) that you want to appear after an order is place. Example: "http://www.uburst.com".
clearcart - This parameter specifies whether to clear the shopping cart and order form after the customer has submitted the order. Valid values are "YES" or "NO". The default value is "NO".
background - The background color of the applet. You can specify an RGB value separated by commas ("integer,integer,integer" where each integer is a value between 0 and 255) or specify one of the predefined colors: white, black, lightGray, gray, darkGray, red, green, blue, yellow, magenta, cyan, pink, and orange. The default value is "white".

Note: Optional parameters are in italics

Example

This order form example has been setup:

To send the order information to the ushop_cgiscript located in our cgi-bin directory.
To accept Check, Money Order, or COD payment methods.
To charge no tax, except for customers from Florida - who are charged 6% sales tax.
To allow 3 shipping methods: UPS based on subtotal, FED EX based on total weight, and Over Night at a flat rate of $50.00.
To charge no handling fees for customers in the US and a $5.00 handling fee for customers outside the US.
To add the message "Thank you for shopping with us." to all order receipts.
To add a BACK link to "http://www.uburst.com" on the order receipt page.
NOT to clear the shopping cart when the order is place.
And to have a light gray background color.

 &ltAPPLET CODE = "uShopOrderBasicCGI.class" WIDTH=450 HEIGHT=600>
 &ltPARAM NAME=scriptpath         VALUE="http://www.uburst.com/cgi-bin/ushop_cgiscript1p3.pl">
 &ltPARAM NAME=payment            VALUE="Check,Money Order,COD">
 &ltPARAM NAME=taxrate            VALUE="0.00">
 &ltPARAM NAME=taxtable           VALUE="FL=0.06,FLORIDA=0.06">
 &ltPARAM NAME=shipping           VALUE="UPS,BY_SUBTOTAL,20=$5.00,35=$7.00,50=$10.00,$15.00;
                                      FED EX,BY_WEIGHT,10=$5.00,20=$10.00,$25.00;
                                      Over Night,FLAT_RATE,$50.00">
 &ltPARAM NAME=handling           VALUE="$5.00">
 &ltPARAM NAME=handlingtable      VALUE="US=$0.00,USA=$0.00,U.S.=$0.00,U.S.A.=$0.00,United States=$0.00">
 &ltPARAM NAME=message            VALUE="Thank you for shopping with us.">
 &ltPARAM NAME=return_url         VALUE="http://www.uburst.com">
 &ltPARAM NAME=clearcart          VALUE="NO">
 &ltPARAM NAME=background         VALUE="lightGray">
 </APPLET>