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 ist seit 2016 das meistgenutzte Framework für Custom Content Elements in TYPO3. Über 1.500 aktive Installationen (Stand: packagist, April 2026) und die Aufnahme in die offizielle TYPO3-Dokumentation als empfohlener Weg für individuelle Inhaltselemente belegen den Status als De-facto-Standard.

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 oder config/mask.json seit Mask 8). 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 den TYPO3-Standard vollständig 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 8 kommen JSON-native Felder und eine verbesserte API hinzu.

Fluid-Templates liegen standardmässig unter fileadmin/templates/mask/ 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). Keine weiteren Extensions nötig. 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 grosse TCA-Konfiguration. TYPO3 lädt diese bei jedem Backend-Aufruf. Lösung: Elemente sinnvoll gruppieren, nicht genutzte deaktivieren, Backend-Cache aktiv halten. Ab Mask 8 ist die TCA-Generierung deutlich performanter als in früheren Versionen.

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. In Mask 8.x ist dieses Verhalten stabiler als in 7.x.

Migration und Versions-Kompatibilität

Mask unterstützt TYPO3 v12 und v13 aktiv. Die aktuelle stabile Version (Mask 8.x) läuft auf beiden LTS-Releases. TYPO3 v11 wird durch Mask 7.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.

Ab TYPO3 v13 steht zusätzlich das native Content Block API zur Verfügung. Für bestehende Mask-Projekte bedeutet das keine Eile: Mask und Content Blocks koexistieren problemlos. Neue Projekte auf reinem TYPO3 v13 können abwägen, ob der native Ansatz 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össe ist optimal? Was passiert, wenn das Beschreibungsfeld leer bleibt? Mask unterstützt seit Version 7 Beschreibungstexte pro Feld, die im Backend als Tooltip 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.