# Dokumentation des Moduls Erweiterte XML-Sitemap für PrestaShop (dfsitemap)

> Das Modul Erweiterte XML-Sitemap (dfsitemap) erzeugt die XML-Sitemaps von PrestaShop 1.7.8, 8 und 9: ein Index pro Shop, eine Datei pro Sprache und Inhaltstyp, mit Bildern, Videos und gegenseitigen hreflang-Tags.…

- Seite: <https://www.datafirefly.com/de/documentation/dfsitemap/>
- Sprache: de
- Aktualisiert am: 2026-11-07
- Weitere Sprachen: [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), [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/de/documentation/llms.txt>

Das Modul **Erweiterte XML-Sitemap** (dfsitemap) erzeugt die XML-Sitemaps von PrestaShop 1.7.8, 8 und 9: ein Index pro Shop, eine Datei pro Sprache und Inhaltstyp, mit Bildern, Videos und gegenseitigen hreflang-Tags. Version 2.0.0 bringt ein neues Backoffice, eine Qualitätsprüfung, einen integrierten Betrachter und gzip-Komprimierung. Diese Seite behandelt Installation, Einstellungen, Ausschlussregeln, Zeitplanung und Fehlerbehebung.

## Installation

1. Laden Sie das ZIP aus Ihrem DataFirefly-Kundenkonto herunter.
2. Gehen Sie im Backoffice zu _Module > Modulmanager > Modul hochladen_ und senden Sie das ZIP.
3. Öffnen Sie _Shop-Einstellungen > Traffic & SEO > Erweiterte XML-Sitemap_. Die Modulleiste führt zu Übersicht, Einstellungen, Automatisierung, Ausschlussregeln und Artikelvideos.
4. Ist das native Modul _Google sitemap_ (gsitemap) aktiv, deaktivieren Sie es und löschen Sie seine `*_sitemap.xml`-Dateien im Hauptverzeichnis: Die Übersicht weist darauf hin, solange es aktiv ist.
5. Klicken Sie auf _Jetzt erzeugen_ und reichen Sie die Index-URL in der Google Search Console und den Bing Webmaster Tools ein.

Dasselbe ZIP läuft von PrestaShop 1.7.8 bis 9.x, in Multishop- und mehrsprachigen Umgebungen. Das Modul schreibt seine `dfsitemap-*.xml`-Dateien ins Hauptverzeichnis des Shops und seine temporären Dateien nach `modules/dfsitemap/var/tmp/`.

### Aktualisierung von 1.1.0

Laden Sie das ZIP 2.0.0 wie bei einer Installation hoch: PrestaShop führt die Aktualisierung aus. Einstellungen, Regeln, Videos, die IndexNow-Warteschlange und veröffentlichte Sitemaps bleiben erhalten. Hatte die 1.1.0 ihren Block in robots.txt geschrieben, bleibt die Option, die ihn aktuell hält, aktiv; sonst ist sie deaktiviert.

## Übersicht

Für jeden Shop im Kontext zeigt die Übersicht den Zustand der Sitemaps (online, Neuerzeugung überfällig, letzte Erzeugung fehlgeschlagen, noch nie erzeugt), die Index-URL mit den Schaltflächen _Kopieren_, _Durchsuchen_ und Roh-XML, die Anzahl der URLs, Bilder, Videos und Dateien sowie das Datum der letzten und nächsten Erzeugung.

![Sitemap-Übersicht: veröffentlichter Index, Anzahl der URLs, Bilder, Videos und Dateien, letzte und nächste Erzeugung](https://www.datafirefly.com/wp-content/uploads/2026/11/xml-sitemap-uebersicht-dfsitemap-de.webp)

Sitemap-Übersicht: veröffentlichter Index, Anzahl der URLs, Bilder, Videos und Dateien, letzte und nächste Erzeugung

Darunter prüfen die aufgeführten Inhalte nach Typ und die Karte _Zustand_ beschreibbare Ordner, suchmaschinenfreundliche URLs, gsitemap oder eine physische `sitemap.xml`, den Wartungsmodus, den Eintrag in robots.txt und den letzten Aufruf der geplanten Aufgabe.

![Aufgeführte Inhalte nach Typ und Zustandsprüfungen: Ordner, suchmaschinenfreundliche URLs, gsitemap-Modul, robots.txt und geplante Aufgabe](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-inhalte-zustand-dfsitemap-de.webp)

Aufgeführte Inhalte nach Typ und Zustandsprüfungen: Ordner, suchmaschinenfreundliche URLs, gsitemap-Modul, robots.txt und geplante Aufgabe

## Qualitätsprüfung

Die Schaltfläche _Prüfung starten_ liest jede veröffentlichte Datei im Datenstrom: Wurzelelement, Namensräume, Grenzen von 50.000 URLs und 50 MB, absolute und kodierte URLs auf der Shop-Domain. Danach öffnet sie 20 zufällige URLs wie ein nicht angemeldeter Besucher: HTTP-Status ohne Weiterleitungen zu folgen, Header `X-Robots-Tag`, Meta-Robots und kanonische URL. Anfragen gehen nur an die Domains des Shops.

![Qualitätsprüfung: Dateien validiert und 20 URLs wie ein Besucher getestet (HTTP-Status, noindex, kanonische URL)](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-qualitaetspruefung-dfsitemap-de.webp)

Qualitätsprüfung: Dateien validiert und 20 URLs wie ein Besucher getestet (HTTP-Status, noindex, kanonische URL)

Eine „zu prüfende“ URL stammt meist von einer Weiterleitung eines anderen Moduls oder von einer Seite, die einer Kundengruppe vorbehalten ist. Schließen Sie sie mit einer Regel aus, wenn sie nicht indexiert werden soll.

## Die Dateien

Für jeden Shop veröffentlicht das Modul einen Index `dfsitemap-{Shop-ID}-index.xml`, der auf Dateien nach Sprache und Typ verweist, zum Beispiel `dfsitemap-1-de-product-1.xml`. Erreicht eine Datei die festgelegte URL-Anzahl oder 45 MB, geht der Rest in `-2`, `-3` usw. Mit gzip-Komprimierung werden die Dateien als `.xml.gz` veröffentlicht, der Index bleibt unkomprimiert.

Das `lastmod` jeder Datei im Index ist das Datum der letzten Inhaltsänderung: Eine Datei, die der vorigen Erzeugung entspricht, behält ihr Datum.

![Veröffentlichte Dateien: URLs pro Datei, Größe und tatsächliches Datum der letzten Inhaltsänderung](https://www.datafirefly.com/wp-content/uploads/2026/11/veroeffentlichte-sitemap-dateien-dfsitemap-de.webp)

Veröffentlichte Dateien: URLs pro Datei, Größe und tatsächliches Datum der letzten Inhaltsänderung

Die Schaltfläche _Durchsuchen_ öffnet einen Betrachter im Backoffice: URLs, Anzahl der Bilder und Videos, hreflang-Sprachen und Änderungsdatum, 100 pro Seite, mit Filter. Er ersetzt die XSLT-Anzeige, die Chrome entfernt.

![Integrierter Betrachter: URLs, Bilder, Videos, hreflang-Sprachen und Änderungsdatum einer Sitemap-Datei](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-betrachter-hreflang-dfsitemap-de.webp)

Integrierter Betrachter: URLs, Bilder, Videos, hreflang-Sprachen und Änderungsdatum einer Sitemap-Datei

Bei aktivierten suchmaschinenfreundlichen URLs wird der Index auch unter `/sitemap.xml` auf der Domain jedes Shops ausgeliefert. Die Dateien entstehen in einem temporären Ordner und werden Shop für Shop veröffentlicht: Die bisherigen Sitemaps bleiben während der Erzeugung online.

## Einstellungen

Die Einstellungen folgen dem Multishop-Kontext: Im Kontext eines Shops gelten gespeicherte Werte nur für diesen Shop. Ein Hinweis zeigt nicht gespeicherte Änderungen an.

### Inhalte

- **Inhaltstypen**: statische Seiten, Artikel, Kategorien, CMS-Seiten, CMS-Kategorien, Marken, Lieferanten, eigene URLs. Nur aktive Inhalte werden aufgeführt.
- **Statische Seiten**: Startseite, Bestseller, Neuheiten, Angebote, Marken- und Lieferantenlisten, Filialen, Kontakt, Sitemap-Seite. Eine in den Shop-Einstellungen deaktivierte Seite (Marken, Lieferanten, Bestseller) wird übersprungen.
- **Nur in der Suche sichtbare Artikel**: standardmäßig werden nur Artikel mit der Sichtbarkeit Überall oder Nur Katalog aufgeführt.
- **Kundengruppen vorbehaltene Inhalte auslassen** (standardmäßig an): Artikel und Kategorien, die ein nicht angemeldeter Besucher nicht öffnen kann und die 403 antworten würden, werden nicht aufgeführt.

![Inhaltseinstellungen: Seitentypen, statische Seiten, Artikelsichtbarkeit und Ausschluss eingeschränkter Inhalte](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-inhalte-einstellungen-dfsitemap-de.webp)

Inhaltseinstellungen: Seitentypen, statische Seiten, Artikelsichtbarkeit und Ausschluss eingeschränkter Inhalte

Eine CMS-Seite mit deaktivierter Option _Indexierung durch Suchmaschinen_ wird von PrestaShop mit noindex ausgeliefert. Das Modul führt sie nicht auf und zeigt die Anzahl betroffener Seiten.

### Sprachen und hreflang

- **Sprachen**: Lassen Sie alles angehakt, um den aktiven Sprachen jedes Shops zu folgen. Der hreflang-Code jeder Sprache wird angezeigt.
- **hreflang-Alternativen**: Jede URL führt alle ihre Übersetzungen auf, sich selbst eingeschlossen, damit die Angaben gegenseitig sind.
- **hreflang-Code**: Sprache und Region (`de-DE`, aus dem Sprachcode unter _International > Sprachen_) oder nur Sprache (`de`). Zwei Sprachen, die sich einen Code teilen würden, behalten ihre Region.
- **x-default-Sprache**: Standardsprache des Shops, eine bestimmte Sprache oder keine.

![Sprachen und hreflang: Sprach-Region-Codes, gegenseitige Angaben und x-default-Sprache](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-sprachen-hreflang-dfsitemap-de.webp)

Sprachen und hreflang: Sprach-Region-Codes, gegenseitige Angaben und x-default-Sprache

### Bilder und Videos

- **Bilder-Sitemap** und **alle Artikelbilder** (sonst nur das Titelbild) in der gewählten Bildgröße.
- **Bilder von Kategorien, Marken und Lieferanten**.
- **Video-Sitemap** und **Erkennung von YouTube und Vimeo** in Artikelbeschreibungen und CMS-Seiten. Für Vimeo werden Titel und Vorschaubild einmal über den öffentlichen oEmbed-Dienst von Vimeo gelesen und dann zwischengespeichert.

### Tags und Dateien

- **lastmod**: tatsächliches Datum der letzten Aktualisierung von Artikeln, Kategorien, CMS-Kategorien, Marken und Lieferanten. Seiten ohne zuverlässiges Datum erhalten kein lastmod.
- **changefreq und priority**: standardmäßig aus, Google ignoriert sie.
- **Lesbare Anzeige im Browser (XSLT)**: Stylesheet in der Sprache jeder Datei. Bei Neuinstallationen standardmäßig aus, da Chrome XSLT entfernt; nutzen Sie den Betrachter im Backoffice.
- **Sitemaps komprimieren (gzip)** und **URLs pro Datei**: standardmäßig 10.000, zwischen 100 und 50.000, Aufteilung vor 45 MB.

![Tags und Dateien: echtes lastmod, XSLT-Anzeige, gzip-Komprimierung und Aufteilung der Dateien](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-tags-dateien-gzip-dfsitemap-de.webp)

Tags und Dateien: echtes lastmod, XSLT-Anzeige, gzip-Komprimierung und Aufteilung der Dateien

### Zusätzliche URLs

- **Eigene URLs**: eine pro Zeile; ein relativer Pfad wie `/blog/` wird an die Shop-URL angehängt. Nur URLs der Shop-Domain werden übernommen, wie es das Protokoll verlangt.
- **Zusätzliche Sitemaps**: absolute URLs anderswo erzeugter Sitemaps, die dem Index hinzugefügt werden. Eine Sitemap einer anderen Domain wird nur gelesen, wenn beide Websites im selben Search-Console-Konto bestätigt sind.

### Erzeugung

- **Häufigkeit**: stündlich bis wöchentlich, vom Cron genutzt.
- **Elemente pro Stapel** (standardmäßig 50) und **Zeitbudget pro Anfrage** (20 Sekunden, im Backoffice auf 15 Sekunden begrenzt).
- **Bei Inhaltsänderungen neu erzeugen**: Nach dem Speichern eines Artikels, einer Kategorie, einer CMS-Seite, einer Marke oder eines Lieferanten erzeugt der nächste Cron-Aufruf neu, ohne die Häufigkeit abzuwarten, höchstens einmal pro Stunde.

## Ausschlussregeln

Inaktive Inhalte, im Katalog ausgeblendete Artikel und Seiten, die bestimmten Kundengruppen vorbehalten sind, werden nie aufgeführt. Regeln entfernen Inhalte, die online sind, aber nicht indexiert werden sollen. Jede Regel gilt für alle Shops oder einen, ab der nächsten Erzeugung.

![Ausschlussregeln: nach URL-Text, nach ID, Artikel ohne Bild, pro Shop](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-ausschlussregeln-dfsitemap-de.webp)

Ausschlussregeln: nach URL-Text, nach ID, Artikel ohne Bild, pro Shop

- **Artikel**: nach ID, in einer Kategorie (Unterkategorien eingeschlossen), einer Marke, eines Standardlieferanten, nicht vorrätig, mit Preis null, ohne Bild.
- **Kategorien**: nach ID oder eine Kategorie mit allen Unterkategorien.
- **CMS-Seiten**: nach ID oder eine CMS-Kategorie mit ihren Seiten. **Marken und Lieferanten**: nach ID.
- **URL enthält einen Text** und **URL entspricht einem regulären Ausdruck**: ein Wert pro Zeile, ohne Beachtung der Groß- und Kleinschreibung. Ein ungültiger Ausdruck wird beim Speichern abgelehnt.

![Erstellen einer Ausschlussregel: URL enthält einen Text, ein Wert pro Zeile, alle Shops](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-url-ausschlussregel-dfsitemap-de.webp)

Erstellen einer Ausschlussregel: URL enthält einen Text, ein Wert pro Zeile, alle Shops

Eine durch eine Regel ausgeschlossene URL verschwindet auch aus den hreflang-Alternativen ihrer Übersetzungen.

## Artikelvideos

Der Reiter _Artikelvideos_ dient für Videos außerhalb von YouTube und Vimeo oder wenn Sie einen bestimmten Titel und eine Beschreibung möchten. Für jedes Video: der Artikel (Suche nach Name, Referenz oder ID), Titel und Beschreibung pro Sprache, die URL des Vorschaubilds, die URL der Videodatei oder des Players, die Dauer in Sekunden und der Shop.

![Artikelvideos in der Video-Sitemap, mit Vorschaubild, Titel und Dauer](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-artikelvideos-dfsitemap-de.webp)

Artikelvideos in der Video-Sitemap, mit Vorschaubild, Titel und Dauer

![Videoformular: Artikel, Titel und Beschreibung pro Sprache, Vorschaubild, Player-URL und Dauer](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-videoformular-dfsitemap-de.webp)

Videoformular: Artikel, Titel und Beschreibung pro Sprache, Vorschaubild, Player-URL und Dauer

## Erzeugung starten

### Im Backoffice

_Jetzt erzeugen_ startet die Erzeugung für die Shops im Kontext, mit Fortschrittsbalken. Schließen Sie die Seite, bleibt der Auftrag gespeichert: _In diesem Fenster fortsetzen_ setzt ihn fort, oder der Cron übernimmt. _Abbrechen_ stoppt den Auftrag, die Online-Sitemaps bleiben unverändert.

### Per Cron

Der Reiter _Automatisierung_ zeigt eine URL wie `https://ihr-shop.de/module/dfsitemap/cron?token=...`, geschützt durch ein geheimes Token. Rufen Sie sie alle 5 Minuten über die Cron-Verwaltung Ihres Hostings auf. Jeder Aufruf arbeitet für das Zeitbudget, der nächste setzt fort. Optionale Parameter: `force=1` und `id_shop=1,2`. Die Karte zeigt den letzten empfangenen Aufruf (HTTP oder CLI); _Neues Token erzeugen_ macht die alte URL ungültig.

![Automatisierung: durch Token geschützte Cron-URL, CLI-Befehl, Suchmaschinen und IndexNow](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-cron-aufgabe-dfsitemap-de.webp)

Automatisierung: durch Token geschützte Cron-URL, CLI-Befehl, Suchmaschinen und IndexNow

### Über die Kommandozeile

```
php /pfad/zu/prestashop/modules/dfsitemap/cron.php
php /pfad/zu/prestashop/modules/dfsitemap/cron.php --force --shop=1
```

Das Skript arbeitet den ganzen Auftrag in einem Durchgang ab. Es lehnt Webaufrufe ab und gibt bei einem Fehler den Exit-Code 1 zurück.

Wird eine Anfrage mitten in der Erzeugung abgebrochen, setzt der Auftrag an der letzten gespeicherten Position fort und die laufenden Dateien werden repariert. Die Sperre der abgebrochenen Anfrage läuft nach dem Zeitbudget plus 90 Sekunden ab.

## robots.txt

Das Modul ändert robots.txt nie von sich aus. Die Karte _robots.txt_ im Reiter Automatisierung zeigt die Zeilen, die es zwischen `# BEGIN dfsitemap` und `# END dfsitemap` hinzufügen würde, und erlaubt, diesen Block hinzuzufügen, zu aktualisieren oder zu entfernen. Der Rest der Datei bleibt unverändert, eine Kopie der vorherigen Version wird in `modules/dfsitemap/var/` gespeichert. Die Option _Sitemap-Zeilen beibehalten, wenn PrestaShop robots.txt neu erzeugt_ (standardmäßig aus) schreibt den Block bei jeder Erzeugung der Datei unter Traffic & SEO neu. Die Deinstallation entfernt nur diesen Block.

![robots.txt: Vorschau des dfsitemap-Blocks, nur auf Anforderung hinzugefügt oder entfernt](https://www.datafirefly.com/wp-content/uploads/2026/11/sitemap-robots-txt-dfsitemap-de.webp)

robots.txt: Vorschau des dfsitemap-Blocks, nur auf Anforderung hinzugefügt oder entfernt

## Suchmaschinen und IndexNow

Google (seit 2023) und Bing (seit 2022) akzeptieren keinen anonymen Sitemap-Ping mehr: Das Modul sendet keinen. Tragen Sie den Index einmal in der Google Search Console, in den Bing Webmaster Tools oder mit einer `Sitemap:`-Zeile in robots.txt ein. Eine Sitemap hilft Suchmaschinen, URLs zu entdecken, garantiert aber keine Indexierung.

IndexNow, standardmäßig aus, meldet neue oder geänderte Seiten an Bing und die anderen Suchmaschinen des Protokolls. Google nutzt es nicht. Nach der Aktivierung legt das Modul eine Schlüsseldatei im Hauptverzeichnis an, stellt jeden gespeicherten Artikel, jede Kategorie, CMS-Seite, Marke oder jeden Lieferanten in die Warteschlange und sendet deren URLs beim nächsten Cron-Aufruf, nur für Inhalte, die in der Sitemap stehen. Die IndexNow-Karte zeigt Warteschlange, Schlüsseldatei und letzten Versand; bei einer Antwort 429 oder 5xx bleibt die Warteschlange erhalten.

## Multishop

Jeder Shop hat seinen Index auf seiner eigenen Domain, seine Sprachen und Einstellungen. Wählen Sie einen Shop im Multishop-Menü, um ihm eigene Werte zu geben. Im Kontext Alle Shops zeigt die Übersicht eine Karte pro Shop.

## Für Entwickler: URLs hinzufügen

Ein Modul kann seine Seiten über den Hook `actionDfSitemapUrls` hinzufügen. Der Hook erhält `id_shop`, `languages` (id_lang => ISO-Code) und `link` und gibt eine Liste von Einträgen zurück:

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

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

Ein nach Sprache indizierter Eintrag erhält hreflang-Tags wie eine native Seite. URLs einer anderen Domain und ungültige Einträge werden ignoriert.

## Häufige Fragen

### Die Qualitätsprüfung meldet eine Weiterleitung

Ein anderes Modul leitet diese Seite weiter (zum Beispiel zu einer Konfigurator-Seite). Führen Sie die Ziel-URL auf oder schließen Sie diese mit einer Regel _URL enthält einen Text_ aus.

### Ein Artikel fehlt

Prüfen Sie, ob er aktiv ist, die Sichtbarkeit Überall oder Katalog hat und in mindestens einer Kategorie liegt, die nicht angemeldeten Besuchern offensteht. Prüfen Sie auch die Ausschlussregeln.

### Die Sitemap enthält keine CMS-Seite

Aktivieren Sie _Indexierung durch Suchmaschinen_ auf den Seiten, die indexiert werden sollen.

### Die Erzeugung bleibt bei „Ein anderer Prozess bearbeitet den Auftrag“

Eine andere Anfrage hält die Sperre, oft der Cron. Wurde sie abgebrochen, läuft die Sperre nach der angezeigten Frist ab und die Erzeugung setzt von selbst fort.

### IndexNow antwortet mit 403 oder 422

Die Suchmaschine findet die Schlüsseldatei nicht oder lehnt den Host ab. Öffnen Sie die URL der Schlüsseldatei aus der IndexNow-Karte: Sie muss den Schlüssel anzeigen.
