Other ways that you can use RomanCart
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
Basic 'Add to Basket' hyperlink
A great product that you'll really enjoy owning!
The Code for this link is:
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.
Basic 'Add to Basket' form
Another fantastic product that you'll really enjoy owning!
The Code for this button is:
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:
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.
'View Basket' link
You can also add a button or link to view the shopping basket.
The Code for this link is:
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:
Single variation which modifies the price
Each option can be a different price - put the price in {braces}
The Code for this link is:
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:
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:
Personalise an Item e.g. Getting the name to inscribe with
If you need to personalise an item, no problem
The Code for this form is:
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.
The Code for this link is:
Allowing the customer to add several products at once selected by checkboxes.
The Code for this link is:
Allowing the customer to add several products at once selected by checkboxes (Product Manager).
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:
Allowing the customer to add several products at once selected by quantity
The Code for this link is:
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 these buttons is:
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.
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.
Paste the following line just before the </body> tag on your page (changing the storeid value from 10000 to your own).
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...
Total...
Total ex Tax...
Total Tax...
Subtotal...
Alternatively you can use the following scripts (slower).
Quantity...
Total...
Total ex Tax...
Total Tax...
Subtotal...
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
The following fields are for the delivery address (if applicable).
- DTitle
- DFirstName
- DLastName
- DAddress1
- DAddress2
- DTown
- DCounty
- DPostcode
- DCountry
- DState
- dPhone
- DCompanyName
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:
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:
Product manager example with radio buttons
Which product would you like to buy?
The Code for this button is:
Product manager example with multiple groups of radio buttons
Which product would you like to buy?
The Code for this button is:
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.
Sign up to RomanCart NOW and you can try out the above examples on your own cart!
