# Documentation du module Sitemap XML avancé PrestaShop (dfsitemap)

> 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,…

- Page: <https://www.datafirefly.com/documentation/dfsitemap/>
- Langue: fr
- Mis à jour le: 2026-11-07
- Autres langues: [en](https://www.datafirefly.com/en/documentation/dfsitemap/index.md), [es](https://www.datafirefly.com/es/documentation/dfsitemap/index.md), [de](https://www.datafirefly.com/de/documentation/dfsitemap/index.md), [it](https://www.datafirefly.com/it/documentation/dfsitemap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfsitemap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfsitemap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfsitemap/index.md)
- Index: <https://www.datafirefly.com/documentation/llms.txt>

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](https://www.datafirefly.com/wp-content/uploads/2026/11/tableau-de-bord-sitemap-xml-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/contenu-liste-sante-sitemap-dfsitemap-fr.webp)

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)](https://www.datafirefly.com/wp-content/uploads/2026/11/controle-qualite-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/fichiers-sitemap-publies-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/visualiseur-sitemap-hreflang-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/reglages-contenu-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/langues-hreflang-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/balises-fichiers-gzip-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/regles-exclusion-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/regle-exclusion-url-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/videos-produit-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/fiche-video-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/tache-cron-sitemap-dfsitemap-fr.webp)

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](https://www.datafirefly.com/wp-content/uploads/2026/11/robots-txt-sitemap-dfsitemap-fr.webp)

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é.
