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 hace años uno de los frameworks más utilizados para Custom Content Elements en TYPO3. Más de 1,7 millones de descargas en Packagist (datos de septiembre de 2026) y su mención en la documentación oficial de TYPO3 junto a Content Blocks y DCE confirman su difusión.

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, por defecto en Configuration/Mask/ del sitepackage). 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 los tipos habituales de TYPO3: String, Integer, Float, RichText, Date, DateTime, File (FAL), Inline (IRRE para estructuras anidadas), Select, Checkbox, Radio, Link, Slug, Color Picker, Tab, Palette. Desde Mask 7.1 esta configuración también puede dividirse en un archivo JSON por elemento.

Las plantillas Fluid se ubican por defecto en el sitepackage, en Resources/Private/Mask/Frontend/Templates, 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). Para v12 y v13 no necesita otras extensiones; para v11, Mask 8.x trae fontawesome_provider como dependencia. 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. Desde Mask 7.1, Mask procesa su configuración como objetos en lugar de arrays, lo que es bastante más rápido.

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. Tras cada actualización de Mask conviene probar brevemente este comportamiento.

Migración y compatibilidad de versiones

Mask es compatible con TYPO3 v12 y v13 de forma activa. La versión estable actual (Mask 9.x) funciona en ambas versiones LTS. TYPO3 v11 está cubierto por Mask 8.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.

Para TYPO3 v13 y v14 existe además la extensión Content Blocks (friendsoftypo3/content-blocks). Para proyectos Mask existentes no hay urgencia: Mask y Content Blocks coexisten sin problemas. Proyectos nuevos en TYPO3 v13 o v14 pueden evaluar si Content Blocks 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 bajo la etiqueta del campo 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.