Formlog für TYPO3

Warum jede dritte Kontaktanfrage in TYPO3 ohne Logging verloren geht

Kontaktformulare sind der wichtigste Lead-Kanal auf Unternehmenswebsites. Aber TYPO3s Form Framework speichert Eingaben standardmässig nicht in der Datenbank - es versendet nur E-Mails. Wenn der Mailserver ausfällt, das SPF-Record falsch konfiguriert ist oder der SMTP-Timeout zuschlägt, ist die Anfrage verloren. Kein Backup, keine Nachverfolgung, keine Analyse. Formlog schliesst diese Lücke, indem es jede Formulareingabe in der TYPO3-Datenbank protokolliert - unabhängig davon, ob die E-Mail-Zustellung erfolgreich war.

In der Praxis betrifft das mehr Unternehmen als vermutet: E-Mail-Zustellraten von Webservern liegen laut Studien zwischen 85% und 95%. Bei 100 Kontaktanfragen pro Monat bedeutet das 5 bis 15 verlorene Leads. Bei einem durchschnittlichen Lead-Wert von 500 EUR im B2B-Bereich summiert sich das auf 2.500 bis 7.500 EUR entgangenen Umsatz pro Monat.

Typische Einsatzszenarien

Absicherung gegen E-Mail-Ausfälle. Ein mittelständisches Unternehmen betreibt 3 Kontaktformulare auf seiner TYPO3-Website. Der SMTP-Server des Hosters hat am Wochenende für 6 Stunden einen Timeout. Ohne Formlog sind alle Anfragen in diesem Zeitraum verloren. Mit Formlog findet das Marketing-Team am Montag alle Eingaben im TYPO3-Backend vor und kann manuell nachfassen.

Compliance-Nachweis für DSGVO und ISO 27001. Unternehmen müssen nachweisen können, wann welche personenbezogenen Daten eingegangen sind und wann sie gelöscht wurden. Formlog speichert Eingaben mit Zeitstempel und bietet eine konfigurierbare automatische Löschung nach X Tagen. Für ISO-27001-Audits liefert das eine lückenlose Dokumentation der Datenverarbeitung.

Analyse des Eingabeverhaltens. Welche Felder werden häufig leer gelassen? Bei welchem Formular-Step brechen Nutzer ab? Formlog macht diese Daten im Backend sichtbar. Ein TYPO3-Integrator kann daraus Optimierungen ableiten, ohne ein externes Analytics-Tool für Formulare einzusetzen.

Technische Architektur

Formlog integriert sich als Finisher in das TYPO3 Form Framework (EXT:form). Jedes Formular, das einen Formlog-Finisher konfiguriert hat, schreibt seine Eingaben nach dem Submit in eine eigene Datenbanktabelle (tx_formlog_entries).

Die Architektur im Detail:

• Finisher-Integration: Formlog registriert einen eigenen Finisher-Typ, der in der YAML-Konfiguration des Form Frameworks hinzugefügt wird. Der Finisher läuft nach der Validierung und vor dem E-Mail-Finisher.
• Datenbank-Schema: Jede Eingabe wird als JSON-serialisiertes Array gespeichert, zusammen mit Metadaten (Zeitstempel, Formular-Identifier, Sprache, Seite).
• Backend-Modul: Formlog stellt ein eigenes Backend-Modul bereit, in dem Redakteure und Administratoren die protokollierten Eingaben filtern, durchsuchen und als CSV exportieren können.
• DSGVO-Löschung: Über eine Scheduler-Task werden Einträge nach einer konfigurierbaren Anzahl von Tagen automatisch gelöscht. Standard: 90 Tage.

Abhängigkeiten: Formlog setzt das TYPO3 Form Framework (EXT:form) voraus, das seit TYPO3 v8 zum Core gehört. Ältere Formular-Extensions wie Powermail oder Formhandler werden nicht unterstützt - dort ist das Logging jeweils nativ integriert. Die Datenbanktabelle benötigt je nach Formularvolumen nur wenig Speicherplatz: 1.000 Einträge mit durchschnittlich 10 Feldern belegen etwa 5 MB. Die automatische Löschung verhindert unkontrolliertes Tabellenwachstum.

Häufige Probleme und Lösungen

Problem: Formlog protokolliert nicht alle Formularfelder. Ursache: Der Formlog-Finisher muss nach dem Validierungs-Step konfiguriert sein, aber vor dem Redirect-Finisher. Wenn der Redirect zuerst greift, wird der Formlog-Finisher nicht mehr ausgeführt. Die Lösung: In der YAML-Konfiguration die Finisher-Reihenfolge prüfen - Formlog sollte an Position 1 stehen, vor E-Mail und Redirect.

Problem: Backend-Modul zeigt keine Einträge. Häufig ein Rechteproblem: Der Backend-User oder die Backend-Gruppe hat keinen Zugriff auf das Formlog-Modul. Die Lösung: In den Backend-Gruppen-Einstellungen das Modul formlog unter “Erlaubte Module” aktivieren. Zusätzlich muss der User Lesezugriff auf den Sys-Folder haben, in dem die Einträge gespeichert werden.

Problem: Automatische Löschung funktioniert nicht. Der TYPO3 Scheduler muss korrekt eingerichtet sein und regelmässig laufen (Cronjob alle 5 bis 15 Minuten). Ohne funktionierenden Scheduler wird die Lösch-Task nie ausgelöst. Auf Shared-Hosting-Umgebungen ist der Cronjob häufig nicht oder falsch konfiguriert. Prüfung im TYPO3-Backend unter System > Scheduler: Die Formlog-Cleanup-Task muss als aktiv gelistet sein und das “Letzte Ausführung”-Datum darf nicht älter als 24 Stunden sein.

Migration und Versions-Kompatibilität

Formlog wurde von Pagemachine (jetzt Teil von Undkonsorten) entwickelt und ist als Composer-Paket (pagemachine/typo3-formlog) verfügbar. Die Extension unterstützt TYPO3 v10 bis v12 LTS. Für TYPO3 v13 gibt es zum aktuellen Zeitpunkt noch keinen offiziellen Release, aber die Codebase basiert auf stabilen TYPO3-APIs (Form Framework Finisher, Extbase Repository Pattern), sodass die Kompatibilität mit überschaubarem Aufwand herstellbar ist.

Bei einem TYPO3-Upgrade von v10 auf v12 muss die Formlog-Konfiguration in den YAML-Formulardefinitionen geprüft werden. Das Form Framework hat in v11 die Finisher-Konfiguration leicht verändert (strikte Typisierung der Optionen). Ein Datenbank-Update über den Install Tool Upgrade Wizard ist in der Regel nicht nötig, da das Schema stabil geblieben ist.

Wer von Powermail auf das TYPO3 Form Framework migriert, verliert dabei das in Powermail integrierte Logging. Formlog ist der empfohlene Ersatz. Gosign migriert Formulare inklusive Logging-Konfiguration und stellt sicher, dass bestehende Daten nicht verloren gehen.

Ein Aspekt, den viele Projektteams übersehen: Formlog ist nicht nur ein Backup-Tool, sondern auch ein Audit-Werkzeug. Wenn ein Kunde behauptet, er habe vor 3 Wochen eine Anfrage gesendet, die nie beantwortet wurde, liefert Formlog den Beweis - entweder die Anfrage existiert mit Zeitstempel, oder sie wurde nie abgesendet. Für Unternehmen mit Service-Level-Agreements und Beschwerdemanagement ist das ein messbarer Vorteil, der die Installation in 10 Minuten rechtfertigt.