Haben Sie jemals ein zentrales Backend-Modul geöffnet und gedacht: „Ich muss nur einen kleinen Button anpassen…“ – und dann ein Labyrinth von Overrides entdeckt? Sie sind nicht allein. Die Erweiterung des TYPO3-Backends, ohne Update-Pfade zu unterbrechen, hat Integratoren lange frustriert. In diesem Leitfaden lernen Sie, wie Sie TYPO3-Backend-Modulansichten mit modernen TYPO3-Fluid-Override-Techniken erweitern, wobei sowohl LTS v11 als auch die neue TYPO3 v12 Page TSConfig-Syntax behandelt werden. Am Ende werden Sie in der Lage sein, benutzerdefinierte Templates zu erstellen, die Kern-Updates überstehen.
Was sind TYPO3 Backend Fluid Templates?
TYPO3 Backend Fluid Templates sind spezielle Dateien, die in der Fluid-Templating-Sprache geschrieben sind und das Erscheinungsbild und Layout der TYPO3-Backend-Module steuern — die Admin-Oberfläche, die Redakteure und Integratoren zur Verwaltung von Websites verwenden.
Warum sollten TYPO3 Backend Templates überschrieben werden?
Es gibt drei starke Gründe, Backend-Templates zu überschreiben:
1. Benutzerdefinierte Benutzererfahrung
Machen Sie TYPO3 für Redakteure einfacher zu bedienen. Sie können den Designstil Ihres Kunden anpassen oder Ablenkungen von der Backend-Oberfläche entfernen.
2. Schnellere Workflows
Fügen Sie Abkürzungen, Schaltflächen oder zusätzliche Felder hinzu. Redakteure müssen nicht mehr 5 Mal klicken, um eine einfache Aufgabe zu erledigen.
3. Bessere Wartbarkeit
Es ist nicht notwendig, den Kern-PHP-Code neu zu schreiben. Überschreiben Sie einfach ein Template und halten Sie die Geschäftslogik an einem Ort. Einfacher zu verwalten, zu aktualisieren und zu debuggen.
Hochrangiger Workflow
- Kopieren Sie das Kern-Template, das Sie erweitern möchten, in Ihre eigene Erweiterung.
- Registrieren Sie den neuen Template-Pfad in Page TSConfig (v12) oder TSconfig (v11).
- Überarbeiten Sie Ihre Kopie — fügen Sie ViewHelpers, Tailwind-Klassen oder was auch immer Sie benötigen, hinzu.
- Caches leeren & aufwärmen; TYPO3 wählt automatisch den ersten passenden Pfad aus.
v12 LTS: die neue Page TSConfig templates.* Syntax
TYPO3 12 führte eine saubere, Composer-bewusste Zuordnung ein:
# EXT:mysite/Configuration/page.tsconfig
templates.typo3/cms-belog.1643293191 = vendor/myext:Resources/Private/Backend/BeLog
Was passiert?
- typo3/cms-belog – der Composer-Name der Kern-Erweiterung, die Sie anvisieren (belog).
- 1643293191 – ein stabiler Hash, der für jede Originalvorlage generiert wird; finden Sie ihn im Changelog oder über die Entwickler-Tools des Browsers.
- vendor/myext: – der Composer-Namespace Ihrer Erweiterung; TYPO3 löst den PSR-4-Pfad auf.
Dieser deklarative Ansatz übersteht Composer-Updates und macht Pfad-Arrays überflüssig. Es ist offiziell im 12.0 Feature-Changelog dokumentiert. (Feature: #96812 - Backend-Templates mit TSconfig überschreiben - TYPO3)
module.tx_belog.view {
partialRootPaths {
20 = EXT:myext/Resources/Private/Backend/BeLog/Partials/
}
templateRootPaths {
20 = EXT:myext/Resources/Private/Backend/BeLog/Templates/
}
}
Sie weisen höhere numerische Indizes zu (20), damit TYPO3 in Ihrer Erweiterung nach den Kernpfaden sucht (0, 10). Dies funktioniert immer noch in v11 eLTS, ist jedoch veraltet für v12+. (typo3 - beste Möglichkeit, ein Erweiterungstemplate zu überschreiben - Stack Overflow)
Vergleichsleitfaden für v11.5 vs v12+
TYPO3-Version | Bevorzugter Überschreibungsmechanismus | Beispielausschnitt | Vorteile | Höhlen |
≥ 12.0 | templates.<composer-name>.<hash> in Page TSConfig | siehe oben | Composer-nativ, update-sicher | Erfordert Template-Hash-Suche |
≤ 11.5 | module.tx_<ext>.view.*RootPaths Arrays | siehe oben | Vertraut, hash-frei | Veraltet; Array-Reihenfolge kann problematisch sein |
Anpassen des Linkvalidator-Berichts
Müssen Sie dem Linkvalidator-Modul eine Schaltfläche „Jetzt erneut prüfen“ hinzufügen?
1. Kopieren
EXT:linkvalidator/Resources/Private/Templates/Backend/Report.html
EXT:myext/Resources/Private/Backend/Linkvalidator/Report.html
templates.typo3/cms-linkvalidator.b24e79b8 = vendor/myext:Resources/Private/Backend/Linkvalidator
4.Ersetzen Sie den <f:link.action>-Block durch Ihren benutzerdefinierten Button.
Voilà—kein Core-Patching erforderlich. (Vorlagen — TypoScript erklärt 12.4 Dokumentation)
Hilfreiche Ressource für Sie
- Verbessern Sie Ihr TYPO3-Editor-UX – fortgeschrittene Backend-Tipps auf unserem T3Planet Blog
- Benötigen Sie maßgeschneiderte Module? Schauen Sie sich unseren TYPO3 Extension Development Service
Externe Referenzen
- Offizielles Backend-Vorlagen mit TSConfig überschreiben Änderungsprotokoll (TYPO3 12) (Feature: #96812 - Backend-Vorlagen mit TSconfig überschreiben - TYPO3)
- TYPO3 Core API: Backend-Module Leitfaden (Backend-Module — TYPO3 erklärt Hauptdokumentation)
Bereit, Ihr Backend-UX zu verbessern?
Wenn Sie praktische Hilfe bei der Implementierung von TYPO3-Backend-Erweiterungsstrategien oder beim Erstellen benutzerdefinierter Module benötigen, buchen Sie noch heute ein kostenloses Gespräch mit unseren TYPO3-Experten.
Viel Spaß beim Programmieren – und mögen Ihre Überschreibungen zukunftssicher bleiben!
Post a Comment