e-BlackHills.com
e-BlackHills.com Home How It Works Cost Frequently Asked Questions Sign Up Demo Store e-BlackHilsl.com Menu

Shopping Cart Options

Setting Up Your e-BlackHills.com WebShop
      Please Note: This is a long form, not because it's difficult, but because of the possibilities.
      There are examples and directions for each item. Take it step by step.
      If you make a mistake on your settings, don't worry...
      You can come back and re-modify it at any time!
This is a Non-Working Demonstration Page

WebSite Variables
For More info see ReadMe.html
1. Type in the address of the page you want folks to see first when they enter your online store, which is also the page they will be taken to if they click on the "Continue Shopping" button.

Default: http://www.e-BlackHills.com/your-site/index.html


2. Type in the address (URL) to your company logo (this can be left blank)

Default: http://www.e-BlackHills.com/your-site/logo.jpg


3. Type in the address (URL) to your website background picture (this can be left blank)

Default: http://www.e-BlackHills.com/your-site/background.gif


4. Does your website use frames? If so, type in the name of your Parent frame.

Example: _Main-Frame
(Normally the shopping cart will work fine without placing anything in here. If you are unsure, just leave this field blank)
Personal Variables
For More info see ReadMe.html and custom.html

1. Custom Options:   
With every item you can have an array of Custom Options or descriptions. Such as color of shirt, size of shirt, or other attributes that change which item they purchase according to their specifications. You can have as many Custom Options of your items as you need. It is recommended for performance reasons that you keep this variable as small as possible. For example, if an item of yours that contains the largest number of Custom Options comes to 15, then set this to 15. There is no need for the shopping cart script to search for higher variable values in this array. Default is set at 15.
Example: If you're selling a shirt, you might have these Custom Options... 1. Size, 2. Color, 3. Fabric, 4. Sleeve Style, 5. With or Without Pocket. So in this case, you would have 5 Custom Options.

2. Order details are emailed to the merchant here:

This is where you put your email address. When someone orders something, a copy of the order details will be emailed to this address.
Need to send copies of the order to more than one address? Just set this variable like so: 
      shipper@youremail.com, orders@youremail.com, mer621@jfax.com
The cart can also send receipts to www.Jfax.com. This is a neat email to fax service. Just put your email address in the first position and put your Jfax email address in any place after that.

3. Your Business Name Here:   
This is the name of your business. Don't leave this variable blank. If you don't want your business name to appear at the top of the carts pages, then set #42 (below) to 0.

4. Checks payable to:   
This is who you want your customer to make their checks and money orders payable to. Perhaps it will be the same as the Business Name above.

5. Guarantee statement on receipt page:

Default: If not completely satisfied with any item within 30 days, return in original packaging for a refund.
This one is pretty self explanatory. This statement will be displayed on the webpage after a customer has made a purchase.

6. Address name:   
Default: ABC Widget Company. Attn: John Doe
This is the name of the mailing address of your company. This could be exactly the same as business name above.

7. Street address:   
This is your street address.

8. City, State, Zip:   
This is your City, State and Zip.

9. Toll Free Phone Number for CC Transactions:   
This is where you put your telephone number for Credit Card Transactions Via Telephone. If you don't have a phone number and are not going to provide this payment option for your customers, then just leave this variable empty. You may also put in a Non-Toll Free Number if you choose.

10. Website Address:   
Default: www.YourName.net
This is your website address. Why again if we already covered it above? This variable won't be a link, just printed on the screen. You can have these two variables the same if you want. Or you may have this one say "yourname.com" instead of "http://www.e-blackhills.com/merchant-name". It's up to you.

11. Allow Sales Tax:   
Set to "1" if you are going to collect sales tax. Or "0" if you are not. If you are selling a few items that are nontaxable, then use this tag in the corresponding item's HTML form.
<INPUT TYPE=HIDDEN NAME="custom2" VALUE="#nontaxable#">
Of course, make sure the name "custom2" is not in conflict with any other custom name. See Template.html for details on "custom". Live in a area where you need to collect tax whether your customer lives in your state or not? Then set this to 2.

12. Your State(s) of taxation:   
This is the state(s) you are in where you need to collect sales tax. If you need to collect tax in more than one state define this variable like so:
South Dakota,Wyoming,Nebraska
If you only need to collect sales tax in one state, the cart will display a checkbox. If you need to collect tax in multiple states, the cart will display a select pull-down menu. See also the sales tax state verification feature in #76.

13. State sales tax rate:   
This is the sales tax rate in your state. If you need to collect tax in more than one state define this variable like so:
6.00,4.75,7.25
If you are collecting sales tax in multiple states, make sure the numbers here correspond in order with the states defined in #12 above.

14. bgcolor:

This is the background color of the pages of your shopping cart if no wallpaper is defined in Website Variables #3 above. Make sure that this color CONTRASTS with the colors you have set in #16 and #19 below.

Want to control the LINK and VLINK colors in the BODY tag of the carts dynamic pages?
Then Set this variable like so:
#FFFFFF" LINK=#0000FF VLINK=#000099 "
Or with marginheight and marginwidth:
#FFFFFF" marginheight=0 marginwidth=0 "
This looks funny, but it will work.

15. Header font color:   
This is the header font color in the shopping cart.

16. Header font face:   
This is the header face font in the shopping cart.

17. Header font size:   
This is the size of the headers in the shopping cart.

18. Standard font color:   
This is the standard font color of the shopping cart.

19. Standard font face:   


20. Standard font size:   


20. Thumb-nail image borders:   
Define the width of the borders around your thumb-nail images. Can be 0 and up.

22. Shopper's data expires:   
This is the amount of days that shopping cart data files are allowed to remain on your host in the "temp" directory, before the shopping cart script deletes them. This makes Shopping Cart really intelligent and tidy, and prevents you from eventually running out of web space on your host. 
1.0  = one day.
0.5  = 12 hours.
0.08 = two hours.
0.04 = one hour.


23. Secure Online CC Transaction Payment Option:   
If this is set to 1 then the option of Secure online credit card transaction will appear in the shopping cart. If set to 0 then it will not appear.

After Secure Online Credit Card Transactions, Online Check Drafts and COD orders, the customers data file is immediately erased because the order is considered final. However, with Credit Card Transaction Via Telephone and Check Or Money Order, the contents of their shopping cart are not erased as the order is not final and the customer could still choose to go back and add more items to their cart before they send you their check or call you.
24. Transaction via toll free number payment option:   
Setting this to 1 enables credit card transaction via toll free phone number. Leave it blank ant that payment option will not appear.

25. Check or Money Order payment option:   
The "Check or Money Order" payment option is not designed to take your customers shipping address if you set it to "1". It just gives them a custom order form that they can print out and mail to you with their check/money order. If you would like the cart script to take your customers shipping address and notify you by email when they may be placing an order via "Check or Money Order", then set this variable to "2" (Without the quotes.)

Notes: Remember, you never know if the customer is really going to order the products until you receive their check in the mail. Therefore, the contents of your customers shopping cart will not be immediately erased after they place their order. This way if your customer decides to go back and add just one more item to their cart, they wont find it empty and get frustrated.

26. Allow shipping:   
The cart has five shipping methods you can use:
  1. Set this variable to 1 if you want the shopping cart to calculate shipping costs based upon the weight of the products they are purchasing.
  2. Set this variable to 1 if you want the shopping cart to calculate shipping costs based upon a flat fee for each item.
  3. Set this variable to 2 if you want the shopping cart to calculate shipping costs based upon the amount of the customer's purchase with flat charges at various increments.
    Example: 
    Under $100   - $10 s&h
$100 - $200  - $20 s&h
$200 or over - Free
  4. Set this to 2 if you want the shopping cart to calculate shipping costs based upon the amount of the customer's purchase with flat charges a various increments. Example: 
    Under $100   - 5%
$100 - $200  - 4%
$200 or over - Free
  5. Set this to 1 if you want to use Custom Database Shipping Tables.
  6. If you are going to make a "shipping included" type of statement, then set this to 0. The cart won't calculate any shipping then.
See Section 10 of ReadMe.html for detailed information on setting up shipping charges.

27. Show shipping weight with each item:   
If you set #26 above to 0 or 2, then ignore this variable. If you set this to 1 then you will see shipping with each item on the invoices. If you set this to 0 then you will only see shipping at the bottom of each invoice. Try it either way and see which you like best. If you set this to 1, make sure you define #31 below also.

28. Shipping methods:   
Default: Standard UPS,3 day UPS,2 day UPS,Next day UPS,Europe,Australia
If you set #26 above to 0 or 2, then ignore this variable. This is an array containing all of the shipping methods you want to offer if you are doing shipping by the weight of your items. Separate them with commas like you see here. You may define anywhere from 1 to 100 shipping locations (or more).

29. Initial shipping cost of first pound:   
If you set #26 above to 0 or 2, then ignore this variable. These are the prices of the initial shipping costs of each item (per pound/kilo). They must correspond in order with #28 above. Set them to whatever you need to. Then, in each product's HTML form, use a tag like this:
<INPUT TYPE=HIDDEN NAME="sh" VALUE="1">
"sh" means shipping and handling. "1" means one pound/kilo.

Do you want the cart to say something like "Call for shipping quote" and not have any numeric value appear in the SELECT pull-down menu? Then set both #29 and PV#30 to 0.00
The "0.00" will tell the cart to not show ANY number (price) in that option.

30. Shipping cost for each additional pound:   
These are the costs of each additional (pound/kilo) per unit. They must also correspond in order with the #28 and #29 above. Example: If someone selects "Standard UPS" and their order has 3 pounds (or kilos) of products in it, the cart will charge 4.95 + .50 + .50 (5.95 total.)

Do you want the cart to say something like "Call for shipping quote" and not have any numeric value appear in the SELECT pull-down menu? Then set both 30 and 31 to 0.00
The "0.00" will tell the cart to not show ANY number (price) in that option.

31. Type of measure of weight. lbs or kg, etc. or just "units":   
This concept allows your shopping cart to be very accurate about shipping costs. You may set this to lbs or kg, etc. or just "units". The shopping cart doesn't really understand what a pound or kilo is, but this word that you define here will be displayed in the shopping cart if you have #29 above set to 1. It will be there to tell your customer how many "pounds" an item weighs for S&H purposes.

32. Shipping calculated by amount of purchase: Locations:   
You only need to set this variable if you set #26 above to 2. These values must correspond in order with the values in #33 below. The locations above are separated by commas. The corresponding shipping costs in #33 below are separated by vertical pipe symbols "|". You may define as many locations as you wish.

33. Shipping calculated by amount of purchase: Amounts:   
You only need to set this variable if you set #26 above to 2. This field contains shipping calculation information for the three corresponding locations defined in #32 above. The three sets of information are separated by "|". The purchase amounts and shipping charges are separated by commas. In the above example, "55" is the lowest purchase amount defined for USA. The next number, "3.95", is the shipping charge (for any purchase amounts under $55). The third number, "100", is the highest purchase amount defined for USA in this example. The fourth number, "5", means that $5.00 will be charged for any purchase amounts that are under $100. Any purchase amounts $100 or over, will be "free shipping" or "shipping included" in this example. In the above example shipping for USA would be calculated like so: 
Order sub-totals Under $55                            - $3.95 s&h
Order sub-totals Under $100 (but greater than $54.99) - $5.00
Any order $100 and over                               - s&h is free.
Always set this variable from smallest order totals to largest (ie, 55 to 100, not 100 to 55). Any sub-total equalling or exceeding the highest defined would be considered free shipping, so define it as high as you need to. Example: 55,3.95,100,5,200,10,500,25,1000,50

If you want to use percentages instead of flat charges, set this variable like so:
100,5%,200,4%,1000,3%,1000000,2%|etc|etc

5% shipping for orders totaling $100 or less.
4% shipping for orders totaling $200 or less.
3% shipping totaling $1000 or less.
2% shipping totaling $1000000 or less.
Free shipping when subtotal is over $1000000.


Do you want the cart to say something like "Call for shipping quote" and not have any numeric value appear in the SELECT pull-down menu? Then set this to 0.00
The "0.00" will tell the cart to not show ANY number (price) in that option.

34. Currency Symbol and decimals:   
This variable has three fields separated by the "|" (pipe) character. The first field will be the currency symbol you want the cart to display. The second field is how many decimal places you want the cart to use with your currency. The third field is what character you want used to separate the currency every three digits. Examples:
     $|2|,       Which will yield: $ 9,999.99
     L|0|.       Which will yield: L 9.000
     £|2|,       Which will yield: £ 9,999.99
Note: If you have this variable set to use no decimals, then it's recommended to not use any decimals in your prices or the programs calculations may not appear correct.

35. Email receipt to customer:   
This Shopping Cart always gives your customer a printable receipt in their web browser. However, if you would like the cart to send them a receipt by email too, then set this variable to 1. If not, set it to 0.

36. Background color of various tables:   
When a customer chooses "Check or Money Order" transaction, they get a printable custom order form. This form has a table where they print their shipping address. You can set the background color of this table here. If you leave it blank, the default is white. This is here in case you want to use a white font (#15) on your pages and still be able to read this table. This also sets the color in the row across the top of the shopping cart display where it says, Item: Description: Quantity: Each: Total:

37. 39 IP addresses or cookies for shopper ID:   
Set this to 0 if you want the cart to identify your customer by their IP address. Set this to 1 if you want the cart to identify your customer using a cookie. If you set this to 1 and your customer has their cookies turned off in their browser, the Shopping Cart has the ability to use your customers IP address for identification.

38. Size of table borders when viewing shopping cart:   
This will set the thickness of the borders in the HTML table on the page that your customers see after they put an item in the cart, or view the cart. If you set this to 0, there will be horizontal rules
between items for clarity.

39. The width of the table when viewing the shopping cart:   
Just like it says. If you are not sure what this does, set it to 50% and then put an item in your cart. You will see that the page seems too narrow. You may set this to pixels or percentages.
Examples:
85%
600
800

40. Online Check Draft Option:   
Yes, a fourth payment option. This is related to #23, #24, #25 and #43. You have six options here.
  • Disable Payment Option. If you set it to 0, the cart will not display this payment option.
  • ssl.pl. If you set it to the full URL of your ssl.pl script, the cart will collect your customers check information and email it to you. The information can be collected securely too if the URL begins with "https". For more information on how to do Online Check Drafts go to: http://www.checkman.com
  • PayByCheck.com/iCheck. If you set this to "icheck", the cart will take your customers shipping address and then send them to http://www.i-check.net (i-check.net and http://www.paybycheck.com are the same company.) to submit their check information. If you have an account with i-check and wish to set this variable to "icheck", login to your account with i-check and set your return URL like so:
    http://www.e-BlackHills.com.com/cgi-bin/cart.pl?icheck1212abc
    This is the full URL to your cart, followed by a "?" then "icheck" then the unique random id that you define in Secure Server Variable #6 below.
    Make the link like so:
    http://www.e-BlackHills.com/cgi-bin/cart.pl?icheck1212abc&merchant=MerchantName
    A "failure" URL with the mall version would be:
    http://www.e-BlackHills.com/cgi-bin/cart.pl?failure&merchant=MerchantName
    Last put your i-check ID in Personal Variable #48.
  • ValidCheck. If you set this to "ValidCheck", the cart will take your customers shipping address and then send them to http://www.ValidCheck.com to submit their check information. If you have an account with ValidCheck.com and wish to set this variable to "ValidCheck", login to your account with ValidCheck.com and set your return URL like so:
    http://www.e-BlackHills.com/cgi-bin/cart.pl?ValidCheck1212abc&merchant=MerchantName
    This is the full URL to your cart, followed by a "?" then "ValidCheck" then the unique random id that you define in Secure Server Variable #6.
    Last put your ValidCheck.com VID in Personal Variable #48.
  • Signio/Verisign Telecheck. If you set this to "telecheck", the cart will take your customers shipping address and then send them to http://www.signio.com (Verisign's Telecheck service) to submit their check information. If you have an account with Signio/Verisign and wish to set this variable to "telecheck", login to your Signio/Verisign account and set your return URL like so:
    http://www.e-BlackHills.com/cgi-bin/cart.pl?check1212abc&merchant=MerchantName
    This is the full URL to your cart, followed by a "?" then "check" then the unique random id that you define in Secure Server Variable #6.
    Last make sure your Signio/Verisign login ID is in Personal Variable #48.
  • CHEXpedite If you set this with your full URL to CHEXpedite, then the cart will take your customers shipping/billing address and then send them to CHEXpedite for electronic check processing. Set your CHEXpedite ID in Personal Variable #48.
Examples:
0
icheck
https://www.BlackhillsSecure/cgi-bin/merchant-name/ssl.pl
telecheck
https://oec2.chexpedite.net/YOURID/NBDS_FromCart.asp



41. Use "state" field in shipping address:   
Europeans don't need to ask for this field in the shipping address. If you set this to 0, "state" will not appear in the shipping address forms. If you set it to 1, it will. Basically, if you expect all your customers will be outside the USA, then set this to 0, turning it off.

42. Show business name at top of all pages:   
At the top of the pages that the shopping cart generates, you will see your business name followed by your company logo. Some customers have logos that have their business name in it and would like to suppress the display of their business name just above it. If you would like to do this, then set this variable to 0. Otherwise, set it at 1.

43. Cash On Delivery payment option:   
A fifth payment option. This is related to #23, #24, #25 and #40. Set this to the price you want to charge your customers for shipping products to them in this manner. Set this to 0 if you do not wish to allow this payment option. If you wish to allow this payment option, but not charge anything for it, then set it to: "0.00".

44. Customer Comments:   
This variable, if used, will create a TEXTAREA box where your customers enter their shipping information. You may solicit them for "Comments, questions, suggestions" or "Special shipping instructions" or a personal message if they are shipping the products to a loved one. This variable needs two numbers separated by the "|" character. The first number is the number of columns you want in the TEXTAREA. The second number is the number of rows you want in the TEXTAREA. Want to change the wording just above the TEXTAREA box? See lang.html variable #99. If you do not wish to have this TEXTAREA box to appear in your cart, then either set this variable to 0 or leave it blank.
If you would like some default text to appear inside the TEXTAREA, then set a third field here like so:
60|8|What is your favorite color?<BR><BR>Favorite number?<BR><BR>Favorite rock band?<BR><BR>Favorite movie?
(Use the <BR> tag to indicate line breaks.)

45. Required fields:   
If you set this like you see above, then all shipping and billing address fields will be required. If any of these words are in this variable the cart will require that your customers include that info when they submit their shipping/billing address. If you don't want to require that your customers include their phone number, then don't put that word in this variable, etc. Default: name,address,city,state,zip,country,phone,email

46. Turn all JavaScript off:   
The Shopping Cart uses a little JavaScript to autocalc prices in the buttons and a few other minor things. The cart's JavaScript is compatible with MSIE and Netscape browsers both new and older versions except with some Mac browser versions and version 3.01 of Netscape which has a bug with JavaScript being used inside of nested tables. However, these nice features are not necessary for the cart to work. You can turn all JavaScript off if you like. Just set this variable to 1.

47. Add and redirect:   
The Shopping Cart has the ability to add your customers items to their cart without needing to actually load a new page and view their shopping cart contents everytime. If you set this variable to 1, it will activate the "Add and Redirect" feature. Set it to 0 and the cart will show your customer their shopping cart contents everytime they put an item in it. If you set this to 2, then your customers item will be added and they will be redirected without the JavaScript popup box.

If you would like to keep this variable set to 0, but you have a few products that you would like to use this feature with, then use this tag in those HTML product forms:
<INPUT TYPE=HIDDEN NAME=redirect VALUE="1">
or
<INPUT TYPE=HIDDEN NAME=redirect VALUE="2">

Make sure the URLs in your HTML FORM tags are EXACTLY the same as the URL in Host Variable #1. For example, notice how these two URLs below are NOT the same:
http://www.e-BlackHills.com/cgi-bin/cart.pl
http://e-BlackHills.com/cgi-bin/cart.pl
One is missing the "www.". If you wish to run your shopping cart without the "www." in the URL, that is fine, just make sure that Host Variable #1 is set that way too. Otherwise, when using the Add and Redirect feature, the cart will keep informing you that it is empty.

48. i-check, ValidCheck ID or Telecheck ID:   
If you have an account with i-check, ValidCheck.com or Signio/Verisign's Telecheck for Online Check Drafts, then put your account ID here. Make sure you have Personal Variable #40 set to properly too.
Currency Exchange Rate Feature:
If you are having the Shopping Cart use a currency other than US Dollars, but need to have it translated to US Dollars before sending the customer to i-Check, then set this variable like so:
00000000|.80
The first field to the left of the "|" character will be your ID with i-Check like normal. The field on the right of the "|" character will be the exchange rate. The total will be divided by the number you place here before the customer is sent to i-Check.


49. Wallpaper URL or background color on check draft table:   
If you have Personal Variable #40 set to the URL to your ssl.pl script and are going to have the shopping cart collect and send you your customers bank and check info, then set this variable to the full URL path to some wallpaper that you would like to have appear in the background of the check table. Or set it to a solid background color like you see here. If you are accessing your ssl.pl script via "https" then it is recommended to access this image via "https" too.

50. Webstore discount:   
The Shopping Cart can calculate discounts for your customers based upon either the "subtotal" or the total number of "items" they are purchasing. In the above example, if you set it to this way "subtotal|100|10", it will subtract 10% from any orders subtotaling $100 or more. If you set this variable like this: "items|10|15", the cart will apply a 15% discount if your customer orders 10 items or more. The first field must be either "subtotal" or "items". The second and third fields can be any numerical value you like. If you do not wish to use this feature leave this variable blank. If you would like to provide more discounts at a higher subtotal or item total, then add more values to #50 like so:
subtotal|500|10|600|15|1000|20
$500 gets a 10% discount. $600 gets a 15% discount. And $1000 gets a 20% discount. Etc.
The Shopping Cart has three discount features: #50 Webstore Discount, #55 Coupon Discount, and Volume Discount Pricing described in section 1C of the Template.html file.

51. Email Signature:   
You can have this info appended to the bottom of email receipts that get sent to your customers. Put your name, company slogan, mailing address, website address, email address, phone number here, etc. Use the "|" to indicate where you want line breaks. If you don't wish to use a signature, then leave this blank. If you set this to "default" (without the quotes), the shopping cart will automatically put your business name (Personal Variable #3), website address (Web Variable #1) and email address (Personal Variable #1) at the bottom of the email receipts.

52. Paper color font:   
Some people like to use a black background and a white font. However, you can't read it when you print it out on a printer. If you must use a white font, but want to use a different color on your receipt pages so your customer can read what they print out, set this to the receipt page font color and either wallpaper or background color. Example:
#000000|#FFFFFF
Or:
#000000|http://www.e-BlackHills.com/merchant-name/SpecialWallpaper.gif
If you want to use the same font colors throughout the cart and even on the receipt pages then just leave this variable blank.

53. Email Content-Type:   
If you are going to translate your lang.html file into a foreign language and you need the Shopping Cart to use a special content type in the email, set it here. If you don't have any clue what this is about, then just ignore this variable or leave it blank.

If you are seeing a lot of HTML tags appearing in the email receipts, then set this to:
text/html

If you have translated the lang.html file to Japanese, set this to:
text/plain; charset=x-sjis

54. Email Content-Transfer-Encoding:   
If you are going to translate your lang.html file into a foreign language and you need the Shopping Cart to use special encoding in the email, set it here. If you don't have any clue what this is about, then just ignore this variable or leave it blank. Example: 8-bit

55. Allow Coupon/Gift Certificate Discount:   
Activating this feature will allow your customers to enter a coupon or gift certificate number that will give them a discount. If you do not wish to use this feature, then set this variable to 0. Set this to 1 if you want to activate this feature. If you do not wish to have the Webstore Discount (Personal Variable #50) feature to be available in conjunction with this discount feature, then set this variable to 2. This way if a customer qualifies for the Webstore Discount and enters in a coupon or gift certificate number, they will only get the discount associated with this feature and not the Webstore Discount. Open and edit the file named "discount.html". This file should look like so:
abc|10%
def|15%
123|10
456|50
If a customer enters in a coupon or gift certificate number that matches a string in one of the left fields, the customer will receive the discount in the corresponding right field. The gift certificate numbers can be anywhere from 1 to 10 characters long made up of numbers and/or letters. You may designate the values as either percentages or flat amounts. Example: If a customer enters in "abc" they will receive a 10% discount on their order. If a customer enters in "456" they will receive a $50 discount on their order. The discount will apply on the subtotal of their order but not on their sales tax and shipping. So they will still pay for any applicable sales tax and shipping. You may have as many coupon/gift certificate numbers and values as you wish in your Online Store. The numbers don't delete themselves from the discount.html file after use. You will need to remove them when you want them removed.
The Shopping Cart has three discount features: Webstore Discount, Coupon Discount, and Volume Discount Pricing described in section 1C of the Template.html file.

56. URL to Online Check Draft image instructions:   
If you don't have #40 set to the full URL to your ssl.pl script, then you can ignore this variable. If you do, then set this to the full URL of an image that may be visually helpful in filling out the Online Check Draft form. Example:
http://www.e-BlackHills.com/merchant-name/checkinfo.gif
If you are accessing your ssl.pl script in "https" mode then it's best to access this image via "https" as well.

57. Auxiliary payment option:   
A sixth payment option. This is related to #23, #24, #24, #40 and #43. If you don't need a sixth payment option, then leave this variable blank. If you do, then type in some text here like so:
Free on the house
lang.html variable #83 will allow you to put some customized text on the receipt page related to this payment option.

58. Suppress custom descriptions:   
You can set this variable to 0, 1, 2 or 3.
  • It is highly recommended to leave this variable set to 0. If you use custom description tags to take custom information from your customers such as size and color of products, that information will be emailed to you in the order and emailed to the customer in their receipt.
  • If you set this variable to 1, then you will not get the custom description details in the email receipts. Your customers will though.
  • If you set this variable to 2, then the custom descriptions will only show in database displays but not on the "Shopping Cart Contents:" page, not on the receipt page and not in the email receipts.
  • If you set this variable to 3, custom descriptions will be displayed in all places as normal. However, custom description info from database displays will not be brought into the cart contents page or email receipts. But customer selected options such as OPTIONS, CHECKBOX, TEXT and QUANTITY will. This enables you to include large amounts of product description in your database displays, without the unnecessary info taking up too much paper when printing out receipts.


59. Add items to top or bottom of cart contents?:   
After clicking on submit buttons in your HTML product forms, the item gets sent to the cart.pl script and appears on the "Your shopping cart contents:" page. You can have the Shopping Cart add your new items to either the top or the bottom of that list. Adding to the top is recommended as the shopper can quickly see their new item in their basket. If you have the cart add the new item to the bottom, they may need to scroll down to see it. You can set this variable to either "top" or "bottom".

60. Shopper ID Prefix:   
Most likely you will want to leave this variable blank. However, if you would like to append something to the beginning of your shopper ID numbers like a letter or two, then set that here. For example if a customer's shopper ID number would be 101, but you set this variable like so:
BBCA
Then the customer's shopper ID number will appear like so: BBCA101

61. Display "Empty Entire Cart" Button:   
If you set this variable to 1 then a button will appear in the main Shopping Cart Contents page that will allow your shoppers to empty their entire cart by clicking one button. lang.dat variables related to this variable are #87, 88 and 89. If you do not wish to allow this option, then leave this variable blank or set to 0.

62. Minimum Order:   
If you set this variable to 100 then the Shopping Cart wont let anyone place an order unless their subtotal is $100 or higher. You can set it to any number you like. If you don't wish to use this feature then leave this variable blank. If you use this feature make sure that lang.html #18 has something like this in it:
To place an order, the subtotal must be a minimum of:


63. Collect Company Name in shipping and billing:   
If you set this variable to 1 the Shopping Cart will collect your customers company name on the shipping and billing address page. If you set it to 0, then a text field that prompts for this info will not appear. Make sure that you have something like this in lang.html #90:
Company Name:
Also, this field can be made to appear but not required. Or appear and be required. See #45 for more details.

64. Auxiliary Real-Time Credit Card Processor Payment Option:   
This is a 7th payment option. Other payment options are #23, #24, #25, #40, #43, 57 and #73.
The Shopping Cart currently works with many different real-time credit card processors as you can see in section 11 of the ReadMe.html. This payment option allows you to have the cart work with more than one real-time credit card processor. How to activate this payment option:
  • Set the URL to the real-time processors processing script in this variable followed by a pipe character then your login ID. For example, if you have service with AT&T then set your merchant ID in this variable like so:
    http://clickatt.att.com|938493
    Or:
    https://secure.hurstlinks.net/~cubecard/checkout.php|YourLoginID
    Or:
    https://www.paypal.com/xclick/|Your@Email.com
  • Be sure you have lang.html #154 set to say whatever you like. Examples:
    AT&T Payment Option
    CubeCard
    PayPal
If you need to set "Success" and "Failure" return URLs in your processors account, set them like so:
Success: http://www.e-BlackHills.com/cgi-bin/cart.pl?aux_processorSSV#6&merchant=MerchantName
Failure: http://www.e-BlackHills.com/cgi-bin/cart.pl?failure&merchant=MerchantName

Change SSV#6 in the above examples to what you have in Server Variables #6 (below).

65. Email Receipt Tables:   
Default: 15|25|4|10|10
This variable allows you to change the way the email receipts look, making them more compact in a table type format. To use this feature, tell the cart program the width you want each column. The columns are respectively:
  • Item name
  • Description of item
  • Quantity
  • Each price
  • Item total
The above settings are recommended for the column widths. You may set a column width to 0 (zero) and it will disable that column in the email receipts. Make sure you have lang.html variables #156 and #157 set in your lang.html file. Customize them as you like. If you do not wish to use this feature, leave this variable blank. If you use a lot of HTML in your lang.html file and your email receipts don't look right, then it's recommended to leave this variable blank.

66. Show shipping weight total on receipt pages:   
If you have the cart calculating shipping by the weight of the items and you have #26 set to 1, then you can also have the cart display the total weight of all the items near the sub total on receipt pages. Just set this variable to 1 to turn it on. If you do not wish to use this feature, leave this variable blank.

69. Sales tax state verification:   
If you set this to "1", it will activate the cart's sales tax state verification. This will do two things:
  • If a shopper selects a different state for their shipping address than they selected for their sales tax location, the cart will prompt them to go back and fix the discrepancy. Make sure you have the latest lang.html file with lang variables #159, 160 and 161.
  • If a shopper selects a state for their shipping address that also appears in Personal Variable #12 (a sales taxable state) and if they did NOT select that they lived in that sales taxable area, the cart will automatically apply the sales tax. No error message will be shown.
It is highly recommended to use this feature in conjunction with Personal Variable #67. If you activate this feature, but don't have #67 activated, then this feature may not work in all cases such as if a shopper misspells their state.

70. Refuse email addresses:   
You can tell the cart to refuse to accept orders with email addresses from domains or domain extensions that pose a security risk to your online business. Such as email addresses from anonymous email accounts or from foreign countries. Example:
.ru,hotmail.com,jack@bigfoot.com
In the above example, the cart wouldn't accept an order from anyone
  • With an email address from Russia (.ru),
  • with an email address from "hotmail.com",
  • and would prevent specifically "jack@bigfoot.com" from ordering.
So you may define just a domain extension, a domain, or a complete email address. Adjust lang.html variables #162 and #163 to best convey the language you would like the cart to use when a shopper attempts to use an email address domain that you have set the cart to refuse.

71. Second Auxiliary Real-Time Credit Card Processor Payment Option:   
This is an 8th payment option. Other payment options are 23, 24, 25, 40, 43, 57 and #61 . The Shopping Cart currently works with many different real-time credit card processors as you can see in section 11 of ReadMe.html. This pament option allows you to have the cart work simultaneously with a third real-time credit card processor. How to activate this payment option:
  • Set the URL to the real-time processors processing script in this variable followed by a pipe character then your login ID. For example:
    https://www.paypal.com/xclick/|Your@Email.com
    Or:
    https://www.SomeProcessor.com/process.cgi|9876543
  • Be sure you have lang.html #165 in your lang.html file. Adjust it to say whatever you like. Examples:
    PayPal
    SomeProcessor.com
If you need to set "Success" and "Failure" return URLs in your processors account, set them like so:
Success: http://www.e-BlackHills.com/cgi-bin/cart.pl?aux_processor2SSV#6&merchant=MerchantName
Failure: http://www.YourName.com/cgi-bin/cart.pl?failure&merchant=MerchantName

Change SSV#6 above to what you have in Server Variables #6 (below).

Secure Server Variables
For More info see ReadMe.html and custom.html

1. URL to ssl.pl or real-time processor:   
Enter here the URL to your real-time credit card processor or the URL to your ssl.pl script. If you are using the ssl.pl script and you would like to have the URL start with "https" you will need to contact your web host about using a security certificate. Example: https://www.BlackHillsSecure.com/cgi-bin/merchant-name/ssl.pl Or
Example: https://cambist.com/cgi-bin/icvtest.pl

2. Your credit card processor username/login ID:   
Place your merchant ID with your real-time credit card processor here. Test ID with Cambist is 0001. Use the test ID until you get your real one. If you are using the ssl.pl script, just ignore this variable.
Currency Exchange Rate Feature:
If you are having the Shopping Cart use a currency other than US Dollars, but need to have it translated to US Dollars before sending the customer to the real-time credit card processor, then set this variable like so:
0001|1.25
The first field to the left of the "|" character will be your merchant ID with your real-time processor like normal. The field on the right of the "|" character will be the exchange rate. The total will be multiplied by the number you place here before the customer is sent to your real-time processor.


3. Font face:   
This variable only works with Cambist or the ssl.pl script. What font face do you want to be used on the secure page. Default: Arial

4. Font color:   
This variable only works with Cambist or the ssl.pl script. What font color do you want to be used on the secure page. Default: #000000

5. Bgrd color:   
This variable only works with Cambist or the ssl.pl script. What background color do you want to be used on the secure page. Default: #FFFFFF

6. Unique, Random ID (1-12 characters, alpha/numeric, no spaces):   
Change this to a string that uses only letters and numbers and NO S P A C E S.
This will create a unique code so the cart.pl script will know when a credit card transaction has occurred. This string could be anywhere from 1 to 12 characters in size. Be creative like "kd93DJE39" or "skDI39fC". Do NOT put one of your passwords in here. This is just random sequence of letters and numbers.

7. Post Transaction Message:   
Your order will be shipped pending credit card approval.
This will be printed at the top of the page immediately after a customer makes a purchase via Secure Online Credit Card Transaction. If you are using a secure server such as Cambist that not only encrypts the numbers, but also transfers funds, you will want to say something like, "Your credit card transaction was successful." If you are using your own security certificate (not a real-time processor), and funds are not transferred immediately, you may want to say something like, "Your order will be shipped pending credit card approval."

8. ssl.pl accepts these card types:   
Default: visa,mastercard,amex,novus
Tell your ssl.pl script which card types to accept and which not to accept. Current card types it can accept are the ones you see listed above. Spell them exactly as you see listed here. The ssl.pl script currently does some error checking to make sure that the credit card number appears valid with the first four card types listed here. However, with the last seven card types, there is no error checking.

10. Credit card numbers are emailed here:   
If you are using the ssl.pl script, this is where you put your email address. When someone orders something via Secure Online Credit Card Transaction, the ssl.pl script can email their credit card number to you. If you leave this variable blank, then the credit card numbers will be emailed to the first email address you have in Personal Variables #2. Need to send copies of the order to more than one address? Just set this variable like so: 
mary@your-email.com, sam@your-email.com
Separated by either commas, spaces or both.

11. Remain in frames while in SSL:   
When the cart.pl script passes the customer to the ssl.pl script or a real-time credit card processor, it will remove all frames if your site is a framed website. This is to effectuate the SSL lock at the top of the browser. If you have a framed website and wish to remain in frames while collecting your customers credit card info, then set this variable to 1. Otherwise set it to 0 or leave it blank.

12. Pending Order Notice:   
If a shopper places an order via Secure Online Credit Card Transaction, the cart will email the order details to the email address(es) that you have set in Personal Variable #2. However, sometimes for some reason or another, the shoppers browser doesn't always make it back to the cart.pl script after their credit card is approved. If you set an email address in this variable then you will receive a copy of what they ordered BEFORE they go to the credit card processor to submit their number. So just in case their browser gets hung up at the real-time processors site, you will still have a copy of the order details. Make sure you have some language like so in the following lang.html variables:
#152 Pending Order Notice
#153 This is a Pending Order Notice. The customer has not submitted their credit card number yet. Wait for order confirmation from the credit card processor.

DataBase Variables
For More info see ReadMe.html and custom.html
1. Optional no-image statement:   
Optional statement to make for items that do not yet have thumb-nail images available for them. If you don't want your pages to say anything, then leave this blank. Default: No Image Available

2. What do you want the order buttons to say:   
What do you want the order buttons to say inside database displays if someone enters with no JavaScript on? Normally the price will be in the button, but if a browser doesn't have JavaScripting on they will just see these words. (ORDER, PURCHASE, BUY NOW, etc...). This also acts as the default button width for Netscape browsers. So put some extra spaces on either side.
Or if you set this variable with a URL to a jpg or gif image, you will see that image used as the submit button.
Default: Add To Cart

3. URL to jpg or gif of a "home" image:   
This is the name or full URL to an image that will show up at the bottom of your flat-file database displays. If you don't specify the full URL, the cart will use Host Variable #2 as the images location. This image will be linked to your "home" page. (Host Variable #1). If you leave this blank, the word "Home" will appear at the bottom of your database displays instead.

4. Items per page:   
This will limit the number of items your database displays will put on a page. If you have 500 computers for sale in one database, it could take 5 minutes for that page to load, right? This will limit it and also provide "jump links" to the rest of the items. 11-20 21-30 31-40 etc. Default: 10

5. Company logo displayed at top of database pages?:   
Want your company logo to show at the top of database display pages? Set this to 1. Don't want it up there? Set this to 0.

6. Align select pull-down menus (left, right or center):   
If you are using any of the Database Options you may determine if they are aligned on the right side of the page, left side or center. Set this variable to one of those three. Default: left

7. Select pull-down menus (across or stack):   
If you are using any of the Database Options and you have more than one option with each item, you may determine if those options are across on the same line, or if they stack on top of each other. Set this to either "across" or "stack".

8. Navigation Bar:   
You may insert some text and HTML along the left side, top or bottom of the pages in database displays. Just put some text and HTML in a file, drop it in your cgi-bin (same directory where your vars.dat file is in) and then put the name of that file in Database Variable #8.

9. Optional return shopping URL:   
After you place an item into the shopping cart from a flat-file database display, if you click the "Continue Shopping" button at the bottom of the cart, it will take you back to the exact page you came from in the database. If you would like to have the shopping cart take you to a different page instead, then specify the URL to that page here. It may be the same as Host Variable #1 if you like. Or you may also use the "return" variable in a search form like so:
<INPUT TYPE=HIDDEN NAME=return VALUE="http://www.e-BlackHills.com/merchant-name/search_form_source.html">


10. Position of Navigation Bar (top, bottom or left):   
You may have your navigation bar in DB #8 (above) appear on the top, bottom or left side of your database displays. You may set this variable to either "top", "bottom" or "left".

11. Show all links to items or just next (all or next):   
If this variable is set to "all" then large database displays will show jump links to many other sets of items at the bottom of the display pages. If you set this to "next" then you will only see two links at the bottom of database display pages that will say "Next 20 Items" and "Previous 20 Items". Setting this to "all" makes it easy to navigate a small to medium size database, but if your database is gigantic then setting this to "next" may prove to be helpful to you.

12. Navigation Bar #2:   
This variable allows you to insert some more text and HTML at the bottom of your database displays. It can work in conjunction with DBV #8 (above). If you have #8 set to start a TABLE you will may need this file to close that TABLE for it to render the database display properly. This navigation2.txt file will always appear at the bottom of the database displays. If you have DBV#10 set so that your first navigation.txt file is displayed bottom, then it will appear right on top of this one.

13. Database Purchase Button Location (top or bottom):   
You can decide if you want the purchase button to appear near the top of the far right column in the database displays, or near the bottom. If you are trying to conserve space and make each row as short as possible, I would recommend setting this to "top". If you have some custom "OPTIONS" in your database, then setting this to "bottom" may work nicer.