t3skin dla TYPO3

t3skin nie istnieje od TYPO3 8.6, ale wiele instalacji wciąż działa na wersjach, które go potrzebują

Od TYPO3 4.0 do 8.5 t3skin był rozszerzeniem systemowym odpowiedzialnym za stylizację backendu. Definiował ikony, kolory, odstępy i całe wrażenie wizualne backendu TYPO3. Wraz z TYPO3 8.6 stylizacja backendu w całości przeszła do rozszerzenia systemowego backend, a t3skin został usunięty z core’a. Mimo to t3skin regularnie pojawia się w analizach stanu istniejącego, ponieważ jest zainstalowany w starych wdrożeniach, a odwołania do niego przy upgrade’ach do aktualnych wersji TYPO3 powodują błędy. Kto znajduje t3skin na liście rozszerzeń, ma jasny sygnał: ta instalacja jest albo przestarzała, albo nie została w pełni uporządkowana przy poprzednim upgrade.

Typowe scenariusze dotyczą wyłącznie instalacji legacy

Jedynym uprawnionym scenariuszem dla t3skin jest instalacja TYPO3 w wersji do 8.5, w praktyce najczęściej 4.5, 6.2 lub 7.6 LTS, której z przyczyn technicznych lub organizacyjnych nie można zaktualizować. W takich instalacjach t3skin dostarcza design backendu. Bez t3skin backend byłby wizualnie bezużyteczny: brakujące ikony, zepsute układy, nieczytelne formularze.

Drugim scenariuszem jest faza przejściowa podczas migracji. Gdy agencja migruje instalację TYPO3 v6 do v12, t3skin w etapach pośrednich do 7.6 pozostaje częścią core’a i znika wraz z aktualizacją do 8.7 LTS. Problemy mogą potem sprawiać własne dostosowania backendu oparte na t3skin.

Trzeci (anty-)scenariusz wynika z nieporozumienia: w TYPO3 v7 t3skin był obowiązkowym rozszerzeniem systemowym i dostarczał tam już nowy design backendu. Starego designu nie dało się nim przywrócić, a od TYPO3 8.6 t3skin w ogóle nie istnieje.

Architektura techniczna była pakietem CSS/ikon bez logiki biznesowej

t3skin nie był rozszerzeniem w klasycznym sensie (brak kontrolera, brak modelu, brak repozytorium). Składał się z plików CSS, sprite’ów ikon, kilku snippetów JavaScript dla interfejsu backendu i ext_tables.php, które rejestrowało go jako skórkę backendu. Rozszerzeniem systemowym był dlatego, że dostarczano go z core’em w katalogu typo3/sysext/. Cała logika była wizualna: kolory, czcionki, odstępy, ikony. Core TYPO3 renderował moduły backendu, t3skin decydował tylko, jak one wyglądają.

To zadanie przechodziło do core’a stopniowo: w TYPO3 7.0 CSS t3skin przeniesiono na Less, w 8.1 CSS backendu trafił do rozszerzenia systemowego “backend”, a w 8.6 t3skin usunięto. Równolegle v7 przestawiło ikony na system oparty na SVG (IconFactory), a CSS przemigrowano później na SCSS.

Częste problemy powstają, gdy odwołania do t3skin przetrwają upgrade

Najczęstszym problemem jest biały lub zepsuty backend po upgrade TYPO3. Samego t3skin nie da się w instalacji v12 w ogóle zainstalować; jeśli błąd ma związek z t3skin, to przez własne rozszerzenia lub dostosowania backendu, które wciąż wczytują pliki z EXT:t3skin. Rezultat: przyciski bez tła, ikony, które się nie ładują, nawigacja modułów, której nie da się klikać. Rozwiązanie: usunąć te odwołania i przejść na środki core’a. Gdy backend jest tak zepsuty, że Extension Manager nie jest dostępny, w klasycznej instalacji rozszerzenie będące przyczyną można wyłączyć przez wiersz poleceń: typo3/sysext/core/bin/typo3 extension:deactivate <extension-key>. W instalacjach Composer tego polecenia nie ma od TYPO3 11.4; tam rozszerzenie usuwa się przez Composer.

Drugi problem: osierocone pliki CSS. Również po upgradzie pliki CSS w fileadmin/ lub typo3temp/ mogą pozostać i być cache’owane przez przeglądarkę. Dlatego po upgradzie konieczne jest pełne wyczyszczenie cache (cache przeglądarki, cache TYPO3, cache CDN).

Trzeci temat: dostosowania backendu oparte na t3skin. Niektóre agencje pisały w TYPO3 v6 własny CSS backendu wykorzystujący klasy t3skin jako bazę. Po usunięciu t3skin takie dostosowania się rozpadają. Rozwiązanie: zmigrować własny CSS backendu na aktualne klasy CSS core’a.

t3skin nie ma ścieżki upgrade’u, migracja oznacza usunięcie

Nie istnieje aktualizacja t3skin do nowej wersji, ponieważ rozszerzenie nie ma następcy. Następcą jest sam core TYPO3. Migracja oznacza: usunąć wszystkie referencje do klas CSS t3skin w niestandardowych modułach backendu i wykorzystywać IconFactory dla własnych ikon. Sam t3skin znika wraz z aktualizacją core’a, nie trzeba go odinstalowywać. Gosign przeprowadza to porządkowanie w ramach każdej migracji TYPO3 i sprawdza przy okazji, czy w instalacji nie pozostały inne rozszerzenia legacy (css_styled_content, rtehtmlarea, adodb), które również trzeba usunąć.