Ocultar información de formato (anteriormente Allowed Formats)
Oculta la ayuda y las directrices de formato de texto en los campos de texto. La funcionalidad original de 'allowed formats' se ha trasladado al Core de Drupal desde la versión 10.1.0.
allowed_formats
Install
composer require 'drupal/allowed_formats:^3.0'
composer require 'drupal/allowed_formats:^2.0'
composer require 'drupal/allowed_formats:8.x-1.5'
Overview
El módulo Allowed Formats ha evolucionado significativamente desde su creación. Originalmente, proporcionaba la capacidad de limitar qué formatos de texto están disponibles para cada instancia de campo de texto. Sin embargo, desde Drupal 10.1.0, esta funcionalidad central se ha integrado directamente en el Core de Drupal.
En la rama 3.x, el módulo ahora se centra en dos áreas clave: Primero, proporciona una ruta de migración para que los sitios existentes conviertan sus configuraciones de formatos permitidos desde la configuración de terceros del módulo a la configuración nativa de campos del Core de Drupal. Segundo, ofrece una función que permite a los constructores de sitios ocultar el enlace de ayuda de formato de texto ("Acerca de los formatos de texto") y las directrices de formato que típicamente aparecen debajo de los campos de texto formateado.
El módulo funciona añadiendo configuraciones de terceros a los widgets de campos de texto, que pueden configurarse a través del formulario de configuración del widget de campo. Cuando está habilitado, estas configuraciones eliminan la ayuda de formato y las directrices del elemento de formulario renderizado, proporcionando una interfaz más limpia para los usuarios finales que no necesitan ver la información de formato.
Features
- Ocultar el enlace de ayuda 'Acerca de los formatos de texto' en campos de texto formateado
- Ocultar las directrices/descripciones de formato de texto debajo de las áreas de texto
- Migración automática de la configuración de formatos permitidos desde versiones anteriores del módulo al formato del Core de Drupal 10.1+
- Manejo de compatibilidad hacia atrás durante el guardado de configuración de campos
- Soporte para todos los tipos de campos de texto formateado: text, text_long y text_with_summary
Use Cases
Simplificar la interfaz de campos de texto para editores de contenido
Los constructores de sitios pueden usar este módulo para ocultar el enlace de ayuda 'Acerca de los formatos de texto' y las directrices de formato en los campos de texto. Esto es particularmente útil cuando los editores de contenido están capacitados en un formato específico y no necesitan ver las opciones de selección de formato o directrices, resultando en una interfaz de edición más limpia y menos saturada.
Migrar desde versiones anteriores de Allowed Formats
Los sitios que usaron las versiones 1.x o 2.x del módulo para restringir formatos de texto por campo pueden usar la versión 3.x para migrar automáticamente esas configuraciones a la configuración nativa allowed_formats de campos del Core de Drupal. La migración ocurre automáticamente durante las actualizaciones de base de datos y cuando se guardan las configuraciones de campos.
Ocultar información de formato en campos de formato único
Cuando un campo de texto está configurado para permitir solo un formato de texto, el selector de formato y las directrices se vuelven innecesarios. Este módulo puede ocultar esa información, haciendo el formulario más limpio mientras preserva las restricciones de formato del campo configuradas en el Core.
Reducir el ruido visual en formularios complejos
En tipos de contenido con múltiples campos de texto formateado, la ayuda de formato y las directrices repetidas pueden crear desorden visual. Los administradores del sitio pueden habilitar las opciones de ocultación en cada widget de campo para optimizar la experiencia de edición.
Tips
- Las configuraciones de ocultación se configuran por widget de campo, no globalmente. Cada campo de texto puede tener diferentes configuraciones de ocultación.
- Cuando solo se permite un formato y tanto la ayuda como las directrices están ocultas, el módulo también elimina el contenedor envolvente para una interfaz completamente limpia.
- El módulo maneja automáticamente la migración durante el presave de field_config, por lo que la migración manual no es necesaria para la mayoría de las operaciones.
- Considere usar este módulo en combinación con la configuración allowed_formats de campos del Core de Drupal para tanto restringir formatos COMO ocultar la interfaz de formato.
Technical Details
Hooks 3
hook_field_widget_third_party_settings_form
Añade configuraciones de casillas de verificación a los widgets de campos de texto para ocultar la ayuda de formato y las directrices
hook_field_widget_single_element_form_alter
Modifica los elementos de formulario del widget de campo de texto para aplicar la configuración de ocultación mediante un callback #after_build
hook_ENTITY_TYPE_presave (field_config)
Convierte la configuración heredada de formatos permitidos de terceros a la configuración de campos del Core de Drupal cuando se guarda una configuración de campo
Troubleshooting 4
Asegúrese de que está editando un campo basado en texto (text, text_long o text_with_summary). El módulo solo añade configuraciones a estos tipos de campo. Navegue a Structure > Content types > [Tipo] > Manage form display, haga clic en el ícono de engranaje para el widget de campo de texto.
Limpie la Cache de Drupal después de cambiar la configuración. Las alteraciones de elementos de formulario usan callbacks #after_build que requieren una reconstrucción de caché para tener efecto.
Ejecute las actualizaciones de base de datos a través de drush updb o mediante /update.php. El módulo proporciona hooks post_update que migran las configuraciones de terceros heredadas al formato nativo del Core de Drupal.
Este módulo requiere Drupal 10.1.0 o superior. Si está en una versión anterior, use la rama 2.x del módulo que proporciona la funcionalidad completa de formatos permitidos.
Security Notes 3
- Este módulo tiene cobertura de avisos de seguridad de Drupal, lo que significa que los problemas de seguridad son revisados y abordados por el Equipo de Seguridad de Drupal.
- Ocultar la ayuda de formato y las directrices no afecta la validación real del formato - los formatos no autorizados seguirán siendo rechazados por el servidor.
- El módulo no omite ninguna verificación de permisos; los usuarios aún necesitan los permisos apropiados para usar formatos de texto.