Fil d’Ariane Pro — Guide complet

Fil d’Ariane Pro (dfbreadcrumbpro) remplace le fil d’Ariane basique de votre thème par une navigation enrichie : menus déroulants de catégories sœurs sur chaque niveau, données structurées JSON-LD BreadcrumbList conformes aux guidelines Google, et chemin intelligent pour les produits appartenant à plusieurs catégories.

Installation

1. Rendez-vous dans Modules > Gestionnaire de modules > Installer un module.
2. Uploadez l’archive dfbreadcrumbpro.zip puis cliquez sur Installer.
3. Le module s’enregistre automatiquement sur les hooks displayHeader, displayWrapperTop et actionFrontControllerSetMedia. Aucune manipulation supplémentaire n’est nécessaire.

Compatibilité : PrestaShop 8.0 à 9.x, PHP 7.4 à 8.3, multiboutique et multilingue.

Configuration

Ouvrez Modules > Gestionnaire de modules, recherchez « Fil d’Ariane Pro » et cliquez sur Configurer. Les options suivantes sont disponibles :

• Remplacer le fil d’Ariane du thème (activé par défaut) — masque en CSS le fil rendu par le thème (classes .breadcrumb et .breadcrumb-wrapper) pour éviter tout doublon visuel.
• Activer les menus déroulants (activé par défaut) — affiche les catégories sœurs dans un menu déroulant sur chaque niveau du fil.
• Afficher les sous-catégories sur le dernier niveau (désactivé par défaut) — sur les pages catégorie, le dernier menu liste les sous-catégories de la catégorie courante plutôt que ses catégories sœurs. Si la catégorie n’a pas d’enfant, le module revient automatiquement aux catégories sœurs.
• Stratégie de chemin pour les produits — voir la section dédiée ci-dessous.
• Activer le JSON-LD BreadcrumbList (activé par défaut) — injecte les données structurées schema.org dans la balise head.
• Afficher le lien Accueil (activé par défaut) — premier élément du fil pointant vers la page d’accueil.
• Séparateur — caractère affiché entre les niveaux (par défaut ›, 8 caractères maximum).
• Nombre maximum d’éléments par menu — plafond des catégories listées dans chaque menu déroulant (par défaut 15, de 1 à 50).

Stratégies de chemin produit

Quand un produit appartient à plusieurs catégories, le module doit choisir quel chemin afficher. Trois stratégies sont proposées :

Catégorie par défaut

Le fil utilise la catégorie par défaut du produit (id_category_default), c’est-à-dire le comportement PrestaShop classique. Si cette catégorie est désactivée ou non associée à la boutique courante, le module se replie automatiquement sur la catégorie la plus profonde.

Catégorie la plus profonde

Le fil utilise la catégorie active la plus profonde (plus grand level_depth) parmi celles du produit. C’est le chemin le plus spécifique, généralement le plus intéressant pour le SEO puisqu’il maximise le nombre de niveaux et de mots-clés dans le fil et dans le JSON-LD.

Contextuelle (recommandée, par défaut)

Le module mémorise la dernière catégorie visitée par le client dans un cookie (dfbcp_last_cat). Sur une fiche produit, si le produit appartient à cette catégorie, le fil affiche ce chemin : la navigation reflète le parcours réel du visiteur. Sinon, le module se replie sur la catégorie la plus profonde.

Menus déroulants

Chaque niveau du fil correspondant à une catégorie affiche un bouton caret. Comportement :

• Desktop — ouverture au survol du niveau ou au clic sur le caret.
• Mobile — ouverture au tap sur le caret, fil défilable horizontalement sur les petits écrans.
• Fermeture — clic en dehors du fil ou touche Échap.
• Accessibilité — attributs aria-haspopup, aria-expanded et aria-current, navigation clavier complète.
• Anti-débordement — les menus se repositionnent automatiquement pour ne jamais sortir de l’écran.

Les listes de catégories sœurs sont mises en cache par requête et respectent la langue et la boutique courantes. La catégorie active est mise en évidence dans le menu.

JSON-LD BreadcrumbList

Le module injecte dans la balise head un script application/ld+json de type BreadcrumbList :

• positions numérotées à partir de 1 ;
• nom et URL pour chaque niveau ;
• dernier élément (page courante) volontairement sans URL, conformément aux recommandations Google ;
• jamais émis si le fil compte moins de deux niveaux.

Vous pouvez vérifier la validité du balisage avec le test des résultats enrichis Google.

Pages couvertes

• Catégories — chemin complet depuis la racine du catalogue.
• Fiches produit — chemin de catégorie selon la stratégie choisie, produit en dernier niveau.
• Pages CMS — arborescence des catégories CMS puis titre de la page.
• Marques et fournisseurs — page liste puis fiche.
• Autres pages (contact, promotions, plan du site…) — repli générique sur le titre meta de la page.
• Page d’accueil — aucun fil affiché.

Multiboutique et multilingue

Toutes les requêtes SQL respectent les associations de la boutique courante (contexte multiboutique) ainsi que la langue du visiteur : noms de catégories, URL réécrites et libellés sont résolus dans la bonne langue. La traduction française du back-office est incluse ; les autres langues se traduisent via International > Traductions > Traductions des modules installés.

Dépannage

Le fil ne s’affiche pas

Vérifiez que votre thème expose bien le hook displayWrapperTop (présent dans le thème Classic et la quasi-totalité des thèmes du marché). Si ce n’est pas le cas, greffez le module sur un hook d’affichage équivalent via Design > Positions.

Deux fils d’Ariane apparaissent

L’option « Remplacer le fil d’Ariane du thème » est désactivée, ou votre thème utilise des classes CSS non standard. Réactivez l’option ou ajoutez une règle CSS ciblant le conteneur du fil de votre thème.

Le mode contextuel affiche toujours le même chemin

Un cache pleine page ignore probablement le cookie dfbcp_last_cat. Basculez sur la stratégie « Catégorie la plus profonde » ou excluez ce cookie de la clé de cache.

Le menu déroulant est vide sur un niveau

La catégorie n’a pas de catégorie sœur active associée à la boutique courante : le caret n’est simplement pas affiché dans ce cas.

Historique des versions

• 1.0.0 (16/07/2026) — Publication initiale : menus déroulants de catégories sœurs, JSON-LD BreadcrumbList, stratégies par défaut / plus profonde / contextuelle, couverture catégories, produits, CMS, marques et fournisseurs, multiboutique et multilingue.