t3skin para TYPO3

O t3skin não existe mais desde o TYPO3 8.6, mas muitas instalações ainda rodam versões que dependem dele

Do TYPO3 4.0 ao 8.5, o t3skin foi a extensão de sistema responsável pelo estilo do backend. Ele definia ícones, cores, espaçamentos e toda a aparência do backend. Com o TYPO3 8.6, esse estilo passou inteiro para a extensão de sistema backend, e o t3skin foi removido do core. Mesmo assim, ele aparece com frequência em análises de instalações existentes, porque continua instalado em sistemas antigos, e as referências a ele causam erros no upgrade para versões atuais do TYPO3. Quem encontra o t3skin na lista de extensões recebe um sinal claro: essa instalação está desatualizada ou não foi totalmente limpa num upgrade anterior.

Só instalações legadas têm motivo para manter o t3skin

O único cenário legítimo para o t3skin é uma instalação do TYPO3 numa versão até a 8.5, na prática quase sempre 4.5, 6.2 ou 7.6 LTS, que, por motivos técnicos ou organizacionais, não pode ser atualizada. Nessas instalações, o t3skin fornece o visual do backend. Sem ele, o backend ficaria visualmente inutilizável: ícones faltando, layouts quebrados, formulários ilegíveis.

O segundo cenário é a fase de transição durante uma migração. Quando uma agência migra uma instalação TYPO3 v6 para o v12, o t3skin continua fazendo parte do core nas etapas intermediárias até a 7.6 e desaparece com o update para a 8.7 LTS. O que pode dar problema depois são personalizações próprias do backend construídas sobre o t3skin.

Um terceiro cenário, que na verdade é um contraexemplo, nasce de um mal-entendido: no TYPO3 v7, o t3skin era uma extensão de sistema obrigatória e já trazia ali o novo visual do backend. Com ele não dava para recuperar um visual antigo, e a partir do TYPO3 8.6 o t3skin deixou de existir.

Um pacote de CSS e ícones, sem nenhuma lógica de negócio

O t3skin não era uma extensão no sentido clássico (sem controller, sem model, sem repository). Consistia em arquivos CSS, sprites de ícones, alguns trechos de JavaScript para a interface do backend e um ext_tables.php que o registrava como skin do backend. Era uma extensão de sistema porque vinha com o core em typo3/sysext/. Toda a lógica era visual: cores, fontes, espaçamentos, ícones. O core do TYPO3 renderizava os módulos do backend; o t3skin só definia a aparência deles.

Essa tarefa passou para o core aos poucos: no TYPO3 7.0, o CSS do t3skin foi migrado para Less, na 8.1 o CSS do backend foi para a extensão de sistema backend e na 8.6 o t3skin foi removido. Em paralelo, a v7 passou os ícones para um sistema baseado em SVG (IconFactory), e o CSS migrou mais tarde para SCSS.

Os problemas aparecem quando referências ao t3skin sobram depois de um upgrade

O problema mais comum é um backend em branco ou quebrado depois de um upgrade do TYPO3. O próprio t3skin nem pode ser instalado num TYPO3 v12; se o erro tem a ver com o t3skin, ele vem de extensões próprias ou personalizações do backend que ainda carregam arquivos de EXT:t3skin. O resultado: botões sem fundo, ícones que não carregam, navegação de módulos que não responde ao clique. A solução: remover essas referências e passar para os recursos do core. Se o backend estiver tão quebrado que o Extension Manager fica inacessível, numa instalação clássica a extensão causadora pode ser desativada pela linha de comando: typo3/sysext/core/bin/typo3 extension:deactivate <extension-key>. Em instalações Composer esse comando não existe mais desde o TYPO3 11.4; lá a extensão é removida pelo Composer.

Segundo problema: arquivos CSS órfãos. Mesmo depois do upgrade, podem restar arquivos CSS em fileadmin/ ou typo3temp/ que o navegador mantém em cache. Por isso, depois do upgrade é preciso limpar todos os caches: do navegador, do TYPO3 e da CDN.

Terceiro ponto: personalizações do backend construídas sobre o t3skin. Algumas agências escreveram, no TYPO3 v6, CSS próprio para o backend com as classes do t3skin como base. Quando o t3skin sai, essas personalizações quebram. A solução: migrar o CSS personalizado do backend para as classes CSS atuais do core.

O t3skin não tem caminho de upgrade: migrar significa remover

Não existe atualização do t3skin para uma versão atual, porque a extensão não tem sucessor. O sucessor é o próprio core do TYPO3. Migrar significa remover todas as referências a classes CSS do t3skin em módulos de backend personalizados e usar a IconFactory para ícones próprios. O próprio t3skin some com o update do core; não é preciso desinstalá-lo. A Gosign faz essa limpeza em toda migração de TYPO3 e verifica, no mesmo passo, se restaram na instalação outras extensões legadas (css_styled_content, rtehtmlarea, adodb) que também precisam ser removidas.