Silverstripe module allowing creation of custom filters through the admin interface and then assigning to an object.
This package is auto-updated.
Last update: 2022-05-24 16:16:20 UTC
Module to allow creation of "Filters" that can be mapped to data objects.
The idea is that we then add ability to render these filters to front end templates and (eventually) add them to search results.
At the moment, only the backend mapping is supported by the module, front-end support comming soon...
This module is created and maintained by ilateral
- SilverStripe Framework 3.1.x
- Grid Field Extensions
Install this module either by downloading and adding to:
Then run: dev/build/?flush=all
Or alternativly add to your project's composer.json
Once installed, you can setup filters via the "Filters" tab in the CMS.
To be able to add filters to your objects, add the following to your _config.php
- YourObjectName is the name of the object you want to add filters to.
- RelationName is the name of the relation added to the FilterOption object (for example, "Products").
To be able to see a list of filtered objects from a controller, you need to add FilterableController to your controller classes. You can do this in either of the standard ways:
YourController: extensions: - FilterableController
Once a controller has been extended, it gains access to a "FilterMenu" and a "filterby" action.
The Filter Menu can be loaded into a template using the template variable:
This generates a menu of available filters and options
The "filterby" action returns a result set of objects, based on the relations you stipulate via Filterable::add().
These results are rendered into a template, you can overwrite this template in several ways.
Create a template called YourClassName_filterby.ss in your Layout This will allow you to create several different styled filters, depending on the controller.
Create a template called FilterBy.ss in your Layout directory.