# Documentatie van de module Geavanceerde XML-sitemap voor PrestaShop (dfsitemap)

> De module Geavanceerde XML-sitemap (dfsitemap) genereert de XML-sitemaps van PrestaShop 1.7.8, 8 en 9: één index per winkel, één bestand per taal en per inhoudstype, met afbeeldingen, video's en wederkerige…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfsitemap/>
- Taal: nl
- Bijgewerkt op: 2026-11-07
- Andere talen: [fr](https://www.datafirefly.com/documentation/dfsitemap/index.md), [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), [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/nl/documentation/llms.txt>

De module **Geavanceerde XML-sitemap** (dfsitemap) genereert de XML-sitemaps van PrestaShop 1.7.8, 8 en 9: één index per winkel, één bestand per taal en per inhoudstype, met afbeeldingen, video's en wederkerige hreflang-tags. Versie 2.0.0 voegt een nieuwe back-office, een kwaliteitscontrole, een ingebouwde viewer en gzip-compressie toe. Deze pagina behandelt installatie, instellingen, uitsluitingsregels, planning en probleemoplossing.

## Installatie

1. Download de ZIP uit uw DataFirefly-klantaccount.
2. Ga in de back-office naar _Modules > Modulebeheer > Een module uploaden_ en verzend de ZIP.
3. Open _Winkelparameters > Verkeer & SEO > Geavanceerde XML-sitemap_. De modulebalk geeft toegang tot dashboard, instellingen, automatisering, uitsluitingsregels en productvideo's.
4. Is de native module _Google sitemap_ (gsitemap) actief, schakel hem dan uit en verwijder zijn `*_sitemap.xml`-bestanden in de hoofdmap: het dashboard meldt het zolang hij actief is.
5. Klik op _Nu genereren_ en dien de index-URL in bij Google Search Console en Bing Webmaster Tools.

Dezelfde ZIP werkt van PrestaShop 1.7.8 tot 9.x, in multistore en meertalig. De module schrijft zijn `dfsitemap-*.xml`-bestanden in de hoofdmap van de winkel en zijn tijdelijke bestanden in `modules/dfsitemap/var/tmp/`.

### Bijwerken vanaf 1.1.0

Upload de ZIP 2.0.0 zoals bij een installatie: PrestaShop voert de update uit. Instellingen, regels, video's, de IndexNow-wachtrij en gepubliceerde sitemaps blijven behouden. Had 1.1.0 zijn blok in robots.txt geschreven, dan blijft de optie die het bijwerkt actief; anders is ze uitgeschakeld.

## Dashboard

Voor elke winkel in de context toont het dashboard de status van de sitemaps (online, regeneratie achterstallig, laatste generatie mislukt, nooit gegenereerd), de index-URL met de knoppen _Kopiëren_, _Bekijken_ en ruwe XML, het aantal URL's, afbeeldingen, video's en bestanden, en de datum van de laatste en volgende generatie.

![Sitemapdashboard: gepubliceerde index, aantal URL’s, afbeeldingen, video’s en bestanden, laatste en volgende generatie](https://www.datafirefly.com/wp-content/uploads/2026/11/xml-sitemap-dashboard-dfsitemap-nl.webp)

Sitemapdashboard: gepubliceerde index, aantal URL’s, afbeeldingen, video’s en bestanden, laatste en volgende generatie

Daaronder controleren de vermelde inhoud per type en de kaart _Gezondheid_ beschrijfbare mappen, vriendelijke URL's, gsitemap of een fysiek `sitemap.xml`, de onderhoudsmodus, de vermelding in robots.txt en de laatste aanroep van de geplande taak.

![Vermelde inhoud per type en gezondheidscontroles: mappen, vriendelijke URL’s, gsitemap-module, robots.txt en geplande taak](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-inhoud-gezondheid-dfsitemap-nl.webp)

Vermelde inhoud per type en gezondheidscontroles: mappen, vriendelijke URL’s, gsitemap-module, robots.txt en geplande taak

## Kwaliteitscontrole

De knop _Controle starten_ leest elk gepubliceerd bestand als stroom: hoofdelement, namespaces, limieten van 50.000 URL's en 50 MB, absolute en gecodeerde URL's op het domein van de winkel. Daarna opent hij 20 willekeurige URL's als een niet-ingelogde bezoeker: HTTP-status zonder doorverwijzingen te volgen, header `X-Robots-Tag`, meta robots en canonieke URL. Verzoeken gaan alleen naar de domeinen van de winkel.

![Kwaliteitscontrole: bestanden gevalideerd en 20 URL’s getest als een bezoeker (HTTP-status, noindex, canonieke URL)](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-kwaliteitscontrole-dfsitemap-nl.webp)

Kwaliteitscontrole: bestanden gevalideerd en 20 URL’s getest als een bezoeker (HTTP-status, noindex, canonieke URL)

Een URL „na te kijken” komt meestal van een doorverwijzing door een andere module of van een pagina die voorbehouden is aan een klantgroep. Sluit hem uit met een regel als hij niet geïndexeerd mag worden.

## De bestanden

Voor elke winkel publiceert de module een index `dfsitemap-{winkel-id}-index.xml` die verwijst naar bestanden per taal en type, bijvoorbeeld `dfsitemap-1-nl-product-1.xml`. Bereikt een bestand het ingestelde aantal URL's, of 45 MB, dan gaat de rest naar `-2`, `-3` enzovoort. Met gzip-compressie worden de bestanden als `.xml.gz` gepubliceerd en blijft de index ongecomprimeerd.

De `lastmod` van elk bestand in de index is de datum van de laatste inhoudswijziging: een bestand dat gelijk is aan de vorige generatie behoudt zijn datum.

![Gepubliceerde bestanden: URL’s per bestand, grootte en werkelijke datum van de laatste inhoudswijziging](https://www.datafirefly.com/wp-content/uploads/2026/11/gepubliceerde-sitemapbestanden-dfsitemap-nl.webp)

Gepubliceerde bestanden: URL’s per bestand, grootte en werkelijke datum van de laatste inhoudswijziging

De knop _Bekijken_ opent een viewer in de back-office: URL's, aantal afbeeldingen en video's, hreflang-talen en wijzigingsdatum, 100 per pagina, met een filter. Hij vervangt de XSLT-weergave die Chrome schrapt.

![Ingebouwde viewer: URL’s, afbeeldingen, video’s, hreflang-talen en wijzigingsdatum van een sitemapbestand](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemapviewer-hreflang-dfsitemap-nl.webp)

Ingebouwde viewer: URL’s, afbeeldingen, video’s, hreflang-talen en wijzigingsdatum van een sitemapbestand

Met vriendelijke URL's ingeschakeld wordt de index ook geleverd op `/sitemap.xml` op het domein van elke winkel. De bestanden worden in een tijdelijke map opgebouwd en winkel per winkel gepubliceerd: de vorige sitemaps blijven online tijdens de generatie.

## Instellingen

De instellingen volgen de multistore-context: in de context van één winkel gelden opgeslagen waarden alleen voor die winkel. Een indicator toont niet-opgeslagen wijzigingen.

### Inhoud

- **Inhoudstypes**: statische pagina's, producten, categorieën, CMS-pagina's, CMS-categorieën, merken, leveranciers, eigen URL's. Alleen actieve inhoud wordt vermeld.
- **Statische pagina's**: startpagina, bestsellers, nieuwe producten, aanbiedingen, merk- en leverancierslijsten, winkels, contact, sitemappagina. Een pagina die in de winkelvoorkeuren is uitgeschakeld (merken, leveranciers, bestsellers) wordt overgeslagen.
- **Producten alleen zichtbaar in de zoekfunctie**: standaard worden alleen producten met de zichtbaarheid Overal of Alleen catalogus vermeld.
- **Inhoud voorbehouden aan klantgroepen weglaten** (standaard aan): producten en categorieën die een niet-ingelogde bezoeker niet kan openen en die 403 zouden antwoorden, worden niet vermeld.

![Inhoudsinstellingen: paginatypes, statische pagina’s, productzichtbaarheid en uitsluiting van beperkte inhoud](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-inhoud-instellingen-dfsitemap-nl.webp)

Inhoudsinstellingen: paginatypes, statische pagina’s, productzichtbaarheid en uitsluiting van beperkte inhoud

Een CMS-pagina waarvan de optie _Indexering door zoekmachines_ uit staat, wordt door PrestaShop met noindex geleverd. De module vermeldt haar niet en toont hoeveel pagina's het betreft.

### Talen en hreflang

- **Talen**: laat alles aangevinkt om de actieve talen van elke winkel te volgen. De hreflang-code van elke taal wordt getoond.
- **hreflang-alternatieven**: elke URL vermeldt al zijn vertalingen, zichzelf inbegrepen, zodat de annotaties wederkerig zijn.
- **hreflang-code**: taal en regio (`nl-NL`, uit de taalcode van _Internationaal > Talen_) of alleen taal (`nl`). Twee talen die een code zouden delen, behouden hun regio.
- **x-default-taal**: standaardtaal van de winkel, een bepaalde taal of geen.

![Talen en hreflang: taal-regiocodes, wederkerige annotaties en x-default-taal](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-talen-hreflang-dfsitemap-nl.webp)

Talen en hreflang: taal-regiocodes, wederkerige annotaties en x-default-taal

### Afbeeldingen en video's

- **Afbeeldingensitemap** en **alle productafbeeldingen** (anders alleen de hoofdafbeelding), in het gekozen formaat.
- **Afbeeldingen van categorieën, merken en leveranciers**.
- **Videositemap** en **detectie van YouTube en Vimeo** in productbeschrijvingen en CMS-pagina's. Voor Vimeo worden titel en miniatuur één keer gelezen via de openbare oEmbed-dienst van Vimeo en daarna in de cache bewaard.

### Tags en bestanden

- **lastmod**: werkelijke datum van de laatste update van producten, categorieën, CMS-categorieën, merken en leveranciers. Pagina's zonder betrouwbare datum krijgen geen lastmod.
- **changefreq en priority**: standaard uit, Google negeert ze.
- **Leesbare weergave in de browser (XSLT)**: stijlblad in de taal van elk bestand. Standaard uit bij nieuwe installaties omdat Chrome XSLT schrapt; gebruik de viewer in de back-office.
- **Sitemaps comprimeren (gzip)** en **URL's per bestand**: standaard 10.000, tussen 100 en 50.000, opsplitsing vóór 45 MB.

![Tags en bestanden: echte lastmod, XSLT-weergave, gzip-compressie en opsplitsing van bestanden](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-tags-bestanden-gzip-dfsitemap-nl.webp)

Tags en bestanden: echte lastmod, XSLT-weergave, gzip-compressie en opsplitsing van bestanden

### Extra URL's

- **Eigen URL's**: één per regel; een relatief pad zoals `/blog/` wordt aan de winkel-URL toegevoegd. Alleen URL's op het domein van de winkel worden behouden, zoals het protocol vereist.
- **Extra sitemaps**: absolute URL's van elders aangemaakte sitemaps, toegevoegd aan de index. Een sitemap van een ander domein wordt alleen gelezen als beide sites in hetzelfde Search Console-account zijn geverifieerd.

### Generatie

- **Frequentie**: van elk uur tot één keer per week, gebruikt door de cron.
- **Items per batch** (standaard 50) en **tijdsbudget per verzoek** (20 seconden, beperkt tot 15 seconden vanuit de back-office).
- **Opnieuw genereren als de inhoud wijzigt**: na het opslaan van een product, categorie, CMS-pagina, merk of leverancier genereert de volgende cron-aanroep opnieuw zonder de frequentie af te wachten, hoogstens één keer per uur.

## Uitsluitingsregels

Inactieve inhoud, producten die in de catalogus verborgen zijn en pagina's die voorbehouden zijn aan bepaalde klantgroepen worden nooit vermeld. Regels verwijderen inhoud die online staat maar niet geïndexeerd mag worden. Elke regel geldt voor alle winkels of voor één, vanaf de volgende generatie.

![Uitsluitingsregels: op URL-tekst, op ID, producten zonder afbeelding, per winkel](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-uitsluitingsregels-dfsitemap-nl.webp)

Uitsluitingsregels: op URL-tekst, op ID, producten zonder afbeelding, per winkel

- **Producten**: op ID, in een categorie (subcategorieën inbegrepen), van een merk, van een standaardleverancier, niet op voorraad, met prijs nul, zonder afbeelding.
- **Categorieën**: op ID, of een categorie met al haar subcategorieën.
- **CMS-pagina's**: op ID, of een CMS-categorie met haar pagina's. **Merken en leveranciers**: op ID.
- **URL bevat een tekst** en **URL komt overeen met een reguliere expressie**: één waarde per regel, hoofdletterongevoelig. Een ongeldige expressie wordt bij het opslaan geweigerd.

![Een uitsluitingsregel aanmaken: URL met een tekst, één waarde per regel, alle winkels](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-url-uitsluitingsregel-dfsitemap-nl.webp)

Een uitsluitingsregel aanmaken: URL met een tekst, één waarde per regel, alle winkels

Een URL die door een regel wordt uitgesloten, verdwijnt ook uit de hreflang-alternatieven van zijn vertalingen.

## Productvideo's

Het tabblad _Productvideo's_ dient voor video's buiten YouTube en Vimeo, of als u een bepaalde titel en beschrijving wilt. Voor elke video: het product (zoeken op naam, referentie of ID), titel en beschrijving per taal, de URL van de miniatuur, de URL van het videobestand of de speler, de duur in seconden en de winkel.

![Productvideo’s toegevoegd aan de videositemap, met miniatuur, titel en duur](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-productvideos-dfsitemap-nl.webp)

Productvideo’s toegevoegd aan de videositemap, met miniatuur, titel en duur

![Videoformulier: product, titel en beschrijving per taal, miniatuur, speler-URL en duur](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-videoformulier-dfsitemap-nl.webp)

Videoformulier: product, titel en beschrijving per taal, miniatuur, speler-URL en duur

## De generatie starten

### Vanuit de back-office

_Nu genereren_ start de generatie voor de winkels in de context, met een voortgangsbalk. Sluit u de pagina, dan blijft de taak bewaard: _Hervatten in dit venster_ zet haar voort, of de cron doet dat. _Annuleren_ stopt de taak en laat de online sitemaps ongewijzigd.

### Via de cron

Het tabblad _Automatisering_ toont een URL zoals `https://uw-winkel.nl/module/dfsitemap/cron?token=...`, beveiligd met een geheim token. Roep hem elke 5 minuten aan vanuit het cronbeheer van uw hosting. Elke aanroep werkt gedurende het tijdsbudget, de volgende gaat verder. Optionele parameters: `force=1` en `id_shop=1,2`. De kaart toont de laatste ontvangen aanroep (HTTP of CLI); _Nieuw token genereren_ maakt de oude URL ongeldig.

![Automatisering: cron-URL beveiligd met token, CLI-opdracht, zoekmachines en IndexNow](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-cron-taak-dfsitemap-nl.webp)

Automatisering: cron-URL beveiligd met token, CLI-opdracht, zoekmachines en IndexNow

### Via de opdrachtregel

```
php /pad/naar/prestashop/modules/dfsitemap/cron.php
php /pad/naar/prestashop/modules/dfsitemap/cron.php --force --shop=1
```

Het script verwerkt de hele taak in één keer. Het weigert webaanroepen en geeft exitcode 1 terug bij een fout.

Wordt een verzoek midden in de generatie afgebroken, dan gaat de taak verder vanaf de laatst opgeslagen positie en worden de lopende bestanden hersteld. De vergrendeling van het afgebroken verzoek verloopt na het tijdsbudget plus 90 seconden.

## robots.txt

De module wijzigt robots.txt nooit uit zichzelf. De kaart _robots.txt_ van het tabblad Automatisering toont de regels die hij zou toevoegen, tussen `# BEGIN dfsitemap` en `# END dfsitemap`, en laat u dat blok toevoegen, bijwerken of verwijderen. De rest van het bestand blijft zoals het is en een kopie van de vorige versie wordt bewaard in `modules/dfsitemap/var/`. De optie _De Sitemap-regels behouden wanneer PrestaShop robots.txt opnieuw genereert_ (standaard uit) herschrijft het blok telkens als het bestand vanuit Verkeer & SEO wordt gegenereerd. Het verwijderen van de module verwijdert alleen dit blok.

![robots.txt: voorbeeld van het dfsitemap-blok, alleen op verzoek toegevoegd of verwijderd](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-robots-txt-dfsitemap-nl.webp)

robots.txt: voorbeeld van het dfsitemap-blok, alleen op verzoek toegevoegd of verwijderd

## Zoekmachines en IndexNow

Google (sinds 2023) en Bing (sinds 2022) aanvaarden de anonieme sitemap-ping niet meer: de module verstuurt er geen. Meld de index één keer aan in Google Search Console, in Bing Webmaster Tools of met een `Sitemap:`-regel in robots.txt. Een sitemap helpt zoekmachines URL's te ontdekken, maar garandeert geen indexering.

IndexNow, standaard uit, meldt nieuwe of gewijzigde pagina's aan Bing en de andere zoekmachines van het protocol. Google gebruikt het niet. Eenmaal ingeschakeld maakt de module een sleutelbestand in de hoofdmap, zet elk opgeslagen product, elke categorie, CMS-pagina, elk merk of elke leverancier in de wachtrij en verstuurt hun URL's bij de volgende cron-aanroep, alleen voor inhoud die in de sitemap staat. De IndexNow-kaart toont de wachtrij, het sleutelbestand en de laatste verzending; bij een antwoord 429 of 5xx blijft de wachtrij behouden.

## Multistore

Elke winkel heeft zijn eigen index op zijn eigen domein, zijn talen en instellingen. Selecteer een winkel in het multistore-menu om hem eigen waarden te geven. In de context Alle winkels toont het dashboard één kaart per winkel.

## Voor ontwikkelaars: URL's toevoegen

Een module kan zijn pagina's toevoegen via de hook `actionDfSitemapUrls`. De hook ontvangt `id_shop`, `languages` (id_lang => ISO-code) en `link`, en geeft een lijst van items terug:

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

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

Een item per taal krijgt hreflang-tags zoals een native pagina. URL's van een ander domein en ongeldige items worden genegeerd.

## Veelgestelde vragen

### De kwaliteitscontrole meldt een doorverwijzing

Een andere module verwijst deze pagina door (bijvoorbeeld naar een configuratiepagina). Vermeld de eind-URL of sluit deze uit met een regel _URL bevat een tekst_.

### Een product ontbreekt

Controleer of het actief is, zichtbaar Overal of in de Catalogus, en in minstens één categorie staat die open is voor niet-ingelogde bezoekers. Controleer ook de uitsluitingsregels.

### De sitemap bevat geen CMS-pagina

Schakel _Indexering door zoekmachines_ in op de pagina's die geïndexeerd moeten worden.

### De generatie blijft hangen op „Een ander proces werkt aan de taak”

Een ander verzoek houdt de vergrendeling vast, vaak de cron. Is het afgebroken, dan verloopt de vergrendeling na de getoonde tijd en gaat de generatie vanzelf verder.

### IndexNow antwoordt 403 of 422

De zoekmachine vindt het sleutelbestand niet of weigert de host. Open de URL van het sleutelbestand uit de IndexNow-kaart: die moet de sleutel tonen.
