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

Following is an example of the widget in use:

Image Removed

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
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 drop-down dropdown selector.Default: SortAll
Please Select TextText Default 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

Options in the dropdown used by the user to sort records.

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

Default: [{text: '

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)

', 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


Where a sort field can display values that are ascending or descending, the default is ascending. This means ascending sorts don'

, value: 'Description DESC'}]All

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