Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Provides a summary by displaying the total cost of all items in the cart , as well as the number of items in the cart. This widget can also act as a contents, display a preview of order lines and their total costs, and link to the shopping cart.


Example of Widget Use


...

Without Preview on HoverWith Preview on Hover

Image Added

From version 3.87, a preview option is available in which more cart detail is displayed on hover.

 

Example of Widget Use

Following is an example of the widget in use:

Without HoverWith Preview on Hover
Image RemovedImage Removed

Image Added


Where can the Widget be placed?

...

  • Theme Layout

Widget Options

Note
titleThird Party Payment Settings

For Zip, Afterpay, Openpay and Payright fields, see: Product Purchase Details Widget help.  


OptionUseCommentsAvailable from Version
DescriptionA short description of the widget's use.
We recommended this field be updated so
This description is added to the widget title. It makes the widget's
purpose is clear at a glance from
use clear on the template page.All
LayerThe layer the widget is valid for.

The layering technology allows for the content to be shown to specific audiences.

This is handy if the content is only valid for a certain type of user, or if the same widget is required

Use layering to limit widget content to certain groups of users. 

To use the same widget for more than one

audience,

user group but

different configuration is needed.The widget can be added to the zone more than once and the layer feature can determine which audience can see each widget

with different options set, add the widget as many times as needed in the same zone. Then add layering to define the user group each time

All
Navigate to
Cart URL
on Cart Icon click?Determines whether the cart button acts as a link to the shopping cart page.

Default is: ticked

Untick to disable

3.88Show Tax Display?Determines whether the 'inc GST' or 'ex GST' text is displayed in the widget.

Default is: unticked

Tick to enable

3.88Show On Mobile?Determines whether the widget is displayed on a mobile device. If unticked, the cart summary will be hidden on mobile devices.

Default is: ticked

Untick to disable

AllShow Only Icon On Mobile?Determines whether the total cost and item/line count are displayed on mobile devices. When ticked, the icon is the only element displayed, saving space on smaller devices.

Default is: ticked

Untick to disable

AllCart Preview On Hover?Determines whether a preview panel appears on hover of the cart button. The preview can contain the cart contents, freight cost, total charges, and so forth.

Default is: unticked

Tick to enable

3.87Link to Tax Toggle Widget?If the Tax Toggle widget has been implemented on your site, tick this to enable the Cart Summary total to update as tax is toggled on/off.

Default is: unticked

Tick to enable

3.88Right Align?Pushes the widget to the right of the zone it is located in.

Default is: ticked

Untick to disable

 AllButtonsCart URLThe address/URL the user will be redirected to on click of the cart summary.Default is: /cartAllCart IconThe icon
Simplified cart URL name to display to user.  Default: /cart
Navigate to Cart URL on Cart Icon click?Whether cart icon is a link to the shopping cart page.

Default: ON

Toggle to disable

3.88
Cart IconIcon displayed to the left of the total cost and item/line count.Default
is
: cv-ico-general_cartAll
Hide Default IconPrevents display of the default icon (if not already overridden with the 'Cart Icon' option).

Default

is

:

unticked

OFF

Tick

Toggle to enable

All
Order Packages or Line Count?

Determines what will be shown in brackets alongside the total order value (e.g. "6 items" or "4 lines").

Options are:

  • Order Packages - the total number of items in the cart.
  • Line count - the number of lines in the cart.

Default

is

: Order Packages

All
Placeholder for Cart Count
Used to display

Displays the number of lines/items in the cart.

If

empty it won't show at all. The

field is empty, cart count will not show. {0} will be replaced with the count

so that the actual

.

If brackets ( ) are used, the count number is

then

shown within

parenthesis. To not include parenthesis just use {0}

them. Exclude ( ) if you don't want brackets.

Default
is
: ({0} items)3.87
Inc / Ex Tax Display
Determines whether

Whether tax is included in the cart summary calculation.

This is

generally

usually defined at the customer level (e.g. B2B Customers = ex Tax and B2C Customers = inc Tax)

, but can be overridden with this widget option.Default is: CustomerDefined3.78

but the setting here will override this default.

Default: CustomerDefined3.78
Show Tax Display?Determines whether the 'inc GST' or 'ex GST' text is displayed in the widget.

Default: OFF

Toggle to enable

3.88
Show Only Icon On Mobile?Determines whether the total cost and item/line count are displayed on mobile devices. When ticked, the icon is the only element displayed, saving space on smaller devices.

Default: ON

Toggle to disable

All
Cart Preview On Hover?Determines whether a preview panel appears when user hovers on cart icon. The preview can contain the cart contents, freight cost, total charges, etc.

Default: OFF

Toggle to enable

3.87
Link to Tax Toggle Widget?If the Tax Toggle Widget is implemented on your site, toggle ON to enable the Cart Summary total to update as tax is toggled on/off.

Default: OFF

Toggle to enable

3.88
Line Sort Field

Determines how items in the cart are ordered. Works with 'Lines Sort Direction' field.

Enter one of the bolded options.

  • LineSeq - orders by first to last entered in cart or reverse
  • OrderItemPrice - orders by lowest to highest prices or reverse 
  • Product[0].Description - orders by alphabetical order of product description from numerals,a-z or z-a,numerals

If no value is entered, the default order adds to cart from first to last. 


 All
Lines Sort Direction

Select:

  • Ascending for first to last/lowest to highest
  • Descending for the reverse. 
Default: AscendingAll
Display Top X Number of LinesThe number of lines from the top to display. The default '0' will show all lines.Default: 0All
Strip Zero Decimal AmountsWhether zeroes after the decimal point are left out when the price has zero cents, e.g., $10 or $10.00.

Default: OFF

Toggle to enable

All
Cart Preview On Hover
Popup Header Text
The heading displayed

Heading at the top of the hover panel.

{0} - placeholder for item count

Default

is

: You currently have {0} products in your cart


3.87
Popup Header Count Text

Descriptor for the number of products in the cart centred around the word 'item'.  

Example: Summary line "You currently have X items in your cart".

Image Added

Default: item


NOTE -  'item' is automatically pluralised when cart has more than one item number.

3.97
Charges Prompt
The label
Label for the order charges
(
, e.g., total of products in the cart
)
.Default
is
: Charges3.87
Charge Line Discounts PromptLabel for order charge discounts.Default: Discounts3.87
Discounts Prompt
The label
Label for the order discounts
(
, e.g., promotions or other discounts
)
.Default
is
: Discounts3.87
Freight Prompt
The label
Label for the freight.Default
is
: Freight3.87
Zero Dollar Freight Charge Display
The text
Text displayed when the order does not attract a freight charge.Default
is
: No Charge3.87
Requires Quote Freight Charge Display
The text
Text displayed when the freight can't be calculated and will require a quote.Default
is
: Requires Quote3.87
GST PromptThe label
Show Promotional Code Expiry Date?Whether the expiry date of the applied promo code is included in the cart preview.

Default: ON

Toggle to disable

3.95
Promotional Code Expiry Date PromptLabel for the promo code expiry date. The placeholder {0} will be replaced with the actual promotion's expiry date.Default: Expires on: {0}3.95
Tax PromptLabel for the GST.Default
is
: GST3.87
Subtotal Prompt
The label
Label for the order subtotal.Default
is
: Subtotal3.87
Including
GST
Tax Prompt (inc tax)
The label
Label for the GST field when the GST has been included in the subtotal.Default
is
: Including GST3.87
Including
GST
Tax Prompt (ex tax)
The label
Label for the GST field when the GST has not been included in the subtotal.Default
is
: Plus GST3.87
Total (inc-tax) prompt
The label
Label for the order total.Default
is
: Total (inc GST)3.87
Giftcard total prompt
The label
Label for the giftcard amount redeemed.Default
is
: Giftcard Total3.87
Amount owing after gift cards
The label
Label for the net owing after giftcard deduction.Default
is
: Net Owing3.87
Checkout button text
The text
Text displayed on the checkout button in the preview panel.Default
is
: Checkout3.87
Include Order Lines in on Hover
Determines whether
Whether the cart contents are displayed in the preview panel.

Default

is

:

unticked

OFF

Tick

Toggle to enable

3.87
Include Link to ProductIf 'Include Order Lines in on Hover' is enabled, determines whether cart lines link back to the product page.

Default

is

:

unticked

OFF

Tick

Toggle to enable

3.87
Use Order Lines Info Sub Template

Whether custom widgets can be used to show additional line info. 

NOTE - For nested widgets to include links, disable 'Include Link to Product'.

Default: OFF

Toggle to enable

4.23.06
Show APN Instead Of Product Code
Determines whether
Whether the Australian Product Number is displayed in lieu of the product code.

Default: OFF

Toggle to enable

3.87
Itemise Charges?Whether various charges are broken down into their various components, instead of being grouped as 'Charges'.

Default: OFF

Toggle to enable

3.95
Show Budget Remaining?Determines whether the budget remaining amount is
: unticked

Tick to enable

3.87
displayed in the cart preview.

Default: OFF

Toggle to enable

3.95
Budget Remaining PromptLabel for the budget remaining amount.Default: Budget Remaining3.95
Increase Quantities In Pack Qty?Enforce increase by pack quantity only if a product must be sold in a pack quantity when a  quantity adjusted.Default: OFF3.95
Add Minimum Quantity To Cart?Enforce minimum quantity to add to cart if a product has specific minimum quantity.Default: OFF3.95
Enable Cart Editing?Whether to let users edit quantities in the cart summary popup.

Default: OFF

Toggle to enable

4.37
Enable Cart Editing Auto Update?Whether to dynamically save user changes in Cart Preview.

Default: OFF

Toggle to enable

4.37
Update cart button text(Only if auto-update is disabled.) Text on the Update Cart button.Default: Update Cart4.37
Delete confirmation message (Only if auto-update is disabled.) Text on dialog popup asking user to confirm deletion of order line. Default: Are you sure you want to remove this product?4.37
Delete confirm button label(Only if auto-update is disabled.) Text on button to confirm deletion of order line.Default: Yes, Remove Product.4.37
Delete cancel button label(Only if auto-update is disabled.) Text on button to cancel deletion of order line.Default: No4.37
Deleted Line Message 

Message confirming order line was deleted from cart.

Image Added

Default: <a href='{0}'>{1}</a> was removed from Shopping Cart


{0} - placeholder for the product URL to product

{1} - placeholder for product title and code.

4.37
Braintree
PayPal Pay Later Messaging Options

(Only if Braintree Payments is used) Allows editing of the PayPal Pay in 4 tagline that in Cart Summary. See: Pay in 4

Image Added


4.31
Force Hide Pay Later MessageWhether the Pay in 4 message displays in Cart Preview. Automatically displays when Braintree Payments is active. Toggle ON to hide the message.

Default: OFF

Toggle to enable

4.31

Implementation Guide

 Cart Preview on Hover

 

...


Related help

Content by Label
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
excludeCurrenttrue
operatorAND
cqllabel = "cart" and space = "KB" and title ~ "'cart preview on hover'"
labelswidget cms

Content by Label
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
excludeCurrenttrue
operatorAND
cqllabel = "widget" and space = "KB" and title ~ "'cart summary'"
labelswidget cms

Content by Label
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
excerptexcludeCurrenttrue
operatorAND
cqllabel = "widget" and space = "KB" and title ~ "'tax toggle'"
labelswidget cms