Versions Compared

Key

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

...

Excerpt

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


Example of Widget Use


Where can the Widget be placed?

...

OptionUseCommentsAvailable from Version
DescriptionA short description of the widget'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 the 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 PromptLabel for the dropdown selector.Default: SortAll
Please Select TextDefault text displayed in the dropdown when the user has not yet selected a sort option.

Default: Please Select...

NOTE - If Lucene is enabled, 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

: [{text: '

:


Name: IntegratedPrice Value: Price (Low to High)

', value

Name:

'IntegratedPrice'},{text: '

IntegratedPrice DESC Value: Price (High to Low)

', value: 'IntegratedPrice DESC'},{text: 'Product Code A-Z', value: 'ProductCode'},{text: '

Name: ProductCode A-Z  Value: Product Code  

Name: ProductCode DESC  Value: Product Code Z-

A'

Name: Description A-Z, value:

'ProductCode DESC'},{text: '

Description A-Z

', value

Name:

'Description'},{text: '

Description DESC   Value: Description Z-A

', value: 'Description DESC'}]

Format must be: [{text: 'TEXT DISPLAYED', value: 'SORT VALUE'},{text: 'TEXT DISPLAYED', value: 'SORT VALUE'}]

All


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 on the site which -wide that also have Apply Globally ON. 


The most recently set sort options will always be used.  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. 

42022.383



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
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
titleRelated widgets
excludeCurrenttrue
operatorAND
cqllabel = "widget" and space = "KB" and title ~ "'product list'"
labelswidget cms