PS PrestaShop PrestaShop Intermédiaire

DF Faceted SEO — Recherche à facettes et SEO PrestaShop

Indexation intelligente des URLs facettées, landing pages SEO et moteur de filtres haute performance pour PrestaShop 8 et 9.

Mis à jour juin 29, 2026 Version du module 1.0.2

DF Faceted SEO transforme la recherche à facettes de PrestaShop en levier SEO durable et accélère vos pages catégorie de 10 à 30 fois grâce à un index dénormalisé. Cette documentation couvre l’installation, la configuration des règles d’indexation, la création de landing pages SEO et l’exploitation des statistiques de combinaisons populaires.

Présentation

Le module natif ps_facetedsearch génère mécaniquement une URL pour chaque combinaison de filtres possible. Sur un catalogue de quelques milliers de produits avec cinq facettes, cela représente des millions d’URLs que Google explore, diluant votre budget de crawl et votre PageRank entre des pages quasi identiques.

DF Faceted SEO résout ce problème en parallèle de deux manières :

Indexation intelligente : des règles métier décident quelles combinaisons sont indexables, lesquelles reçoivent noindex follow, et où pointe le canonical.
Landing pages SEO dédiées : pour vos combinaisons à fort potentiel commercial (par exemple « chaussures rouges taille 42 »), créez des pages d’atterrissage avec URL propre, H1, meta et contenus personnalisés par langue.

En bonus, le moteur de recherche du module remplace le moteur natif par un système beaucoup plus rapide basé sur un index dénormalisé et un cache deux niveaux.

Pré-requis

PrestaShop 8.0 à 9.x
PHP 8.1 ou supérieur
MySQL 5.7 ou MariaDB 10.3 minimum
URLs simplifiées activées (Préférences → SEO et URLs)
Permissions standards pour création de tables MySQL

Installation

Téléversez l’archive ZIP via Modules → Module Manager → Téléverser un module.
Cliquez sur Installer. Le module crée automatiquement 10 tables ps_dffacetedseo_* et 5 onglets sous Améliorer.
Allez dans Améliorer → DF Faceted SEO → Tableau de bord.
Cliquez sur Reconstruire l’index. Cette étape est obligatoire la première fois : sans index, le moteur de recherche du module n’a aucune donnée à exploiter.
Videz le cache PrestaShop : Paramètres avancés → Performance → Vider le cache.

Sur un catalogue de 50 000 produits, la reconstruction de l’index prend typiquement entre 2 et 5 minutes. Le module insère les lignes par lots de 500.

Premiers pas — Tableau de bord

Le tableau de bord (Améliorer → DF Faceted SEO) affiche six tuiles statistiques :

Règles actives : nombre de règles d’indexation activées
Landing pages : nombre de pages d’atterrissage SEO créées
Produits dans l’index : nombre de produits indexés (doit être proche du total catalogue)
Lignes dans l’index : nombre de couples (produit, valeur de filtre) — c’est la table dénormalisée
Entrées en cache : nombre de requêtes mises en cache
Combinaisons populaires : nombre de combinaisons de filtres observées

Sous les tuiles, deux blocs d’opérations :

Reconstruire l’index : utile après une grosse modification catalogue (import en masse, changement de structure d’attributs)
Vider le cache : utile après une modification de règles ou de paramètres

Règles d’indexation

Les règles décident, pour chaque combinaison de filtres visitée, quelle balise robots et quel canonical sont envoyés au navigateur et à Google. Une règle a un scope (zone d’application) et une politique (décision).

Scopes disponibles

Global : s’applique à toutes les pages facettées du catalogue
Catégorie spécifique : s’applique uniquement aux pages d’une catégorie donnée
Groupe d’attributs : s’applique aux combinaisons contenant un groupe précis (par exemple toutes les pages où Couleur est filtrée)
Feature : idem, pour une caractéristique produit
Marque : idem, pour une marque (manufacturer)
Fourchette de prix : s’applique aux pages filtrées sur une plage tarifaire donnée

Politiques disponibles

Index, follow : page indexable, canonical pointant sur elle-même normalisée
Noindex, follow : page non indexée, mais les liens sont suivis (recommandé pour les combinaisons rares)
Canonical parent : page accessible mais le canonical pointe sur la catégorie parente (la valeur SEO est transférée)
Canonical self normalisé : canonical sur la page elle-même avec les filtres triés et regroupés (élimine les doublons d’URL pour la même combinaison)

Chaîne de priorité

Le module évalue les règles de la plus spécifique à la plus générique. Concrètement, pour une page de la catégorie Chaussures filtrée par couleur :

Le module cherche d’abord une règle scope category sur Chaussures
Si elle existe et matche, elle est appliquée
Sinon il cherche une règle scope attribute_group sur Couleur
Sinon il remonte vers la règle globale
Si aucune règle ne matche, la politique par défaut du tableau de bord est appliquée

Champs avancés d’une règle

Maximum de filtres indexables : si la combinaison contient plus de filtres que cette limite, la politique passe automatiquement en noindex follow. Exemple : 2 filtres maximum sur les chaussures (couleur + taille indexées, mais pas couleur + taille + matière + saison).
Whitelist de valeurs : IDs de valeurs autorisées (séparés par virgules). Une combinaison contenant uniquement des valeurs de la whitelist est indexable. Exemple : whitelister les couleurs rouge, noir, blanc, bleu — les couleurs rares comme « vert pomme » ne seront pas indexées.
Blacklist de valeurs : l’inverse. Toute combinaison contenant une valeur blacklisée tombe automatiquement en noindex.
Minimum de produits : si la combinaison ne retourne pas au moins ce nombre de produits, elle passe en noindex. Évite d’indexer des pages presque vides.
Priorité : entier. En cas de conflit entre deux règles du même scope, la priorité la plus haute gagne.

Stratégie recommandée pour démarrer : créez une règle globale avec politique canonical parent et maximum 1 filtre indexable, puis ajoutez progressivement des règles plus spécifiques pour ouvrir l’indexation des combinaisons à fort potentiel.

Landing pages SEO

Les landing pages sont des pages d’atterrissage dédiées à des combinaisons de filtres stratégiques. Elles ont leur propre URL propre, leur propre H1, leurs propres meta, et un contenu rédactionnel par langue.

Créer une landing page

Allez dans Améliorer → DF Faceted SEO → Landing pages
Cliquez sur Ajouter
Section Ciblage : choisissez la catégorie et éventuellement la marque concernée
Section Affichage : tri par défaut, direction, activation, indexation, priorité
Section Combinaison de filtres : ajoutez les filtres qui composent la combinaison (groupe d’attributs et valeurs, feature, ou marque). Exemple : Couleur = Rouge ET Taille = 42.
Onglets multilingues : renseignez pour chaque langue le nom interne, le slug d’URL, le H1, le meta title, la meta description, le contenu d’intro et le contenu d’outro.
Sauvegardez

Structure d’URL

L’URL d’une landing page suit le motif :

https://votre-domaine.com/landing/votre-slug
https://votre-domaine.com/en/landing/votre-slug
https://votre-domaine.com/fr/landing/votre-slug

Le préfixe de langue est automatiquement géré par le routeur PrestaShop dès que les URLs simplifiées sont activées et que plusieurs langues sont actives sur la boutique.

Si vous avez une 404 sur l’URL d’une landing, vérifiez dans cet ordre : URLs simplifiées activées, .htaccess régénéré (bouton Sauvegarder en bas de SEO et URLs), cache vidé, landing active dans le formulaire, hook moduleRoutes bien attaché au module dans Modules → Positions.

Contenu rédactionnel

Pour chaque langue, vous disposez de deux blocs HTML riches :

Intro : affiché au-dessus de la grille de produits. Idéal pour un paragraphe d’introduction SEO de 150 à 300 mots avec vos mots-clés cibles.
Outro : affiché sous la grille. Idéal pour des éléments de réassurance, des guides d’achat, des FAQ.

JSON-LD automatique

Chaque landing page injecte automatiquement deux blocs JSON-LD dans la page :

BreadcrumbList : Accueil → Catégorie → Landing
Product : un bloc Product par produit affiché (nom, prix, image, URL, disponibilité)

Vous obtenez automatiquement les rich snippets Google sans configuration supplémentaire.

Statistiques des combinaisons populaires

Le module enregistre automatiquement, dans la table ps_dffacetedseo_combination_log, chaque combinaison de filtres réellement visitée par vos clients : signature, nombre de hits, dernière vue.

Exploiter les statistiques

Allez dans Améliorer → DF Faceted SEO → Statistiques
Filtrez par catégorie, nombre minimum de hits, limite d’affichage
Triez par hits décroissants
Repérez les combinaisons à plus de 50 hits par semaine
Cliquez sur Promouvoir dans la colonne action
Le formulaire de landing page s’ouvre pré-rempli avec la combinaison de filtres
Vous n’avez plus qu’à renseigner le contenu rédactionnel et sauvegarder

Maintenance

Le bas de la page Statistiques propose un bouton Purger les anciennes données avec un champ « jours à conserver ». Recommandé : purger tous les 90 jours pour éviter une croissance illimitée de la table.

Paramètres globaux

Le tableau de bord propose 11 paramètres globaux regroupés en 3 sections.

Indexation

Politique par défaut : politique appliquée quand aucune règle ne matche
Maximum de filtres indexables : valeur globale (peut être surchargée par règle)
Minimum de produits par combinaison : seuil global pour considérer une page indexable

Performance

TTL du cache (secondes) : durée de vie d’une entrée en cache. Défaut : 3600 (1 heure). Augmentez à 86400 (24 h) en production stable.
Masquer les filtres vides : si activé, les valeurs avec 0 résultat sont cachées dans le panneau de filtres
Limite de résultats par page : pagination produits

URLs

Préfixe des URLs de landings : par défaut landing. Le motif de route est défini en dur dans le hook moduleRoutes du module et utilise ce préfixe.

Canonical intelligent

Sur chaque page facettée, le module calcule le canonical optimal :

Combinaison qui matche une landing existante : canonical = URL pretty de la landing
Combinaison indexable selon les règles : canonical = self normalisé (filtres triés et regroupés)
Combinaison non indexable selon les règles : canonical = catégorie parente
Page de catégorie sans filtre : canonical = self standard

La normalisation regroupe les valeurs par groupe et trie les groupes par ID. Deux URLs visuellement différentes mais sémantiquement identiques (par exemple ordre des paramètres GET différent) reçoivent le même canonical.

Moteur de filtres haute performance

Le moteur s’appuie sur la table ps_dffacetedseo_index : une ligne par couple (produit, type de filtre, valeur). La recherche se transforme en une intersection d’ensembles d’identifiants produits.

Cache deux niveaux

Niveau 1 : mémoire (in-process). Évite de retaper la même requête deux fois dans la même page.
Niveau 2 : base de données (table ps_dffacetedseo_cache). Persiste les résultats entre les requêtes avec TTL.

Invalidation automatique

Le module écoute les hooks actionProductSave, actionProductDelete et actionCategoryUpdate. Chaque fois qu’un produit est sauvegardé, son entrée dans l’index est régénérée et toutes les entrées de cache liées à ce produit sont invalidées.

AJAX et UX

Le panneau de filtres front est entièrement piloté en AJAX :

Debounce de 250 ms sur les changements de filtres
pushState pour mettre à jour l’URL sans recharger la page
Mise à jour en temps réel des balises canonical et robots dans la tête du document
Scroll fluide vers la grille de produits après mise à jour
Chips actifs cliquables pour retirer un filtre individuel
Slider de prix avec champs numériques et bouton Appliquer
Swatches de couleur visibles sur les attributs de type Couleur

Multiboutique et multilingue

Le module est nativement multi-boutique et multi-langue :

Chaque landing page a des traductions par langue (table ps_dffacetedseo_landing_page_lang)
Chaque landing peut être restreinte à une ou plusieurs boutiques (table ps_dffacetedseo_landing_page_shop)
Les règles d’indexation s’appliquent par défaut à toutes les boutiques
L’index est partitionné par boutique
Les traductions de l’interface sont fournies en français et en anglais (XLIFF dans translations/)

Architecture technique

Hooks utilisés

displayHeader : canonical et meta robots dynamiques
actionFrontControllerSetMedia : CSS et JS frontend
moduleRoutes : route propre pour les landing pages
displayLeftColumn : injection du panneau de filtres
displayBeforeBodyClosingTag : JSON-LD sur les landings
actionProductSearchProviderRunQuery : intégration avec le moteur PS
actionProductSave et actionProductDelete : réindexation incrémentale
actionCategoryUpdate : invalidation du cache catégorie
displayBackOfficeHeader : CSS et JS admin

Tables créées

Table	Rôle
`dffacetedseo_rule`	Règles d’indexation par scope
`dffacetedseo_landing_page`	Landings (données métier)
`dffacetedseo_landing_page_lang`	Traductions des landings
`dffacetedseo_landing_page_shop`	Liens multi-boutique
`dffacetedseo_landing_filter`	Filtres associés aux landings
`dffacetedseo_combination_log`	Statistiques de visite
`dffacetedseo_cache`	Cache résultats requêtes
`dffacetedseo_filter_template`	Templates de filtres réutilisables
`dffacetedseo_index`	Index dénormalisé (clé performance)
`dffacetedseo_setting`	Paramètres internes

Convention d’URL des filtres

?attribute_group__{id_group}=v1,v2&feature__{id_feature}=v3&manufacturer__0=5&price=10-50&s=needle

Une signature SHA-1 stable est calculée pour comparer les combinaisons (matching landing, clé de cache, log).

Performance attendue

Mesures réalisées sur un catalogue de référence (50 000 produits, 8 facettes actives) :

Moteur	Temps moyen
`ps_facetedsearch` natif	800 ms à 1,4 s par requête
DF Faceted SEO sans cache	50 à 120 ms
DF Faceted SEO avec cache	moins de 10 ms

Gain typique : ×10 à ×30

FAQ technique

Faut-il désinstaller ps_facetedsearch

Non, le module s’intègre via les hooks officiels. Vous pouvez le tester en parallèle. Une fois validé, désinstallez ps_facetedsearch pour éviter la duplication du panneau de filtres.

Le module est-il compatible HTTPS et URL canoniques absolus

Oui. Le module utilise Context::getContext()->link->getPageLink() et getModuleLink() qui respectent la configuration HTTPS de PrestaShop.

Comment ajouter une nouvelle langue côté module

Copiez le fichier translations/fr-FR.xlf en translations/xx-XX.xlf et traduisez les trans-unit. Aucune autre intervention nécessaire.

Le module supporte-t-il les attributs composés (combinaisons d’attributs)

Oui. L’index dénormalisé indexe les déclinaisons via leurs attributs. Le moteur de recherche filtre sur les produits dont au moins une déclinaison correspond à tous les filtres actifs.

Comment déboguer une règle qui ne s’applique pas

Activez les logs PrestaShop (Paramètres avancés → Logs) et consultez la section dffacetedseo. Chaque résolution de directive logge la règle matchée et la raison.

Dépannage

Fatal error sur un appel à `getBySlug`

Symptôme : Call to a member function getBySlug() on false. Cause : ancien helper get() qui retournait false au lieu de l’objet service. Corrigé en v1.0.1. Mettez à jour le module.

404 sur l’URL d’une landing page

Symptôme : https://votre-site/en/landing/votre-slug renvoie 404. Cause typique : le hook moduleRoutes n’est pas enregistré ou le cache de routes PrestaShop est obsolète.

Vérifiez que Préférences → SEO et URLs → Activer les URL simplifiées est sur OUI
Sauvegardez cette page (régénère le .htaccess)
Videz le cache PrestaShop deux fois
Allez dans Modules → Positions, vérifiez que dffacetedseo est attaché à moduleRoutes
Fallback de test : https://votre-site/index.php?fc=module&module=dffacetedseo&controller=landing&slug=votre-slug

Le moteur de recherche ne retourne aucun produit

L’index est probablement vide. Allez dans le tableau de bord et cliquez sur Reconstruire l’index.

Les filtres ne s’affichent pas dans la colonne

Vérifiez dans Modules → Positions que dffacetedseo est attaché au hook displayLeftColumn. Selon votre thème, vous pouvez également l’attacher à displayRightColumn ou displayHome.

Performance dégradée après import massif de produits

L’invalidation incrémentale fonctionne bien pour des modifications unitaires. Après un import en masse, il est plus rapide de reconstruire l’index entier depuis le tableau de bord et de vider le cache.

Mises à jour

Le module suit un cycle de versionnage MAJEUR.MINEUR.PATCH. Les correctifs critiques (sécurité, fatal errors) sont fournis sous forme de patch ; les nouvelles fonctionnalités déclenchent un bump mineur. Chaque mise à jour majeure inclut un script upgrade/upgrade-X.Y.Z.php qui s’exécute automatiquement à l’installation de la nouvelle version.

Support

Pour toute question ou rapport de bug, contactez support@datafirefly.com en précisant la version PrestaShop, la version PHP, la version du module et les logs PHP/PrestaShop.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support