Built-in Filter Elements
All classes live in HeimrichHannot\FlareBundle\Filter\Element\ unless noted otherwise and are named after
their type with a FilterElement suffix (e.g. flare_bool → BooleanFilterElement).
"Form controls" are the Symfony form fields of the filter controls an editor can choose for the element; elements without a value class (or with the control left blank) are applied without a user-facing form field (intrinsic filters).
| Type | Backend label | Form controls | Purpose |
|---|---|---|---|
flare_archive | Archive | ChoiceType | Filter by parent archive (e.g. news archives). Without a control the value (any parent archive) is the restriction; with one, the parent whitelist provides the options. |
flare_bool | Boolean property value | CheckboxType | Filter on a boolean column. |
flare_calendar_current | Calendar time window | 2× DateType (from/to) | Time-window filter for calendar events, recurring-aware. |
flare_dateRange | Date range | 2× DateType (from/to) | Filter a date column by from/to values; either field can be disabled via the from_enabled/to_enabled config options. |
flare_dcaSelectField | DCA field options selection | ChoiceType | Choices from a DCA select field's options. |
flare_equation_simple | Simple equation | — | Intrinsic column <operator> value condition. |
flare_fieldValueChoice | DCA field value selection (beta) | ChoiceType | Choices from the distinct values of a column. |
flare_published | Published | — | Contao publish state incl. start/stop dates. |
flare_relation_belongsTo | Relation: Belongs to | — | Filter by a belongs-to (pid) relation, dynamic-ptable-aware. |
flare_search_keywords | Keyword search | TextType | Keyword search across configured columns. |
:::note Known limitation of flare_archive
Without a control, on a list whose data container has a dynamic parent table (e.g. tl_content), the backend value
field lists every record of every parent table.
:::
Each element translates its configuration into calls to reusable predicates, which build the actual query fragments.
Integration filter elements
Available when codefog/tags-bundle is installed
(classes in HeimrichHannot\FlareBundle\Integration\CodefogTags\FilterElement\):
| Type | Backend label | Form controls | Purpose |
|---|---|---|---|
cfg_tags_choice | Tags [codefog/tags-bundle] | ChoiceType | Filter by tags of the source field. |
cfg_tags_search | — | — | Keyword search across tag names — currently disabled (under development, hidden from the backend selection). |
To create your own filter element, see Developers / Custom Filter Elements.