Mask für TYPO3

Redakteure brauchen eigene Content-Elemente, nicht den nächsten Workaround mit Textfeldern

Jede TYPO3-Website erreicht den Punkt, an dem die mitgelieferten Content-Elemente nicht mehr reichen. Ein Team-Karussell, eine Preistabelle mit Toggles, ein Produkt-Teaser mit Bild, Text und CTA-Button - solche Anforderungen landen sonst im RTE als HTML-Brei oder in einem überfüllten Flexform-Container. Mask löst dieses Problem grundsätzlich: Redakteure bekommen eigene Backend-Masken mit genau den Feldern, die sie brauchen. Keine PHP-Klassen, kein TCA von Hand, kein ext_tables.sql.

Mask gehört seit Jahren zu den meistgenutzten Frameworks für Custom Content Elements in TYPO3. Über 1,7 Millionen Abrufe auf Packagist (Stand September 2026) und die Nennung in der offiziellen TYPO3-Dokumentation neben Content Blocks und DCE belegen die Verbreitung.

Typische Einsatzszenarien

Corporate Websites mit komplexen Seitenstrukturen. Marketing-Teams brauchen 15 bis 30 verschiedene Content-Elemente: Hero-Banner, Testimonials, Akkordeons, Tabbed Content, Downloads mit Vorschaubild, Kontaktkarten. Mask bildet jedes davon als eigenes Backend-Formular ab. Redakteure sehen nur die Felder, die zum jeweiligen Element gehören, keine Verwirrung durch irrelevante Optionen.

Mehrsprachige Projekte mit konsistenter Struktur. Mask-Elemente unterstützen die TYPO3-Übersetzungsmechanismen vollständig. Felder lassen sich als l10n_mode exclude (nicht übersetzbar) oder prefixLangTitle (übersetzbar mit Hinweis) konfigurieren. Bei Websites in 5+ Sprachen spart das Redaktionszeit, weil die Struktur identisch bleibt und nur der Inhalt übersetzt wird.

Relaunch-Projekte mit Bestandsdaten. Wer von einem alten System (WordPress, TYPO3 mit Gridelements oder TemplaVoilà) migriert, braucht saubere Content-Strukturen. Mask-Elemente lassen sich per mask_export als eigenständige Extension exportieren. Damit werden Content-Definitionen versionierbar und über CI/CD-Pipelines deploybar.

Technische Architektur

Mask speichert die Konfiguration aller Content-Elemente in einer einzigen JSON-Datei (mask.json, standardmäßig unter Configuration/Mask/ im Sitepackage). Diese Datei beschreibt Felder, Typen, Paletten und die Zuordnung zu Fluid-Templates. Beim Aktivieren oder Aktualisieren generiert Mask daraus die nötigen TCA-Konfigurationen und Datenbank-Felder automatisch.

Die Feldtypen decken die gängigen TYPO3-Typen ab: String, Integer, Float, RichText, Date, DateTime, File (FAL), Inline (IRRE für verschachtelte Strukturen), Select, Checkbox, Radio, Link, Slug, Color Picker, Tab, Palette. Seit Mask 7.1 lässt sich diese Konfiguration auch auf eine JSON-Datei je Element aufteilen.

Fluid-Templates liegen standardmäßig im Sitepackage unter Resources/Private/Mask/Frontend/Templates oder in einem konfigurierbaren Pfad. Jedes Content-Element hat ein eigenes Template, optional mit Partials und Layouts. Mask registriert die Elemente im New Content Element Wizard, inklusive Icon und Beschreibung.

Abhängigkeiten sind minimal: Mask benötigt nur den TYPO3 Core (v11, v12, v13 werden aktiv unterstützt). Für v12 und v13 sind keine weiteren Extensions nötig, für v11 bringt Mask 8.x fontawesome_provider als Abhängigkeit mit. Für den Export-Workflow kommt mask_export als optionale Ergänzung dazu.

Häufige Probleme und Lösungen

Feld-Änderungen auf Produktivsystemen. Wird ein Mask-Feld auf dem Staging-System geändert (Typ, Feldname), aber die Datenbank auf Production nicht aktualisiert, entstehen Fehler. Lösung: mask_export nutzen, damit Konfigurationsänderungen über Git und Deployment-Pipelines laufen. Alternativ: Database Compare im Install Tool nach jedem Deployment.

Performance bei vielen Content-Elementen. Websites mit 40+ verschiedenen Mask-Elementen erzeugen eine große TCA-Konfiguration. TYPO3 lädt diese bei jedem Backend-Aufruf. Lösung: Elemente sinnvoll gruppieren, nicht genutzte deaktivieren, Backend-Cache aktiv halten. Seit Mask 7.1 verarbeitet Mask die Konfiguration als Objekte statt als Arrays und damit deutlich schneller.

Verschachtelte Elemente (IRRE) und Sortierung. Inline-Relationen (z.B. Slider-Slides innerhalb eines Slider-Elements) verlieren bei Copy/Paste manchmal die Sortierung. Lösung: Sorting-Feld explizit definieren und im Fluid-Template <f:for> mit sortBy absichern. Nach jedem Mask-Update lohnt sich ein kurzer Test dieses Verhaltens.

Migration und Versions-Kompatibilität

Mask unterstützt TYPO3 v12 und v13 aktiv. Die aktuelle stabile Version (Mask 9.x) läuft auf beiden LTS-Releases. TYPO3 v11 wird durch Mask 8.x abgedeckt, erhält aber keine neuen Features mehr.

Für Projekte, die noch auf TemplaVoilà oder DCE setzen, bietet Mask einen klaren Migrationspfad. DCE-Elemente lassen sich manuell in Mask überführen: Felder in der Mask-GUI nachbauen, Fluid-Templates anpassen, Daten per SQL-Skript migrieren. Gosign hat diesen Prozess bei Projekten mit 20+ DCE-Elementen durchgeführt und den Aufwand je nach Komplexität auf 2 bis 5 Tage beziffert.

Für TYPO3 v13 und v14 gibt es zusätzlich die Extension Content Blocks (friendsoftypo3/content-blocks). Für bestehende Mask-Projekte bedeutet das keine Eile: Mask und Content Blocks koexistieren problemlos. Neue Projekte auf TYPO3 v13 oder v14 können abwägen, ob Content Blocks ausreicht oder Mask durch seine GUI und den Export-Workflow Vorteile bietet. Gosign berät projektspezifisch, welcher Ansatz den geringsten Wartungsaufwand langfristig verursacht.

Ein häufig unterschätzter Aspekt ist die Dokumentation. Mask-Elemente sind für Entwickler selbsterklärend (Felder, Typen, Templates), aber Redakteure brauchen Hilfestellungen: Welche Felder sind Pflicht? Welche Bildgröße ist optimal? Was passiert, wenn das Beschreibungsfeld leer bleibt? Mask unterstützt seit Version 7 Beschreibungstexte pro Feld, die im Backend unter dem Feldnamen erscheinen. Gosign erstellt zusätzlich ein internes Redaktionshandbuch pro Projekt, in dem jedes Mask-Element mit Screenshot, Feldbeschreibung und Best Practices dokumentiert ist. Der Aufwand liegt bei einer halben Stunde pro Element, spart aber Rückfragen im Betrieb.

Für die initiale Einrichtung eines Mask-Projekts mit 15 bis 20 Content-Elementen kalkuliert Gosign 3 bis 5 Entwicklungstage, inklusive Fluid-Templates, Backend-Preview und mask_export-Konfiguration. Einzelne neue Elemente im laufenden Betrieb sind in 1 bis 4 Stunden umgesetzt, je nach Komplexität der Verschachtelung und des Template-Designs. Für Agenturen, die Mask als Standard in allen Kundenprojekten einsetzen, lohnt sich eine Bibliothek wiederverwendbarer Mask-Elemente: Basis-Teaser, Akkordeon, Tab-Container und Hero-Banner, die per mask_export als Composer-Paket in neue Projekte eingebunden werden.