Widget Use
Adds input lines to the cart so that users can add products directly to the order. This can be achieved by entering product codes and quantities, or using a search function.
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:
- Cart Template
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 |
| Number Of Lines | The number of order entry lines displayed. | Default is: 1 | All |
| Number Of Lines Use User Preferences? | Overrides the 'Number of Lines' widget setting with the user's preference (set in User Preferences). | Default is: disabled Tick to enable | All |
| Use Predictive Search? | Enables predictive search via Lucene in the Product Code input box. | Default is: disabled Tick to enable | All |
| Show Product Image? | Determines whether the image is included in the product search suggestions dropdown. | Default is: disabled Tick to enable | 3.89 |
| Show Product Code? | Determines whether the product code is included in the product search suggestions dropdown. | Default is: enabled Untick to disable | 3.89 |
| Show APN Instead Of Product Code | Displays the product's APN instead of product code in search results. | Default is: disabled Tick to enable | All |
| Show On Mobile? | Enables the display of the widget on mobile devices. | Default is: disabled Tick to enable | All |
| Show Tool Tip? | Determines whether a help icon is displayed, which launches tooltip text on hover. | Default is: disabled Tick to enable | 3.86 |
| Collapsible Area Expanded By Default? | Where the 'Show Expand/Collapse Button' flag is enabled, ticking this option will expand the additional order entry lines by default. | Default is: disabled Tick to enable | 3.86 |
| Show Add All Button? | Includes a button to add multiple products to the cart. | If enabled, button will only appear when the number of lines is > 1. Tick to enable | All |
| Show Expand/Collapse Button? | Determines whether a toggle button is rendered, allowing the user to expand or collapse the additional order entry lines. | If enabled, button will only appear when the number of lines is > 1. Default is: disabled Tick to enable | 3.86 |
| Exclude Order Restricted Products | Where Order Restrictions are in use on the site, this flag will prevent restricted products from showing up in the Fast Order Entry lookup. | Default is: disabled Tick to enable. | 4.06 |
| Titles | |||
| Heading | The text displayed at the top of the widget. | Default is: Fast Order Entry | All |
| Heading Icon | The icon displayed to the left of the heading text. | Select via drop-down | All |
| Notifications | |||
| Product Added Message | The text displayed when a single product is successfully added to cart. | Default is: Your product has been successfully added | All |
| Products Added Message | The text displayed when multiple products are successfully added to cart. | Default is: These products have been successfully added: | All |
| Add All Error Message Format | Use placeholders {0} for product code and {1} for error message | Default is: {0} : {1} | All |
| Buttons | |||
| Add Button Label | The text displayed on the 'Add To Cart' button. | Default is: Add To Cart | All |
| Add All Button Label | The text displayed on the 'Add All To Cart' button. | Default is: Add All To Cart | All |
| Expand/Collapse Button Label (Expanded) | The text displayed on the expand/collapse toggle button when all lines are expanded. Use placeholder {0} for the total number of lines. | Default is: Expand to {0} | 3.86 |
| Expand/Collapse Button Label (Collapsed) | The text displayed on the expand/collapse toggle button when additional lines are collapsed. | Default is: Collapse to 1 | 3.86 |
| Prompts | |||
| Code Placeholder Text | The placeholder text displayed in the Product Code input box. | Default is: Product Code | All |
| Cost Centre Heading and Placeholder Text | THe placeholder text displayed in the Cost Centre input box. | Default is: Cost Centre | 3.88 |
| Notes Heading and Placeholder Text | The placeholder text displayed in the Note input box. | Default is: Notes | 3.88 |
| Tooltips | |||
| Fast Order Entry Tool Tip | The text displayed when the user hovers over the help icon. | 3.86 | |
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.
