English Version

Zurück zur Übersicht

XML Sitemap Generator: Technische Details

Erzeugte Dateien

Alle Dateien liegen im Ausgabeverzeichnis. Mit den Standardeinstellungen ist das source/export/:

source/export/
├── sitemap.xml                 # Sitemap-Index
├── sitemap-products.xml        # Produkte
├── sitemap-categories.xml      # Kategorien
├── sitemap-cms.xml             # CMS-Seiten
├── sitemap-manufacturers.xml   # Hersteller
└── sitemap-static.xml          # Statische URLs (nur bei aktivierter Einstellung)

Pro Typ entsteht höchstens eine Datei. Für Produkte, Kategorien, CMS-Seiten und Hersteller enthält sie höchstens 50.000 URLs, die statische Sitemap hat kein Limit. Dateinamen mit Nummern wie sitemap-products-1.xml erzeugt das Modul nicht. Das Verzeichnis source/export/sitemap, das bei der Aktivierung angelegt wird, bleibt mit den Standardeinstellungen leer.

Aufbau der XML-Ausgabe

Jede URL wird mit loc, lastmod, changefreq und priority geschrieben:

<url>
  <loc>https://shop.example.com/Produkt-Seite/</loc>
  <lastmod>2026-01-15</lastmod>
  <changefreq>weekly</changefreq>
  <priority>0.8</priority>
</url>

• lastmod stammt aus oxtimestamp des Objekts im Format Y-m-d. Ist der Wert leer oder ungültig, steht das Tagesdatum der Generierung dort
• Mit aktivem Hreflang erscheinen zusätzlich xhtml:link-Einträge mit rel="alternate", und der Namensraum xhtml wird nur gesetzt, wenn solche Einträge vorkommen
• Produkte erhalten image:image-Einträge mit image:loc und, falls der Produkttitel nicht leer ist, image:title. Der Namensraum image wird nur gesetzt, wenn Bilder vorkommen
• Der Index sitemap.xml enthält pro Datei loc und lastmod (Datum der Generierung)

Google wertet changefreq und priority nach eigener Dokumentation nicht aus, lastmod nur bei verlässlichen Werten. Das Modul schreibt die Felder trotzdem, weil das Sitemap-Protokoll sie vorsieht.

Standardwerte je Typ

Ablauf

graph TD
    A["GenerateSitemapCommand"] --> B["Einstellungen und Sprachen lesen"]
    B --> C["GenerateSitemapService"]
    C --> D["Query-Service je Typ"]
    D --> E["HreflangService (optional)"]
    E --> F["UrlBuilderService"]
    D --> F
    F --> G["XmlWriterService"]
    G --> H["FileWriterService"]
    H --> I["sitemap-typ.xml"]
    I --> J["Sitemap-Index sitemap.xml"]

Das Modul arbeitet ohne Cache, ohne Komprimierung (.xml.gz), ohne Ping an Suchmaschinen und ohne eigenen Scheduler. Jede Generierung liest die Daten neu aus der Datenbank und überschreibt die Dateien.

Klassen

Mehrsprachigkeit

• Sprachen und ihre Reihenfolge stammen aus der Shop-Einstellung aLanguages, die Sprach-ID ist die Position in dieser Liste. Es wird dabei nicht geprüft, ob eine Sprache im Frontend aktiv ist
• Pro Sprache fragt der Befehl die SEO-URLs dieser Sprache ab und baut die Adressen aus der Sprach-URL (aLanguageURLs), ersatzweise aus der Shop-URL
• Der Dateiname enthält keine Sprache. Jeder Sprachdurchlauf überschreibt die Datei des vorherigen, die zuletzt verarbeitete Sprache bleibt bestehen
• Hreflang (blHreflangEnabled) wirkt nur, wenn der Shop mehr als eine Sprache hat. Pro Objekt mit mindestens zwei Sprach-URLs entstehen Alternativen je Sprachcode. Ein x-default auf die Standardsprache (sDefaultLang) entsteht nur, wenn das Objekt in der Standardsprache eine URL hat

Datenbank

Das Modul legt nur die Tabelle mmd_sitemap_static_urls an (Spalten siehe Statische URLs). Alle anderen Daten liest es aus den OXID-Tabellen, ohne sie zu verändern. Es nutzt die Datenbankverbindung des Shops als PDO-Objekt.

Lebenszyklus

Migrationen gibt es nicht. oe:module:apply-configuration übernimmt nur die Modul-Einstellungen, nicht die Tabelle.

Grenzen

• Höchstens 50.000 URLs pro Datei für Produkte, Kategorien, CMS-Seiten und Hersteller, der Rest wird abgeschnitten (die Einstellung iMaxUrls wird nicht ausgewertet). Die statische Sitemap hat kein Limit
• Die Größe der Datei wird nicht geprüft, das Protokoll-Limit von 50 MB wird also nicht überwacht
• Die Daten eines Typs werden vollständig in den Arbeitsspeicher geladen und mit einem Schreibvorgang in die Datei geschrieben, es gibt kein stückweises Schreiben
• Mehrere Shops: Shop-URL, Sprachliste und statische URLs stammen immer aus Shop-ID 1. Mit -s ändert sich die Shop-ID in den Inhaltsabfragen und in der Hreflang-Abfrage
• Produktbilder werden immer aufgenommen, die Einstellung blImagesEnabled wird nicht ausgewertet

Modulstruktur

mmd/sitemap/                       # source/modules/mmd/sitemap
├── metadata.php                   # Modul-ID mmd_sitemap, Einstellungen, Events
├── services.yaml                  # Dienste und Konsolenbefehl
├── menu.xml                       # Admin-Menü "Sitemap"
├── src/
│   ├── Command/                   # GenerateSitemapCommand
│   ├── Controller/Admin/          # Übersicht, Statische URLs
│   ├── Core/Events.php            # Aktivierung/Deaktivierung
│   ├── DTO/, Enum/, Model/        # Wertobjekte, Typen, StaticUrl-Modell
│   └── Service/                   # Bridge, Query, Domain, Command
└── views/                         # Admin-Templates und Übersetzungen