heimrichhannot/contao-form-fields-collection-bundle

A collection of additional form fields for contao form generator.

0.2.2 2026-07-01 07:20 UTC

Requires

• php: ^8.2
• contao/core-bundle: ^5.3
• symfony/http-kernel: ^6.4 || ^7.0

Requires (Dev)

• contao/contao-rector: dev-main
• contao/core-bundle: 5.3.*
• contao/manager-plugin: ^2.13
• phpstan/phpstan: ^2.2
• phpstan/phpstan-symfony: ^2.0
• rector/rector: ^2.5
• symplify/easy-coding-standard: ^13.2
• terminal42/contao-leads: ^3.2

LGPL-3.0-or-later

• Heimrich & Hannot

• Forms
• contao

Published on Packagist.org on 2026-07-01 07:21 UTC

README

This bundle adds additional form fields to the Contao form generator.

Fields

• Date/Time field - Field of html type date or time with native pickers (if supported by browser)
• Single Checkbox field - A single checkbox with a rich-text option label and configurable submitted value

Installation

Install the bundle via composer and update your database afterwards:

composer require heimrichhannot/contao-form-fields-collection-bundle

Usage

After install you'll find new form field types.

Date/Time field

Select the field type "Date/ time" and select the format (date or time).

Single Checkbox field

Select the field type "Checkbox Single". Then configure the checkbox label in the text field and, if needed, define a custom submitted value in the value field. If no value is set, the checkbox submits 1.

Like other Contao form fields, you can also mark the checkbox as mandatory and provide a help text.

Customize

The template is made to be customized. Following variables are available:

Variable	Description
option_wrapper_element	(string) Default 'span'
option_wrapper_attributes	(HtmlAttributes|null) The wrapper element attributes
checkbox_attributes	(HtmlAttributes|null) The checkbox element attributes
label_attributes	(HtmlAttributes|null) The label element attributes
error_wrapper_element	(string) Default 'p'
error_wrapper_attributes	(HtmlAttributes|null) The error wrapper element attributes

Example:

// Make it a bootstrap 5 one:
<?php
$this->extend('form_huh_single_checkbox');
$this->option_wrapper_element = 'div';
$this->option_wrapper_attributes = $this->attrs()->addClass('form-check')->mergeWith($this->wrapperElementAttributes);
$this->checkbox_attributes = $this->attrs()->addClass('form-check-input')->mergeWith($this->checkbox_attributes ?: []);
$this->label_attributes = $this->attrs()->addClass('form-check-label')->mergeWith($this->label_attributes);
?>

Tip

To make an overridden template like form_huh_single_checkbox_bs5.html5 the project default, create twig template to extend it:

{# contao/templates/twig/form_huh_single_checkbox.html.twig #}
{% extends '@Contao/form_huh_single_checkbox_bs5.html5' %}