Loading...
 
Skip to main content

History: PluginList sort control block

Preview of version: 11 (current)

PluginList sort control block

Setting Sort Mode
Please be warned that sorting is normally based on string. If you are trying to sort by numbers, make sure all your numbers are of the same number of digits. Otherwise 2 will be larger than 12 if doing a string sort.

Copy to clipboard
{sort mode="tracker_field_example_asc"} {sort mode="tracker_field_example_desc"}
or
Copy to clipboard
{sort mode="title_asc"}


If you want to do a numeric sort (such that 12 is larger then 2, use the following instead:

Copy to clipboard
{sort mode="tracker_field_ticketNumber_nasc"} {sort mode="tracker_field_ticketNumber_ndesc"}
or often
Copy to clipboard
{sort mode="modification_date_ndesc"}

In the example above modification_date is used as the sort parameter - the list of other generic parameters that might be used to 'sort' and are available from Unified search are shown here.

Starting with Tiki27: If you want to sort using two fields, separate them with a comma:

Copy to clipboard
{sort mode="tracker_field_ticketCustomerName_text_asc,tracker_field_ticketNumber_nasc"}

In the example above we sort using ticketCustomerName in alphabetic order and for each value of ticketCustomerName we sort the ticketNumber in numeric ascending order.

There is also a way to simulate random results when showing a short list. This is of course not compatible with pagination. You have to specify a list of sort modes on irrelevant fields to choose randomly from, for example:

Copy to clipboard
{sort mode="randommode" modes="title_asc,tracker_field_example_asc,tracker_field_ticketNumber_nasc, modification_date_nasc"}
(Note, opposite directions will be added automatically)


You can further select the results that are going to be return by using return_only, for example:

Copy to clipboard
{sort mode="tracker_field_ticketNumber_nasc" return_only="2,1,3"}
will return only the 2nd, 1st and 3rd result, in that order.


Starting with 19.1 you can use scripted sort orders on Elasticsearch, as described here for example:

Copy to clipboard
{sort mode="script" source="Math.abs(new Date().getTime() - doc['date'].date.getMillis() )" order="asc"}
which sorts items by nearest to the current date/time.

All the LIST Plugin control blocks

History

Advanced
Information Version
Jean-Marc Libs 11
Jean-Marc Libs 10
drsassafras removing references to EOL tiki versions 9
Jonny Bradley 8
luciash d' being 🧙 7
rjsmelo 6
lindon 5
Geoff Brickell 4
Jonny Bradley changed to use permanent names 3
Geoff Brickell 2
Geoff Brickell 1