Tags, Fields & Tips

ACTION LINKS
Used to review cart contents and also recommended as the link for "checkout" Checkout Used to add single products to the cart http://ww3.aitsafe.com/cf/add.cfm? Used to add multiple products to the cart http://ww3.aitsafe.com/cf/addmulti.cfm? NOTE: Userid beginning with 4 or less use www in links & forms
Mandatory Tags	Optional Tags
userid - Your seven digit account number	return - url if you want to return to your site (default=none)
product - Your product name	lg - A language other than your default language
productpr - Your product name & price (no $ symbol) (Ex. Blue Widget:3.95)	units - a numerical value to use for calculating shipping within the cart (default=0)
price - Price of your product (no $ symbol)	currency - A number if you take multi currency payments. See Mals help files for this option.
return url - Mal calls this an optional tag, but I believe it's mandatory. After all, we do want the customer to continue shopping. (NO http://)	qty = a quantity (default = 1)
	tax = % rate of sales tax for that item (default = 0)
You can use any or all of the above tags in either a link or a form. No spaces are allowed in a URL or query string. Field names are case sensitive; no upper case letters. If you need spaces in your product description use the plus (+) sign as illustrated, and don't forget to add the double quotes ( " )around the link.
A typical link looks like the following:
<a href="http://ww3.aitsafe.com/cf/add.cfm?userid=1234567&product=Little+Red+ Wagon&price=29.95&units=10&qty=1&return=www.yoursite.com/yourpage.htm"</a><a href="http://ww3.aitsafe.com/cf/add.cfm"> </a>

To add an item to the cart using a form, set the following values as Hidden input fields.

(Action link http://ww3.aitsafe.com/cf/add.cfm?)

Like this example:
<input type="hidden" name="userid" value="5234567">
<input type="hidden" name="product" value="Blue Widget">
etc.

Mandatory Tags:

userid = Your User ID
product = Description of your product
price = Price (No $ symbol)
or
productpr = instead of separate product and price fields

Optional Tags:

qty = a quantity (default = 1)
return = www.your_co.com/your_page.htm (default = none)
units = a value for calculating shipping (default = 0)
message = a message (see the messages help file)
lg = a language other than your default
tax = % rate of sales tax for that item (default = 0)

To add multiple items (with a single "Submit" button) to the cart using a form you follow the rules above, but the action link used is:

http://www.aitsafe.com/cf/addmulti.cfm

For each item you post to the cart, you also need to set:

productX = Product description
priceX = Its price
OR
productprX = Combined Product:Price:Units
and
qtyX = Its qty

Optional :
unitsX = A value such as its weight for calculating shipping
taxX = % rate of sales tax for that item (default = 0)

Where X is 1 for the first product, 2 for the second product, etc. up to a maximum of 30 products in each form. You can have as many forms as you want.

Some additional Tips!!

<input type=hidden name=return value="www.yoursite.com/your_page.htm">
vs:
<input type="hidden" name="return" value="www.yoursite.com/your_page.htm">

Notice the quotes around the values hidden & return in the second example. For some reason, some servers will not recognize the values without quotes to separate them from the fields. A space does not always work which leads me to believe your site is hosted on a Unix server. The cart (Mals server) seems to recognize spaces as a delimiter, but some Unix servers most often don't.
It seems to be good practice to enclose all values in quotes. At least I've found it so.

qty - Default=1 (If a text input box is used for quantity and no quantity is entered into the box, that item will not be passed to the cart. [Default=1 does not apply in this case]).

FRONT PAGE WYSIWYG

With Front Page, you should be able to copy a form or link (from within a table or cell) and then paste it in page view. Usually it does ok, but sometimes it forgets the hidden fields. Always check the html 'cause sometimes FP thinks it knows what you want to do better than you. If you're bald; you're in trouble. You don't have anything to pull out! The reverse isn't always true though. I recommend if you delete anything from the form in page view make sure you check the html to be sure the hidden fields were deleted also. Most times they ain't, and they have a tendency to pile up at the top or bottom of the page in html view. Two years later you're going to wonder what all that extra code is and where did it come from. If some of the product numbers happen to be the same as the product number you're adding, and those numbers happen to be in stray hidden fields at the bottom of the page....Guess what! That's the info that's going to go to the cart 'cause the browser reads the html from the top to bottom and picks up the last incidence of the number. To "get around" this little problem, try to keep everything in tables or cells. Then you can select the cell with the info you want to delete, delete the cell and everything within it including the "hidden" fields goes to html heaven.

If you copy the code below (page view) and then paste it in html view, you will wind up with the same thing on the page. The reason being that html editors usually change things here & there for display purposes. You will need to do a search & replace for the little thingies I mention at the bottom of this paragraph in order to have it show up as a working form. Then switch to page view, do your formatting, add your products & descriptions, then switch back to html view to finish the hidden fields and values and double check for code errors such as spaces where there shouldn't be spaces, & q u o t ; instead of ", & l t ; instead of <, & g t ; instead of >, and (important) an </form> tag.. Or avoid the problem altogether by copying the source you want from the source view and then paste in html view.
I hope this seems clearer to you than it does to me.

<select size="1" name="productpr">
<option value="2 inch Candle:2.98:200">2 inch Candle:$2.98</option>
<option value="4 inch Candle:4.98">4 inch Candle $4.98</option>
<option value="6 inch Candle:6.98">6 inch Candle $6.98</option>
<option value="8 inch Candle:8.98">8 inch Candle $8.98</option>
<option value="10 inch Candle:10.98">10 inch Candle $10.98</option>
</select>

</form>

(to be continued