Shopping cart layout

Description

This layout controls the look and content of the Shopping Cart.

Accessible from

The Shopping Cart is the panel customer sees after clicking the "View Cart" link outputted by the module {module_shoppingcartsummary} or after they click a product's "Buy now" button (this is outputted by the {tag_buynow} tag used in a product's Individual Product - Small or Individual Product - Large layouts.)

In the "Develop" section of the site or if you connect via sFTP you can find this layout at this path - /Layouts/OnlineShop/shopping_cart-XX

Replace "XX" with the country code you have added in the Site Settings > Site Domains panel (see the "Country" column).

If you have multiple domains with different "Country" values you will find multiple quote-receipt-XX files, one for each country. This way, with one layout for every country defined you can vary the contents of the layout to accomodate a multilingual website.

Note: Some of the Liquid tags will need to be looped through as they represent a carts' item property. Please check How-To Build a Liquid Powered Shopping Cart Layout for implementation details.

Renders these tags

Liquid tag Legacy tag Description
{tag_buybutton,Text or Image,true}Link to checkout and purchase products in cart (Text or Image allow you to render your own text or to use image instead). True is validation function that checks to make sure every order has a valid shipping charge before the customer is able to pay and finalize the order.
{{buyUrl}}

The URL for the Buy button

To ensure server side validation of shipping options please add &VS=True
<a href="{{burUrl}}&VS=True">Checkout</a>

{{buyButtonOnClick}} The javascript event to be assigned to the Buy button
{tag_cataloguebreadcrumbs}Catalogue breadcrumbs help customers easily navigate between related catalogues
{tag_clearcartbutton,imagepath}Link to clear the cart (add an 'imagepath' to use image instead)
{{clearCartOnClick}} The javascript event to be assigned to the clear cart button
{{items.custom1}} {tag_custom1}Custom field #1. Use to display any information about a product
{{items.custom2}} {tag_custom2}Custom field #2. Use to display any information about a product
{{items.custom3}} {tag_custom3}Custom field #3. Use to display any information about a product
{{items.custom4}} {tag_custom4}Custom field #4. Use to display any information about a product
  {tag_discountcode}

An input box for customers to enter discount code in.

{{discountCode}} - Can be used to ouput the discount code's name after it was applied to the cart.

{{quoteUrl}} Link to checkout and request a quote.
{tag_getquotebutton}Link to checkout and request a quote (customize to use image instead)
{{giftVoucher}} {tag_giftvoucher}An input box for customer to enter gift voucher code in
{{giftVoucherAmount}} {tag_giftvoucheramount}Total amount of credit applied to this order as a result of a gift voucher
{{giftVoucherOnChange}} The javascript event applied to the gift voucher controls
{{invoiceDiscountAmount}} {tag_invoicediscountamount}Total discount amount based on the discount code entered (shipping price isnotdiscounted)
{{invoiceTotal}} {tag_invoicetotal} Total cost of the current cart (factoring in all cost and discounts)
{{invoiceTotalExceptTaxAmount}} {tag_invoicetotalextaxamount}Invoice total amount excluding tax (e.g. products ex tax + shipping ex tax)
{tag_invoicetotaltaxamount,state,state special tax rate,regular tax rate name,special tax rate name}Invoice total amount of tax (e.g. products tax + shipping tax). The additional parameters allow a user to configure the system to break out part of the tax for a specific state into two parts. This is useful in some countries where by law you are required to show GST or similar tax on a separate line, for example:
  • Tax code BC is configured as 12% (the sum of 7% PST and 5% GST)
  • Our tag is configured like this: {tag_invoicetotaltaxamount,BC,5,PST,GST}
  • $100 order for BC would render the tax like this: PST: $7
    GST: $5
{{productTaxPercentage}} {tag_producttaxpercentage,percentage}To use this tag, you should enter in the prices of all your products inclusive of tax. To show how much of the product price will be paid as a sales tax, use {tag_producttaxpercentage, 12.5} tag where 12.5 is the percentage of tax to be paid.
{{totalTaxPercentage}} {tag_totaltaxpercentage,percentage}To use this tag, you should enter in the prices of all your products inclusive of tax. To show how much of the total price will be paid as a sales tax , use {tag_producttaxpercentage, 12.5} tag where 12.5 is the percentage of tax to be paid.
{{orderId}} {tag_orderid}Order ID normally assigned to quotes. You can also use this value to search for the order in the Admin console's CRM > Search panel
{{code}} {tag_productcode, syncWithAttributes, noSelectionMessage, disabledSelectionMessage} Product code. With variations enabled, tg product will render the variation code instead of the product codes in all layouts where this is used.

Parameters:

  • syncWithAttributes – true or false
  • noSelectionMessage – specify the message displayed when site customer has not selected a variation
  • disabledSelectionMessage – specify the message displayed when site customer has selected a variation that is disabled
{tag_productdescription}Product description captured from the 'Instructions' box or 'Product Attributes'
{{body}} {tag_producteditorcontent}Product description as it appears in the WYSIWYG editor
{tag_productextaxamount}Price of each product excluding tax in the cart
{{productGrandTotal}} {tag_productgrandtotal}Total price of all products including tax in the cart
{tag_productimage}Small image of the product
{{imagePath}} The path of the product's image
{{productAmountIncludingTax}} {tag_productinctaxamount}Price of each product including tax in the cart
{{name}} {tag_productname}List of product names in the cart
{tag_productname_nolink}Product name already in the cart without a link back to the product
{{quantity}} {tag_productquantity}Number of units of each product in the cart
{tag_productremovelink}Link to remove product from the cart
{{removeOnClick}} The event to be associated with the remove product button
{{productSubTotal}} {tag_productsubtotal}Total price of all products excluding tax in the cart
{{productTaxAmount}} {tag_producttaxamount}Amount of tax for each product in the cart
{{productTaxRate}} {tag_producttaxrate}Tax rate associated with each product in the cart
{{productTaxTotal}} {tag_producttaxtotal}Total tax amount for all products in the cart
{{productTotal}} {tag_producttotal}Total price of each product in the cart (e.g. units x unit price inc tax)
{{productTotalExceptTax}} {tag_producttotalextax}Total amount for product excluding tax (Product x Quantity)
{tag_shippingextaxamount}Price of shipping option chosen excluding tax
{tag_shippingoptions} List of shipping options. The full syntax is {tag_shippingoptions, true, OnlyChargeCountryUsers, ShipToSingleCountry, ApplyTaxToShipping, ApplyTaxToGiftVouchers}

Take a look at the Displaying shipping options article for more details on each parameter.

{{shippingTaxAmount}} {tag_shippingtaxamount}Amount of tax associated with the shipping option chosen
{{shippingTaxRate}} {tag_shippingtaxrate}Tax rate associated with the shipping option chosen
{{shippingTotal}} {tag_shippingtotal}Total cost of the shipping option chosen (e.g. shipping ex tax + shipping tax)
{{totalUnits}} {tag_totalunits}Total product units in the cart