Easy Breadcrumb
Proporciona migas de pan configurables basadas en rutas que extienden el sistema de migas de pan del núcleo de Drupal con el título de la página actual y numerosas opciones de personalización.
easy_breadcrumb
Install
composer require 'drupal/easy_breadcrumb:^2.0'
Overview
Easy Breadcrumb es un módulo de migas de pan altamente configurable que mejora la funcionalidad de migas de pan del núcleo de Drupal. Construye automáticamente las migas de pan basándose en el alias de la URL actual y el título de la página, proporcionando una ayuda de navegación amigable sin requerir configuración manual para cada página.
El módulo funciona inmediatamente con valores predeterminados sensatos, pero ofrece extensas opciones de personalización que incluyen: control sobre qué segmentos aparecen en el rastro de migas de pan, modos de transformación de títulos (capitalización), rutas de migas de pan personalizadas usando patrones regex, reemplazos de títulos, exclusiones de rutas y soporte para jerarquías de términos de taxonomía.
Una característica clave es la capacidad de generar datos estructurados JSON-LD para propósitos de SEO, ayudando a los motores de búsqueda a comprender la jerarquía de su sitio. El módulo también se integra con el módulo Redirect para seguir redirecciones de URL al construir las migas de pan.
Features
- Incluye automáticamente el título de la página actual como el último segmento de migas de pan
- Construye migas de pan a partir de alias de rutas URL para una navegación consistente
- Salida de datos estructurados JSON-LD para SEO (Schema.org BreadcrumbList)
- Segmento de página de inicio/principal configurable con título personalizado
- Múltiples modos de transformación de títulos: capitalizar cada palabra, solo primera letra, todo en mayúsculas o forzar palabras específicas
- Rutas de migas de pan personalizadas con soporte de patrones regex para coincidencia de URL complejas
- Reglas de reemplazo de títulos para personalizar los nombres de visualización de segmentos
- Reglas de exclusión de rutas para ocultar rutas específicas de las migas de pan
- Soporte para jerarquía de términos de taxonomía padre en las migas de pan
- Soporte de campo de título alternativo para títulos de migas de pan basados en entidades
- Respaldo al título de menú cuando el título de página no está disponible
- Limitación de segmentos para controlar la longitud del rastro de migas de pan
- Truncamiento de títulos con longitud y puntos suspensivos configurables
- Eliminación de segmentos de migas de pan duplicados/repetidos
- Manejo de prefijo de ruta de idioma para sitios multilingües
- Integración con el módulo Redirect para seguir redirecciones de URL
- Opción para usar rutas absolutas o relativas para enlaces de migas de pan
- Umbral mínimo de cantidad de segmentos antes de mostrar las migas de pan
- Opción para habilitar/deshabilitar migas de pan en páginas de administración
Use Cases
Navegación de productos de comercio electrónico
Para un sitio de comercio electrónico con jerarquías de productos profundas, configure Easy Breadcrumb para mostrar la ruta completa: Inicio > Categoría > Subcategoría > Nombre del Producto. Habilite 'Usar el título real de la página cuando esté disponible' para mostrar nombres de productos reales, y habilite 'Agregar jerarquía padre' para páginas de categorías basadas en taxonomía para incluir automáticamente las categorías padre.
Migas de pan optimizadas para SEO
Habilite 'Agregar migas de pan actuales como datos estructurados' para generar marcado JSON-LD en el encabezado HTML. Esto ayuda a los motores de búsqueda a comprender la jerarquía de su sitio y puede mostrar rastros de migas de pan en los resultados de búsqueda. Asegúrese de que 'Incluir la página actual como segmento' esté habilitado para datos completos de migas de pan.
Migas de pan para sitios multilingües
Para sitios que usan prefijos de ruta de idioma (/en/, /de/, /fr/), configure si mostrar el prefijo de idioma como un segmento de migas de pan. Por defecto, el prefijo de idioma está oculto de las migas de pan para una navegación más limpia.
Migas de pan con marca personalizada
Use el modo de capitalización 'ucforce' combinado con 'Palabras a forzar capitalización' para asegurar que nombres de marca, nombres de productos o acrónimos siempre aparezcan con capitalización consistente en las migas de pan, independientemente de cómo estén estructuradas las URLs.
Blog con rutas URL limpias
Para una estructura de blog como /blog/categoria/2024/mi-titulo-de-articulo, use la función 'Rutas a excluir' para ocultar segmentos de fecha (2024) de las migas de pan, resultando en una navegación más limpia: Inicio > Blog > Categoría > Mi Título de Artículo.
Migas de pan para páginas de destino
Use 'Rutas a reemplazar con migas de pan personalizadas' para definir rastros de migas de pan específicos para páginas de destino que no siguen la jerarquía del sitio. Por ejemplo, una página de campaña en /oferta-primavera podría tener migas de pan personalizadas: Inicio > Ofertas > Oferta de Primavera, incluso si no existe una página 'Ofertas'.
Campo de título alternativo para SEO
Agregue un campo llamado 'field_breadcrumb_title' (o configure el suyo propio) a los tipos de contenido. Esto permite a los editores especificar títulos más cortos u optimizados para palabras clave que aparecen solo en las migas de pan, separados del título completo de la página. Por ejemplo, una página titulada 'Guía Completa para el Desarrollo de Módulos Drupal para Principiantes' podría tener un título de migas de pan simplemente como 'Guía de Desarrollo de Módulos'.
Ocultar migas de pan en páginas simples
Use 'Cantidad mínima de segmentos de migas de pan' para ocultar migas de pan en páginas que solo mostrarían 'Inicio' o rastros muy cortos. Establezca en 2 o 3 para solo mostrar migas de pan cuando hay una jerarquía de navegación significativa.
Tips
- El módulo funciona inmediatamente después de la instalación con valores predeterminados sensatos - no se requiere configuración inicial
- Use la función 'Campo de título alternativo' para dar a los editores de contenido control sobre el texto de migas de pan sin afectar el título de la página
- Al definir rutas personalizadas con regex, use paréntesis para capturar grupos que pueden referenciarse con $1, $2, etc. en las URLs de segmentos
- El modo de capitalización 'ucwords' respeta palabras comunes en minúsculas como 'de', 'y', 'el' - personalice esta lista para su idioma
- Habilite datos estructurados JSON-LD para mejor SEO - Google puede mostrar sus migas de pan en los resultados de búsqueda
- Para sitios grandes, use exclusiones de rutas para ocultar rutas de utilidad como /search o /ajax de las migas de pan
- El marcador <title> en rutas personalizadas le permite usar el título real de la página en definiciones de migas de pan personalizadas
- Considere establecer una cantidad mínima de segmentos de 2 para evitar mostrar migas de pan que solo muestran 'Inicio'
- Al usar el módulo Redirect, habilite 'Seguir redirecciones' para asegurar que las migas de pan reflejen la estructura de URL canónica
Technical Details
Admin Pages 1
/admin/config/user-interface/easy-breadcrumb
Configure todos los aspectos del módulo Easy Breadcrumb incluyendo visualización de segmentos, transformaciones de títulos, rutas personalizadas, exclusiones y configuración de SEO.
Permissions 1
Hooks 1
hook_system_breadcrumb_alter
Hook del núcleo de Drupal que Easy Breadcrumb respeta. Permite a otros módulos alterar las migas de pan antes de que se rendericen. Easy Breadcrumb invoca este hook al generar datos estructurados JSON-LD.
Troubleshooting 8
Asegúrese de que el bloque de Migas de Pan del Sistema esté colocado en una región en el diseño de bloques de su tema. Easy Breadcrumb mejora el bloque de migas de pan del sistema existente en lugar de proporcionar uno propio. También verifique que la página tenga suficientes segmentos para cumplir con la configuración 'Cantidad mínima de segmentos de migas de pan'.
Habilite 'Usar el título real de la página cuando esté disponible' en la configuración de Easy Breadcrumb. Si usa páginas de Views, asegúrese de que la Vista tenga un título de página apropiado configurado. Para rutas personalizadas, asegúrese de que definan _title o _title_callback.
Habilite 'Eliminar segmentos idénticos repetidos' en la configuración. Si los duplicados aún aparecen con diferentes URLs, también habilite 'Eliminar segmentos idénticos repetidos - validar solo el texto' para eliminar segmentos basándose únicamente en texto coincidente.
Habilite 'Agregar migas de pan actuales como datos estructurados' en la configuración. El JSON-LD solo se agrega cuando el bloque de Migas de Pan del Sistema se renderiza, así que asegúrese de que el bloque esté colocado y visible. Verifique el código fuente de la página buscando una etiqueta <script type="application/ld+json"> en el encabezado.
Verifique si 'Aplicar a páginas de administración' está habilitado en la configuración. Cuando está deshabilitado, las rutas de administración usan el constructor de migas de pan predeterminado de Drupal en lugar de Easy Breadcrumb.
Para rutas personalizadas basadas en regex, asegúrese de que el patrón tenga el prefijo 'regex!' y las barras se manejen correctamente. Pruebe los patrones incrementalmente. Para rutas no-regex, asegúrese de que la ruta coincida exactamente (con o sin barra inicial según esté configurado).
Habilite 'Agregar jerarquía padre' en la Configuración avanzada. Esto solo aplica cuando se visualizan páginas de términos de taxonomía directamente, no contenido que referencia términos.
Limpie la caché de Drupal después de cambiar la configuración de Easy Breadcrumb. Las migas de pan se almacenan en caché por ruta y ruta URL. Use drush cr o la página de Rendimiento para limpiar cachés.
Security Notes 3
- El módulo filtra todos los títulos proporcionados por usuarios a través del filtrado XSS de Drupal para prevenir inyección de scripts
- Las configuraciones de rutas personalizadas solo son accesibles para usuarios con el permiso 'administer easy breadcrumb'
- Se realizan verificaciones de acceso para cada segmento de migas de pan - los usuarios solo ven enlaces a páginas a las que pueden acceder