Mask para TYPO3

Los editores necesitan elementos de contenido propios, no el siguiente parche con campos de texto genéricos

Toda web TYPO3 llega al punto en que los elementos de contenido estándar se quedan cortos. Un carrusel de equipo, una tabla de precios con toggles, un teaser de producto con imagen, texto y botón CTA - esas necesidades acaban como HTML suelto en el RTE o dentro de un contenedor Flexform saturado. Mask resuelve este problema de raíz: los editores obtienen formularios de backend con exactamente los campos que necesitan. Sin clases PHP, sin TCA manual, sin ext_tables.sql.

Mask es desde 2016 el framework más utilizado para Custom Content Elements en TYPO3. Más de 1.500 instalaciones activas (datos de Packagist, abril 2026) y su inclusión en la documentación oficial de TYPO3 como método recomendado confirman su estatus como estándar de facto.

Escenarios de uso habituales

Webs corporativas con estructuras de página complejas. Equipos de marketing necesitan entre 15 y 30 elementos de contenido diferentes: banners hero, testimonios, acordeones, contenido con pestañas, descargas con vista previa, tarjetas de contacto. Mask modela cada uno como formulario de backend propio. Los editores solo ven los campos relevantes para cada elemento, sin confusión por opciones irrelevantes.

Proyectos multilingües con estructura consistente. Los elementos Mask soportan completamente los mecanismos de traducción de TYPO3. Los campos se configuran como l10n_mode exclude (no traducible) o prefixLangTitle (traducible con indicación). En webs con 5 o más idiomas, esto ahorra tiempo de redacción porque la estructura permanece idéntica y solo se traduce el contenido.

Proyectos de relanzamiento con datos existentes. Quien migra desde un sistema anterior (WordPress, TYPO3 con Gridelements o TemplaVoilà) necesita estructuras de contenido limpias. Los elementos Mask se exportan con mask_export como extensión independiente. Las definiciones de contenido pasan a ser versionables y desplegables vía CI/CD.

Arquitectura técnica

Mask almacena la configuración de todos los elementos de contenido en un único archivo JSON (mask.json o config/mask.json desde Mask 8). Este archivo describe campos, tipos, paletas y la asignación a plantillas Fluid. Al activar o actualizar, Mask genera automáticamente las configuraciones TCA y los campos de base de datos necesarios.

Los tipos de campo cubren el estándar TYPO3 completamente: String, Integer, Float, RichText, Date, DateTime, File (FAL), Inline (IRRE para estructuras anidadas), Select, Checkbox, Radio, Link, Slug, Color Picker, Tab, Palette. Desde Mask 8 se añaden campos nativos JSON y una API mejorada.

Las plantillas Fluid se ubican por defecto en fileadmin/templates/mask/ o en una ruta configurable. Cada elemento de contenido tiene su propia plantilla, opcionalmente con Partials y Layouts. Mask registra los elementos en el New Content Element Wizard, incluyendo icono y descripción.

Las dependencias son mínimas: Mask solo requiere el TYPO3 Core (v11, v12 y v13 reciben soporte activo). No necesita otras extensiones. Para el flujo de exportación se añade mask_export como complemento opcional.

Problemas frecuentes y soluciones

Cambios de campo en sistemas productivos. Si un campo Mask se modifica en staging (tipo, nombre) pero la base de datos en producción no se actualiza, aparecen errores. Solución: usar mask_export para que los cambios de configuración fluyan por Git y pipelines de despliegue. Alternativa: Database Compare en el Install Tool tras cada deployment.

Rendimiento con muchos elementos de contenido. Webs con más de 40 elementos Mask generan una configuración TCA considerable. TYPO3 la carga en cada llamada al backend. Solución: agrupar elementos con criterio, desactivar los que no se usen, mantener activo el caché del backend. A partir de Mask 8 la generación de TCA es significativamente más eficiente que en versiones anteriores.

Elementos anidados (IRRE) y ordenación. Las relaciones inline (por ejemplo, slides dentro de un elemento slider) pierden a veces la ordenación al copiar y pegar. Solución: definir explícitamente un campo de ordenación y asegurar en la plantilla Fluid el uso de <f:for> con sortBy. En Mask 8.x este comportamiento es más estable que en 7.x.

Migración y compatibilidad de versiones

Mask es compatible con TYPO3 v12 y v13 de forma activa. La versión estable actual (Mask 8.x) funciona en ambas versiones LTS. TYPO3 v11 está cubierto por Mask 7.x, que ya no recibe nuevas funcionalidades.

Para proyectos que aún usan TemplaVoilà o DCE, Mask ofrece una ruta de migración clara. Los elementos DCE se transfieren manualmente a Mask: recrear campos en la GUI de Mask, adaptar plantillas Fluid, migrar datos mediante script SQL. Gosign ha realizado este proceso en proyectos con más de 20 elementos DCE, estimando el esfuerzo entre 2 y 5 días según la complejidad.

A partir de TYPO3 v13 está disponible además la Content Block API nativa. Para proyectos Mask existentes no hay urgencia: Mask y Content Blocks coexisten sin problemas. Proyectos nuevos en TYPO3 v13 puro pueden evaluar si el enfoque nativo es suficiente o si Mask aporta ventajas gracias a su GUI y flujo de exportación. Gosign asesora caso por caso sobre qué enfoque minimiza el mantenimiento a largo plazo.

Un aspecto frecuentemente subestimado es la documentación. Los elementos Mask son autoexplicativos para desarrolladores (campos, tipos, plantillas), pero los editores necesitan orientación: qué campos son obligatorios, qué tamaño de imagen es óptimo, qué ocurre si el campo de descripción queda vacío. Mask soporta desde la versión 7 textos descriptivos por campo que aparecen como tooltip en el backend. Gosign crea además un manual de redacción interno por proyecto donde cada elemento Mask se documenta con captura de pantalla, descripción de campos y buenas prácticas. El esfuerzo es de media hora por elemento, pero ahorra consultas durante la explotación.

Para la configuración inicial de un proyecto Mask con 15 a 20 elementos de contenido, Gosign estima de 3 a 5 días de desarrollo, incluyendo plantillas Fluid, vista previa del backend y configuración de mask_export. Elementos individuales nuevos durante la explotación se implementan en 1 a 4 horas, según la complejidad del anidamiento y el diseño de la plantilla.