Peter Adelmann, trilobit GmbH
Formulare sind das Herzstück der Interaktion auf jeder Website – vom einfachen Kontaktformular bis hin zu komplexen Konfiguratoren.
Doch wie holt man das Beste aus Contao heraus, ohne das Rad jedes Mal neu zu erfinden?
Das Fundament
Contao Core & Formulargenerator
Das Ökosystem
Nützliche Erweiterungen
Deep Dive
Spezial-Lösungen von trilobit
Daten & Benachrichtigung
Verarbeitung nach dem Absenden
Für Entwickler
Eigene Anwendungen & Hooks
Best Practices
Praxisbeispiele
Der integrierte Formulargenerator liefert bereits ein solides Grundgerüst – ohne zusätzliche Erweiterungen.
Contao stellt ein flexibles Sortiment zur Verfügung:
fieldset
text, textarea, password
select, radio, checkbox,
range, upload
captcha, hidden
submit
Eine gute User Experience beginnt im Frontend – aber die echte Kontrolle liegt auf dem Server.
Möglichkeiten der serverseitigen Validierung:
| Numerische Zeichen | Zahlen, Minus -, Punkt ., Leerzeichen _ |
|---|---|
| Alphabetische Zeichen | Buchstaben, Minus -, Punkt ., Leerzeichen _ |
| Alphanumerische Zeichen | Zahlen, Buchstaben, Minus -, Punkt ., Leerzeichen _ |
| Erweiterte alphanumerische Zeichen | alle Zeichen mit Ausnahme von: # / ( ) < = > |
| Datum | gem. globalen Datumsformat; z. B. d.m.Y *) |
| Uhrzeit | gem. globalen Uhrzeitformat; z. B. H:i *) |
| Datum, Uhrzeit | gem. globalen Datums- und Uhrzeitformats; z. B. l, j. M Y (H:i.s) *) |
| Telefonnummer | Zahlen, Plus +, Minus -, Schrägstrich /, runde Klammern ( ), Leerzeichen _ |
| E-Mail-Adresse | gültige E-Mail-Adresse |
| URL-Format | gültige URL |
| Absolute URL | absolute URL http:// oder https:// |
| Eigene | eigener regulärer Ausdruck |
Ein wirklich gutes Formular nimmt die Nutzer an die Hand und
schützt sich gleichzeitig selbst vor falschen Eingaben.
Für die vertiefende Recherche lohnt sich ein
Blick in das offizielle Benutzerhandbuch ;-)
Dort findet sich ein ausführliches, praxisnahes Kapitel rund um den Formulargenerator, mit allen Feldtypen und Validierungen Schritt für Schritt im Detail.
docs.contao.org/5.x/manual/de/formulargenerator/formularfelder/
Standard ist gut – Erweiterungen sind für spezielle Anforderungen oft die bessere Wahl.
Mehr Benutzerfreundlichkeit bei komplexen Formularen — Wenn Standard-Formulare an ihre Grenzen stoßen.
Statische Formulare in interaktive Abfragen verwandeln.
https://github.com/terminal42/contao-conditionalformfields
https://github.com/terminal42/contao-conditionalselectmenu
Manuelle Ländertabellen anlegen war gestern!
Komfortabler Datei-Upload mit Bild-Vorschau & Drag & Drop.
Formularoptionen direkt aus der Contao-Datenbank speisen.
https://github.com/trilobit-gmbh/contao-databaseformfieldoptions-bundle
Umfangreiche SPAM-Schutz-Mechanismen: Multi-Layer SPAM-Schutz.
Erweiterte Formular-Validierung direkt bei der Eingabe.
https://github.com/trilobit-gmbh/contao-formvalidation-bundle
CSRF Fehler; ungültiges Anfrage-Token?!
Zuverlässige Formulare vor maximalem Cache.
Ein Blick in die Contao Extensions lohnt sich immer!
Hier lässt sich gezielt nach passenden Formular-Modulen suchen: Ob mehrseitige Abfragen, digitale Signaturfelder, erweiterte Validierungen oder bedingte Anzeigen – die große Auswahl bietet für jeden Zweck die richtige Funktion.
Wenn Standard-Lösungen an ihre Grenzen stoßen, kommen spezialisierte Erweiterungen ins Spiel.
Maximale Flexibilität für komplexe Datenstrukturen.
https://github.com/trilobit-gmbh/contao-multiformgroup-bundle
Formular-Abläufe und Abhängigkeiten definieren. Intelligente Formular-Logik auf Basis der Contao-Mitgliederverwaltung.
Was passiert nach dem Klick auf „Senden"? Die richtige Verarbeitung ist entscheidend.
Speichere Formular-Daten ganz flexibel als Tabelleneinträge in deiner Datenbank – entweder als Ergänzung oder als Alternative zum E-Mail-Versand. Über die Zieltabelle ordnest du jedes Formularfeld der passenden Datenbankspalte zu und behältst so die volle Kontrolle über deine Daten.
Mit dieser Erweiterung speicherst du Contao-Formulardaten zentral als Leads – inklusive Unterstützung für mehrsprachige Formulare und Unterformulare.
E-Mail, SMS oder individuelle Kanäle: Flexible Benachrichtigungen einfach gelöst.
Alle Uploads automatisch in einem ZIP zusammenfassen.
terminal42/contao-fineuploader.
terminal42/notification_center.
Wenn es richtig individuell wird, lohnt sich der Blick in den Code.
Standard-Validierungen reichen oft nicht aus: Mit eigenen Validierungen stellst du sicher, dass eingegebene Daten exakt deinen Anforderungen entsprechen.
string $regexp,$input,\Contao\Widget $widget
\Contao\Widget $widget,string $formId,array $formData,\Contao\Form $form,
// src/EventListener/AddCustomRegexpListener.php
namespace App\EventListener;
use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;
use Contao\Widget;
#[AsHook('addCustomRegexp')]
class AddCustomRegexpListener
{
public function __invoke(string $regexp, $input, Widget $widget): bool
{
if ('foobar' !== $regexp) {
return false;
}
$foo = new bar($input);
if (!$foo->Verify()) {
$widget->addError($GLOBALS['TL_LANG']['ERR']['foobar']);
}
return true;
}
}
// contao/dca/tl_form_field.php
$GLOBALS['TL_DCA']['tl_form_field']['fields']['rgxp']['options'][] = 'foobar';
// contao/languages/en/tl_form_field.php
$GLOBALS['TL_LANG']['tl_form_field']['foobar'] = [
'foobar',
'Enter a valid foobar.'
];
// src/EventListener/ValidateFormFieldListener.php
namespace App\EventListener;
use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;
use Contao\Form;
use Contao\Widget;
#[AsHook('validateFormField')]
class ValidateFormFieldListener
{
public function __invoke(
Widget $widget,
string $formId,
array $formData,
Form $form
): Widget
{
if ('myform' !== $form->formID || 'foobar' !== $widget->name) {
return $widget;
}
$foo = new bar($input);
if (!$foo->Verify()) {
$widget->addError($GLOBALS['TL_LANG']['ERR']['foobar']);
}
return $widget;
}
}
Mit Submit-Hooks klinkst du dich nahtlos in den Prozess direkt nach dem Formularversand ein. Ob Daten an externe APIs übergeben, individuelle Datenbank-Einträge, ... Alles ist möglich.
array $submittedData,array $formData,array|null $files,
array $labels,Form $form
// src/EventListener/ProcessFormDataListener.php
namespace App\EventListener;
use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;
use Contao\Form;
#[AsHook('processFormData', priority: 100)]
class ProcessFormDataListener
{
public function __invoke(
array &$submittedData,
array $formData,
array|null $files,
array $labels,
Form $form
): void
{
// do somthing
}
}
Erzeuge individuelle Dokumente genau dann, wenn sie gebraucht werden. Ob strukturierte Excel-Tabellen (XLSX), bearbeitbare Word-Dokumente (DOCX) oder druckfertige PDFs: System- und Formulardaten in maßgeschneiderte Dokumente verwandeln.
Für die vertiefende Recherche lohnt sich ein
Blick in die offizielle Entwickler-Dokumentation ;-)
Dort findet sich ein ausführliches, praxisnahes Kapitel rund um Hooks Schritt für Schritt im Detail.
Theorie ist gut, Praxis ist besser. Reale Anwendungsfälle zeigen, wie die Werkzeuge ineinandergreifen.
Von Core bis Custom Code – für jede Anforderung das passende Werkzeug.
Beginne immer mit dem Core und steigere dich nur bei
Bedarf – das hält Projekte wartbar und schlank.
Contao bietet ein durchdachtes Formular-Ökosystem – vom einfachen Kontaktformular bis zum komplexen Konfigurator.
