heimrichhannot/contao-be_explanation-bundle

This bundle offers a simple backend explanation form field (inputType).

2.4.0 2021-08-31 09:09 UTC

This package is auto-updated.

Last update: 2021-10-31 00:35:07 UTC


README

Build Status Coverage Status

Backend Explanation Bundle

This bundle offers a simple backend explanation form field (inputType).

Technical instructions

Just add the field to some of your data container arrays as follows:

$GLOBALS['TL_DCA']['tl_table']['fields']['myExplanation'] = [
    'inputType' => 'explanation',
    'eval'      => [
        'text'          => &$GLOBALS['TL_LANG']['tl_table']['explanation']['myExplanation'], // this is a string, not an array
        'text_callback' => [\AppBundle\EventListener\Dca\TableListener::class, 'onTextCallback'], // a callback to dynamical generate text
        'class'         => 'tl_info', // all contao message css classes are possible
        'tl_class'      => 'w50 long',
        'collapsible'   => true // If text is to long, if will be collapsed
    ]
];

Text Callback

The callback gets the $attributes array from the widget constructar as parameter, which containers the widget config and the current DataContainer.

Example:

public function textCallback(array $attributes): string {
    $dc = $attributes["dataContainer"];
    $text = $attributes["text"];
    return "My new text";
}