netzmacht/contao-subforms

Contao extension for using sub forms.


Keywords
form, contao, form generator, sub form
License
LGPL-3.0+

Documentation

Subforms extension for Contao CMS form genrator

Build Status Version License Downloads Contao Community Alliance coding standard

Features

This extension provides an easy way to include fields of subforms into a main form. So it is easy to use some parts of a form again or structure huge forms with many field much better.

This extension provides full support for the multipage forms, conditionalformfield and leads extension provided by terminal42.

Important: Support of the efg is not tested and won't be offically supported.

Requirements

The extension requires at least Contao 3.3 and PHP 5.4

Install

This extension can be installed using composer:

$ php composer.phar require netzmacht/contao-subforms:~1.0

Usage

  1. Create the subforms you want to use in the main form. Please be aware that the field names are not prefixed. So they have to be unique in all subforms together!

  2. Create the main form and a new form element: subform

  3. If you use conao-leads the settings of the subform are ignored. You have to define them in the subform form element. Please be aware that if you use a master form which has to include all form elements which are used in the subforms.

  4. If you use the multi page form extension you should create the page breaks in the main form. Otherwise it's not guaranteed if it works.