Documentatie van de module Geavanceerde XML-sitemap voor PrestaShop (dfsitemap)
dfsitemap 2.0.0 installeren en instellen: dashboard, kwaliteitscontrole, inhoud, hreflang, afbeeldingen en video's, uitsluitingsregels, cron, robots.txt, IndexNow en multistore.
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
- Download de ZIP uit uw DataFirefly-klantaccount.
- Ga in de back-office naar Modules > Modulebeheer > Een module uploaden en verzend de ZIP.
- Open Winkelparameters > Verkeer & SEO > Geavanceerde XML-sitemap. De modulebalk geeft toegang tot dashboard, instellingen, automatisering, uitsluitingsregels en productvideo’s.
- 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. - 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.

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.

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.

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.

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.

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.

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.

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.

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.

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


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.

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.

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.