Skip to end of metadata
Go to start of metadata

Widget Use

Renders the 'Filter By' options on the product list page. Customers can filter their search or browsing results by metadata values such as Brand, Size, Colour, and so forth.

 

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:

  • Product List Template

 

Widget Options

OptionUseCommentsAvailable 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
Allow Combinations?

Determines whether the user is permitted to filter by more than one variable at a time. When enabled, the user can select multiple filter options and click the button to apply them all.

Note that when combinations are enabled, the entire list of filter options will be presented, not just those options which contain products.

Default is: unticked

Tick to enable

All
Show Clear All?Determines whether the 'Clear All' option is presented to allow the user to remove all filters at once.

Default is: unticked

Tick to enable

All
Default Expanded Filters

A comma-separated list of filters that you would like automatically expanded on page load.

 

Note - Filter names are case-sensitive and should not include spaces.

Example: Brand,Colour,Size
All
Show Price Filter?Determines whether a price filter option is presented, allowing filtering based on the integrated price for a product (NOT the calculated price).

Default is: unticked

Tick to enable

All
Default Price Filter Expanded?Determines whether the price filter is automatically expanded on page load, so that the price slider is always visible.

Default is: unticked

Tick to enable

All
Show Default Minimum and Maximum Price FiltersDetermines whether the min/max values specified here in the widget will be used when there are no min/max values associated with the category.

Default is: unticked

Tick to enable

3.94
Default Price Filter MinThe minimum price value to be used if there is no min on the category itself. 3.94
Default Price Filter MaxThe maximum price value to be used if there is no max on the category itself. 3.94
Show Product Feature Count?

Determines whether a product count is displayed next to the feature name in the Filter list on selection.

For example - filtering by brand would display as "Apple (18)" if there are 18 product results when 'Apple' is selected.

Default is: unticked

Tick to enable

3.92
Add Filtered Attribute Prefix?

Determines whether the metadata type is prefixed to the selected filter.

For example - "Currently Filtered By: (Brand) Reflex" rather than "Currently Filtered By: Reflex".

Default is: unticked

Tick to enable

3.90
Include Please Select Option In Mobile View? 

Default is: unticked

Tick to enable

 
Preview Top 5 Values

Displays the Top 5 (by number of results) filter values only, with a 'see more' indicator for the user to display all. This keeps filter options with many values from obstructing other filters on the page.

Default is: unticked

Tick to enable

3.95
Notifications
No Filters Message The text displayed when no metadata is present to filter by.Default is: There are no filter options availableAll
Buttons
Combination Button LocationDetermines the location of the 'Apply' button (top or bottom).

Default is: Bottom

Select via drop-down

All
Prompts
Filter By PromptThe heading text displayed at the top of the widget.Default is: Filter ByAll
Current Filter PromptThe heading text displayed above the filters that are currently in use.Default is: Currently Filtered By...All
Clear All PromptThe label for the Clear All option.Default is: Clear All FiltersAll
Price Filter PromptThe label for the price slider.Default is: Price RangeAll

 

 

Other Widgets

  • Page:
    Standing Order Due Days Widget Inserts the message stating the number of days a recurring order is due to be placed. Used for standing orders only.
  • Page:
    Standing Order Removed Lines Widget Inserts a message in an order notification email for a recurring standing order if any products have been removed due to unavailability.
  • Page:
    Standing Order Message Widget Inserts standing order messages in email notifications for recurring orders placed from standing orders.
  • Page:
    Items Meta Data Filter Widget — Configures the data source and filtering options when Server Side filtering mode is selected for the Article List Features filter.
  • Page:
    B2C Registration Verification Notification Widget Used in the B2C Registration Verification Notification email template to alert your online team or a staff member that a user has registered on your website.
  • Page:
    B2C Registration Verification Required Email Widget Creates the content of the email notifying a B2C user they have to authenticate their email address after they register on your site.
  • Page:
  • Page:
    Token Customer Credit Card Info Widget — Displays the message in credit card expiry reminder emails to Customers who have existing token payment set up.
  • Page:
    Email Credit Card Verification Link Widget Adds credit card verification instructions in order confirmation and verification reminder emails, and includes a link to the validation page.
  • Page:
    Report Subscription Widget Renders input field and button configurations for the Report Subscription screen. Field labels, headings and text can be edited.
  • Page:
    Report Generator Widget Provides input field and button configurations for the Report Generator feature. You can customise the widget to configure display field options and text to suit your website style.
  • Page:
    SignalR Group Message Selector Widget Define the text for the button users will click when selecting a SignalR client–in this example, a printer enabled to print orders/invoices in PDF format.
  • Page:
    Page Content Search Result Widget Customise the 'no results returned' message when the keyword search does not match any static content on your pages or products.
  • Page:
    Display Customer Currency Widget Displays the default currency set for a Customer based on login for websites operating in international markets. 
  • Page:
    Scripts & Styles Widget — The new Scripts & Styles widget allows you to bundle related scripts and styles into one widget to function as a unit, or add multiple Scripts & Styles widgets to a page so they operate independently. Due to its name, and because the widget functions to run scripts or apply styles only, you know at a glance if a page is using customised JavaScript or Style Sheets.