t3skin für TYPO3

t3skin gibt es seit TYPO3 8.6 nicht mehr, aber viele Installationen laufen noch auf Versionen, die es brauchen

t3skin war von TYPO3 4.0 bis 8.5 die System-Extension für das Backend-Styling. Es definierte Icons, Farben, Abstände und das gesamte Look-and-Feel des TYPO3-Backends. Mit TYPO3 8.6 ging das Backend-Styling vollständig in die System-Extension backend über, t3skin wurde aus dem Core entfernt. Trotzdem taucht t3skin in Bestandsanalysen regelmäßig auf, weil es in alten Installationen installiert ist und Verweise darauf beim Upgrade auf aktuelle TYPO3-Versionen Fehler verursachen. Wer t3skin in seiner Extension-Liste findet, hat ein klares Signal: Diese Installation ist entweder veraltet oder wurde bei einem früheren Upgrade nicht vollständig aufgeräumt.

Typische Einsatzszenarien betreffen ausschließlich Legacy-Installationen

Das einzige legitime Szenario für t3skin ist eine TYPO3-Installation auf einer Version bis 8.5, in der Praxis meist 4.5, 6.2 oder 7.6 LTS, die aus technischen oder organisatorischen Gründen nicht aktualisiert werden kann. In solchen Installationen liefert t3skin das Backend-Design. Ohne t3skin wäre das Backend visuell unbrauchbar: fehlende Icons, kaputte Layouts, unlesbare Formulare.

Ein zweites Szenario ist die Übergangsphase während einer Migration. Wenn eine Agentur eine TYPO3-v6-Installation auf v12 migriert, bleibt t3skin in den Zwischenstufen bis 7.6 Teil des Core und verschwindet mit dem Update auf 8.7 LTS. Was danach Probleme machen kann, sind eigene Backend-Anpassungen, die auf t3skin aufbauen.

Ein drittes (Anti-)Szenario beruht auf einem Missverständnis: In TYPO3 v7 war t3skin eine Pflicht-System-Extension und lieferte dort bereits das neue Backend-Design aus. Ein altes Backend-Design ließ sich damit nicht zurückholen, und ab TYPO3 8.6 gibt es t3skin gar nicht mehr.

Technische Architektur war ein CSS/Icon-Paket ohne Geschäftslogik

t3skin war keine Extension im klassischen Sinne (kein Controller, kein Model, kein Repository). Es bestand aus CSS-Dateien, Icon-Sprites, ein paar JavaScript-Snippets für die Backend-Oberfläche und einer ext_tables.php, die es als Skin für das Backend registrierte. System-Extension war es, weil es mit dem Core unter typo3/sysext/ ausgeliefert wurde. Die gesamte Logik war visuell: Farben, Schriften, Abstände, Icons. Der TYPO3-Core renderte die Backend-Module, t3skin bestimmte nur, wie sie aussahen.

Diese Aufgabe wanderte schrittweise in den Core: Mit TYPO3 7.0 wurde das CSS von t3skin auf Less umgestellt, mit 8.1 zog das Backend-CSS in die System-Extension backend um, mit 8.6 wurde t3skin entfernt. Parallel stellte v7 die Icons auf ein SVG-basiertes Icon-System um (IconFactory), CSS wurde später auf SCSS migriert.

Häufige Probleme entstehen, wenn Verweise auf t3skin ein Upgrade überdauern

Das häufigste Problem ist ein weißes oder kaputtes Backend nach einem TYPO3-Upgrade. t3skin selbst lässt sich in einer v12-Installation gar nicht installieren; hängt der Fehler mit t3skin zusammen, dann über eigene Extensions oder Backend-Anpassungen, die noch Dateien aus EXT:t3skin einbinden. Das Ergebnis: Buttons ohne Hintergrund, Icons die nicht laden, Modul-Navigationen die nicht klickbar sind. Die Lösung: diese Verweise entfernen und auf die Mittel des Core umstellen. Wenn das Backend so kaputt ist, dass der Extension Manager nicht erreichbar ist, lässt sich die verursachende Extension in einer klassischen Installation über die Kommandozeile deaktivieren: typo3/sysext/core/bin/typo3 extension:deactivate <extension-key>. In Composer-Installationen gibt es diesen Befehl seit TYPO3 11.4 nicht mehr, dort wird die Extension über Composer entfernt.

Zweites Problem: Verwaiste CSS-Dateien. Auch nach dem Upgrade können CSS-Dateien in fileadmin/ oder typo3temp/ zurückbleiben, die der Browser cached. Ein vollständiger Cache-Clear (Browser-Cache, TYPO3-Cache, CDN-Cache) ist deshalb nach dem Upgrade nötig.

Drittes Thema: Backend-Anpassungen, die auf t3skin aufbauen. Manche Agenturen haben in TYPO3 v6 Custom Backend CSS geschrieben, das t3skin-Klassen als Basis nutzt. Nach der Entfernung von t3skin brechen diese Anpassungen. Die Lösung: Custom Backend CSS auf die aktuellen Core-CSS-Klassen migrieren.

t3skin hat keinen Upgrade-Pfad, die Migration bedeutet Entfernung

Es gibt kein Update von t3skin auf eine aktuelle Version, weil die Extension keinen Nachfolger hat. Der Nachfolger ist der TYPO3-Core selbst. Die Migration bedeutet: alle Referenzen auf t3skin-CSS-Klassen in Custom Backend Modulen entfernen und die IconFactory für Custom Icons nutzen. t3skin selbst verschwindet mit dem Core-Update, deinstallieren muss man es nicht. Gosign führt diese Bereinigung im Rahmen jeder TYPO3-Migration durch und prüft dabei, ob weitere Legacy-Extensions (css_styled_content, rtehtmlarea, adodb) in der Installation verblieben sind, die ebenfalls entfernt werden müssen.