Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Widget Use

Excerpt

Allows you to add a sorter widget to a product list

...

Renders the 'Sort By' selector for products found in a product list search results.


Example of Widget Use

Following is an example of the widget in use:

 Image Added


Where can the Widget be placed?

The widget can be used in the following templates: 

  • Product List Template
  • Product Favorite's Template

  • Prior Purchases Template


Widget Options

OptionUseCommentsAvailable from Version
Description
The
A short description of the widget
It is recommended to use this so the reason for use of the widget is seem from the template page
's use.This description is added to the widget title. It makes the widget's use clear on the template page.All
Layer

The layer

that

the widget

will be shown onThe 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

is valid for.

Use layering to limit widget content to certain groups of users. 

To use the same widget for more than one user group but with different options set, add the widget as many times as needed in the same zone. Then add layering to define the user group each time

All
Sort By Prompt
   
Label for the dropdown selector.Default: SortAll
Please Select Text
 
Default text displayed in the dropdown when the user has not yet selected a sort option.

Default: Please Select...

NOTE - If Lucene is enabled

this will default to Popularity. Sort Options   Show On Mobile?   

 

 

...

, the default sort value will be Popularity.

All
RelevanceText to tell what the dropdown is for.Default: RelevanceAll
Sort Options

Click Edit to select options for the sort dropdown. 

In the Sort Options modal, add, remove or reorder sort options, then click Apply.


Default:


Name: IntegratedPrice Value: Price (Low to High)

Name: IntegratedPrice DESC Value: Price (High to Low)

Name: ProductCode A-Z  Value: Product Code  

Name: ProductCode DESC  Value: Product Code Z-A 

Name: Description A-Z, value: Description A-Z

Name: Description DESC   Value: Description Z-A


Where a sort field can display values that are ascending or descending, the default is ascending. This means ascending sorts don't have to be specified. DESC = descending


NOTE - Listed are the six default sort options. You can configure sort options to custom sort by fields in the Product table.    

Info
titleCustom Sort Fields

Add custom sort fields

IMPORTANT - You will need to know the field name.

In Name: enter the field name. Ascending values default, e.g., alphabetically from A up, or low to high etc. For descending order, add a space, then DESC. 

In Value, enter the text displayed to the user. 



2022.3
Apply Globally

When ON, sort options set in this widget instance are applied to all Product List widget instances site-wide that also have Apply Globally ON. 


The most recently set sort options In a widget instance with Apply Globally ON will be applied to other widget instances that also have Apply Globally ON. Includes the Product List Sort Mobile Widget.   

Default: OFF

When OFF, sort options set here are applied only to this widget instance. 

2022.3



Related help

Content by Label
showLabelsfalse
max10
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
excludeCurrenttrue
operatorAND
cqllabel = "product-list-sort" and space = "KB" and text ~ "'sort product list'"
labelswidget cms

Content by Label
excerpt
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
titleRelated widgets
excludeCurrenttrue
operatorAND
cqllabel = "widget" and space = "KB" and title ~ "'product list'"
labelswidget cms