heimrichhannot / contao-flare-bundle
Filter, list, and read entities with this bundle for Contao Open Source CMS.
Package info
github.com/heimrichhannot/contao-flare-bundle
Type:contao-bundle
pkg:composer/heimrichhannot/contao-flare-bundle
Requires
- php: ^8.2
- ext-mbstring: *
- composer/semver: ^3.4
- contao/core-bundle: ^4.13 || ^5.0
- doctrine/dbal: ^2.13 || ^3.0
- mvo/contao-group-widget: ^1.5
- psr/log: ^1.0 || ^2.0 || ^3.0
- symfony/config: ^5.4 || ^6.0
- symfony/dependency-injection: ^5.4 || ^6.0
- symfony/event-dispatcher-contracts: ^1.0 || ^2.0 || ^3.0
- symfony/filesystem: ^5.4 || ^6.0
- symfony/form: ^5.4 || ^6.0
- symfony/http-foundation: ^5.4 || ^6.0
- symfony/http-kernel: ^5.4 || ^6.0
- symfony/options-resolver: ^5.4 || ^6.0
- symfony/property-access: ^5.4 || ^6.0
- symfony/property-info: ^5.4 || ^6.0
- symfony/serializer: ^5.4 || ^6.0
- symfony/string: ^5.2 || ^6.0
- symfony/validator: ^5.4 || ^6.0
- twig/twig: ^3.0
Requires (Dev)
- contao/manager-plugin: ^2.0
- contao/test-case: ^4.0 || ^5.0
- heimrichhannot/contao-test-utilities-bundle: ^0.1
- php-coveralls/php-coveralls: ^2.0
- phpstan/phpstan: ^1.10
- phpstan/phpstan-symfony: ^1.2
- phpunit/phpunit: ^8.0 || ^9.0
- symfony/phpunit-bridge: ^5.4 || ^6.0
Suggests
- codefog/tags-bundle: FLARE integrates with Codefog Tags Bundle for tag-based filtering on any data container.
- contao/calendar-bundle: FLARE can be used to filter and list calendar events.
- dev-main
- 0.1.0-alpha.15
- 0.1.0-alpha.14
- 0.1.0-alpha.13
- 0.1.0-alpha.12
- 0.1.0-alpha.11
- 0.1.0-alpha.10
- 0.1.0-alpha.9
- 0.1.0-alpha.8
- 0.1.0-alpha.7
- 0.1.0-alpha.6
- 0.1.0-alpha.5
- 0.1.0-alpha.4
- 0.1.0-alpha.3
- 0.1.0-alpha.2
- 0.1.0-alpha.1
- 0.1.0-alpha.0
- 0.0.34
- 0.0.33
- 0.0.32
- 0.0.31
- 0.0.30
- 0.0.29.1
- 0.0.29
- 0.0.28
- 0.0.27
- 0.0.26
- 0.0.25
- 0.0.24
- 0.0.23
- 0.0.22
- 0.0.21
- 0.0.20
- 0.0.19
- 0.0.18
- 0.0.17
- 0.0.16
- 0.0.15
- 0.0.14
- 0.0.13
- 0.0.12
- 0.0.11
- 0.0.10
- 0.0.9
- 0.0.8
- 0.0.7
- 0.0.6
- 0.0.5
- 0.0.4
- 0.0.3
- 0.0.2
- 0.0.1
- dev-feat/phpstan
- dev-feat/contao-5.7-support
- dev-feat/refactor-abstraction
- dev-support/0.0.29
- dev-history/0.0
- dev-history/0.0.34
- dev-history/v00
- dev-support/0.0.34
- dev-feat/callbacks-to-symfony-events
This package is auto-updated.
Last update: 2026-04-02 17:26:12 UTC
README
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.
Features
- 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!
Installation
Install the bundle via Composer, then update your database:
composer require heimrichhannot/contao-flare-bundle
Requires Contao ^4.13 or ^5.0 and PHP ^8.2.
Basic Usage
- 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!
Filter Configuration
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.
What is intrinsic?
- 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.