heimrichhannot/contao-be_explanation-bundle

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

2.5.0 2024-03-11 08:17 UTC

Requires

• php: ^7.4 || ^8.0
• contao/core-bundle: ^4.13 || ^5.0

Replaces

• heimrichhannot/contao-be_explanation: *

LGPL-3.0-or-later

• Heimrich & Hannot

• backend
• developer
• field
• contao
• explanation

README

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:

use AppBundle\EventListener\Dca\TableListener;

$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' => [TableListener::class, 'onTextCallback'], // a callback to dynamical generate text. Can also be a callable.
        '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 constructor 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";
}