t3skin dla TYPO3

t3skin jest przestarzały od TYPO3 v7, ale wiele instalacji wciąż działa na wersjach, które go potrzebują

t3skin był pakietem stylizacji backendu dla TYPO3 v4 i v6. Definiował ikony, kolory, odstępy i całe wrażenie wizualne backendu TYPO3. Od TYPO3 v7 stylizacja backendu została zintegrowana z core’em, t3skin jako osobne rozszerzenie stał się zbędny. Mimo to t3skin regularnie pojawia się w analizach stanu istniejącego, ponieważ jest zainstalowany w starych wdrożeniach i przy upgrade’ach do aktualnych wersji TYPO3 powoduje 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 od 4.5 do 6.2, 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 podczas procesu upgrade’u wciąż istnieje na liście rozszerzeń, ale po upgrade jest dezaktywowany i usuwany. W tej fazie t3skin może powodować konflikty z nową stylizacją backendu, jeśli nie zostanie odinstalowany na czas.

Trzeci (anty-)scenariusz: niektórzy administratorzy ręcznie instalowali t3skin w TYPO3 v7 lub v8, ponieważ preferowali stary design backendu. Działało to krótkoterminowo, ale generowało błędy wyświetlania, bo CSS t3skin i CSS core’a wzajemnie się nadpisywały. Najpóźniej od TYPO3 v9 nie jest to już opcja.

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_emconf.php, które rejestrowało go jako rozszerzenie systemowe. Cała logika była wizualna: kolory, czcionki, odstępy, ikony. Core TYPO3 renderował moduły backendu, t3skin decydował tylko, jak one wyglądają.

Od TYPO3 v7 core sam przejął to zadanie. Stylizacja backendu została zintegrowana z pakietem rozszerzeń systemowych “backend”. Ikony przeniesiono na system oparty na SVG (IconFactory), CSS przemigrowano na Less, a później na SCSS. t3skin nie był w stanie odwzorować tych zmian, ponieważ opierał się na starym systemie ikon opartym na sprite’ach.

Częste problemy powstają, gdy t3skin nie jest usuwany przy upgrade

Najczęstszym problemem jest biały lub zepsuty backend po upgrade TYPO3. Gdy t3skin jest wciąż zainstalowany w instalacji v12, nadpisuje pliki CSS core’a przestarzałymi regułami. Rezultat: przyciski bez tła, ikony, które się nie ładują, nawigacja modułów, której nie da się klikać. Rozwiązanie: odinstalować t3skin przez Extension Manager i wyczyścić wpisy w sys_registry. Gdy backend jest tak zepsuty, że Extension Manager nie jest dostępny, pomaga dezaktywacja przez wiersz poleceń: typo3/sysext/core/bin/typo3 extension:deactivate t3skin.

Drugi problem: osierocone pliki CSS. Również po deinstalacji t3skin pliki CSS w fileadmin/ lub typo3temp/ mogą pozostać i być cache’owane przez przeglądarkę. Po usunięciu 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: odinstalować t3skin, usunąć wszystkie referencje do klas CSS t3skin w niestandardowych modułach backendu i wykorzystywać IconFactory dla własnych ikon. 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ąć.