oveleon / contao-be-field-dependency
Allows to control the output of DCA fields via a condition.
Installs: 74
Dependents: 1
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Type:contao-bundle
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ^4.9
Requires (Dev)
- contao/manager-plugin: ^2.0
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
README
In addition to palettes and sub-palettes, this extension adds a new field property (dependsOn
) for DCA's where conditions can be defined to display the field.
Condition based on another field and its value:
'field1' => [ 'exclude' => true, 'inputType' => 'checkbox', 'eval' => ['tl_class' => 'w50 m12'], 'sql' => "char(1) NOT NULL default '0'", ], 'field2' => [ 'exclude' => true, 'inputType' => 'text', 'eval' => ['maxlength'=>64, 'tl_class'=>'w50'], 'sql' => "varchar(64) NOT NULL default ''", 'dependsOn' => [ 'field1' => 1 // Displays this field only if the checkbox (field1) has been selected. ] ],
Condition based on another field and a custom callback:
'field2' => [ 'exclude' => true, 'inputType' => 'text', 'eval' => ['maxlength'=>64, 'tl_class'=>'w50'], 'sql' => "varchar(64) NOT NULL default ''", 'dependsOn' => [ 'field1' => static function($fieldName, $objModel) { // $fieldName = field1 // "field1" is automatically supplemented with the field evaluation "submitOnChange = true" (autoSubmit = true). // Return true = show / false = hide return $objModel->{$fieldName} == 1; } ] ],
With this variant, the specification of the field name to be reacted to is optional. Please note that the first parameter corresponds to the given key.
For example:
'field2' => [ 'exclude' => true, 'inputType' => 'text', 'eval' => ['maxlength'=>64, 'tl_class'=>'w50'], 'sql' => "varchar(64) NOT NULL default ''", 'dependsOn' => [ static function($fieldName, $objModel, &$arrEvaluationFields) { // $fieldName = 0 // 'field1' must be extended independently with the field evaluation 'submitOnChange = true' or added via the third parameter ($arrFields) (autoSubmit = true). $arrEvaluationFields[] = 'field1'; // Return true = show / false = hide return $objModel->field1 == 1; } ] ],
Multiple conditions:
'field1' => [ 'exclude' => true, 'inputType' => 'checkbox', 'eval' => ['tl_class' => 'w50 m12'], 'sql' => "char(1) NOT NULL default '0'", ], 'field2' => [ 'exclude' => true, 'inputType' => 'checkbox', 'eval' => ['tl_class' => 'w50 m12'], 'sql' => "char(1) NOT NULL default '0'", ], 'field3' => [ 'exclude' => true, 'inputType' => 'text', 'eval' => ['maxlength'=>64, 'tl_class'=>'w50'], 'sql' => "varchar(64) NOT NULL default ''", 'dependsOn' => [ 'field2' => 1, 'field3' => 1 // Both fields must be checked to display this field ] ],
Configuration
Basic settings must be maintained via the config/config.yml file.
contao_be_field_dependency: autoSubmit: true tables: - tl_article - tl_content - tl_files - tl_form_field - tl_form - tl_image_size_item - tl_image_size - tl_layout - tl_member_group - tl_member - tl_module - tl_opt_in - tl_page - tl_style - tl_style_sheet - tl_theme - tl_user_group - tl_user