	Website Shopping Cart System

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
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
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 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

Basic 'Add to Basket' hyperlink

A great product that you'll really enjoy owning!

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>

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.

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>

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>

Fields you can send to the cart

The most important field, as this identifies your store.

The code of a product in the product manager (This avoids having to post itemname parameters).

The name of the item. This must be unique.

Additional Item Name Variation - if required.

You can post itemname,itemname2 up to itemname10 - see below for details. The total concatonated itemname must not exceed 1000 characters.

The price of the item (Excluding any currency symbols).

The quantity to add to the basket.

The tax rate for this product (optional - not for use with advanced tax)(Percent but don't include the % sign).

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).

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.

The maximum shipping1 cost for this product (optional - only for 'Basic' shipping method)(Excluding any currency symbols).

The weight of the product for use with weight based shipping (assumed to be zero if not posted).

Continue Shopping URL - Overrides Admin Setting for multiple websites using one cart.

Maximum quantity of this product which is available for purchase.

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=no will cause the cart to jump straight to the continue shopping page.

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.)

The taxband parameter is used by the advanced tax functionality. Valid values are A-F. (If not posted, Default is A)

For quantity discounts post the thresholds using threshold1 to threshold5.

thresholdprice1..5

For quantity discounts post the threshold prices using thresholdprice1 to thresholdprice5.

When posting multiple items set mustbuy=no if the customer does not have to purchase the main product.

fixedquantity=yes will prevent the user from changing the quantity on the cart for that product.

The name of a mixed quantity discount group e.g. mygroup1.

clearbasket=yes will clear the basket before adding the posted products.

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)

The passthru parameter is passed through the cart unchanged and can be used in sales tracking scripts configured in RomanCart.

'View Basket' link.

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

The Code for this link is:

<a href=http://www.romancart.com/cart.asp?storeid=10000>View Basket</a>

'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>

Single variation e.g. Color dropdown

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

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>

Single variation which modifies the price

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

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>

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.

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>

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

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>

Personalise an Item e.g. Getting the name to inscribe with

If you need to personalise an item, no problem

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>

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 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=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>

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

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>

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

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  <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  <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  <input type=text name=X2quantity size=4 maxlength=6 value=0><br><br> <input type=submit value='Add to Basket'> </form>

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>

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>

Allow customers to enter a quantity on your page

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: <input type=text name=quantity value=1><br> <input type=submit value='Add to Basket'> </form>

Allow customers to enter a quantity from a list on your page

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: <select name=quantity><option>1<option>2<option>3<option>4</select><br> <input type=submit value='Add to Basket'> </form>

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>

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>

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.

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

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.

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>

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

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>

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.

(c) Roman Interactive Ltd.