t3skin para TYPO3

t3skin ya no existe desde TYPO3 8.6, pero muchas instalaciones siguen funcionando en versiones que lo necesitan

De TYPO3 4.0 a 8.5, t3skin fue la extensión del sistema para el estilo del backend. Definía iconos, colores, espaciados y toda la apariencia y experiencia del backend de TYPO3. Con TYPO3 8.6, el estilo del backend pasó por completo a la extensión del sistema backend y t3skin se eliminó del core. Aun así, t3skin aparece con regularidad en los análisis de sistemas existentes, porque sigue instalado en instalaciones antiguas y las referencias a él provocan 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 una versión hasta la 8.5, en la práctica casi siempre 4.5, 6.2 o 7.6 LTS, 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 sigue formando parte del core en las etapas intermedias hasta la 7.6 y desaparece con la actualización a 8.7 LTS. Lo que puede dar problemas después son las personalizaciones propias del backend que se apoyan en t3skin.

Un tercer (anti)escenario se basa en un malentendido: en TYPO3 v7, t3skin era una extensión del sistema obligatoria y ya incluía allí el nuevo diseño del backend. Con ella no se podía recuperar un diseño antiguo, y a partir de TYPO3 8.6 t3skin ya no existe.

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_tables.php que la registraba como skin del backend. Era una extensión del sistema porque se entregaba con el core en typo3/sysext/. 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.

Esa tarea pasó al core paso a paso: con TYPO3 7.0 el CSS de t3skin se migró a Less, con 8.1 el CSS del backend se trasladó a la extensión del sistema “backend” y con 8.6 se eliminó t3skin. En paralelo, v7 migró los iconos a un sistema basado en SVG (IconFactory), y el CSS pasó después a SCSS.

Los problemas habituales aparecen cuando las referencias a t3skin sobreviven a un upgrade

El problema más frecuente es un backend en blanco o roto tras un upgrade de TYPO3. t3skin ni siquiera se puede instalar en una instalación v12; si el error tiene que ver con t3skin, se debe a extensiones propias o personalizaciones del backend que siguen cargando archivos de EXT:t3skin. El resultado: botones sin fondo, iconos que no cargan, navegaciones de módulos que no se pueden pulsar. La solución: eliminar esas referencias y pasar a los recursos del core. Si el backend está tan roto que el Extension Manager no es accesible, en una instalación clásica la extensión causante se puede desactivar por línea de comandos: typo3/sysext/core/bin/typo3 extension:deactivate <extension-key>. En las instalaciones con Composer ese comando ya no existe desde TYPO3 11.4; allí la extensión se elimina con Composer.

Segundo problema: archivos CSS huérfanos. Incluso tras el upgrade pueden quedar archivos CSS en fileadmin/ o typo3temp/ que el navegador cachea. Por eso, tras el upgrade es necesario un vaciado completo de caché (caché del navegador, caché TYPO3, caché del CDN).

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: eliminar todas las referencias a clases CSS de t3skin en módulos de backend personalizados y usar la IconFactory para iconos personalizados. t3skin desaparece por sí solo con la actualización del core; no hace falta desinstalarlo. 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.