TYPO3-Backend-Layouts mit Fluid-Templates erweitern.

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 (010). 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-VersionBevorzugter ÜberschreibungsmechanismusBeispielausschnittVorteileHöhlen
≥ 12.0templates.<composer-name>.<hash> in Page TSConfigsiehe obenComposer-nativ, update-sicherErfordert Template-Hash-Suche
≤ 11.5module.tx_<ext>.view.*RootPaths Arrayssiehe obenVertraut, hash-freiVeraltet; 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

2. Platzieren Sie es bei 

EXT:myext/Resources/Private/Backend/Linkvalidator/Report.html

3. Im Page TSConfig registrieren (v12):

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

 

Externe Referenzen

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

×

    Got answer to the question you were looking for?