Field Display Label
Permite definir una etiqueta separada para la visualización de campos que difiere de la etiqueta del formulario.
field_display_label
Instalar
composer require 'drupal/field_display_label:^2.0'
composer require 'drupal/field_display_label:8.x-1.3'
Overview
El módulo Field Display Label proporciona la capacidad de configurar una etiqueta diferente para los campos cuando se visualiza el contenido en comparación con cuando se edita. Esto es particularmente útil cuando la etiqueta de campo apropiada para la entrada de datos difiere de la etiqueta que tiene sentido para la visualización del contenido.
Por ejemplo, un campo podría etiquetarse como "Body" en el formulario de edición para mayor claridad durante la creación de contenido, pero mostrarse como "Descripción" o "Contenido del Artículo" al visualizar el contenido publicado. Esta separación permite a los editores de contenido trabajar con etiquetas de formulario intuitivas mientras proporciona a los visitantes del sitio etiquetas de visualización contextualmente apropiadas.
El módulo se integra perfectamente con el sistema de configuración de campos de Drupal añadiendo una opción de "Etiqueta de visualización" a la página de configuración de cada campo. Cuando se configura una etiqueta de visualización, automáticamente reemplaza la etiqueta de campo predeterminada durante el renderizado del campo en todos los modos de visualización.
Features
- Añade un campo 'Etiqueta de visualización' al formulario de configuración de campo para todos los campos configurables
- Permite diferentes etiquetas para la edición de formularios y la visualización de contenido sin necesidad de sobrescribir plantillas
- Almacena la configuración de etiquetas de visualización utilizando el sistema de configuración de terceros de Drupal para una exportación de configuración limpia
- Aplica automáticamente las etiquetas de visualización durante el preprocesamiento de campos para todos los modos de visualización
- Funciona con cualquier tipo de entidad con campos, incluyendo tipos de contenido, términos de taxonomía, usuarios y entidades personalizadas
- Deja la etiqueta de campo original sin cambios, preservando la experiencia de edición
Use Cases
Etiquetado de campos compatible con multilingüismo
Usar etiquetas de campo técnicas o internas para la edición de contenido (por ejemplo, 'field_hero_cta_text') mientras se muestran etiquetas amigables para el usuario a los visitantes (por ejemplo, 'Llamada a la Acción'). Esta separación ayuda a los editores de contenido a identificar campos mientras proporciona etiquetas apropiadas para los usuarios finales.
Nomenclatura de campos específica por contexto
Un campo 'Resumen' podría ser apropiado para los editores de contenido, pero 'Acerca de Este Artículo' o 'Descripción General' podría ser más significativo para los visitantes del sitio. Configurar diferentes etiquetas de visualización para diferentes tipos de contenido usando el mismo campo.
Flujo de trabajo de theming simplificado
En lugar de crear plantillas de campo personalizadas o usar hooks template_preprocess para sobrescribir etiquetas de campo, simplemente configurar la etiqueta de visualización a través de la interfaz de administración. Esto reduce la necesidad de código de tema personalizado.
Edición consistente con visualización variada
Mantener etiquetas de campo consistentes entre tipos de contenido en la interfaz de edición para la capacitación y documentación de editores de contenido, mientras se personaliza cómo esas etiquetas aparecen a los visitantes según el contexto de cada tipo de contenido.
Tips
- La etiqueta de visualización afecta a todos los modos de visualización donde la etiqueta del campo es visible. Si necesitas diferentes etiquetas por modo de visualización, considera usar plantillas personalizadas en su lugar.
- Dejar la etiqueta de visualización vacía para usar la etiqueta de campo predeterminada - este es el enfoque recomendado cuando no se necesita una etiqueta de visualización separada.
- Las etiquetas de visualización soportan traducción a través del sistema de traducción de configuración de Drupal cuando el módulo Configuration Translation está habilitado.
- La etiqueta de campo original permanece sin cambios y siempre se usa en formularios, preservando la experiencia de edición de contenido.
Technical Details
Admin Pages 1
/admin/structure/types/manage/{content_type}/fields/{field_name}
El módulo añade un campo 'Etiqueta de visualización' al formulario de configuración de campo existente. Esto permite establecer una etiqueta separada que se utilizará al mostrar el campo en el frontend, mientras que la etiqueta original permanece para la edición de formularios.
Hooks 3
hook_form_field_config_edit_form_alter
Modifica el formulario de edición de configuración de campo para añadir el campo de texto de Etiqueta de visualización
hook_preprocess_field
Preprocesa las variables del campo para reemplazar la etiqueta con la etiqueta de visualización si está configurada
hook_help
Proporciona texto de ayuda para el módulo en la página de Ayuda
Troubleshooting 3
Asegurarse de que la configuración de visualización de la etiqueta del campo no esté establecida en 'Oculto' en la configuración de Administrar visualización. La etiqueta de visualización solo aparece cuando la etiqueta del campo está configurada para ser visible (Arriba o En línea).
Limpiar la caché de Drupal y asegurarse de que el módulo esté correctamente habilitado. La configuración aparece en el formulario de configuración del campo, no en el formulario de Administrar visualización.
La etiqueta de visualización se almacena como una configuración de terceros en la entidad de configuración del campo. Re-exportar la configuración específica del campo (field.field.*.yml) para incluir la configuración.