t3skin para TYPO3

t3skin está obsoleto desde TYPO3 v7, pero muchas instalaciones siguen funcionando en versiones que lo necesitan

t3skin era el paquete de estilos del backend para TYPO3 v4 y v6. Definía iconos, colores, espaciados y toda la apariencia y experiencia del backend de TYPO3. Desde TYPO3 v7, el estilo del backend se integró en el core y t3skin como extensión independiente quedó obsoleto. Aun así, t3skin aparece con regularidad en los análisis de sistemas existentes, porque sigue instalado en instalaciones antiguas y provoca errores al actualizar a versiones recientes de TYPO3. Quien encuentra t3skin en su listado de extensiones tiene una señal clara: esa instalación o bien está desactualizada o no se limpió por completo durante un upgrade anterior.

Los escenarios típicos afectan exclusivamente a instalaciones legacy

El único escenario legítimo para t3skin es una instalación TYPO3 en las versiones 4.5 a 6.2 que por motivos técnicos u organizativos no se puede actualizar. En esas instalaciones, t3skin aporta el diseño del backend. Sin t3skin, el backend resultaría visualmente inutilizable: iconos ausentes, layouts rotos, formularios ilegibles.

Un segundo escenario es la fase de transición durante una migración. Cuando una agencia migra una instalación TYPO3 v6 a v12, t3skin permanece en la lista de extensiones durante el proceso de upgrade, pero se desactiva y elimina tras el mismo. En esa fase, t3skin puede provocar conflictos con el nuevo estilo del backend si no se desinstala a tiempo.

Un tercer (anti)escenario: algunos administradores instalaron manualmente t3skin en TYPO3 v7 u v8 porque preferían el diseño antiguo del backend. Funcionaba a corto plazo, pero generaba errores de presentación porque el CSS de t3skin y el del core entraban en contradicción. A partir de TYPO3 v9 eso ya no es una opción.

La arquitectura técnica era un paquete de CSS e iconos sin lógica de negocio

t3skin no era una extensión en el sentido clásico (sin controlador, sin modelo, sin repositorio). Consistía en archivos CSS, sprites de iconos, algunos snippets JavaScript para la interfaz del backend y una ext_emconf.php que la registraba como extensión del sistema. Toda la lógica era visual: colores, tipografías, espaciados, iconos. El core de TYPO3 renderizaba los módulos del backend y t3skin solo determinaba su apariencia.

Desde TYPO3 v7 el core asumió esa tarea por sí mismo. El estilo del backend se integró en el paquete de extensión del sistema “backend”. Los iconos se migraron a un sistema basado en SVG (IconFactory), el CSS se migró a Less y después a SCSS. t3skin no podía reflejar esos cambios porque se apoyaba en el antiguo sistema de iconos basado en sprites.

Los problemas habituales aparecen cuando t3skin no se elimina en un upgrade

El problema más frecuente es un backend en blanco o roto tras un upgrade de TYPO3. Si t3skin sigue instalada en una instalación v12, sobrescribe archivos CSS del core con reglas obsoletas. El resultado: botones sin fondo, iconos que no cargan, navegaciones de módulos que no se pueden pulsar. La solución: desinstalar t3skin mediante el Extension Manager y limpiar las entradas en la tabla sys_registry. Si el backend está tan roto que el Extension Manager no es accesible, ayuda la desactivación por línea de comandos: typo3/sysext/core/bin/typo3 extension:deactivate t3skin.

Segundo problema: archivos CSS huérfanos. Incluso tras desinstalar t3skin pueden quedar archivos CSS en fileadmin/ o typo3temp/ que el navegador cachea. Un vaciado completo de caché (caché del navegador, caché TYPO3, caché del CDN) es necesario tras la eliminación.

Tercer tema: personalizaciones del backend que dependen de t3skin. Algunas agencias escribieron en TYPO3 v6 CSS personalizado para el backend que utilizaba clases t3skin como base. Tras eliminar t3skin, esas personalizaciones se rompen. La solución: migrar el CSS personalizado del backend a las clases CSS actuales del core.

t3skin no tiene ruta de upgrade, la migración significa eliminación

No existe actualización de t3skin a una versión actual, porque la extensión no tiene sucesor. Su sucesor es el propio core de TYPO3. La migración consiste en: desinstalar t3skin, eliminar todas las referencias a clases CSS de t3skin en módulos de backend personalizados y usar la IconFactory para iconos personalizados. Gosign realiza esa limpieza en el marco de cada migración TYPO3 y comprueba si otras extensiones legacy (css_styled_content, rtehtmlarea, adodb) siguen presentes en la instalación y también deben eliminarse.