tritum/repeatable-form-elements

Adds a new form element which allows the editor to create new container elements with any type fields in them. In the frontend, a user can create any number of new containers. This is an extension for TYPO3 CMS.

5.0.0 2024-12-03 12:55 UTC

Requires

• typo3/cms-core: ^12.4 || ^13.4
• typo3/cms-extbase: ^12.4 || ^13.4
• typo3/cms-form: ^12.4 || ^13.4

GPL-2.0-or-later

• Ralf Zimmermann
• Falko Linke
• Elias Häußler
• Christian Seyfferth

README

Custom form element "Repeatable container"

This TYPO3 extension adds a custom form element "Repeatable container" to the TYPO3 form framework. It displays one/ a set of fields which can be duplicated and removed if desired. Any existing validation is copied as well. All form finishers will be aware of the copied field(s).

Preferred installation

1. Require the extension via composer.
2. Add the site set tritum/form-element-linked-checkbox to the dependencies of your site packages site set (TYPO3 v13). Or add the static TypoScript configuration to your TypoScript template (TYPO3 v12 and TYPO3 v13).

Usage

Open the TYPO3 form editor and create a new form/ open an existing one. Add a new element to your form. The modal will list the new custom form element "Repeatable container".

Add the desired fields with the favored validators to the "Repeatable container".

The frontend will render the "Repeatable container" as fieldset. In addition to the included form elements it will display buttons for copying/ removing new sets of fields.

The newly implemented extended version of SaveToDatabaseFinisher can be used as seen here.

Configuration

To deactivate the copying of variants, the feature repeatableFormElements.copyVariants can be used

Extendability

The following options can be used to extend the behavior when copying.

Credits

This TYPO3 extension was created by Ralf Zimmermann (https://dreistrom.land).

Thank you

Nora Winter - "Faktenkopf" at www.faktenhaus.de - sponsored this great extension. The fine people at www.b13.de connected all the people involved.

Elias Häußler - haeussler.dev - for helping with TYPO3v11 compatability and providing the beautiful TYPO3 badges. Use them. Give him some kudos!

Uwe - Hawkeye1909 - for removing jQuery as dependency.

Alexander Opitz @ extrameile-gehen.de - for his work on saving repeatable elements to database.

especially to all others who have contributed to the improvement of the extension.