hschottm / contao-multitextwizard

1.4.2 2026-10-28 11:23 UTC

Requires

• php: ^8.3
• contao/core-bundle: ^5.7
• contao/manager-plugin: ^2.0

LGPL-3.0-or-later, CC-BY-NC-SA-4.0

• Helmut Schottmüller

• wizard
• bundle
• extension
• input
• multiple
• widget
• contao

Published on Packagist.org on 2026-10-28 11:26 UTC

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.

Release history

Contao 5.7 support

• Added support for Contao 5.7 and PHP 8.3 or newer.
• Preserved the multitextWizard input type and existing stored values.
• Migrated rendering to Twig, with escaped values, labels, button titles and error messages.
• Updated row controls to work after backend navigation and keep field names and IDs synchronized.
• Changed row editing so that changes are saved only when the backend form is submitted.
• Improved column validation: explicit settings take precedence regardless of option order, and uniqueness is checked after value normalization.
• Retained custom buttonTitles with German and English defaults.
• Updated row action icons to locally bundled SVGs.

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.