PS PrestaShop Débutant

Documentation du module Sitemap XML avancé PrestaShop (dfsitemap)

Installer et configurer dfsitemap 2.0.0 : tableau de bord, contrôle qualité, contenus, hreflang, images et vidéos, règles d'exclusion, cron, robots.txt, IndexNow et multiboutique.

Mis à jour Version du module 2.0.0

Le module Sitemap XML avancé (dfsitemap) génère les sitemaps XML de PrestaShop 1.7.8, 8 et 9 : un index par boutique, un fichier par langue et par type de contenu, avec images, vidéos et balises hreflang réciproques. La version 2.0.0 ajoute un nouveau back-office, un contrôle qualité, un visualiseur intégré et la compression gzip. Cette page couvre l’installation, les réglages, les règles d’exclusion, la planification et le dépannage.

Installation

  1. Téléchargez le ZIP depuis votre compte client DataFirefly.
  2. Dans le back-office, allez dans Modules > Gestionnaire de modules > Installer un module et envoyez le ZIP.
  3. Ouvrez Paramètres de la boutique > Trafic et SEO > Sitemap XML avancé. La barre du module donne accès au tableau de bord, aux réglages, à l’automatisation, aux règles d’exclusion et aux vidéos produit.
  4. Si le module natif Google sitemap (gsitemap) est actif, désactivez-le et supprimez ses fichiers *_sitemap.xml à la racine : le tableau de bord le signale tant qu’il est actif.
  5. Cliquez sur Générer maintenant, puis soumettez l’URL d’index dans Google Search Console et Bing Webmaster Tools.

Le même ZIP fonctionne de PrestaShop 1.7.8 à 9.x, en multiboutique et en multilingue. Le module écrit ses fichiers dfsitemap-*.xml à la racine de la boutique et ses fichiers temporaires dans modules/dfsitemap/var/tmp/.

Mise à jour depuis la 1.1.0

Envoyez le ZIP 2.0.0 comme pour une installation : PrestaShop lance la mise à jour. Les réglages, les règles, les vidéos, la file IndexNow et les sitemaps publiés sont conservés. Si la 1.1.0 avait écrit son bloc dans robots.txt, l’option qui le garde à jour reste active ; sinon elle est désactivée.

Tableau de bord

Le tableau de bord affiche, pour chaque boutique du contexte, l’état des sitemaps (en ligne, régénération en retard, dernière génération en erreur, jamais généré), l’URL de l’index avec les boutons Copier, Parcourir et XML brut, le nombre d’URL, d’images, de vidéos et de fichiers, la date de la dernière génération et celle de la prochaine.

Tableau de bord du sitemap : index publié, nombre d’URL, d’images, de vidéos et de fichiers, dernière et prochaine génération
Tableau de bord du sitemap : index publié, nombre d’URL, d’images, de vidéos et de fichiers, dernière et prochaine génération

Plus bas, le contenu listé par type et la carte Santé vérifient les dossiers accessibles en écriture, les URL simplifiées, la présence de gsitemap ou d’un sitemap.xml physique, le mode maintenance, la déclaration dans robots.txt et le dernier appel de la tâche planifiée.

Contenu listé par type et contrôles de santé : dossiers, URL simplifiées, module gsitemap, robots.txt et tâche planifiée
Contenu listé par type et contrôles de santé : dossiers, URL simplifiées, module gsitemap, robots.txt et tâche planifiée

Contrôle qualité

Le bouton Lancer le contrôle lit chaque fichier publié en flux : élément racine, espaces de noms, limites de 50 000 URL et 50 Mo, URL absolues, encodées et sur le domaine de la boutique. Il ouvre ensuite 20 URL tirées au hasard comme un visiteur non connecté : statut HTTP sans suivre les redirections, en-tête X-Robots-Tag, balise meta robots et URL canonique. Les requêtes ne partent que vers les domaines de la boutique.

Contrôle qualité : fichiers validés et 20 URL testées comme un visiteur (statut HTTP, noindex, URL canonique)
Contrôle qualité : fichiers validés et 20 URL testées comme un visiteur (statut HTTP, noindex, URL canonique)

Une URL « à vérifier » vient en général d’une redirection ajoutée par un autre module ou d’une page réservée à un groupe de clients. Excluez-la avec une règle si elle ne doit pas être indexée.

Les fichiers produits

Pour chaque boutique, le module publie un index dfsitemap-{id boutique}-index.xml qui pointe vers des fichiers nommés par langue et par type, par exemple dfsitemap-1-fr-product-1.xml. Quand un fichier atteint le nombre d’URL fixé, ou avant 45 Mo, la suite part dans -2, -3, etc. Avec la compression gzip, les fichiers sont publiés en .xml.gz et l’index reste non compressé.

La date lastmod de chaque fichier dans l’index est celle du dernier changement de son contenu : un fichier identique à la génération précédente garde sa date.

Fichiers publiés : URL par fichier, taille et date de dernière modification réelle du contenu
Fichiers publiés : URL par fichier, taille et date de dernière modification réelle du contenu

Le bouton Parcourir ouvre un visualiseur dans le back-office : URL, nombre d’images et de vidéos, langues hreflang et date de modification, par pages de 100, avec un filtre. Il remplace l’affichage XSLT, que Chrome est en train de retirer.

Visualiseur intégré : URL, images, vidéos, langues hreflang et date de modification d’un fichier sitemap
Visualiseur intégré : URL, images, vidéos, langues hreflang et date de modification d’un fichier sitemap

Si les URL simplifiées sont activées, l’index est aussi servi à l’adresse /sitemap.xml du domaine de chaque boutique. Les fichiers sont construits dans un dossier temporaire puis publiés boutique par boutique : les anciens sitemaps restent en ligne pendant la génération.

Réglages

Les réglages suivent le contexte multiboutique : en contexte d’une boutique, les valeurs enregistrées ne concernent que cette boutique. Un indicateur signale les modifications non enregistrées.

Contenu

  • Types de contenu : pages statiques, produits, catégories, pages CMS, catégories CMS, marques, fournisseurs, URL personnalisées. Seul le contenu actif est listé.
  • Pages statiques : accueil, meilleures ventes, nouveautés, promotions, listes des marques et des fournisseurs, magasins, contact, plan du site. Une page désactivée dans les préférences de la boutique (marques, fournisseurs, meilleures ventes) est ignorée.
  • Produits visibles en recherche seulement : par défaut, seuls les produits en visibilité Partout ou Catalogue uniquement sont listés.
  • Exclure les contenus réservés à des groupes de clients (activé par défaut) : les produits et catégories qu’un visiteur non connecté ne peut pas ouvrir, et qui répondraient 403, ne sont pas listés.
Réglages du contenu : types de pages, pages statiques, visibilité des produits et exclusion des contenus réservés
Réglages du contenu : types de pages, pages statiques, visibilité des produits et exclusion des contenus réservés

Une page CMS dont l’option Indexation par les moteurs de recherche est désactivée est servie par PrestaShop avec une balise noindex. Le module ne la liste pas et affiche le nombre de pages concernées.

Langues et hreflang

  • Langues : laissez tout coché pour suivre les langues actives de chaque boutique. Le code hreflang de chaque langue est affiché.
  • Alternatives hreflang : chaque URL liste toutes ses traductions, elle comprise, pour que les annotations soient réciproques.
  • Code hreflang : langue et région (fr-FR, tiré du code de langue de International > Langues) ou langue seule (fr). Deux langues qui partageraient un code gardent leur région.
  • Langue x-default : langue par défaut de la boutique, une langue précise, ou aucune.
Langues et hreflang : codes langue-région, annotations réciproques et langue x-default
Langues et hreflang : codes langue-région, annotations réciproques et langue x-default

Images et vidéos

  • Sitemap images et toutes les images produit (sinon la couverture seule), dans le format d’image choisi.
  • Images des catégories, marques et fournisseurs.
  • Sitemap vidéos et détection YouTube et Vimeo dans les descriptions produit et les pages CMS. Pour Vimeo, le titre et la miniature sont lus une fois sur le service public oEmbed de Vimeo, puis gardés en cache.

Balises et fichiers

  • lastmod : date réelle de dernière mise à jour des produits, catégories, catégories CMS, marques et fournisseurs. Les pages sans date fiable n’ont pas de lastmod.
  • changefreq et priority : désactivées par défaut, Google les ignore.
  • Affichage lisible dans le navigateur (XSLT) : feuille de style dans la langue de chaque fichier. Désactivé par défaut pour les nouvelles installations, car Chrome retire XSLT ; utilisez le visualiseur du back-office.
  • Compresser les sitemaps (gzip) et URL par fichier : 10 000 par défaut, entre 100 et 50 000, avec un découpage avant 45 Mo.
Balises et fichiers : lastmod réel, affichage XSLT, compression gzip et découpage des fichiers
Balises et fichiers : lastmod réel, affichage XSLT, compression gzip et découpage des fichiers

URL supplémentaires

  • URL personnalisées : une par ligne ; un chemin relatif comme /blog/ est ajouté à l’URL de la boutique. Seules les URL du domaine de la boutique sont gardées, comme l’exige le protocole.
  • Sitemaps supplémentaires : URL absolues de sitemaps produits ailleurs, ajoutées à l’index. Un sitemap d’un autre domaine n’est lu que si les deux sites sont validés dans le même compte Search Console.

Génération

  • Fréquence : de toutes les heures à une fois par semaine, utilisée par le cron.
  • Éléments par lot (50 par défaut) et budget de temps par requête (20 secondes, limité à 15 secondes depuis le back-office).
  • Régénérer quand le contenu change : après l’enregistrement d’un produit, d’une catégorie, d’une page CMS, d’une marque ou d’un fournisseur, le prochain appel cron régénère sans attendre la fréquence, au plus une fois par heure.

Règles d’exclusion

Les contenus inactifs, les produits masqués du catalogue et les pages réservées à certains groupes de clients ne sont jamais listés. Les règles retirent des contenus en ligne qui ne doivent pas être indexés. Chaque règle s’applique à toutes les boutiques ou à une seule, et prend effet à la génération suivante.

Règles d’exclusion : par texte d’URL, par identifiant, produits sans image, par boutique
Règles d’exclusion : par texte d’URL, par identifiant, produits sans image, par boutique
  • Produits : par ID, dans une catégorie (sous-catégories comprises), d’une marque, d’un fournisseur par défaut, en rupture de stock, à prix zéro, sans image.
  • Catégories : par ID, ou une catégorie et toutes ses sous-catégories.
  • Pages CMS : par ID, ou une catégorie CMS avec ses pages. Marques et fournisseurs : par ID.
  • URL contient un texte et URL correspond à une expression régulière : une valeur par ligne, sans tenir compte de la casse. Une expression invalide est refusée à l’enregistrement.
Création d’une règle d’exclusion : URL contenant un texte, une valeur par ligne, toutes les boutiques
Création d’une règle d’exclusion : URL contenant un texte, une valeur par ligne, toutes les boutiques

Une URL exclue par une règle disparaît aussi des alternatives hreflang de ses traductions.

Vidéos produit

L’onglet Vidéos produit sert aux vidéos hébergées hors YouTube et Vimeo, ou quand vous voulez un titre et une description précis. Pour chaque vidéo : le produit (recherche par nom, référence ou ID), le titre et la description par langue, l’URL de la miniature, l’URL du fichier vidéo ou du lecteur, la durée en secondes et la boutique.

Vidéos produit ajoutées au sitemap vidéo, avec miniature, titre et durée
Vidéos produit ajoutées au sitemap vidéo, avec miniature, titre et durée
Fiche d’une vidéo : produit, titre et description par langue, miniature, URL du lecteur et durée
Fiche d’une vidéo : produit, titre et description par langue, miniature, URL du lecteur et durée

Lancer la génération

Depuis le back-office

Générer maintenant lance la génération pour les boutiques du contexte, avec une barre de progression. Si vous fermez la page, la tâche reste enregistrée : Reprendre dans cette fenêtre la poursuit, ou le cron s’en charge. Annuler arrête la tâche, les sitemaps en ligne restent inchangés.

Par le cron

L’onglet Automatisation affiche une URL de la forme https://votre-boutique.fr/module/dfsitemap/cron?token=..., protégée par un jeton secret. Appelez-la toutes les 5 minutes depuis le gestionnaire cron de votre hébergement. Chaque appel travaille pendant le budget de temps, puis l’appel suivant reprend. Paramètres facultatifs : force=1 et id_shop=1,2. La carte affiche le dernier appel reçu (HTTP ou CLI) ; Générer un nouveau jeton invalide l’ancienne URL.

Automatisation : URL cron protégée par jeton, commande CLI, moteurs de recherche et IndexNow
Automatisation : URL cron protégée par jeton, commande CLI, moteurs de recherche et IndexNow

En ligne de commande

php /chemin/vers/prestashop/modules/dfsitemap/cron.php
php /chemin/vers/prestashop/modules/dfsitemap/cron.php --force --shop=1

Le script traite toute la tâche d’un seul coup. Il refuse d’être appelé par le web et renvoie le code de sortie 1 en cas d’erreur.

Si une requête est coupée en pleine génération, la tâche reprend à la dernière position enregistrée et les fichiers en cours sont réparés. Le verrou de la requête coupée expire après le budget de temps plus 90 secondes.

robots.txt

Le module ne modifie jamais robots.txt de lui-même. La carte robots.txt de l’onglet Automatisation montre les lignes qu’il ajouterait, entre # BEGIN dfsitemap et # END dfsitemap, et propose d’ajouter, mettre à jour ou retirer ce bloc. Le reste du fichier est gardé tel quel et une copie de la version précédente est enregistrée dans modules/dfsitemap/var/. L’option Garder les lignes Sitemap quand PrestaShop régénère robots.txt (désactivée par défaut) réécrit le bloc à chaque génération du fichier depuis Trafic et SEO. La désinstallation retire uniquement ce bloc.

robots.txt : aperçu du bloc dfsitemap, ajout ou retrait uniquement sur demande
robots.txt : aperçu du bloc dfsitemap, ajout ou retrait uniquement sur demande

Moteurs de recherche et IndexNow

Google (depuis 2023) et Bing (depuis 2022) n’acceptent plus le ping anonyme de sitemap : le module n’en envoie aucun. Déclarez l’index une fois dans Google Search Console, dans Bing Webmaster Tools ou par une ligne Sitemap: de robots.txt. Un sitemap aide les moteurs à découvrir les URL, il ne garantit pas leur indexation.

IndexNow, désactivé par défaut, annonce les pages créées ou modifiées à Bing et aux autres moteurs du protocole. Google ne l’utilise pas. Une fois activé, le module crée un fichier clé à la racine, met en file chaque produit, catégorie, page CMS, marque ou fournisseur enregistré, puis envoie leurs URL au prochain appel cron, uniquement pour le contenu listé dans le sitemap. La carte IndexNow affiche la file, le fichier clé et le dernier envoi ; en cas de réponse 429 ou 5xx, la file est conservée.

Multiboutique

Chaque boutique a son index sur son propre domaine, ses langues et ses réglages. Sélectionnez une boutique dans le menu multiboutique pour lui donner des valeurs propres. En contexte Toutes les boutiques, le tableau de bord affiche une carte par boutique.

Pour les développeurs : ajouter des URL

Un module peut ajouter ses pages en s’accrochant au hook actionDfSitemapUrls. Le hook reçoit id_shop, languages (id_lang => code ISO) et link, et renvoie une liste d’entrées :

public function hookActionDfSitemapUrls($params)
{
    $loc = [];
    foreach ($params['languages'] as $idLang => $iso) {
        $loc[$idLang] = $params['link']->getBaseLink($params['id_shop']) . $iso . '/blog/mon-article';
    }

    return [
        ['loc' => $loc, 'lastmod' => '2026-09-01 10:00:00', 'images' => ['https://.../image.jpg']],
    ];
}

Une entrée indexée par langue reçoit les balises hreflang comme une page native. Les URL d’un autre domaine et les entrées invalides sont ignorées.

Questions fréquentes

Le contrôle qualité signale une redirection

Un autre module redirige cette page (par exemple vers une page de composition). Listez l’URL finale ou excluez celle-ci avec une règle URL contient un texte.

Un produit n’apparaît pas

Vérifiez qu’il est actif, en visibilité Partout ou Catalogue, et rangé dans au moins une catégorie accessible aux visiteurs non connectés. Vérifiez aussi les règles d’exclusion.

Le sitemap ne contient aucune page CMS

Activez l’option Indexation par les moteurs de recherche sur les pages à indexer.

La génération reste sur « Un autre processus traite la tâche »

Une autre requête tient le verrou, souvent le cron. Si elle a été coupée, le verrou expire au bout du délai affiché et la génération reprend seule.

IndexNow renvoie 403 ou 422

Le moteur ne trouve pas le fichier clé ou refuse l’hôte. Ouvrez l’URL du fichier clé affichée dans la carte IndexNow : elle doit afficher la clé.

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

Toujours bloqué ? Contactez le support