home

Website Shopping Cart System

  
home how it works demo support mall  
home > How It Works > Integration        

How the RomanCart Shopping Cart Works


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
A great product that you'll really enjoy owning!
Add to Basket
 
The Code for this link is:
<a href=http://www.romancart.com/cart.asp?itemname=A+great+product&storeid=10000&quantity=1&price=5.95>Add to Basket</a>
Top
Shopping cart hyperlink wizard
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 the link below 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 in the box below.
 
Top

Basic 'Add to Basket' form
Another fantastic product that you'll really enjoy owning!
 
The Code for this button is:
<form action=http://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>
Top

Basic 'Add to Basket' form using your own image as a button
Another fantastic product that you'll really enjoy owning!
 
The Code for this button is:
<form action=http://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="mybutton.gif" alt="Add to Basket"> </form>
Top

Fields you can send to the cart
 
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.
 
Top

'View Basket' link.
You can also add a button or link to view the shopping basket.
 
View Basket
 
The Code for this link is:
<a href=http://www.romancart.com/cart.asp?storeid=10000>View Basket</a>
Top

'View Basket' form.
 
The Code for this button is:
<form action=http://www.romancart.com/cart.asp method=post> <input type=hidden name=storeid value='10000'> <input type=submit value='View Basket'> </form>
 
Top

Single variation e.g. Color dropdown
You can add a dropdown box to allow customers to customize the product.
 
A Great Product in:
 
The Code for this link is:
<form action=http://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>
 
Top

Single variation which modifies the price
Each option can be a different price - put the price in {braces}
 
A Great Product in:
 
The Code for this link is:
<form action=http://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>
 
Top

Multiple variations which modify the price
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:
Size:
Pack:
Dimensions:
 
The Code for this link is:
<form action=http://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>
Top

Single variation which modifies the price and weight
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:
 
The Code for this link is:
<form action=http://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>
 
Top

Donation button where customer enters amount to donate
 
Amount to Donate:
 
The Code for this button is:
<form action=http://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>
Top

Personalise an Item e.g. Getting the name to inscribe with
If you need to personalise an item, no problem
 
Personalised NamePlate £9.99
Name Required:
 
The Code for this link is:
<form action=http://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<br> Name Required:<input type=text name=itemname2 value=''><br> <input type=submit value='Add to Basket'> </form>
Top

Main product with accessories e.g. Toy car and batteries
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=http://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> Accessory 1<input type=checkbox name=X1include><br><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> Accessory 2<input type=checkbox name=X2include><br><br> <input type=submit value='Add to Basket'> </form>
Top

Allowing the customer to add several products at once selected by checkboxes.
 
Product 1

Product 2

Product 3

 
The Code for this link is:
<form action=http://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> Product 1<input type=checkbox name=include><br><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> Product 2<input type=checkbox name=X1include><br><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> Product 3<input type=checkbox name=X2include><br><br> <input type=submit value='Add to Basket'> </form>
Top

Allowing the customer to add several products at once selected by quantity.
 
Product 1  

Product 2  

Product 3  

 
The Code for this link is:
<form action=http://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> Product 1&nbsp;&nbsp;<input type=text name=quantity size=4 maxlength=6 value=0><br><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> Product 2&nbsp;&nbsp;<input type=text name=X1quantity size=4 maxlength=6 value=0><br><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> Product 3&nbsp;&nbsp;<input type=text name=X2quantity size=4 maxlength=6 value=0><br><br> <input type=submit value='Add to Basket'> </form>
Top

Setting up quantity discounts
 
 
The Code for this link is:
<form action=http://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>
Top

Setting up quantity discounts across a number of products
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 this link is:
<form action=http://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=http://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>
Top

Allow customers to enter a quantity on your page
Quantity: 
 
The Code for this button is:
<form action=http://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:&nbsp;<input type=text name=quantity value=1><br> <input type=submit value='Add to Basket'> </form>
Top

Allow customers to enter a quantity from a list on your page
Quantity: 
 
The Code for this button is:
<form action=http://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:&nbsp;<select name=quantity><option>1<option>2<option>3<option>4</select><br> <input type=submit value='Add to Basket'> </form>
Top

Use your own graphical buttons for the recalculate, checkout and continue shopping buttons on the cart
Upload some pictures to the web somewhere, and link to them in the basket page sub header or footer.
 
<recalculate>http://www.romancart.com/demo/recalc.gif</recalculate> <checkout>http://www.romancart.com/demo/checkout.gif</checkout> <continue>http://www.romancart.com/demo/continue.gif</continue> <returntobasket>http://www.romancart.com/demo/returntobasket.gif</returntobasket>
 
Top

Show the cart quantity and total on your own website
To show the cart quantity and total on your own website insert the following code onto your webpage.
 
Quantity: <SCRIPT LANGUAGE="JavaScript" SRC="http://www.romancart.com/cartinfo.asp?storeid=10000&type=1"></SCRIPT>
Total: <SCRIPT LANGUAGE="JavaScript" SRC="http://www.romancart.com/cartinfo.asp?storeid=10000&type=2"></SCRIPT>
Total exc Tax: <SCRIPT LANGUAGE="JavaScript" SRC="http://www.romancart.com/cartinfo.asp?storeid=10000&type=3"></SCRIPT>
Total Tax: <SCRIPT LANGUAGE="JavaScript" SRC="http://www.romancart.com/cartinfo.asp?storeid=10000&type=4"></SCRIPT>
Subtotal: <SCRIPT LANGUAGE="JavaScript" SRC="http://www.romancart.com/cartinfo.asp?storeid=10000&type=5"></SCRIPT>
 
Top

Post Customer Details to the Cart
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  
 
Top

Using the Product Manager
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.
 
Top

Product manager example for a simple product
Another fantastic product that you'll really enjoy owning!
 
The Code for this button is:
<form action=http://www.romancart.com/cart.asp method=post> <input type=hidden name=itemcode value='Product1'> <input type=hidden name=storeid value=10000> <input type=submit value='Add to Basket'> </form>
 
Top

Product manager example with modifiers
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:
 
The Code for this link is:
<form action=http://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>
 
Top
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.
Top
 
 
(c) RomanCart Ltd.