Widget Use
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 link to the shopping cart.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 Hover | With Preview on Hover |
---|---|
Where can the Widget be placed?
The widget can be used in the following templates:
- Theme Layout
Widget Options
Option | Use | Comments | Available from Version |
---|---|---|---|
Description | A short description of the widget's use. | We recommended this field be updated so the widget's purpose is clear at a glance from the template page. | All |
Layer | The 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 for more than one audience, 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. | 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.88 |
Show Tax Display? | Determines whether the 'inc GST' or 'ex GST' text is displayed in the widget. | Default is: unticked Tick to enable | 3.88 |
Show 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 | All |
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 is: ticked Untick to disable | All |
Cart 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.87 |
Link 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.88 |
Right Align? | Pushes the widget to the right of the zone it is located in. | Default is: ticked Untick to disable | All |
Buttons | |||
Cart URL | The address/URL the user will be redirected to on click of the cart summary. | Default is: /cart | All |
Cart Icon | The icon displayed to the left of the total cost and item/line count. | Default is: cv-ico-general_cart | All |
Hide Default Icon | Prevents display of the default icon (if not already overridden with the 'Cart Icon' option). | Default is: unticked Tick 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:
| Default is: Order Packages | All |
Placeholder for Cart Count | Used to display the number of lines/items in the cart. If empty it won't show at all. The {0} will be replaced with the count so that the actual number is then shown within parenthesis. To not include parenthesis just use {0}. | Default is: ({0} items) | 3.87 |
Inc / Ex Tax Display | Determines whether tax is included in the cart summary calculation. This is generally 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: CustomerDefined | 3.78 |
Cart Preview On Hover | |||
Popup Header Text | The heading displayed at the top of the hover panel. | Default is: You currently have {0} products in your cart | 3.87 |
Charges Prompt | The label for the order charges (e.g. total of products in the cart). | Default is: Charges | 3.87 |
Discounts Prompt | The label for the order discounts (e.g. promotions or other discounts). | Default is: Discounts | 3.87 |
Freight Prompt | The label for the freight. | Default is: Freight | 3.87 |
Zero Dollar Freight Charge Display | The text displayed when the order does not attract a freight charge. | Default is: No Charge | 3.87 |
Requires Quote Freight Charge Display | The text displayed when the freight can't be calculated and will require a quote. | Default is: Requires Quote | 3.87 |
Show Promotional Code Expiry Date? | Determines whether the expiry date of the applied promo code is included in the cart preview. | Default is: ticked | 3.95 |
Promotional Code Expiry Date Prompt | The label for the promo code expiry date. The placeholder {0} will be replaced with the actual promotion's expiry date. | Default is: Expires on: {0} | 3.95 |
GST Prompt | The label for the GST. | Default is: GST | 3.87 |
Subtotal Prompt | The label for the order subtotal. | Default is: Subtotal | 3.87 |
Including GST Prompt (inc tax) | The label for the GST field when the GST has been included in the subtotal. | Default is: Including GST | 3.87 |
Including GST Prompt (ex tax) | The label for the GST field when the GST has not been included in the subtotal. | Default is: Plus GST | 3.87 |
Total (inc-tax) prompt | The label for the order total. | Default is: Total (inc GST) | 3.87 |
Giftcard total prompt | The label for the giftcard amount redeemed. | Default is: Giftcard Total | 3.87 |
Amount owing after gift cards | The label for the net owing after giftcard deduction. | Default is: Net Owing | 3.87 |
Checkout button text | The text displayed on the checkout button in the preview panel. | Default is: Checkout | 3.87 |
Include Order Lines in on Hover | Determines whether the cart contents are displayed in the preview panel. | Default is: unticked Tick to enable | 3.87 |
Include Link to Product | If 'Include Order Lines in on Hover' is enabled, determines whether cart lines link back to the product page. | Default is: unticked Tick to enable | 3.87 |
Show APN Instead Of Product Code | Determines whether the Australian Product Number is displayed in lieu of the product code. | Default is: unticked Tick to enable | 3.87 |
Implementation Guide
Other Widgets
-
Order Payment Links Form Widget — Renders an order details stepper with an order form that can be automatically populated with query strings, and/or manually entered by the user. The form doesn't validate the order details are accurate in order to stay both secure and accessible to unauthenticated users.
-
Magic Link Authentication Message Widget — Renders the Magic Link authentication message.
-
CUSTOM_Side by Side Content Tiles Widget — Renders two side by side content tiles in a zone with widget options for selecting or adding background colour, image, text and link/button positioning.
-
Stock Dialog Widget — Displays the Stock to Receive Detail dialog window.
-
Stock to Receive Widget — Displays the Stock to Receive page.
-
Stock Levels Widget — Displays Stock Levels page.
-
Order Declined Pending 3rd Party Installment Msg Widget — Renders the message body for the email sent when the user selects to sign up and pay with a Buy Now Pay Later provider but approval is subject to further checks.
-
Order Field Static Widget — Renders an additional order field in email templates.
-
Online Quote Validation Widget — Renders the appropriate message to the user after the current status of an online quote accessed via an email link is validated.
-
Header Level Cost Centre Widget — Renders the cost centre input field on the order header in the shopping cart.
-
Openpay Summary Widget — Renders Openpay marketing information for a product on the product detail page. Use this widget instead of the Product Purchase Details widget if you want to customise tagline placement on the template.
-
Order Line Availability - Click and Collect Widget — Displays product availability and delivery methods at the order line level in dynamic scenarios such as the cart when Click & Collect is enabled.
-
Account Activation Email Content Widget — Renders the message content in the Invitation to Register an Account email.
-
Order Template Cost Centre Widget — Renders the cost centre input field on each product line in an order template.
-
BPAY Account Payment Detail Widget — Renders BPAY payment information in the body of the BPAY Account Payment email. This email is sent to users who pay invoices or pay down their account balance using BPAY.