(Formerly known as the Post Code Validation Modal widget)
Widget Use
Displays a modal window to allow the user to set the postcode for their order. This launches automatically on the user's first navigation to the cart, or can be accessed later via a link in the site header.
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:
- Any template, but generally used on Theme Layout
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 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 |
| Current Postcode Prompt | The text displayed for the link in the site navigation header. | Default is: Current Postcode: | 3.82 |
| Icon | The icon displayed to the left of the 'Current Postcode Prompt' text. | Default is: cv-ico-general-pin-alt | 3.82 |
| Modal Title | The heading displayed at the top of the widget. | Default is: Enter Postcode | 3.82 |
| Modal Subtitle | The subtitle displayed below the Title. | Default is: To help us localise our product and delivery options, please enter your postcode to continue | 3.82 |
| Modal Message | The text displayed in the content area of the modal window, between the Modal Subtitle and the Postcode Entry Label. | 3.82 | |
| Postcode Entry Label | The prompt for the postcode entry field. | Default is: Post Code | 3.82 |
| Apply Button Label | The text displayed on the Apply button. | Default is: Apply | 3.82 |
| Cancel Button Label | The text displayed on the Cancel button. | Default is: Cancel | 3.82 |
| Products Removed Message | The message displayed to users when products are automatically removed from the cart based on postcode. The placeholder '{0}' is used to display the list of product codes. | Default is: The following products have been removed from your order: {0} | 3.82 |
| Blank Postcode Validation Message | The text displayed on the validation message when a user clicks 'Apply' without entering a postcode. | NOTE - This message is only used when no Postcode Regex Validation has been specified. If there is a Regex in use, this message will be overridden by the 'Postcode Not Valid' message. Default is: Please enter a postcode | 3.82 |
| Postcode Regex Validation | Javascript Regular Expression sequence. This can be used to restrict the field entry to a specific type or number of characters. | Example - to limit entry in the postcode field to 4 numeric characters, use this expression: /^\d{4}$/ | 3.82 |
| Invalid Postcode Validation Message | The text displayed on the validation message when a user enters an invalid postcode. | Default is: The postcode you have entered is invalid | 3.82 |
| Show On Mobile? | Determines whether the widget is displayed on a mobile device. If unticked, the Postcode Validation modal will be hidden on mobile devices. | Default is: ticked Untick to disable | 3.82 |
| Show Only Icon On Mobile? | Determines whether just the icon is displayed on mobile devices. If ticked, the 'Current Postcode Prompt' text will be hidden on mobile screens. | Default is: ticked Untick to disable | 3.82 |
| Right Align? | Pushes the widget to the right of the zone it is located in. | Default is: ticked Untick to disable | 3.82 |
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.
