A Contao CMS bundle for building filterable lists and detail pages — for news, events, or any DCA-based entity.
Note
Flare is a work in progress. We are actively working on it and will release updates regularly.
- Filter and list entities (e.g. news, events, or any generic data-container)
- Ease of use:
- Only one place to manage list and filter configurations
- Only two content elements (a list view with filter, and a reader)
- Filter forms created and displayed using Symfony Forms
- Pagination included (not based on Contao's pagination, this one is actually good!)
- Individual detail views (readers) using the Contao standard
auto_itemfeature - Batteries-included: Comes with a set of predefined filter and list types
- Customizable filter and list templates
- Extensible with custom filter and list types
- No modules, no worries!
Install the bundle via Composer, then update your database:
composer require heimrichhannot/contao-flare-bundleRequires Contao ^4.13 or ^5.0 and PHP ^8.2.
- Create a new list configuration in the Contao backend under "Layout" → "Lists FLARE"
- Each list is an archive of filter elements: add filters as children to the list configuration
- Add a list view content element to a page and select the list configuration
- Add a reader content element to a separate page and select the list configuration
- Select the reader page in the list configuration
- Profit!
Each filter element type specifies its own configuration options. The following options are available for all filter types:
- Title: A title that should briefly describe the filter and is shown in the backend listings.
- Type: The filter element type to use.
- Intrinsic: If checked, the filter is always applied to the list view and not visible in the form shown to the user.
- Published: If unchecked, the filter is not shown in the form and not applied when filtering the list view.
- Each filter has an "intrinsic" option, which means that the filter is always applied to the list view and not visible in the form shown to the user.
- A filter that has intrinsic unchecked is shown in the form and can be used by the user to filter the list view.
- Some filters can only be intrinsic, e.g. the "published" filter. Under the hood, these filters do not specify a Symfony FormType.