Easily provide front-end sorting controls for SilverStripe lists

Installs: 30 616

Dependents: 3

Suggesters: 0

Security: 0

Stars: 16

Watchers: 7

Forks: 10

Open Issues: 1


3.0.0 2023-08-23 05:07 UTC

This package is auto-updated.

Last update: 2024-05-06 19:22:16 UTC


CI Version License

A front-end control for sorting SilverStripe lists easily. The aim of this module is to make sorting lists as simple as it is to use PaginatedList.


  • SilverStripe 4+ or 5+


There are a few ways you can define sort options within an array.

Make a public function on your controller:

public function getSorter(){
	$sorts = [
		'Title', //DB field name only
		'Popularity' => 'Popularity DESC', //map title to sort sql
		'Price' => ['BasePrice' => 'ASC'], //map title to data list sort
		ListSorter_Option::create('Age', ['Created' => 'DESC'], //object
			ListSorter_Option::create('Age', ['Created' => 'ASC']) //reverse
	return ListSorter::create($this->request,$sorts);

Call that function when updating your list:

public function getSortableChildren() {
	$list = $this->Children();
	$list = $this->getSorter()->sortList($list);
	return $list;

Use my template or roll your own.

<% include Sorter %>
<% loop SortableChildren %>
<% end_loop %>

Usage with Silvershop

Silvershop's PageCategoryController comes with some sortings predefined. If you want to define your own sorting possibilities, you can add an Extension to ProductCategory like this:


namespace MyNamespace\SilverShop\Extensions;

use SilverShop\ListSorter\ListSorter;
use SilverShop\ListSorter\ListSorterOption;
use SilverStripe\Core\Extension;
use SilverStripe\Security\Security;

class ProductCategorySorting extends Extension

    public function updateSorter(ListSorter $sorter)

        $basePriceOptionDESC = ListSorterOption::create('BasePrice highest first', ['BasePrice' => 'DESC']);
        $basePriceOptionASC = ListSorterOption::create('BasePrice lowest first', ['BasePrice' => 'ASC']);

        $titleOptionASC = ListSorterOption::create('Title a-z', ['Title' => 'ASC']);
        $titleOptionDESC = ListSorterOption::create('Title z-a', ['Title' => 'DESC']);

        $newestOption = ListSorterOption::create('Newest first', ['Created' => 'DESC']);

        $popularityOption = ListSorterOption::create('Most Popular', ['Popularity' => 'DESC']);

//overwrite all settings
//you can use $sorter->addSortOption($option) if you want to add a sort option


Then add this extension to ProductCategoryController in your config:

    - MyNamespace\Silvershop\Extensions\ProductCategorySorting