Smart Breadcrumbs : installation et aide

Installez le ZIP depuis le gestionnaire de modules de votre boutique. Configurer ouvre Configuration. Le module propose aussi les pages Dropdown Groups, Definable Trails, Integrity, License, Support et Update.

Sélectionnez une seule boutique avant d'enregistrer les paramètres ou de gérer les groupes et les chemins. Ces modifications sont propres à cette boutique. Les employés doivent disposer des droits correspondants de consultation, d'ajout, de modification ou de suppression.

Le remplacement du fil d'Ariane en boutique nécessite une licence admissible et un contrôle d'intégration du fil d'Ariane réussi. Si l'intégration est indisponible, le module conserve le fil d'Ariane natif du thème.

Ouvrez Integrity dans la boutique sélectionnée et cliquez sur Check breadcrumb integration. Gardez la page ouverte pendant le contrôle d'installation. La page affiche les URLs concernées, la langue, l'appareil et le résultat, y compris les requêtes publiques après publication.

Le module comprend des profils d'intégration pour Classic et ses thèmes enfants sous PrestaShop 1.7 à 9, Hummingbird et ses thèmes enfants sous PrestaShop 8.1 à 9, ainsi que default-bootstrap sous PrestaShop 1.6.1 ou ultérieur dans la branche 1.6. Les templates du thème eux-mêmes doivent correspondre à l'un de ces profils ; le nom du thème seul ne suffit pas.

Relancez le contrôle après un changement de thème ou lorsque Integrity signale une intégration modifiée. Si un message indique que les contrôles publics n'ont pas abouti, relancez Check breadcrumb integration.

Le contrôle Breadcrumb links in structured data indique quel module fournit la navigation et lequel fournit le schéma. Il avertit aussi si le schéma s'exécute avant la navigation ou si un module connu qui écrit les URLs s'exécute ensuite. Ce contrôle indique l'ordre ; il ne réorganise pas les hooks.

Dans Configuration, Enable Smart Breadcrumbs est réglé sur Oui par défaut. Ce paramètre contrôle la fonction de fil d'Ariane partagée pour la boutique sélectionnée. Réglez-le sur Non et enregistrez pour arrêter le remplacement du fil d'Ariane par le module dans cette boutique.

Les paramètres sont enregistrés ensemble. Utilisez Enregistrer ou Enregistrer et rester après avoir modifié une section. La confirmation est The breadcrumb settings were saved.

Les menus déroulants proposent des liens provenant de la source de catégories, de produits ou de contenu associée à un élément du fil. Un élément reçoit un menu déroulant uniquement si cette source fournit des alternatives.

Seules les destinations accessibles et disponibles de la source sont proposées. La sélection d'éléments dans un groupe personnalisé n'ajoute pas à cette source des produits ou catégories sans rapport avec elle.

Les liens des menus déroulants sont distincts du fil d'Ariane linéaire et ne sont pas ajoutés comme ancêtres supplémentaires à son schéma BreadcrumbList.

Les visiteurs peuvent ouvrir un panneau avec son bouton, parcourir les liens avec les touches fléchées et appuyer sur Échap pour le fermer. Un clic à l'extérieur le ferme également. La recherche dans les menus déroulants nécessite JavaScript ; les premiers liens alternatifs sont générés avec la page.

Tous les commutateurs suivants sont réglés sur Oui par défaut. Désactivez le commutateur correspondant pour supprimer la navigation du module sur ce type de page.

Add missing page-title crumb est également réglé sur Oui par défaut. Il ajoute le titre de la page actuelle lorsque le fil fourni ne contient aucune entrée pour cette page, par exemple sur les pages de connexion ou de panier. Activer un type de page n'ajoute pas la prise en charge d'un thème non reconnu ou d'une route de module indisponible.

BreadcrumbList ownership est réglé par défaut sur Defer to an existing valid schema, otherwise emit.

Le module coordonne la responsabilité du fil d'Ariane avec les modules MPR coopérants. mprschema et mprseorevolution peuvent partager cette politique : une modification du schéma de fil d'Ariane depuis l'un de leurs paramètres pris en charge peut donc affecter cette même politique partagée.

Les chemins du compte et de la commande sont exclus de la génération du BreadcrumbList. Des restrictions de page comme noindex peuvent aussi supprimer le schéma. Un chemin visible n'a donc pas toujours d'équivalent dans le schéma.

Si les paramètres conservés divergent, la page de configuration peut afficher les conflits sous BreadcrumbList ownership. Lorsque cette option est proposée, examinez Keep the canonical breadcrumb policy and retain conflicting legacy values., sélectionnez Accept the detected policy conflicts, puis enregistrez. L'adoption dans toutes les boutiques nécessite un employé ayant accès à chacune d'elles, y compris aux boutiques inactives.

Modifiez les libellés dans Configuration pour chaque langue de la boutique. Ces champs sont obligatoires. Les valeurs ci-dessous sont les valeurs anglaises par défaut ; l'allemand, le français, l'espagnol, l'italien et le polonais disposent aussi de valeurs par défaut localisées.

Ces libellés modifient le texte du fil d'Ariane. Ils ne renomment pas les produits, catégories, pages CMS ni les pages fournies par un autre module.

Persistent cache lifetime est réglé par défaut sur 86400 secondes, soit un jour. Il accepte de 300 à 2592000 secondes. Il contrôle la réutilisation des données stockées sur les catégories ancêtres, et non la durée de vie de votre cache de pages ou de votre CDN. Les alternatives des menus déroulants et les résultats de recherche sont lus depuis leurs sources à la demande.

L'enregistrement de la configuration, des groupes ou des chemins actualise le cache de navigation concerné. Le module invalide aussi les données de navigation via ses hooks enregistrés de modification des catégories, produits, contenus, langues, boutiques et groupes de clients.

Si les modifications sont enregistrées mais que l'actualisation du cache échoue, le back-office affiche The changes were saved. The navigation cache still needs to be refreshed. Vérifiez les droits de stockage et l'accès à la base de données, puis enregistrez à nouveau. Videz tout cache de pages complètes distinct s'il sert encore une ancienne page.

Activez d'abord Enable curated dropdown groups dans Configuration. Pour les groupes de produits, activez aussi Show other products on the product crumb. Ouvrez Dropdown Groups et ajoutez un groupe.

Les choix de Match fonctionnent ainsi :

• Match by keyword in the item name regroupe les alternatives dont le nom contient Keyword, sans tenir compte de la casse.
• Pick specific items regroupe les alternatives sélectionnées dans l'ordre enregistré.
• Hide these items retire les alternatives sélectionnées de ce menu déroulant et de ses résultats de recherche. Leurs pages dans la boutique ne sont pas masquées.
• Everything else / remaining items fournit le titre et la position des alternatives qui n'ont été attribuées à aucun autre groupe. Un seul groupe actif d'éléments restants est autorisé par contexte et type d'élément.

Les groupes actifs propres à une catégorie remplacent l'ensemble global de groupes pour ce contexte et ce type d'élément. Ils ne sont pas combinés à l'ensemble global. Les exclusions sont appliquées en premier ; les autres groupes s'attribuent ensuite les éléments correspondants dans l'ordre de position. Un élément n'apparaît que dans un groupe. Les éléments non attribués reçoivent tout de même une section d'éléments restants si vous n'en avez pas défini.

Cliquez sur Enregistrer ou Enregistrer et rester. La liste permet la modification, la suppression, le basculement de Active et les actions groupées Activer la sélection et Désactiver la sélection. Les groupes de catégories affectent les alternatives de même niveau, y compris la partie correspondante du choix catégories de même niveau et sous-catégories, plutôt que les listes de sous-catégories seules.

Ouvrez Definable Trails et ajoutez une définition. Ces règles personnalisent les ancêtres des pages produit. Elles ne modifient pas l'affectation des produits aux catégories.

1. Saisissez Name, un nom interne de 255 caractères maximum. Priority commence à 0 et Active à Oui.
2. Choisissez Match products by. La valeur par défaut est Exact product. Sélectionnez le produit, la catégorie ou la page de filtre cible selon le cas.
3. Choisissez Build method. La valeur par défaut est Replace existing ancestors.
4. Sous Ordered ancestors, cliquez sur Add ancestor pour chaque nœud nécessaire. Home et Current product sont des extrémités fixes. Utilisez Move up, Move down ou Remove pour modifier l'ordre.
5. Sélectionnez un Sample product et cliquez sur Preview with sample product. Examinez le chemin obtenu et tout problème signalé avant d'enregistrer.
6. Cliquez sur Enregistrer ou Enregistrer et rester, puis ouvrez la page produit concernée.

Include subcategories est décoché au départ et s'applique aux deux critères de catégorie. Il inclut les produits dont la catégorie correspondante se trouve sous la catégorie sélectionnée.

Avec Replace existing ancestors, le résultat est Home, vos nœuds ordonnés, puis Current product. Une liste de nœuds vide laisse Home et Current product. Avec Insert after a category crumb, sélectionnez Insert after category et fournissez au moins un nœud. Cette catégorie doit déjà figurer dans le chemin original du produit.

Les sources d'ancêtres disponibles sont :

Pour les nœuds d'entités, Label override (optional) peut remplacer le libellé normal dans chaque langue. Sans remplacement, le libellé source est utilisé. Les liens personnalisés nécessitent à la fois le libellé traduit et l'URL. Des destinations répétées ou invalides empêchent l'application de cette définition.

Les valeurs de Priority les plus basses sont examinées en premier. À priorité égale, l'ordre est Exact product, Filter SEO page membership, Assigned category, puis Default category, suivi de l'identifiant de définition. La première définition correspondante qui produit un chemin valide est retenue. Si aucune n'est applicable, le chemin original est conservé. Si l'appartenance au filtre fournie ne peut pas être établie de manière sûre, le chemin original est également préservé.

Il peut y avoir au maximum 100 définitions actives de chemins produit par boutique et 128 nœuds par définition. Utilisez le commutateur Active de la liste ou Activer la sélection et Désactiver la sélection pour gérer les définitions. Supprimez individuellement celles qui ne sont plus nécessaires.

Modifier l'élément parent immédiat d'un produit peut supprimer son menu déroulant de produits alternatifs. Ce menu n'est conservé que si le chemin personnalisé garde la même catégorie parente immédiate que le chemin original.

Filter Revolution peut fournir la navigation des catégories filtrées, des choix de pages SEO de filtre avec recherche, l'appartenance des produits pour la correspondance des chemins et des nœuds ancêtres de pages de filtre. L'intégration doit fournir des données valides pour la boutique et la langue actuelles. Si l'éditeur de chemins affiche Filter Revolution breadcrumb integration is unavailable., les choix dépendant des filtres restent inutilisables jusqu'à ce que l'intégration soit disponible.

La navigation des racines de contenu reconnaît les sections de Blog Revolution, MPR FAQ, Support Revolution ou Knowledge Base, la documentation de Product Tabs, Issues Revolution, Feature Request, la feuille de route de Digital Revolution, les avis de Comments et Customer Showcase lorsque leurs routes publiques respectives sont disponibles.

Cross-link content sections relie les sections de ressources disponibles à d'autres sections de ressources, et les avis aux réalisations clients au sein de leur groupe de contenu distinct. Il ne crée pas ces sections et n'active pas une route publique désactivée. La navigation des tickets d'assistance appartient à l'espace compte.

Pour une intégration personnalisée, un développeur peut utiliser filterMprBreadcrumbTrail pour modifier ou renvoyer un fil d'Ariane. Le hook reçoit le chemin, le nom du fournisseur et le module chargé du rendu. Les intégrations qui modifient une source du fil peuvent notifier actionMprBreadcrumbSourceChanged pour invalider les données de navigation.

Ouvrez License pour examiner l'état et l'expiration de la licence. Utilisez Refresh après un achat ou un renouvellement. La participation à l'affichage en boutique nécessite un état actif, test, démo ou essai dans sa période de validité.

Ouvrez Update et cliquez sur Check for updates. Lorsqu'une mise à jour est proposée, utilisez Update Now. Pour un ZIP de module, utilisez Manual Update, Add file, puis Upload & Install. Examinez ensuite Integrity et relancez Check breadcrumb integration si cela vous est demandé.

Ouvrez Support pour obtenir de l'aide sur le module. Indiquez l'URL de la boutique concernée, la boutique et la langue sélectionnées, les paramètres pertinents et le message affiché par Integrity ou l'aperçu du chemin.

Pour arrêter la fonction partagée de fil d'Ariane dans une boutique, réglez Enable Smart Breadcrumbs sur Non et enregistrez. Pour arrêter la participation de ce module, désactivez Smart Breadcrumbs dans le gestionnaire de modules. Un autre module coopérant admissible peut continuer à fournir la fonction partagée de fil d'Ariane.

La désinstallation supprime le menu de back-office et les préférences de ce module. Elle conserve volontairement les paramètres partagés du fil d'Ariane, les traductions, les clés secrètes de recherche, les sept tables de fil d'Ariane et l'infrastructure partagée d'intégration au thème. Une réinstallation peut donc réutiliser la configuration, les groupes et les chemins existants. La désinstallation ne réinitialise pas ces données.

Déclare PrestaShop de 1.6.0.0 à 9.99.99 et nécessite PHP 7.1 ou ultérieur. Le remplacement du fil d'Ariane en boutique exige aussi une composition de templates prise en charge et un contrôle d'intégration réussi.