heimrichhannot/contao-entity_filter

This module offers an input type for selecting one or more entities by comfortably 'clicking together' sql-like conditions.

1.1.3 2017-06-27 15:22 UTC

Requires

• php: ~5.4 || ~7.0
• contao-community-alliance/composer-plugin: ~2.4 || ~3.0
• contao/core-bundle: ^3.5.1 || ~4.1
• heimrichhannot/contao-field_value_copier: ~1.0
• heimrichhannot/contao-haste_plus: ^1.5
• heimrichhannot/contao-list_widget: ~2.0
• heimrichhannot/contao-multi_column_editor: ~1.0

LGPL-3.0+

• Heimrich & Hannot

• filter
• selector
• entity
• select
• contao

README

This module offers an input type for selecting one or more entities by comfortably "clicking together" sql-like conditions.

Features

• "click together" conditions for filtering (aka selecting) arbitrary contao entities
• load existing filter conditions from other records
• display a result list of your filtering right in the contao record's edit view

Technical instructions

This module offers 3 comfortable different functions for adding the widgets mentioned before right to your dca.

Note: Of course, you can also copy these 3 functions and customize them if they don't suit your needs

Add the entity filter widget to your dca:

\HeimrichHannot\EntityFilter\Backend\EntityFilter::addFilterToDca(
    // the name of the field
    'memberConditions',
    // your dca
    'tl_md_recipient_list',
    // the table to be filtered
    'tl_member'
);

Add a field for copying entity filters from other records:

\HeimrichHannot\EntityFilter\Backend\EntityFilter::addFilterCopierToDca(
    // the name of the field
    'filterCopier',
    // your dca
    'tl_recipient_list',
    // the dca where the field values are situated you want to copy (usually the same as your dca)
    'tl_recipient_list',
    // the entity_filter field
    'memberConditions',
    // a custom options_callback -> if left out, array('HeimrichHannot\FieldValueCopier\Backend\FieldValueCopier', 'getOptions') is used
    array('Namespace\SomeClass', 'getOptions')
);

Add a live-reloaded table for showing the results of your conditions:

\HeimrichHannot\EntityFilter\Backend\EntityFilter::addListToDca(
    // the name of the field
    'memberList',
    // your dca
    'tl_recipient_list',
    // the entity_filter field
    'memberConditions',
    // the table being filtered
    'tl_member',
    // the header fields of the table
    array(
        'title',
        'firstname',
        'lastname',
        'email',
    )
);