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.
We recommended this field be updated so
This description is added to the widget title. It makes the widget's
purpose is clear at a glance from This is handy if the content is only valid for a certain type of user, or if the same widget is required
use clear on 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.

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

To use the same widget for more than one

audience,

user group 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

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
The label
Label for the
drop-down
dropdown selector.Default
is
: Sort
 
All
Please Select Text
The
Default text displayed in the
drop-down selector
dropdown when the user has not yet selected a sort option.

Default

is

: Please Select...

Note

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

The options present in the drop-down selector by which the user can sort records.

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

Default is: [{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', value: 'ProductCode DESC'},{text: '

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

', value

Name:

'Description'},{text: '

Description DESC   Value: Description Z-A

', value: 'Description DESC'}] Show On Mobile?Determines whether the widget is displayed on a mobile device. If unticked, the sorter will be hidden on mobile devices.

Default is: ticked

Untick to disable

 

 

 

Other Widgets


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