6.9. Tags for Summarizing Shopping Basket/Cart
The following elements are used to access common items which need to be displayed on baskets and checkout pages.
* marks an optional parameter
[item-list cart*]
-
named attributes: [item-list name="cart"]
Places an iterative list of the items in the specified shopping cart, the main cart by default. See Item Lists for a description.
[/item-list]
-
Terminates the [item-list] tag.
[nitems cart*]
-
Expands into the total number of items ordered so far. Takes an optional cart name as a parameter.
[subtotal]
-
Expands into the subtotal cost, exclusive of sales tax, of all the items ordered so far.
[salestax cart*]
-
Expands into the sales tax on the subtotal of all the items ordered so far. If there is no key field to derive the proper percentage, such as state or zip code, it is set to 0. See SALES TAX for more information.
[shipping-description mode*]
-
named attributes: [shipping-description name="mode"]
The text description of mode. The default is the shipping mode currently selected.
[shipping mode*]
-
named attributes: [shipping name="mode"]
The shipping cost of the items in the basket via mode. The default mode is the shipping mode currently selected in the mv_shipmode variable. See SHIPPING.
[total-cost cart*]
-
Expands into the total cost of all the items in the current shopping cart, including sales tax, if any.
[currency convert*]
-
named attributes: [currency convert=1*]
When passed a value of a single number, formats it according to the currency specification. For instance:
[currency]4[/currency]
-
will display:
4.00
-
Uses the Locale and PriceCommas settings as appropriate, and can contain a [calc] region. If the optional "convert" parameter is set, it will convert according to PriceDivide> for the current locale. If Locale is set to fr_FR, and PriceDivide for fr_FR is 0.167, using the following sequence:
[currency convert=1] [calc] 500.00 + 1000.00 [/calc] [/currency]
-
will cause the number 8.982,04 to be displayed.
[/currency]
-
Terminates the currency region.
[cart name]
-
named attributes: [cart name="name"]
Sets the name of the current shopping cart for display of [shipping], [price], [total], [subtotal] and [nitems] tags. If a different price is used for the cart, all of the above except [shipping] will reflect the normal price field. Those operations must be emulated with embedded Perl or the [item-list], [calc] and [currency] tags, or use the PriceAdjustment feature to set it.
[row nn]
-
named attributes: [row width="nn"]
Formats text in tables. Intended for use in emailed reports or <PRE></PRE> HTML areas. The parameter nn gives the number of columns to use. Inside the row tag, [col param=value ...] tags may be used.
[/row]
-
Terminates a [row nn] element.
[col width=nn wrap=yes|no gutter=n align=left|right|input spacing=n]
-
Sets up a column for use in a [row]. This parameter can only be contained inside a [row nn] [/row] tag pair. Any number of columns (that fit within the size of the row) can be defined.
The parameters are:
width=nn The column width, including the gutter. Must be supplied, there is no default. A shorthand method is to just supply the number as the first parameter, as in [col 20]. gutter=n The number of spaces used to separate the column (on the right-hand side) from the next. Default is 2. spacing=n The line spacing used for wrapped text. Default is 1, or single-spaced. wrap=(yes|no) Determines whether text that is greater in length than the column width will be wrapped to the next line. Default is yes. align=(L|R|I) Determines whether text is aligned to the left (the default), the right or in a way that might display an HTML text input field correctly.
[/col]
-
Terminates the column field.