PHPackages                             netzmacht/contao-form-helper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. netzmacht/contao-form-helper

Abandoned → [netzmacht/contao-form-designer](/?search=netzmacht%2Fcontao-form-designer)ArchivedContao-bundle[Utility & Helpers](/categories/utility)

netzmacht/contao-form-helper
============================

Library for supporting customized Contao form rendering

1.0.8(9y ago)28.4k[2 issues](https://github.com/netzmacht-archive/contao-form-helper/issues)1LGPL-3.0+PHPPHP >=5.3

Since Mar 6Pushed 9y ago1 watchersCompare

[ Source](https://github.com/netzmacht-archive/contao-form-helper)[ Packagist](https://packagist.org/packages/netzmacht/contao-form-helper)[ RSS](/packages/netzmacht-contao-form-helper/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (2)Dependencies (7)Versions (29)Used By (1)

Contao Form Helper - Extended form rendering
============================================

[](#contao-form-helper---extended-form-rendering)

[![Build Status](https://camo.githubusercontent.com/550fb5ad8816a282e78eb444b930e45e64372b370077d33100dad8d6cef686bf/687474703a2f2f696d672e736869656c64732e696f2f7472617669732f6e65747a6d616368742f636f6e74616f2d666f726d2d68656c7065722f646576656c6f702e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/netzmacht/contao-form-helper)[![Version](https://camo.githubusercontent.com/21b15c5d650d0137f6ca6d40d2789c9f573bcc8b1e9d9394e69ea6e9edc6e131/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e65747a6d616368742f636f6e74616f2d666f726d2d68656c7065722e7376673f7374796c653d666c61742d737175617265)](http://packagist.com/packages/netzmacht/contao-form-helper)[![License](https://camo.githubusercontent.com/b626e1ba604939aa3a9732e9314390c587f7357ed2d04a0fd3219e86ca5ae61d/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e65747a6d616368742f636f6e74616f2d666f726d2d68656c7065722e7376673f7374796c653d666c61742d737175617265)](http://packagist.com/packages/netzmacht/contao-form-helper)[![Downloads](https://camo.githubusercontent.com/63fc53ea359d0d4b62933ff982ae609bf94bff9f205317c7805a7c4f2f8a003a/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e65747a6d616368742f636f6e74616f2d666f726d2d68656c7065722e7376673f7374796c653d666c61742d737175617265)](http://packagist.com/packages/netzmacht/contao-form-helper)[![Contao Community Alliance coding standard](https://camo.githubusercontent.com/5c83beb382413cbfa523bbea12d70d0723a803b3f7cbba029609ed1848dfa99b/687474703a2f2f696d672e736869656c64732e696f2f62616467652f6363612d636f64696e675f7374616e646172642d7265642e7376673f7374796c653d666c61742d737175617265)](https://github.com/contao-community-alliance/coding-standard)

This library provides extended form widget rendering for Contao frontend form widgets. By default the rendering of Contao forms widgets are not very customizable because of inline html rendering. Adjust output can be quite difficult.

Contao Form Helper provides an *event driven form rendering* which is fully backward compatible. This means that it supports the html output usually provided by Contao. Also every widgets from extension will work without any customizing.

Contao Form Helper renders the form in two steps. First it creates objects representing the HTML elements before passing them to the templates. Using the event driven interface it is possible to simply change attributes, provide extra features and so on.

Installation
------------

[](#installation)

To install the extension simply install `netzmacht/contao-form-helper` using the [Composer](http://c-c-a.org/ueber-composer) repository.

Changelog
---------

[](#changelog)

Changes between 0.x version and 1.x

- Change namespace of `Netzmacht\FormHelper` to `Netzmacht\Contao\FormHelper`
- Using a view object which is created instead of return an array of elements
- Simplify events (no select message event anymore)
- Introduce an attributes object for
- Drop supporting form messages handling

How it works
------------

[](#how-it-works)

By default this extension enables the extended form rendering for every form widget which is shipped with Contao. They are activated by customized form templates.

The helper creates a view object for each widget. The view contains:

- Attributes which can be used for a wrapper ``
- The form label
- Container including the element and by default the extra submit button
- Error messages
- Using a layout which is used to render

```