'Add to Basket' Examples

Adding the RomanCart shopping cart to your website can be as simple as pasting in a hyperlink, or you might prefer using a form and a button. Listed below are some examples of what the cart can do, and how to do it.

• Basic 'Add to Basket' hyperlink
• Basic 'Add to Basket' form
• Basic 'Add to Basket' form using your own image as a button
• Shopping cart hyperlink wizard
• Fields you can send to the shopping cart
• View basket link
• View basket form
• Single variation e.g. Color dropdown
• Single variation which modifies the price
• Multiple variations which modify the price
• Single variation which modifies the price and weight
• Donation button where customer enters amount to donate
• Personalise an item e.g. Getting the name to inscribe with
• Main product with accessories, e.g. Toy car and batteries
• Allowing the customer to add several products at once selected by checkboxes
• Allowing the customer to add several products at once selected by checkboxes (Product Manager)
• Allowing the customer to add several products at once selected by quantity
• Setting up quantity discounts
• Setting up quantity discounts across a number of products
• Allow customers to enter a quantity on your page
• Allow customers to enter a quantity from a list on your page
• Use your own graphical buttons for the 'recalculate', 'checkout', 'return to basket' and 'continue shopping buttons on the cart
• Show the cart quantity and total on your own website
• Post customer details to the cart
• Using the Product Manager
• Product manager example for a simple product
• Product manager example with modifiers
• Product manager example with radio buttons
• Product manager example with multiple groups of radio buttons

A great product that you'll really enjoy owning!

Add to Basket

The Code for this link is:
<a href='https://www.romancart.com/cart.asp?itemname=A+great+product&storeid=10000&quantity=1&price=5.95'>Add to Basket</a>

Let's make it even easier. Enter the name and Price of your Product below, and you can paste the link code directly into your Website.

Your Store Id
The name of the item you are selling
The price of the item (excluding any currency symbols)
You can paste this link directly into the code of your web page for an 'Add to Basket' link...
Test the link	Add to Basket
If you are using a web design tool with some sort of 'Insert Hyperlink' function, the URL to insert is...

Another fantastic product that you'll really enjoy owning!

 
The Code for this button is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Another Fantastic Product'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=submit value='Add to Basket'> </form>

Another fantastic product that you'll really enjoy owning!

 
The Code for this button is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Another Fantastic Product'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=image src="tabimages/mybutton.gif" alt="Add to Basket"> </form>

• storeid - The most important field, as this identifies your store.
• itemcode - The code of a product in the product manager (This avoids having to post itemname parameters).
• itemname - The name of the item. This must be unique.
• itemname2 - Additional Item Name Variation - if required.
• itemname3..10 - You can post itemname,itemname2 up to itemname10 - see below for details. The total concatonated itemname must not exceed 1000 characters.
• price - The price of the item (Excluding any currency symbols).
• quantity - The quantity to add to the basket.
• tax - The tax rate for this product (optional - not for use with advanced tax)(Percent but don't include the % sign).
• shipping1 - The shipping1 cost for this product (optional - set up on control panel)(Excluding any currency symbols).
• shippingsecond1 - Used with basic shipping method for shipping cost of second product (optional).
• shippingothers1 - Used with basic shipping method for shipping cost of products other than the first product (or the second product if using shippingsecond1) (optional).
• shippinggroup - Used with basic shipping method to group together products for a mixed stepped group. (optional). Add '-priority' after the group name e.g. mygroup-priority to make sure a specific product in the group is always processed first to calculate shipping.
• maxShipping1 - The maximum shipping1 cost for this product (optional - only for 'Basic' shipping method)(Excluding any currency symbols).
• weight - The weight of the product for use with weight based shipping (assumed to be zero if not posted).
• returnurl - Continue Shopping URL - Overrides Admin Setting for multiple websites using one cart.
• maxquantity - Maximum quantity of this product which is available for purchase.
• minquantity - Minimum quantity of this product which is available for purchase.
• activeproducttoken - If you are using a Active Products this value will be posted to the relevant url when an order is paid.
• displayCart - displaycart=no will cause the cart to jump straight to the continue shopping page.
• tangible - tangible=no will inform the cart that there is nothing to ship (not required for downloadable or password products). tangible=yes when sent to the cart with a downloadable or password product causes shipping to apply to the product (e.g. if the product is a downloadable software item with manual which is physically shipped.)
• taxband - The taxband parameter is used by the advanced tax functionality. Valid values are A-F. (If not posted, Default is A)
• threshold1..5 - For quantity discounts post the thresholds using threshold1 to threshold5.
• thresholdprice1..5 - For quantity discounts post the threshold prices using thresholdprice1 to thresholdprice5.
• mustbuy - When posting multiple items set mustbuy=no if the customer does not have to purchase the main product.
• fixedquantity - fixedquantity=yes will prevent the user from changing the quantity on the cart for that product.
• qdgroup - The name of a mixed quantity discount group e.g. mygroup1.
• clearbasket - clearbasket=yes will clear the basket before adding the posted products.
• getimage - getimage=yes will prompt the customer for an image to associate with the product. e.g. for a t-shirt printed with the customers image. (Requires Upgrade)
• dependentmaster - dependentmaster=yes when posted with multiple products causes all products added to the cart at the same time as the master product to be removed if the master product is removed.
• dependentsub - dependentsub=yes when posted with multiple products causes only that product to become a dependent product of the first product added to the cart from that group at the same time.
• passthru - The passthru parameter is passed through the cart unchanged and can be used in sales tracking scripts configured in RomanCart.

You can also add a button or link to view the shopping basket.

View Basket

The Code for this link is:
<a href=https://www.romancart.com/cart.asp?storeid=10000>View Basket</a>

You can add a dropdown box to allow customers to customize the product.

A Great Product in: Green Blue Orange

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=price value=1.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=itemname value='A Great Product'> A Great Product in: <select name=itemname2> <option value="Green">Green</option> <option value="Blue">Blue</option> <option value="Orange">Orange</option> </select> <input type=submit value='Add to Basket'> </form>

Each option can be a different price - put the price in {braces}

A Great Product in: Please Select Green - £1.99 Blue - £2.99 Orange - £3.99

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> A Great Product in: <select name=itemname> <option value="Please Select {exclude}">Please Select</option> <option value="A Great Product (Green) {1.99}">Green - £1.99</option> <option value="A Great Product (Blue) {2.99}">Blue - £2.99</option> <option value="A Great Product (Orange) {3.99}">Orange - £3.99</option> </select> <input type=submit value='Add to Basket'> </form>

If you have lots of options, this is not a problem, you can post itemname, itemname2, up to itemname10.
In this example, we have also added prices to the options, but this is optional.

A Great Product (£1.99) in:	Green (+£1.00) Blue (+£1.00) Orange (+£1.00)
Size:	Large (+£1.00) Small (+£2.00) Medium (+£3.00)
Pack:	Pack 1 (+£5.00) Pack 2 (+£6.00) Pack 3 (+£7.00)
Dimensions:	6x4 (+£4.00) 8x2 (+£5.00) 16x6 (+£6.00)

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=price value=1.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=itemname value='A Great Product'> A Great Product (£1.99) in: <select name=itemname2> <option value="Green {1.00}">Green (+£1.00)</option> <option value="Blue {1.00}">Blue (+£1.00)</option> <option value="Orange {1.00}">Orange (+£1.00)</option> </select><br> Size: <select name=itemname3> <option value="Large {1.00}">Large (+£1.00)</option> <option value="Small {2.00}">Small (+£2.00)</option> <option value="Medium {3.00}">Medium (+£3.00)</option> </select><br> Pack: <select name=itemname4> <option value="Pack 1 {5.00}">Pack 1 (+£5.00)</option> <option value="Pack 2 {6.00}">Pack 2 (+£6.00)</option> <option value="Pack 3 {7.00}">Pack 3 (+£7.00)</option> </select><br> Dimensions: <select name=itemname5> <option value="6x4 {4.00}">6x4 (+£4.00)</option> <option value="8x2 {5.00}">8x2 (+£5.00)</option> <option value="16x6 {6.00}">16x6 (+£6.00)</option> </select><br> <input type=submit value='Add to Basket'> </form>

Each option can be a different price - put the price in {braces}

And a different weight - add the weight after W in the braces

A Great Product in: Green - £1.99 10g Blue - £2.99 20g Orange - £3.99 30g

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> A Great Product in: <select name=itemname> <option value="A Great Product (Green) {1.99W10}">Green - £1.99 10g</option> <option value="A Great Product (Blue) {2.99W20}">Blue - £2.99 20g</option> <option value="A Great Product (Orange) {3.99W30}">Orange - £3.99 30g</option> </select> <input type=submit value='Add to Basket'> </form>

Amount to Donate:

 
The Code for this button is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Donation'> Amount to Donate: <input type=text name=price value='' size=6> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=submit value='Donate'> </form>

If you need to personalise an item, no problem

Personalised NamePlate £9.99 Name Required:

 
The Code for this form is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=price value=9.99> <input type=hidden name=itemname value='A Personalised NamePlate'> Personalised NamePlate £9.99 Name Required: <input type=text name=itemname2 value=''> <input type=submit value='Add to Basket'> </form>

You can also have accessory products by prefixing the accessory fieldnames with Xn where n is a number between 1 and 100. The 'dependentmaster' parameter means that if the main product is removed from the cart the accessory products will also be removed.

 Main Product
Accessory 1
Accessory 2

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Main Product'> <input type=hidden name=dependentmaster value=yes> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=shipping1 value=4.00> <input type=hidden name=shipping2 value=5.00> Main Product<br><br> <input type=hidden name=X1itemname value='Accessory 1'> <input type=hidden name=X1price value=9.99> <input type=hidden name=X1storeid value=10000> <input type=hidden name=X1quantity value=1> <input type=hidden name=X1shipping1 value=4.00> <input type=hidden name=X1shipping2 value=5.00> <input type=checkbox name=X1include> Accessory 1<br> <input type=hidden name=X2itemname value='Accessory 2'> <input type=hidden name=X2price value=9.99> <input type=hidden name=X2storeid value=10000> <input type=hidden name=X2quantity value=1> <input type=hidden name=X2shipping1 value=4.00> <input type=hidden name=X2shipping2 value=5.00> <input type=checkbox name=X2include> Accessory 2<br><br> <input type=submit value='Add to Basket'> </form>

Product 1
Product 2
Product 3

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Product 1'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=shipping1 value=4.00> <input type=hidden name=shipping2 value=5.00> <input type=hidden name=mustbuy value=no> <input type=checkbox name=include> Product 1<br> <input type=hidden name=X1itemname value='Product 2'> <input type=hidden name=X1price value=9.99> <input type=hidden name=X1storeid value=10000> <input type=hidden name=X1quantity value=1> <input type=hidden name=X1shipping1 value=4.00> <input type=hidden name=X1shipping2 value=5.00> <input type=checkbox name=X1include> Product 2<br> <input type=hidden name=X2itemname value='Product 3'> <input type=hidden name=X2price value=9.99> <input type=hidden name=X2storeid value=10000> <input type=hidden name=X2quantity value=1> <input type=hidden name=X2shipping1 value=4.00> <input type=hidden name=X2shipping2 value=5.00> <input type=checkbox name=X2include> Product 3<br><br> <input type=submit value='Add to Basket'> </form>

 
Set the products required for this on the product manager to mustbuy=no
Change the itemcodes and storeid to your own
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemcode value='Product1'> <input type=hidden name=storeid value=10000> <input type=checkbox name=include> Product 1<br> <input type=hidden name=X1itemcode value='Product2'> <input type=hidden name=X1storeid value=10000> <input type=checkbox name=X1include> Product 2<br> <input type=hidden name=X2itemcode value='Product3'> <input type=hidden name=X2storeid value=10000> <input type=checkbox name=X2include> Product 3<br> <input type=submit value='Add to Basket'> </form>

Product 1
Product 2
Product 3

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Product 1'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> <input type=hidden name=shipping1 value=4.00> <input type=hidden name=shipping2 value=5.00> <input type=hidden name=mustbuy value=no> <input type=hidden name=include value=on> <input type=text name=quantity size=4 maxlength=6 value=0> Product 1<br> <input type=hidden name=X1itemname value='Product 2'> <input type=hidden name=X1price value=9.99> <input type=hidden name=X1storeid value=10000> <input type=hidden name=X1shipping1 value=4.00> <input type=hidden name=X1shipping2 value=5.00> <input type=hidden name=X1include value=on> <input type=text name=X1quantity size=4 maxlength=6 value=0> Product 2<br> <input type=hidden name=X2itemname value='Product 3'> <input type=hidden name=X2price value=9.99> <input type=hidden name=X2storeid value=10000> <input type=hidden name=X2shipping1 value=4.00> <input type=hidden name=X2shipping2 value=5.00> <input type=hidden name=X2include value=on> <input type=text name=X2quantity size=4 maxlength=6 value=0> Product 3<br><br> <input type=submit value='Add to Basket'> </form>

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Quantity Discount Product'> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=threshold1 value=1> <input type=hidden name=thresholdprice1 value=19.99> <input type=hidden name=threshold2 value=10> <input type=hidden name=thresholdprice2 value=19.50> <input type=hidden name=threshold3 value=50> <input type=hidden name=thresholdprice3 value=19.00> <input type=hidden name=threshold4 value=100> <input type=hidden name=thresholdprice4 value=18.00> <input type=hidden name=threshold5 value=500> <input type=hidden name=thresholdprice5 value=15.00> <input type=submit value='Add to Basket'> </form>

Submit products with mixed quantity discounts using the qdgroup parameter.
The total quantity of both products provides the threshold for the discount price.

 
The Code for these buttons is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Quantity Discount Product 1'> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=threshold1 value=1> <input type=hidden name=thresholdprice1 value=1> <input type=hidden name=threshold2 value=10> <input type=hidden name=thresholdprice2 value=2> <input type=hidden name=threshold3 value=50> <input type=hidden name=thresholdprice3 value=3> <input type=hidden name=threshold4 value=100> <input type=hidden name=thresholdprice4 value=4> <input type=hidden name=threshold5 value=500> <input type=hidden name=thresholdprice5 value=5> <input type=hidden name=qdgroup value='mygroup1'> <input type=submit value='Add to Basket'> </form> <form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='Quantity Discount Product 2'> <input type=hidden name=storeid value=10000> <input type=hidden name=quantity value=1> <input type=hidden name=threshold1 value=1> <input type=hidden name=thresholdprice1 value=10> <input type=hidden name=threshold2 value=10> <input type=hidden name=thresholdprice2 value=15> <input type=hidden name=threshold3 value=50> <input type=hidden name=thresholdprice3 value=20> <input type=hidden name=threshold4 value=100> <input type=hidden name=thresholdprice4 value=25> <input type=hidden name=threshold5 value=500> <input type=hidden name=thresholdprice5 value=30> <input type=hidden name=qdgroup value='mygroup1'> <input type=submit value='Add to Basket'> </form>

Quantity:

 
The Code for this button is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='A great demo product'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> Quantity: <input type=text name=quantity value=1><br> <input type=submit value='Add to Basket'> </form>

Quantity: 123

 
The Code for this button is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=itemname value='A great demo product'> <input type=hidden name=price value=9.99> <input type=hidden name=storeid value=10000> Quantity: <select name=quantity><option value='1'>1</option><option value='2'>2</option><option value='3'>3</option></select><br> <input type=submit value='Add to Basket'>

Upload some pictures to the web somewhere, and link to them in the basket page sub header or footer.

<recalculate>https://www.romancart.com/demo/recalc.gif</recalculate> <checkout>https://www.romancart.com/demo/checkout.gif</checkout> <continue>https://www.romancart.com/demo/continue.gif</continue> <returntobasket>https://www.romancart.com/demo/returntobasket.gif</returntobasket>

To show the cart quantity and total on your own website insert the following code onto your webpage.

Paste the following line just before the </body> tag on your page (changing the storeid value from 10000 to your own).
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/ROC_info.asp?storeid=10000"></SCRIPT>

Next paste the following lines where you want the actual values to appear.
These return the value and currency symbol. You can use one, some or all of these.

Quantity...
<span id='ROC_infoquantity'></span>

Total...
<span id='ROC_infototal'></span>

Total ex Tax...
<span id='ROC_infototalextax'></span>

Total Tax...
<span id='ROC_infototaltax'></span>

Subtotal...
<span id='ROC_infosubtotal'></span>

Alternatively you can use the following scripts (slower).

Quantity...
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/cartinfo.asp?storeid=10000&type=1"></SCRIPT>

Total...
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/cartinfo.asp?storeid=10000&type=2"></SCRIPT>

Total ex Tax...
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/cartinfo.asp?storeid=10000&type=3"></SCRIPT>

Total Tax...
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/cartinfo.asp?storeid=10000&type=4"></SCRIPT>

Subtotal...
<SCRIPT LANGUAGE="JavaScript" SRC="https://www.romancart.com/cartinfo.asp?storeid=10000&type=5"></SCRIPT>

To post customer details to the cart you can use the following fields. Always make sure the Address1 field is populated.

• CompanyName
• Title
• Firstname
• Lastname
• Address1
• Address2
• Town
• County
• Postcode
• Country
• State
• Phone
• Email

 
The following fields are for the delivery address (if applicable).

• DTitle
• DFirstName
• DLastName
• DAddress1
• DAddress2
• DTown
• DCounty
• DPostcode
• DCountry
• DState
• dPhone
• DCompanyName

If you would prefer not to store your product details and prices on your web pages you can use the product manager.

Click on the 'Product Manager' button on the Romancart control panel and preload the cart with the details of each product.

If a product has several options, you will need to create modifier groups. An example modifier group might be 'Size' - with 'Small', 'Medium' and 'Large' as the modifiers.

Once you have added a product to the product manager, you only need to post the itemcode and storeid parameters for each product to the cart. If you are using modifiers then you will need to also post the itemnameX parameter as shown on the product manager for the modifier group.

Each option can be a different price - set the price and weight modifications on the product manager for each modifier value

A Great Product in: Small Medium Large

 
The Code for this link is:
<form action=https://www.romancart.com/cart.asp method=post> <input type=hidden name=storeid value=10000> <input type=hidden name=itemcode value='Product2'> A Great Product in: <select name=itemname2> <option value="Small">Small</option> <option value="Medium">Medium</option> <option value="Large">Large</option> </select> <input type=submit value='Add to Basket'> </form>

Which product would you like to buy?

Product A:
Product B:
Product C:

 
The Code for this button is:
Which product would you like to buy?<br> <form action=https://www.romancart.com/cart.asp method=post> Product A: <input type=radio name=itemcode value='producta' checked><br> Product B: <input type=radio name=itemcode value='productb'><br> Product C: <input type=radio name=itemcode value='productc'><br><br> <input type=hidden name=storeid value=10000> <input type=submit value='Add to Basket'> </form>

Which product would you like to buy?

None:
Product A:
Product B:
Product C:

None:
Product D:
Product E:
Product F:

 
The Code for this button is:
Which product would you like to buy?<br> <form action=https://www.romancart.com/cart.asp method=post> None: <input type=radio name=itemcode value='roc_ignore' checked><br> Product A: <input type=radio name=itemcode value='producta'><br> Product B: <input type=radio name=itemcode value='productb'><br> Product C: <input type=radio name=itemcode value='productc'><br><br> None: <input type=radio name=X1itemcode value='roc_ignore' checked><br> Product D: <input type=radio name=X1itemcode value='productd'><br> Product E: <input type=radio name=X1itemcode value='producte'><br> Product F: <input type=radio name=X1itemcode value='productf'><br><br> <input type=hidden name=storeid value=10000> <input type=hidden name=X1storeid value=10000> <input type=hidden name=X1include value=on> <input type=submit value='Add to Basket'> </form>

Important: Test the 'Add to Basket' buttons or links you have created once you have uploaded your page(s) to the Internet, not when the page is stored on your PC.

Click here to get started

Sign up to RomanCart NOW and you can try out the above examples on your own cart!