t3skin for TYPO3

t3skin ist seit TYPO3 v7 obsolet, aber viele Installationen laufen noch auf Versionen, die es brauchen

t3skin war das Backend-Styling-Paket für TYPO3 v4 und v6. Es definierte Icons, Farben, Abstände und das gesamte Look-and-Feel des TYPO3-Backends. Ab TYPO3 v7 wurde das Backend-Styling in den Core integriert, t3skin als separate Extension wurde überflüssig. Trotzdem taucht t3skin in Bestandsanalysen regelmässig auf, weil es in alten Installationen installiert ist und beim Upgrade auf aktuelle TYPO3-Versionen Fehler verursacht. 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.

Typical use cases involve ausschliesslich Legacy-Installationen

Das einzige legitime Szenario für t3skin ist eine TYPO3-Installation auf Version 4.5 bis 6.2, 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, existiert t3skin während des Upgrade-Prozesses noch in der Extension-Liste, wird aber nach dem Upgrade deaktiviert und entfernt. In dieser Phase kann t3skin Konflikte mit dem neuen Backend-Styling verursachen, wenn es nicht rechtzeitig deinstalliert wird.

Ein drittes (Anti-)Szenario: Manche Administratoren haben t3skin in TYPO3 v7 oder v8 manuell installiert, weil sie das alte Backend-Design bevorzugten. Das funktionierte kurzfristig, erzeugte aber Darstellungsfehler, weil t3skin-CSS und Core-CSS sich widersprachen. Spätestens ab TYPO3 v9 ist das keine Option mehr.

Technical architecture 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_emconf.php, die es als System-Extension registrierte. Die gesamte Logik war visuell: Farben, Schriften, Abstände, Icons. Der TYPO3-Core renderte die Backend-Module, t3skin bestimmte nur, wie sie aussahen.

Ab TYPO3 v7 übernahm der Core diese Aufgabe selbst. Das Backend-Styling wurde in das System-Extension-Paket backend integriert. Icons wurden auf ein SVG-basiertes Icon-System umgestellt (IconFactory), CSS wurde auf Less und später auf SCSS migriert. t3skin konnte diese Änderungen nicht abbilden, weil es auf dem alten Sprite-basierten Icon-System basierte.

Common problems entstehen, wenn t3skin bei einem Upgrade nicht entfernt wird

Das häufigste Problem ist ein weisses oder kaputtes Backend nach einem TYPO3-Upgrade. Wenn t3skin in einer v12-Installation noch installiert ist, überschreibt es Core-CSS-Dateien mit veralteten Regeln. Das Ergebnis: Buttons ohne Hintergrund, Icons die nicht laden, Modul-Navigationen die nicht klickbar sind. Die Lösung: t3skin über den Extension Manager deinstallieren und die Tabellen-Einträge in sys_registry bereinigen. Wenn das Backend so kaput ist, dass der Extension Manager nicht erreichbar ist, hilft die Deaktivierung über die Kommandozeile: typo3/sysext/core/bin/typo3 extension:deactivate t3skin.

Zweites Problem: Verwaiste CSS-Dateien. Auch nach der Deinstallation von t3skin 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 nach der Entfernung 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: t3skin deinstallieren, alle Referenzen auf t3skin-CSS-Klassen in Custom Backend Modulen entfernen, und die IconFactory für Custom Icons nutzen. 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.