README

contao-multitextwizard

Contao backend widget for text list input

contao-multitextwizard is a backend widget that can be used to add and edit an array of text input fields to Contao backend forms.

Use in the data container array (DCA)

'authors' => array
(
  'label'                   => &$GLOBALS['TL_LANG']['tl_extension']['authors'],
  'inputType'               => 'multitextWizard',
  'save_callback'           => array(array('tl_extension', 'saveAuthors')),
  'load_callback'           => array(array('tl_extension', 'loadAuthors')),
  'eval'                    => 
    array(
      'mandatory' => false, 
      'doNotSaveEmpty'=>true, 
      'style' => 'width: 100%;', 
      'columns' => array
      (
        array
        (
          'label' => &$GLOBALS['TL_LANG']['tl_extension']['firstname'],
          'width' => '180px'
        ),
        array
        (
          'label' => &$GLOBALS['TL_LANG']['tl_extension']['lastname'],
        )
      ),
      'buttonTitles' => array(
        'rnew' => $GLOBALS['TL_LANG']['tl_extension']['buttontitle_author_new'], 
        'rcopy' => $GLOBALS['TL_LANG']['tl_extension']['buttontitle_author_copy'], 
        'rdelete' => $GLOBALS['TL_LANG']['tl_extension']['buttontitle_author_delete']
      )
    ),
  'sql'                     => "blob NULL"
),

The Contao Manager registers the bundle and the multitextWizard input type automatically. After adding a field that requires a database column, update the database using the Contao Manager or vendor/bin/contao-console contao:migrate.

The widget stores rows with zero-based column indexes. The columns option accepts a column-definition array or a positive column count; labels can supply separate labels. Column options include label, name (CSS class), mandatory, rgxp, unique, maxlength, width and style. Explicit column settings override global defaults.

Changelog

See CHANGELOG.md for changes grouped by release tag.

Updating existing installations

Custom .html5 template overrides must be converted to Twig. The supplied template is be_multitext.html.twig. JavaScript must be enabled to edit rows.

Credits

Row action icons are from Lucide 0.468.0. License notices are included in src/Resources/public/icons/lucide/LICENSE.

License

This extension is licensed under the GNU Lesser General Public License, version 3 or (at your option) any later version (LGPL-3.0-or-later). See LICENSE.

Bundled third-party assets retain their respective licenses and copyright notices.

Package icon

The scalable logo.svg combines six input fields in two columns with a magic wand and sparkle on an anthracite background with an orange corner. For display in the Contao Manager, the logo is maintained separately in contao/package-metadata under meta/hschottm/contao-multitextwizard/logo.svg.