Linked Checkbox para TYPO3

form_element_linked_checkbox hace realmente clicables los consentimientos RGPD

El Form Framework del núcleo TYPO3 conoce una casilla de verificación, pero no una casilla con etiqueta enlazada. Quien trabaja con el elemento estándar no puede poner en la etiqueta un enlace a la política de privacidad o a los términos, y eso es precisamente un requisito que aparece en cualquier formulario. La extensión form_element_linked_checkbox cubre ese hueco con un elemento de formulario personalizado limpio que combina texto y enlace de forma adecuada. Para cualquier instalación TYPO3 que trabaje con el Form Framework nativo, esta extensión es prácticamente obligatoria. Sin ella solo queda el workaround de ampliar el texto de la etiqueta con un bloque de texto contiguo, lo que no solo parece desordenado, sino que además resulta problemático para los lectores de pantalla y la accesibilidad.

Escenarios típicos están en el ámbito de compliance de cualquier web corporativa

El primer y más frecuente escenario son los consentimientos RGPD al pie de formularios de contacto, boletín y candidatura. El texto “He leído la política de privacidad y acepto el tratamiento de mis datos” debe contener un enlace clicable a /privacidad, sin que el visitante tenga que marcar la casilla para abrirlo. form_element_linked_checkbox cubre exactamente ese caso.

Un segundo escenario son las aceptaciones de condiciones generales en formularios de registro y compra. Las universidades lo utilizan en inscripciones a cursos, las asociaciones en solicitudes de alta, los proyectos de comercio electrónico con el Form Framework de TYPO3 en los checkouts. Aquí a menudo no se pide un único enlace, sino varios (condiciones, desistimiento, privacidad), que deben integrarse en la misma etiqueta.

El tercer escenario afecta a los boletines Double-Opt-In. Antes del alta el destinatario debe confirmar expresamente que se suscribe al boletín, con enlace a las notas de privacidad específicas del boletín. form_element_linked_checkbox permite usar varias casillas con enlace propio en el mismo formulario, de modo que, junto al consentimiento de privacidad, también se pueda pedir el consentimiento explícito al boletín como elemento separado. Eso es importante, porque la AEPD interpreta el RGPD en el sentido de que se requieren consentimientos separados, y una casilla genérica “acepto todo” no basta jurídicamente.

Arquitectura técnica dentro del sistema de plugins del Form Framework

El Form Framework de TYPO3 está diseñado para ser ampliable a propósito: cualquier extensión puede registrar elementos de formulario propios, que aparecen en el editor YAML y son utilizables en el backend por arrastrar y soltar. form_element_linked_checkbox aprovecha ese mecanismo y registra un nuevo elemento “LinkedCheckbox” mediante el YAML de configuración del Form y el área de definiciones de elementos de formulario. Los redactores arrastran el elemento a su formulario, igual que harían con una casilla estándar, y configuran la etiqueta, el texto del enlace y el destino en el panel de detalle.

Internamente la extensión amplía la clase Checkbox y añade propiedades para linkTarget, linkText y wrapLabel. El renderizado corre a través de un partial Fluid propio que divide el texto de la etiqueta en “before”, “linkText” y “after” y sitúa el área clicable solo sobre la parte del enlace. El clic en el enlace abre la página de destino sin conmutar la casilla. Para la accesibilidad eso es importante, porque los lectores de pantalla leen el enlace como elemento separado y la casilla puede manejarse de forma independiente.

La configuración se realiza directamente en el editor YAML del Form Framework: tras arrastrar el elemento a un formulario aparecen en la columna de detalle derecha los campos “Etiqueta antes del enlace”, “Texto del enlace”, “Etiqueta después del enlace” y “Destino del enlace”. El destino puede ser una página interna, un enlace a archivo o una URL externa. La validación obligatoria se fija, como en el elemento estándar, en la pestaña Validators.

Problemas frecuentes: multilingüismo, estilos y mensajes del validator

El primer tema de soporte es la traducción. La etiqueta consta de tres partes, y cada parte debe mantenerse por separado en cada idioma. En la práctica eso significa que, para una instalación bilingüe (ES/EN), el mantenimiento se duplica. Quien trabaje con ext:l10nmgr debería referenciar explícitamente las claves LLL en la definición del formulario, para que import y export funcionen limpiamente. Un truco de proyectos grandes: mantener las tres partes de la etiqueta en una única clave LLL con placeholders y componerlas en el servidor en la salida. Eso reduce claramente el número de cadenas a traducir.

El segundo tema es el estilado. Muchos sistemas de diseño trabajan con casillas personalizadas que se reproducen mediante CSS desde una construcción span o label. La plantilla por defecto de la extensión entrega un wrapper sencillo que choca con algunos frameworks CSS. Recomendamos sobrescribir el partial en el overlay del paquete y adaptar la estructura al estilado del resto del formulario.

En tercer lugar, los mensajes de error del validator son un tropiezo habitual. Si el usuario no marca la casilla, debería aparecer “Por favor, acepte la política de privacidad” en lugar del mensaje por defecto “Campo obligatorio”. La extensión soporta mensajes de error personalizados mediante formElementsDefinition en el YAML del formulario; el mensaje puede adaptarse por elemento. Para la accesibilidad eso es importante, porque los lectores de pantalla leen el mensaje de error directamente y los mensajes inespecíficos no ayudan. Recomendamos formular cada mensaje de error de manera que sea comprensible con independencia del contexto.

TYPO3 v12 y v13 están totalmente soportados, la migración desde v10 exige adaptación de YAML

form_element_linked_checkbox está disponible para TYPO3 v11, v12 y v13. La estructura YAML del Form Framework ha cambiado en detalles entre v10 y v12, sobre todo en el registro de elementos personalizados. Al actualizar una instalación v10, las definiciones de formulario que usan el elemento deben adaptarse a la nueva sintaxis YAML.

En proyectos de Gosign migramos la extensión como parte del refactoring del Form Framework, no por separado. El esfuerzo suele ser mínimo, porque el elemento se referencia en cada formulario solo por su identificador de tipo. En la migración comprobamos además si los textos de consentimiento RGPD se renderizan correctamente en cada idioma tras el upgrade de TYPO3 y actualizamos los enlaces a privacidad si han cambiado en estructura de URL o contenido textual.