Mal's FAQ's are at the bottom of this page below the syntax codes.
These are the syntax for use within Mal's, if anyone knows of any others or can offer a fuller explanation, please email me and I'll add them to this page.
All examples given here are based mainly on singular actions, for that I mean:
form action=http://ww.aitsafe.com/cf/add.cfm and not multiple products using the same form as in:
Where the latter is the case, you will need to add a number after each syntax for example, price would become price1, the first product would be product1, the next product would be product2, price2 and so on. All multiple products must follow the same rule for example, qty becomes qty1 and so on.
For a button add the syntax after the userid in the string, ie &qty=XX
For a form include like this: input type="hidden" name="qty" value="XX"
There are many examples of this in use on the Mal's forms page.
qty The quantity the product is sold in, it could be singular or in multiples (case of six bottles), or you could have a text box for the buyer to enter their own quantity in the case of a form.
noqty The syntax of: 'noqty=1' puts a qty number in the cart, 'noqty=2' puts a checkbox so the item can be removed and 'noqty=3' puts a checkbox and a number. With all of these, you should have a syntax of 'qty=number' to send the value to the cart. A typical button code might be:
See this example
If using a form, then you need to use <input type="hidden" name="noqty" value="2"> or a value of 1 or 3 depending on what you are wanting to be shown in the cart.
price The cost of a product, this is per product, an example is price=9.99 don't forget the rule about multiple products using the same form (see the top of the page).
product The product name or description, for example, product="Peach Cider 1/2 Gal"
return The web page you want to return the buyer to, it may be the same page or the home page of your web site, for example: &return=www.malsforms.com/syntax.html the important thing to remember is to remove any http:// from your return field, only use www.mywebsite.com/nameofpage.html for example.
product If your browser doesn't show them correctly the symbols after product are open and close square brackets [ ]. You would use this where you have options for your product, for example, Pen in green, Pen in red, etc. An example can be seen here. Only one option can be selected and its value passed to the cart, for other variables see productpr below.
productpr This says 'we have variables relating to the product'. There are many examples of this in use on the Mal's forms page. Productpr can send: product:price:units:scode:hash (in that order), units, scode and hash are optional. In other words, you must send at least the product name and its price.
discountpr A discount relating to the product, only of use for one product. Here you would NOT use the price= syntax, instead the pricing for the product is taken from the values you apply here. For example:
I've given a discount on any number after 10, 10 or less you pay 15.00, after that number they are 14.00 discountpr=10,15:0,14 the important thing to remember about this syntax is the values are added for example:
discountpr=2,7.95:3,7.45:5,7.00:10,6.45:0,6.00 means up to two are 7.95 each, the next three are 7.45 (3,4 or 5), then next five are 7.00 (up to 10), then next 10 are 6.45 (up to 20) and any number over 20 are 6.00 each.
nocart Keeps the customer on the page. It doesn't post back the cart contents and it's reported in the forum that it doesn't work with voucher.cfm
A nocart example.
message This can be used to send additional information with the order, Mal's page says it all:
producturl Makes the product name in the cart a clickable link back to the page holding the information for that product. Examples for a link or multiple product forms can be seen here.
hash Link verification, all you need to know is on this page: https://www.mals-e.com/tpv.php?tp=27
pay.cfm This syntax is described fully on https://www.mals-e.com/tpv.php?tp=28 I suspect it may not work with advanced shipping.
currency You can use up to five different currencies in your cart, this is set up under 'Cart setup' / Language, country and currency. A problem with using this syntax is that whatever the first currency is that goes to the cart, all other purchases will be in the same currency.
lg Language, you might have a page in a different language to what the cart default is, in which case you would use lg=number based on:
0 - English (US) / 1 - Spanish / 2 - Portuguese - S American / 3 - Danish / 4 - Norwegian / 5 - Swedish / 6 - Polish / 7 - German / 8 - French / 9 - Indonesian / 10 - Italian / 11 - Dutch / 12 - Turkish / 13 - Croatian / 14 - English (European) / 15 - Afrikaans 16 - Romanian / 17 - Icelandic / 18 - Portuguese - Euro / 19 - Finnish / 20 - Hungarian / 21 - Greek / 22 - Estonian / 23 - Welsh / 24 - Czech / 25 - Albanian / 26 - Slovenian / 27 - English (2Checkout.com compliant) / 28 - Russian / 29 - English (For charities) / 30 - Serbian / 31 - English (Australian)
shipopts This sends information with the cart order back to you about which shipping option the buyer has used, the buyer doesn't see this data.
shipping You can set up your own shipping value for your products by using this syntax. For example shipping="4.99", this is where you have no shipping set up in the cart. The last value entered into the cart will overwrite any written previously. It will not total them.
noship=1 This will override the option to automatically set shipping units to the same as the price for that product.
It doesn't work with Advanced shipping, or with pay.cfm or with discountpr.
units A value that is associated with the cost for shipping as set up in the cart, options 3, 5, and 7 without the 'units=price' box checked, click on 'based on the total sum of the units'.
tax The specific value of tax to be added to a product, most people use the tax section in the cart, but you may have a product that is exempt from tax, in which case the syntax would be tax=0 or, if most of your products are tax free, you might want to use tax=15 when a product is taxable. Any tax value is taken as a percentage.
scode A stock code you would like the cart to store for you.
pcode This is for a premium cart to use for downloadable products, see this page.
sd This passes your own session data to the cart.
voucher.cfm All information regarding vouchers can be found at https://www.mals-e.com/tpv.php?tp=19
Creating Buy Now buttons
Includes, product options, quantity discounts and removing the quantity box
View cart contents
Setup payment methods
Vouchers and coupons
Configuring your cart
Free v Premium