Easy Breadcrumb

El módulo Easy Breadcrumb está diseñado para simplificar la navegación con migas de pan en tu sitio Drupal. Genera automáticamente rutas de migas de pan a partir de las URLs existentes o de la estructura de menús. En esta guía encontrarás todo lo que necesitas saber: desde la instalación y configuración hasta la personalización avanzada y las mejores prácticas.

1. Instalación y activación de Easy Breadcrumb

Easy Breadcrumb es un módulo contribuido, por lo que primero hay que instalarlo antes de usarlo. Puedes hacerlo con Composer o descargándolo manualmente:

• Usando Composer: Ejecuta este comando desde la raíz de tu proyecto:

  composer require drupal/easy_breadcrumb

• Instalación manual: Descarga el módulo desde Drupal.org y colócalo en tu carpeta modules/contrib.

Después de instalarlo, actívalo desde la página Extender (/admin/modules) o con Drush:

drush en easy_breadcrumb -y

2. Configuración de las migas de pan

Una vez activado, puedes personalizar su comportamiento en la página de configuración (/admin/config/user-interface/easy-breadcrumb). 

Las opciones de configuración están divididas en dos secciones principales: Configuraciones generales y Configuraciones avanzadas.

Configuraciones generales

• Aplicar a páginas de administración: Si activas esta opción, Easy Breadcrumb generará migas de pan también para las páginas de administración (como /admin).
• Incluir rutas no válidas como texto: Si una URL no resuelve correctamente, se mostrará como texto en la miga de pan.
• Incluir la página actual como segmento: Agrega el título de la página actual al final de la ruta de migas de pan.
• Eliminar segmentos repetidos: Si un segmento aparece varias veces seguidas, se eliminarán las repeticiones.
• Incluir la página de inicio como segmento: Asegura que "Inicio" siempre aparezca al inicio de la ruta.

Configuraciones avanzadas

• Excluir rutas específicas: Puedes introducir rutas (una por línea) que no deben generar migas de pan.
• Sustituir títulos en los segmentos: Puedes definir una lista de títulos a reemplazar en el formato TÍTULO_ORIGINAL::NUEVO_TÍTULO.
• Definir rutas personalizadas: Permite especificar estructuras personalizadas para ciertas páginas.

3. Personalización de las migas de pan

• Patrones personalizados: Usa tokens para generar títulos de enlace dinámicos.
• Modificaciones manuales: Puedes definir migas de pan personalizadas para ciertas páginas.
• Integración con otros módulos: Puedes combinarlo con Redirect para gestionar URLs antiguas.

4. Integración con temas

• Sobrescribir plantillas: Puedes crear una plantilla Twig personalizada en tu tema para cambiar el HTML de las migas de pan.
• Personalización con CSS: Modifica la apariencia de las migas de pan con clases personalizadas.

5. Personalización para desarrolladores

• hook_easy_breadcrumb_alter(): Permite modificar la estructura de las migas de pan antes de renderizarlas.

6. Mejores prácticas y casos de uso

• Mantén una estructura clara: Asegúrate de que la estructura de URLs y menús en tu sitio sea coherente.
• Verifica en distintas páginas: Revisa cómo se generan las migas de pan en distintos tipos de contenido.
• Optimización SEO: Las migas de pan bien estructuradas pueden mejorar la indexación de tu sitio en buscadores.

Conclusión

El módulo Easy Breadcrumb es una herramienta muy útil para mejorar la navegación en tu sitio Drupal. Gracias a su configuración automática basada en URLs o menús, mejora la experiencia del usuario y el SEO del sitio. Tanto si eres un administrador configurando el módulo desde la interfaz como un desarrollador que quiere personalizar su comportamiento con hooks y APIs, Easy Breadcrumb te da la flexibilidad y el control necesarios para construir rutas de migas de pan claras y efectivas.