DF Glossary — Glossaire SEO pour PrestaShop 8 & 9

Présentation

DF Glossary transforme votre vocabulaire métier en actif SEO. Vous saisissez vos termes une seule fois — avec une définition courte et une définition longue — et le module fait trois choses automatiquement : il injecte un lien avec infobulle sur chaque occurrence du terme dans vos descriptions produits, catégories et pages CMS ; il publie une page de définition indexable par terme ; et il relie chaque définition aux produits que vous lui associez.

Le résultat est un maillage interne bidirectionnel qui se construit sans effort éditorial : vos fiches renforcent vos définitions, vos définitions renforcent vos produits, et vos définitions se renforcent entre elles.

Installation

Prérequis

• PrestaShop 8.0, 8.1, 8.2 ou 9.x
• PHP 7.4 à 8.3
• MySQL 5.7 / MariaDB 10.3 ou supérieur
• URLs simplifiées activées (Paramètres de la boutique, Trafic et SEO) — indispensable pour les pages du glossaire

Procédure

1. Dans le back-office, allez dans Modules → Gestionnaire de modules → Installer un module.
2. Uploadez le fichier dfglossary-1.0.0.zip.
3. L’installation crée quatre tables SQL, un onglet de back-office et les clés de configuration par défaut.
4. Un nouvel onglet Catalogue → Glossaire SEO apparaît dans le menu. C’est là que vous gérez vos termes.
5. Cliquez sur Configurer depuis le gestionnaire de modules pour accéder aux réglages globaux.

Configuration du module

Le panneau de configuration se divise en trois sections.

Activation et mode d’injection

• Activer l’injection — interrupteur maître. Désactivé, le module cesse d’enrichir vos contenus, mais les pages du glossaire restent en ligne et indexées.
• Mode — trois valeurs possibles :
  • Lien + infobulle (par défaut) : le terme devient un lien vers sa page de définition et affiche l’infobulle au survol. C’est le mode qui combine bénéfice SEO et bénéfice conversion.
  • Lien seul : le terme devient un lien, sans infobulle. À privilégier si vous ne visez que le maillage interne.
  • Infobulle seule : le terme affiche la définition au survol, sans devenir un lien. À privilégier si vous voulez de la pédagogie sans ajouter de liens sortants dans vos fiches produits.

Limites (garde-fous anti-suroptimisation)

• Occurrences maximum par terme — 1 par défaut. Même si un mot apparaît huit fois dans une description, seule la première occurrence devient un lien. Nous recommandons fortement de conserver cette valeur : un seul lien par notion suffit à transmettre le signal sémantique, et les suivants diluent le PageRank interne sans rien apporter.
• Liens maximum par contenu — 10 par défaut, tous termes confondus. Au-delà, le moteur s’arrête, quels que soient les termes restants.

Contenus ciblés

Quatre interrupteurs indépendants déterminent où l’injection s’applique :

• Descriptions produits — la description longue.
• Inclure la description courte — option distincte. Attention : la description courte s’affiche souvent en haut de fiche et dans les listings ; y placer des liens peut être excessif.
• Descriptions de catégories — description et description additionnelle.
• Pages CMS et catégories CMS — contenu des pages CMS.

Base d’URL

Le champ Base d’URL définit le segment sous lequel les pages du glossaire sont publiées. Valeur par défaut : glossaire, ce qui donne /glossaire pour l’index et /glossaire/toile-enduite pour une fiche de terme. Le champ est validé comme une réécriture de lien : uniquement des lettres, chiffres et tirets.

Gérer les termes

Rendez-vous dans Catalogue → Glossaire SEO. La liste affiche tous vos termes avec leur slug, leur état d’auto-liaison et leur statut. Vous pouvez rechercher, trier, filtrer, activer ou désactiver en un clic, et supprimer en masse.

Créer un terme

Cliquez sur Ajouter un terme. Le formulaire est entièrement multilingue : chaque champ texte se saisit langue par langue.

• Terme — le libellé exact recherché dans vos contenus. La correspondance est insensible à la casse et respecte les frontières de mots.
• Slug — l’identifiant dans l’URL. Laissez vide pour qu’il soit généré automatiquement à partir du nom.
• Synonymes — liste séparée par des virgules. Pluriels, abréviations, variantes orthographiques : toutes ces formes déclenchent le même lien et la même infobulle.
• Définition courte — c’est le texte de l’infobulle. Texte brut recommandé. Elle est tronquée à 180 caractères dans la bulle, mais s’affiche en entier en tête de la page de définition.
• Définition longue — éditeur riche. C’est le corps de la page de définition, et le contenu qui va se positionner dans Google.
• Meta title / Meta description — optionnels. En leur absence, le module se rabat automatiquement sur le nom du terme et la définition courte.
• Produits associés — liste d’IDs produits séparés par des virgules. Leurs vignettes s’afficheront sur la page du terme.
• Auto-liaison — interrupteur individuel. Désactivé, le terme conserve sa page de définition indexée mais n’est jamais injecté dans les contenus.
• Actif — désactivé, le terme disparaît du glossaire et sa page renvoie une 404 propre.

Bonnes pratiques éditoriales

• Visez 20 à 50 termes. Le volume n’est pas la variable importante : un terme mérite sa place s’il apparaît réellement dans vos descriptions et s’il correspond à une question que vos clients se posent.
• Rédigez des définitions longues de 150 à 400 mots. Assez pour constituer un contenu autonome aux yeux de Google, assez court pour être produit rapidement.
• Associez 2 à 6 produits par terme, pas davantage. Une page de définition qui pointe vers vingt produits dilue son autorité.
• Soignez les synonymes. C’est le levier qui multiplie la couverture : un catalogue rédigé sur plusieurs années par plusieurs personnes exprime rarement un même concept d’une seule façon.
• Ne traduisez pas les synonymes mot à mot. Chaque langue a ses propres variantes ; saisissez-les indépendamment.

Comment fonctionne l’injection

L’enrichissement s’effectue côté serveur, au moment du rendu de la page, via les hooks de filtrage de contenu de PrestaShop. Vos descriptions ne sont jamais modifiées en base de données : si vous désactivez le module, vos contenus retrouvent immédiatement leur état d’origine.

Le moteur de remplacement

Le contenu est découpé en segments balises et segments texte. Seuls les segments texte sont candidats au remplacement. Les zones suivantes sont systématiquement ignorées :

• liens existants (aucun risque de créer un lien imbriqué),
• titres h1, h2 et h3,
• blocs script, style, code, pre, svg, noscript,
• champs de formulaire : textarea, select, option, button,
• iframes.

Sur les segments autorisés, la recherche utilise des frontières de mots Unicode : impossible de transformer un fragment situé à l’intérieur d’un mot ou d’un identifiant. La correspondance ignore la casse et tolère les espaces multiples ou les retours à la ligne. Enfin, chaque lien injecté est temporairement remplacé par un jeton unique le temps du traitement — un terme ne peut donc jamais être re-lié à l’intérieur d’un lien que le module vient lui-même de créer.

Ordre de priorité des variantes

Toutes les variantes d’un terme (nom principal et synonymes) sont fusionnées puis triées par longueur décroissante. L’expression la plus longue gagne toujours. Concrètement, si toile enduite PVC et toile enduite figurent tous deux dans vos synonymes, c’est le premier qui sera lié lorsqu’il apparaît en entier.

Les pages du glossaire

Page d’index

Accessible à /glossaire, elle liste tous les termes actifs, groupés par lettre, avec une navigation alphabétique et un extrait par terme. Elle émet un JSON-LD de type DefinedTermSet.

Page de définition

Accessible à /glossaire/{slug}, chaque fiche comporte :

• un titre H1 et la définition courte mise en avant,
• la définition longue au format riche, dans laquelle les autres termes du glossaire sont automatiquement liés à leur tour (le terme courant est exclu, pas d’auto-lien),
• les vignettes des produits associés,
• un nuage de termes connexes,
• meta title et meta description dédiés, URL canonique, fil d’Ariane,
• un JSON-LD de type DefinedTerm.

Si un slug n’existe pas ou si le terme est désactivé, la page renvoie une 404 propre.

Multilingue et multi-boutique

Tous les champs texte du glossaire sont multilingues : nom, synonymes, définitions, slug, meta title et meta description peuvent différer dans chaque langue. Le matching s’effectue toujours dans la langue du contexte courant : une description française ne sera jamais enrichie avec des termes anglais.

Côté multi-boutique, les termes sont rattachés aux boutiques via la table d’association standard de PrestaShop. Vous pouvez donc avoir un glossaire technique dense sur une boutique B2B et un glossaire vulgarisé sur une boutique B2C, dans la même installation.

Comportement sur mobile

Il n’y a pas de survol sur un écran tactile. Le module charge un mini-script qui gère le tap : le premier tap sur un terme affiche l’infobulle et bloque la navigation, le second tap ouvre la page de définition. Les autres infobulles ouvertes se referment automatiquement, et un tap en dehors du terme ferme la bulle.

Performance

Le dictionnaire des termes est chargé une seule fois par requête et mis en cache statique : même une page catégorie affichant trente produits ne déclenche qu’une seule requête SQL pour le glossaire. Le remplacement lui-même est une manipulation de chaîne en PHP, de l’ordre de la milliseconde. Aucun JavaScript bloquant n’est chargé, aucun appel réseau n’est effectué, et le résultat est parfaitement compatible avec le cache full-page.

Dépannage

Aucun lien n’apparaît dans mes fiches produits

• Vérifiez que l’interrupteur maître Activer l’injection est bien sur Oui.
• Vérifiez que Descriptions produits est activé dans les contenus ciblés.
• Vérifiez que le terme est actif et que son auto-liaison est activée.
• Vérifiez que le terme est bien renseigné dans la langue de la fiche consultée — un terme saisi uniquement en français ne sera jamais injecté dans une description anglaise.
• Videz le cache PrestaShop (Paramètres avancés → Performances).

Le terme apparaît dans le texte mais n’est pas lié

Trois causes possibles. Soit le terme est déjà à l’intérieur d’un lien, d’un titre h1–h3 ou d’une zone protégée — c’est le comportement voulu. Soit la limite d’occurrences par terme (1 par défaut) est déjà atteinte pour ce contenu : les occurrences suivantes restent en texte brut, c’est normal. Soit la limite globale de 10 liens par contenu est atteinte.

Les pages du glossaire renvoient une 404

• Vérifiez que les URLs simplifiées sont activées.
• Régénérez le fichier .htaccess (Paramètres de la boutique → Trafic et SEO → Générer le fichier .htaccess).
• Vérifiez que le terme est actif et que son slug est bien renseigné dans la langue consultée.

Les infobulles ne s’affichent pas

Vérifiez que le mode n’est pas réglé sur Lien seul. Si le mode est correct, videz le cache et vérifiez que la feuille de style du module est bien chargée (elle est ajoutée automatiquement sur toutes les pages du front).

Désinstallation

La désinstallation supprime les quatre tables SQL du module, l’onglet de back-office et l’ensemble des clés de configuration. Vos termes sont donc définitivement perdus — exportez-les si vous comptez réinstaller plus tard. En revanche, aucune description produit, catégorie ou CMS n’a jamais été modifiée en base : vos contenus retrouvent simplement leur état d’origine, sans aucun nettoyage à effectuer.

Limites connues

• L’unicité des slugs n’est pas forcée par langue. Si deux termes partagent le même slug dans la même langue, le premier trouvé gagne. Vérifiez vos slugs à la saisie.
• Les zones protégées (liens, titres h1–h3, code, formulaires) ne sont jamais enrichies. C’est un choix de conception, pas une limitation contournable.