Maillage Interne Automatique pour Shopware 6

Présentation

DfInternalLinking automatise le maillage interne de votre boutique Shopware 6. Vous définissez des règles associant un mot-clé à une page cible (produit, catégorie ou URL libre), et le module transforme les occurrences de ce mot-clé en liens contextuels dans vos descriptions de produits et vos blocs de contenu CMS.

Compatibilité

• Shopware 6.5.x, 6.6.x et 6.7.x
• PHP 8.1 ou supérieur, selon les prérequis de votre version de Shopware
• Multi-canal : configuration indépendante par canal de vente
• Administration traduite en anglais, allemand, français, espagnol et italien

Installation

Depuis l’administration

1. Rendez-vous dans Extensions > Mes extensions.
2. Cliquez sur Charger l’extension et sélectionnez le fichier ZIP du module.
3. Cliquez sur Installer puis activez l’extension avec l’interrupteur.

En ligne de commande

Décompressez le dossier du plugin dans custom/plugins/ puis exécutez :

bin/console plugin:refresh
bin/console plugin:install --activate DfInternalLinking
bin/console cache:clear

Si vous installez depuis les sources plutôt que depuis un ZIP pré-compilé, reconstruisez l’administration :

./bin/build-administration.sh

Configuration générale

Ouvrez Paramètres > Système > Extensions, puis les paramètres de DfInternalLinking. Chaque option peut être définie globalement ou par canal de vente.

• Activer le maillage — active ou désactive l’injection des liens. Valeur par défaut : activé.
• Nombre maximum de liens par page — budget global de liens injectés sur une même page, toutes règles confondues. Valeur par défaut : 5.
• Mode silo — n’applique une règle que si sa cible partage une branche de catégorie avec la page courante. Valeur par défaut : désactivé.
• Ajouter nofollow — ajoute l’attribut rel nofollow aux liens générés. Valeur par défaut : désactivé.
• Classe CSS des liens — classe appliquée à chaque lien généré, pour le styler dans votre thème. Valeur par défaut : df-internal-link.

Créer une règle de mot-clé

Le module ajoute une entrée Maillage interne dans le menu Marketing de l’administration. Cliquez sur Ajouter une règle pour ouvrir le formulaire.

• Mot-clé — l’expression à détecter dans vos contenus. La détection est insensible à la casse et respecte les frontières de mots.
• Type de cible — Produit, Catégorie ou URL personnalisée.
• Produit / Catégorie cible — le sélecteur affiché dépend du type choisi. L’URL SEO canonique est générée automatiquement par Shopware pour le canal en cours.
• URL cible — champ affiché uniquement pour le type URL personnalisée. Accepte une URL absolue ou un chemin relatif.
• Nombre maximum de liens par page — plafond propre à cette règle, appliqué en plus du budget global.
• Priorité — les règles sont traitées par priorité croissante. À priorité égale, le mot-clé le plus long est appliqué en premier.
• Langue — restreint la règle à une seule langue. Laissez vide pour l’appliquer à toutes.
• Canal de vente — restreint la règle à un seul canal. Laissez vide pour l’appliquer à tous.
• Actif — désactivez temporairement une règle sans la supprimer.

Où les liens sont injectés

Le module traite les contenus suivants :

• La description du produit sur les pages produit
• Les blocs de contenu de type texte et HTML des pages produit, des pages de navigation (catégories) et des landing pages

L’analyse est effectuée sur l’arbre HTML et ne traite que les nœuds de texte. Les zones suivantes sont systématiquement ignorées :

• L’intérieur des liens existants
• Les titres de niveau 1 à 6
• Les balises de script et de style
• Les boutons

Deux garde-fous complètent ce comportement : les frontières de mots Unicode empêchent tout remplacement à l’intérieur d’un mot, et une page ne se lie jamais à elle-même.

Le mode silo

Le mode silo est destiné aux catalogues structurés en univers thématiques. Lorsqu’il est activé, une règle n’est appliquée que si sa cible partage au moins une branche de catégorie avec la page en cours de rendu.

Concrètement, sur une fiche produit rangée dans la branche Randonnée, seules les règles pointant vers d’autres produits ou catégories de cette branche seront appliquées. Les règles pointant vers une autre branche sont ignorées. Cela concentre le jus de lien à l’intérieur de chaque silo et renforce la cohérence thématique perçue par les moteurs de recherche.

Le rapport de pages orphelines

Depuis la liste des règles, cliquez sur Rapport pages orphelines. Le rapport liste :

• Les produits actifs qui ne sont ciblés par aucune règle active
• Les catégories actives de type page qui ne sont ciblées par aucune règle active

Trois statistiques accompagnent chaque tableau : le nombre total d’éléments actifs, le nombre d’éléments maillés et le nombre d’orphelins. Utilisez ce rapport comme feuille de route : chaque page orpheline est une page qui ne reçoit aucun lien interne de votre catalogue.

Cache et mise en production

Videz le cache après une session de modification des règles :

bin/console cache:clear

Vous pouvez également utiliser le bouton de vidage du cache disponible dans l’administration Shopware.

Dépannage

Aucun lien n’apparaît en boutique

• Vérifiez que le maillage est activé dans la configuration, pour le canal de vente concerné.
• Vérifiez que la règle est active et que sa langue et son canal correspondent bien à la page consultée.
• Videz le cache du storefront.
• Assurez-vous que le mot-clé est réellement présent dans la description, en dehors d’un lien ou d’un titre.

Moins de liens que prévu

Le budget global par page est atteint. Augmentez la valeur dans la configuration, ou réduisez le plafond des règles les moins prioritaires.

Une règle est ignorée sur certaines pages

Le mode silo est probablement actif et la cible de la règle appartient à une autre branche de catégorie. Désactivez le mode silo ou rattachez la cible à la bonne branche.

Un mot-clé est lié au mauvais endroit

Deux règles concurrentes ciblent le même texte. Ajustez la priorité : la valeur la plus basse est traitée en premier.

Désinstallation

Lors de la désinstallation, si vous ne cochez pas l’option de conservation des données, la table des règles est supprimée. Vos descriptions de produits et vos contenus CMS restent intacts, puisqu’ils n’ont jamais été modifiés.