Migas de Pan Pro — Guía completa
Instalación, configuración de los desplegables, estrategias de ruta multi-categoría y JSON-LD BreadcrumbList del módulo Migas de Pan Pro.
Migas de Pan Pro (dfbreadcrumbpro) sustituye las migas de pan básicas de tu tema por una navegación enriquecida: menús desplegables de categorías hermanas en cada nivel, datos estructurados JSON-LD BreadcrumbList conformes a las directrices de Google, y ruta inteligente para los productos que pertenecen a varias categorías.
Instalación
- Ve a Módulos > Gestor de módulos > Subir un módulo.
- Sube el archivo
dfbreadcrumbpro.zipy haz clic en Instalar. - El módulo se registra automáticamente en los hooks
displayHeader,displayWrapperTopyactionFrontControllerSetMedia. No se requiere ninguna acción adicional.
El módulo no crea ninguna tabla SQL ni realiza overrides: la desinstalación simplemente elimina sus claves de configuración.
Compatibilidad: PrestaShop 8.0 a 9.x, PHP 7.4 a 8.3, multitienda y multilingüe.
Configuración
Abre Módulos > Gestor de módulos, busca «Migas de Pan Pro» y haz clic en Configurar. Están disponibles las siguientes opciones:
- Sustituir las migas de pan del tema (activado por defecto) — oculta con CSS las migas renderizadas por el tema (clases
.breadcrumby.breadcrumb-wrapper) para evitar duplicidades visuales. - Activar los menús desplegables (activado por defecto) — muestra las categorías hermanas en un desplegable en cada nivel.
- Mostrar las subcategorías en el último nivel (desactivado por defecto) — en las páginas de categoría, el último desplegable lista las subcategorías de la categoría actual en lugar de sus hermanas. Si la categoría no tiene hijas, el módulo vuelve automáticamente a las hermanas.
- Estrategia de ruta para los productos — ver la sección dedicada más abajo.
- Activar el JSON-LD BreadcrumbList (activado por defecto) — inyecta los datos estructurados schema.org en el head de la página.
- Mostrar el enlace de inicio (activado por defecto) — primer elemento de la ruta apuntando a la página de inicio.
- Separador — carácter mostrado entre niveles (por defecto
›, máximo 8 caracteres). - Número máximo de elementos por menú — límite de categorías listadas en cada desplegable (por defecto 15, de 1 a 50).
Estrategias de ruta de producto
Cuando un producto pertenece a varias categorías, el módulo debe elegir qué ruta mostrar. Hay tres estrategias disponibles:
Categoría por defecto
La ruta usa la categoría por defecto del producto (id_category_default), es decir, el comportamiento clásico de PrestaShop. Si esa categoría está desactivada o no asociada a la tienda actual, el módulo recurre automáticamente a la categoría más profunda.
Categoría más profunda
La ruta usa la categoría activa más profunda (mayor level_depth) entre las del producto. Es la ruta más específica, generalmente la más interesante para el SEO ya que maximiza el número de niveles y palabras clave en la ruta y en el JSON-LD.
Contextual (recomendada, por defecto)
El módulo memoriza la última categoría visitada por el cliente en una cookie (dfbcp_last_cat). En una ficha de producto, si el producto pertenece a esa categoría, la ruta muestra ese camino: la navegación refleja el recorrido real del visitante. En caso contrario, el módulo recurre a la categoría más profunda.
El modo contextual depende de una cookie del visitante. Si tu tienda está detrás de una caché de página completa muy agresiva (Varnish sin variación por cookies, CDN en modo caché total), la cookie puede ser ignorada: en ese caso, elige la estrategia «Categoría más profunda».
Menús desplegables
Cada nivel de la ruta correspondiente a una categoría muestra un botón caret. Comportamiento:
- Escritorio — apertura al pasar el ratón por el nivel o al hacer clic en el caret.
- Móvil — apertura al tocar el caret, ruta desplazable horizontalmente en pantallas pequeñas.
- Cierre — clic fuera de la ruta o tecla Escape.
- Accesibilidad — atributos
aria-haspopup,aria-expandedyaria-current, navegación por teclado completa. - Anti-desbordamiento — los menús se reposicionan automáticamente para no salir nunca de la pantalla.
Las listas de categorías hermanas se cachean por petición y respetan el idioma y la tienda actuales. La categoría activa se resalta en el menú.
JSON-LD BreadcrumbList
El módulo inyecta en el head un script application/ld+json de tipo BreadcrumbList:
- posiciones numeradas desde 1;
- nombre y URL para cada nivel;
- último elemento (página actual) deliberadamente sin URL, como recomiendan las directrices de Google;
- nunca emitido si la ruta tiene menos de dos niveles.
Puedes validar el marcado con la prueba de resultados enriquecidos de Google.
Si tu tema ya genera su propio JSON-LD BreadcrumbList, coexistirán dos marcados y Search Console podrá señalar duplicados. Desactiva el marcado del tema o la opción JSON-LD del módulo.
Páginas cubiertas
- Categorías — ruta completa desde la raíz del catálogo.
- Fichas de producto — ruta de categoría según la estrategia elegida, producto en el último nivel.
- Páginas CMS — árbol de categorías CMS y luego título de la página.
- Marcas y proveedores — página de listado y luego ficha.
- Otras páginas (contacto, ofertas, mapa del sitio…) — respaldo genérico en el título meta de la página.
- Página de inicio — no se muestra ninguna ruta.
Multitienda y multilingüe
Todas las consultas SQL respetan las asociaciones de la tienda actual (contexto multitienda) así como el idioma del visitante: nombres de categorías, URL reescritas y etiquetas se resuelven en el idioma correcto. La traducción francesa del back-office está incluida; los demás idiomas se traducen desde Internacional > Traducciones > Traducciones de los módulos instalados.
Resolución de problemas
La ruta no se muestra
Comprueba que tu tema expone el hook displayWrapperTop (presente en el tema Classic y en la práctica totalidad de los temas del mercado). Si no es así, engancha el módulo a un hook de visualización equivalente desde Diseño > Posiciones.
Aparecen dos migas de pan
La opción «Sustituir las migas de pan del tema» está desactivada, o tu tema usa clases CSS no estándar. Reactiva la opción o añade una regla CSS que apunte al contenedor de las migas de tu tema.
El modo contextual muestra siempre la misma ruta
Una caché de página completa probablemente ignora la cookie dfbcp_last_cat. Cambia a la estrategia «Categoría más profunda» o excluye esta cookie de la clave de caché.
Un desplegable está vacío en un nivel
La categoría no tiene ninguna hermana activa asociada a la tienda actual: en ese caso el caret simplemente no se muestra.
Tras cualquier cambio de configuración, recuerda vaciar la caché de PrestaShop (Parámetros avanzados > Rendimiento) para ver los cambios en el front inmediatamente.
Historial de versiones
- 1.0.0 (16/07/2026) — Publicación inicial: menús desplegables de categorías hermanas, JSON-LD BreadcrumbList, estrategias por defecto / más profunda / contextual, cobertura de categorías, productos, CMS, marcas y proveedores, multitienda y multilingüe.