This article has moved to a new home. View the updated version Base Tag Library


Generates a list of items in the cart as well as extra data around cart totals


    [%param *header%]
        <h4>Cart Items</h4>
    [%param *body%]
        <p><img src="[@thumb@]"/> [@qty@] x [@model@] x [@price@]</p>
    [%param *footer%]


The cart_items tag generates a list of all the items in your cart and includes data tags that along side a form will let you give your users the ability to edit the cart items.

This tag only updates on page load and as such won't reflect any ajax add to cart functions in a page until a refresh is forced.

Cart_items also extends to supporting tags regarding totals for the cart order and some discounts.

cart_items Parameters

Name Options Description
limit:'' Integer Limit the results
template:'' Name of the template without the .template.html Loads the template specified. If there is no value, it will load the default product template
header HTML & b@se tags Renders a single usable space above the body
body* HTML & b@se tags Runs an array for result
footer HTML & b@se tags Renders a single usable space below the body
ifempty:'' HTML & b@se tags If the random_products returns no results, it'll load this block instead

cart_items Data Tags

Name Description
[@model@] The name of the product
[@extra@] Any basic product extras
[@acc_code@] Accounting Code
[@actual_height@], [@actual_length@], [@actual_width@] The assembled dimensions for the SKU. Prints as meters by default
[@arrival_date@] Arrival date of SKU, recommended to use format tag
[@availability_description@] Availability Description for the SKU, typically used to explain when product will become available.
[@base_unit_qty@] Unit quantity description
[@brand@] Product brand, can be used with brand tag to load further information.
[@count@] Counts for every time the body param is run as a whole number integer
[@discount@] Discount Name
[@discount_total@] Total order discount
[@gifts_available@] Will print a 1 if there are free gifts available for the SKU
[@inventory_id@] A unique ID assigned to the item, typically for internal use
[@itm_sortorder@], [@itm_sortorder2@] Sort order integer, used to determine the sort order of the item depending on the thumblist sortby options
[@manufacturer_model@] The model no. / Sku provided by the manufacturer
[@misc#@] Where # indicates the misc number, this prints the misc field specified
[@model@],[@name@] The item name
[@notax@] A boolean that when true indicates it is tax free
[@preorder@] A boolean that when true indicates that the item meets the conditions to be available for preorder
[@price@] Item price based on users group ID
[@parent_name@] If the item is a child item, print the parent item name
[@parent_sku@] If the item is a child item, print the parent SKU
[@rental_only@] A boolean that when true means it is a rental only item
[@retail@] Retail price
[@reviews@] Total number of reviews
[@rating@] The average rating of the item
[@service_only@] A boolean that when true indicates a service item which has no delivery options required
[@sh_type_id@] The shipping ID of the shipping method that the item belongs to
[@short_description@] Item short description, has a character limit of 250 characters
[@sku@] The items SKU, the unique identifier
[@store_quantity@] The quantity available for purchase
[@subtitle@] The items subtitle
[@thumb@], [@thumb#@] Where # represents a number, prints the image url
[@unit@] The unit of measure
[@url@] The URL used to reach the items product page
[@warranty@] Loads the text from the warranty description block
[@tax_total@] The total tax of the order
[@discount_total@] The total of discounts in the order
[@grand_total@] The grand total of the order
[@subtotal@] The subtotal of the items in the order
[@product_total@] The product total of the items in the order
[@shipping_total@] The total cost of the shipping in the order based on session shipping method if any methods are available. If all shipping options require user input such as post code and none is loaded in session, this will print 0

Was this article useful?

Be notified when this page is updated. Optional.