dynamic/silverstripe-collection

Display a filterable collection of pages or dataobjects on a page.

Silverstripe Collection

Display a filterable collection of pages or dataobjects on a page., _(*1)

, _(*2)

, _(*3)

Requirements

• SilverStripe 4.x

Installation

composer require dynamic/silverstripe-collection, _(*4)

Configuration

In your config.yml:, _(*5)

Your/Namespace/ExamplePageController:
  managed_object: ExampleObject
  page_size: 10
  extensions:
    - Dynamic\Collection\CollectionExtension

Managed Page/DataObject

Collection will create a search form based on the managed object's $searchable_fields., _(*6)

private static $searchable_fields = [
  'Title' => [
    'title' => 'Name',
  ],
  'Category.ID' => [
    'title' => 'Category',
  ],
];

For advanced setups, you can also create getCustomSearchContext() on your managed object., _(*7)

To include a sorting dropdown field, create a getSortOptions() method on your managed object:, _(*8)

public function getSortOptions()
{
  return array(
    'Created' => 'Date',
    'Title' => 'Name A-Z',
    'Title DESC' => 'Name Z-A',
  );
}

Templates

$CollectionSearchForm will display the search form., _(*9)

You have mutliple options to loop through the results in your template:, _(*10)

• $Collection will display a list of all results
• $PaginatedList will paginate the results
• $GroupedList.GroupedBy(CategoryTitle) will display results grouped by the variable you pass

Documentation

See the docs/en folder., _(*11)