Table of Contents
sortablejs Plugin
Compatible with DokuWiki
- 2023-04-04 "Jack Jackrum" yes
- 2022-07-31 "Igor" yes
- 2020-07-29 "Hogfather" yes
- 2018-04-22 "Greebo" yes
Similar to datatables, tablelayout
Needed for linkmanager
Description
A JavaScript-based (client-side) plugin, which can be used to create sortable tables. It is optional for linkmanager plugin.
For server-side sorting or more robust sort facilities use Sam Wilson's sorter, based on https://github.com/Mottie/tablesorter (supports server-side sorting): https://github.com/samwilson/dokuwiki_sortablejs
Previously maintained by oiv (Otto Vainio at otto@valjakko.net)
Usage
After installing the plugin you should make sure that your DokuWiki cache is updated. This can easily be done by changing any parameter value in settings (or by doing a touch conf/local.php
).
You need to set <sortable>
and </sortable>
tags around your table.
<sortable> ^ Col1 ^ Col3 ^ Col3 ^ | 1 | one |25/12/2008 | | 2 | two |10/12/2008 | </sortable>
Table initially sorted by column 1
<sortable 1> ^ Col1 ^ Col3 ^ Col3 ^ | 1 | one |25/12/2008 | | 2 | two |10/12/2008 | </sortable>
Table initially reverse sorted by column 1
<sortable r1> ^ Col1 ^ Col3 ^ Col3 ^ | 1 | one |25/12/2008 | | 2 | two |10/12/2008 | </sortable>
To sort the columns you (the page viewer) just needs to click on the correct column on the first row. A second click on the same column reverses sort.
Options
<sortable [[r]column] [sumrow[=2]] [column=alpha|numeric|date|nosort] [3phase]> <sortable r1 sumrow=2 3phase 1=numeric 2=alpha 3=nosort> ││ │ │ │ │ │ ││ │ │ │ │ └ No sort option for column 3 ││ │ │ │ └ Sort column 2 as text always ││ │ │ └ Sort column 1 as numeric always ││ │ └ Add a 3-phase sort option. Normal, Reverse and Back to original order. ││ └ Prevent last 2 rows from sort. The number can be omitted. Default is last row (=1) │└ Initially sort by column 1 on page load └ Reverse initial sort
Misc links
- Historical versions: https://github.com/FyiurAmron/sortablejs/wiki/older-versions
- GitHub revision history: https://github.com/FyiurAmron/sortablejs/commits/master
- Historical bugs/ehnancements: https://github.com/FyiurAmron/sortablejs/wiki/old-issues-and-enhancement-requests
- current issue tracker: https://github.com/FyiurAmron/sortablejs/issues