cart_items

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

Example

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

Usage

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.

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
`ifempty:''`	HTML & b@se tags	If the random_products returns no results, it'll load this block instead
`*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

Data Tags (body)

Name	Product Field	Example	Description
`[@acc_code@]`	Custom Label/Code	220/MDC	Product identifier for eBay or accounting integration
`[@actual_height@]`	Assembled Height	0.420	Assembled height in metres
`[@actual_length@]`	Assembled Length	0.990	Assembled length in metres
`[@actual_width@]`	Assembled Width	1.200	Assembled width in metres
`[@aff_id@]`	–	free	Returns `free` if it is a free product added by a Discount Coupon. Blank if none
`[@aff_ref@]`	–	*26	Returns the ID number of the Discount Coupon (proceeded by an *). Blank if none
`[@arrival_date@]`	Date arrival	2018-12-31	Displays date if in the future or nothing if the date is today or in the past (YYYY-MM-DD)
`[@availability_description@]`	Availability Description	New stock arriving in December	Details of when the product will be available
`[@base_unit@]`	Base Unit of Measure	kg	The base unit of measure (ctn, ea, L,ml, cm, m, lb, g, kg)
`[@base_unit_qty@]`, `[@baseqty@]`	Base Unit Per Qty	2.0000	For display purposes only. Multiplies the actual qty by this qty. For example if base unit qty is 1.9 then a qty of 2 will display as 3.8.
`[@brand@]`	Brand	Kingston	Product brand
`[@cart_counter@]`, `[@count@]`, `[@counter@]`, `[@line@]`, `[@total_items@]`	–	0	Counts for every time the body param is run as a whole number integer
`[@date_delivery@]`	–	2018-08-16 00:00:00	The first available delivery date or the date the customer selected. This will be blank if the desired delivery date selector is not turned on
`[@discount@]`	–	10.00	Discount amount based on the applicable discount coupons. Returns `0` if it is a free product on a discount coupon
`[@editable_bundle@]`	Editable Kit	n	Is this product an editable kit. n - no, y - yes
`[@extra@]`	Extra Options	Gift message: Happy Mother's Day;	Non-inventoried extras you offer the customer at the point of purchase. Displays the option name followed by the value. Options are semicolon separated
`[@gifts_available@]`	Freebies	1	Are there free gifts available for the product. 0 - no, 1 - yes
`[@has_extra@]`	Extra Options	1	Product has extra options. 0 - no, 1 - yes
`[@inventory_id@]`	–	22343	Unique number for this product
`[@is_au_gst_exempted@]`	AU GST Exempt	0	If you are based outside Australia and need to pay GST, this indicates if GST is applicable on this product. 0 - no, 1 - yes
`[@item_count@]`	–	1	Counter for the cart entry. Starts at 1
`[@itm_sortorder@]`	Sort Order 1	1	Sort order (ascending order)
`[@itm_sortorder2@]`	Sort Order 2	2	Sort order (ascending order)
`[@manufacturer_model@]`	Manufacturer model number	A7DC/K	The manufacturers model number of the product
`[@misc1@]`, `[@misc2@]`, etc	custom field name	The Fault in Our Stars	Custom product fields
`[@model@]`	Name	Turtles All the Way Down	Product name
`[@notax@]`	Tax Free Product	n	Tax Free Product. n - does attract tax, y - does not attract tax
`[@parent_inventory_id@]`	–	22237	If the item is a child item, returns the ID number of the parent product
`[@parent_name@]`	–	John Green Collection	If the item is a child item, returns the name of the parent product
`[@parent_sku@]`	Parent	BA72-4	If the item is a child item, returns the SKU of the parent product
`[@preorder@]`	–	1	Is the product on pre-order. 0 - no, 1 - yes
`[@price@]`	Price	100.00	Product price based on the group the customer is assigned to. Does not take into account promo pricing
`[@product_discount@]`	–	22.00	Running total of the discount applied to the order excluding this and successive order lines
`[@product_total@]`	–	110.00	Running total of the price of the products excluding this and successive order lines
`[@qty@]`	–	1	Quantity ordered of this product
`[@retail@]`	RRP	125.00	Recommended retail price
`[@service_only@]`	Service Item	n	Service product. Shipping methods and rates are ignored for service items
`[@sh_group_id@]`	–	17	ID number for the selected shipping method on this order
`[@sh_type_id@]`	Shipping Category	1	ID number of the shipping category. Blank if Service Item is selected
`[@ship_zip@]`	–	4215	Postcode / zip if it has been entered or the customer is logged in
`[@shipping@]`	Shipping Weight	15.0000	Shipping weight of the product in kilograms
`[@shipping_discount@]`	–	1	Is there a discount on the shipping cost using a Discount Coupon. 0 - no, 1 - yes
`[@shipping_method@]`	–	Standard Shipping	Name of the shipping method for the order, if selected
`[@shipping_method_id@]`	–	1	ID number of the shipping method for the order, if selected
`[@shipping_status@]`	–	normal	Type of shipping. Options: `normal`, `free`
`[@shipping_total@]`	–	10.00	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
`[@sku@]`	SKU	17MD-Black	Product SKU
`[@store_price@]`	–	110.00	Price for one of this product
`[@store_quantity@]`	Qty On Hand	26	Available stock to sell. It is calculated by the total of all the warehouses minus the committed stock
`[@subtitle@]`	Subtitle	Fiction	Normally appears below the name of the product on product pages
`[@subtotal@]`	–	297.50	The subtotal of the items in the order
`[@thumb@]`	Main	/assets/thumb/17MD-Black.jpg	Main product image thumbnail. If the child product has no image the parent image is returned
`[@total_gifts@]`	Freebies	2	Number of free gift options available for this product
`[@unit@]`	Selling Unit of Measure	g	The selling unit of measure. Can appear on invoices, etc
`[@url@]`	Product URL	http://www.mysite.com/turtles-all-the-way-down	Product web address
`[@warranty@]`	Warranty		Loads the text from the warranty description block

cart_items

Example

Usage

Parameters

Data Tags (body)

Was this article useful?