Widget Use
Presents the various shipping methods available to the user during checkout. Each option and its associated cost are displayed so that the user can make their selection before proceeding to payment.The widget is also used to present pickup locations when Store Pickup functionality is enabled.
Example of Widget Use
Following is an example of the widget in use:
Where can the Widget be placed?
The widget can be used in the following templates:
- Checkout Template
- Checkout Quote Template
- Guest Checkout Template
- PayPal Express Template
Widget Options
| Option | Use | Comments | Available from Version |
|---|---|---|---|
| Description | A short description of the widget's use. | We recommend 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 configurations are 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 |
| Show Widget Before Freight Options Are Known? | Determines whether this widget displays before freight options are known. | Default: ON Toggle to disable | 4.21 |
| Show GST Suffix? | Determines whether to include the (ex GST) or (inc GST) suffix against each charge option. | Default: ON Toggle to disable | All |
| Zero Dollar Freight Charge Display | The text displayed when the freight option does not attract a charge due to the user meeting a spend threshold. | Default: No Charge | All |
| Freight Quote Display | Determines whether freight quote is displayed. | Default: To Be Confirmed | |
| Map Link Text | The text displayed for the location map hyperlink. | Default: map | All |
| Auto Select Single Pickup Warehouse? | Determines whether a pickup location is automatically selected if it is the only one available. | Default: OFF Toggle to enable | 4.17 |
| Force Freight Selection at checkout (if there are multiple options) | When there's multiple freight options available, don't select any by default, and require the buyer to actively choose freight | Default: OFF Toggle to enable | 4.42 |
| Postcode Required Before Error Notifications Shown | Determines whether freight error popup message will display before the user enters a postcode. | Default: OFF Toggle to enable | 4.21 |
| Titles | |||
| Freight Options Heading | The heading text displayed at the top of the widget. | Default: Freight Options | All |
| Freight Options Heading Icon | The icon displayed to the left of the heading text. | Default is: cv-ico-general-shipping Select via drop-down | All |
| Pickup Locations Heading | The heading text displayed above the Pickup Locations section. | Default: Pickup Location NOTE - An 's' is automatically appended when there are multiple pickup warehouses. | All |
| Pickup Locations Heading Icon | The icon displayed to the left of the Pickup Locations Heading text. | Default: cv-ico-general-location Select via drop-down | All |
| Notifications | |||
| No Own Carrier Name Message | The message text displayed when Own Carriers are enabled but the user has not yet selected. | Default: Please select one of your own carriers | All |
| No Own Carrier Account Message | The message text displayed for the Own Carrier Account Number field. | Default: Please enter your Freight Account Number | All |
| Freight Option Not Selected Message | The message text displayed when no Freight Option selection has been made. | Default: Please select a freight option | All |
| No Normal Carrier Message | The message text displayed when the user has opted to include freight on order, but hasn't selected a specific option. | Default: Please select one freight option on order | 3.88 |
| Freight Recalculation On Quote Acceptance Message | The message displayed when the user submits the order as a quote and the freight recalculation is on. (For the Online Quote mode only) | Default: The freight for this quote may have changed. Please reselect. | 4.37 |
| Prompts | |||
| GST Prompt | The text displayed in the GST Suffix with either 'ex' or 'inc'. | Default: GST | All |
| Pickup Location List Label | The prompt text displayed when the user has not yet selected a pickup location. | Default: Select Pickup Location | All |
| Select Warehouse Label | The button text displayed against each possible pickup location. | Default: Select Warehouse | All |
| Select Freight On Order | The prompt text displayed above the freight options. | Default: Select freight on order | 3.88 |
| Select Own Freight Label | The prompt text displayed above the user's list of own carriers. | Default: Select from your list of own carriers | 3.88 |
| Free Delivery Label | The text displayed when the freight has been charged at $0 due to a promotion or freight quote requirement. | Default: Free Delivery Promotion Applied | 3.90 |
| Freight Protection Insurance (Contact CV Support to enable this functionality). | |||
| Freight Insurance 'Accepted' Label | Default: Freight protection | 4.00 | |
| Freight Insurance 'Declined' Label | Default: No, I do not want my order insured | 4.00 | |
| Freight Insurance Heading | Default: Would you like freight protection insurance? | 4.00 | |
| Freight Insurance Label | Default: We will cover any loss or damage to your goods that may occur during freight. | 4.00 | |
| Tailgate Service | |||
| Tailgate Service 'Accepted' Label | Default: Tailgate Service | 4.00 | |
| Tailgate Service 'Declined' Label | Default: No, I have a forklift that I can unload my goods with | 4.00 | |
| Tailgate Service Heading | Default: Do you require a Tailgate delivery service? | 4.00 | |
| Tailgate Service Label | Default: You have items in your order that require a forklift to unload and cannot be unloaded by hand. | 4.00 | |
| Dangerous Goods | |||
| Dangerous Goods Surcharge Text | The text added to a freight estimate or charge displayed if the dangerous goods surcharge feature is active. | Default: (includes dangerous goods surcharge) | 4.00 |
Related help
