Hreflang Manager: hreflang-Tags für mehrsprachige Shops und Multishop
hreflang-Tags in PrestaShop installieren, konfigurieren, in der Vorschau prüfen und auditieren, ohne Override.
Überblick
Hreflang Manager schreibt die Tags <link rel="alternate" hreflang> Ihrer Seiten, um Google die sprachlichen und regionalen Versionen derselben Seite anzugeben. Es schreibt nur einen einzigen Satz pro Seite, ausschließlich auf kanonischen und indexierbaren Seiten und nur zu Versionen, die tatsächlich existieren.
Kompatibel mit PrestaShop 1.7.8 bis 9.x, Einzelshop und Multishop (eine oder mehrere Domains). Version 2.0.0 enthält kein Override und verändert keine Theme-Datei.

Neuerungen in Version 2.0
- Kein Override mehr: Das Modul arbeitet mit Hooks. Das FrontController-Override der Version 1.0.0 wird beim Update entfernt.
- Ein einziger Satz Tags: geschrieben in die Theme-Variable oder über den Hook displayHeader, mit einem Duplikatschutz, der Dubletten entfernt.
- Geprüfte Versionen: nichts zu inaktiven, nicht übersetzten oder in einem Shop fehlenden Produkten; nichts auf 404-Seiten, noindex-Seiten, gefilterten Listen und Varianten.
- Überarbeitetes Back Office: Einrichtungsassistent, Karte Sprache × Land → Shop, Tag-Vorschau, Audit mit Bewertung, Konflikterkennung, Testmodus.
- Optionale hreflang-XML-Sitemap, Cache pro Seite, Kompatibilität mit PrestaShop 1.7.8 und Oberfläche in 8 Sprachen.
Installation und Update
- Klicken Sie unter Module > Modulmanager auf Modul hochladen und laden Sie die ZIP-Datei hoch.
- Das Modul befindet sich unter Shopparameter > Traffic & SEO > Hreflang Manager.
- Solange keine Version konfiguriert ist, ändert es nichts an Ihren Seiten. Starten Sie den Einrichtungsassistenten.
Beim Update von 1.0.0 bleiben Ihre Versionen und Gruppen erhalten. Falsch geschriebene Werte werden korrigiert, wenn die Korrektur eindeutig ist (aus en_UK wird en-GB, aus fr_BE wird fr-BE), pro Gruppe wird nur ein x-default beibehalten, das alte Override wird durch das Standardverfahren von PrestaShop entfernt und das Menü wandert unter Traffic & SEO. In der Übersicht wird ein Bericht angezeigt.
Installieren Sie das Modul im Multishop-Betrieb im Kontext „Alle Shops“ und prüfen Sie, ob es in jedem Shop einer Gruppe aktiviert ist: Andernfalls verweisen dessen Seiten nicht auf die anderen Versionen, und Google ignoriert die Paare. Die Konflikterkennung meldet dies.
Einrichtungsassistent
Der Assistent liest Ihre Shops, deren Domains (HTTP oder HTTPS), deren Land und deren aktive Sprachen aus und schlägt dann für jede Kombination aus Shop und Sprache einen hreflang-Wert vor:
- Eine Sprache, die nur in einem Shop angeboten wird, erhält nur die Sprache (
fr): Sie richtet sich an alle Französischsprachigen; - eine Sprache, die in mehreren Shops angeboten wird, erhält das Land des jeweiligen Shops (
fr-FR,fr-BE), damit Google den richtigen Shop anzeigt; - als x-default wird die Hauptsprache des Standardshops vorgeschlagen.
Die Werte werden während der Eingabe geprüft. Vor dem Speichern ändert sich nichts an Ihren Seiten.

Versionen, Gruppen und Karte
Jede Zeile ist eine Version: ein Shop, eine Sprache, ein hreflang-Wert, ein optionaler öffentlicher Ursprung (wenn der Shop unter einer anderen Domain ausgeliefert wird), ein Aktiv-Schalter und die Auswahl als x-default. Pro Gruppe gibt es nur eine x-default-Version.
Die Karte Sprache × Land → Shop zeigt, welcher Shop welchen Markt bedient. Ausgegraute Versionen werden nicht ausgegeben (inaktiv oder Sprache im Shop deaktiviert).
Gruppen verbinden Shops, die aufeinander verweisen. Inhalte werden über die ID (gemeinsamer Katalog) oder ausschließlich per manuellem Mapping (getrennte Kataloge) zugeordnet. Das Mapping verknüpft zwei IDs eines Produkts, einer Kategorie, einer CMS-Seite, einer Marke oder eines Lieferanten; es funktioniert in beide Richtungen und bleibt in der gesamten Gruppe konsistent.

Angewendete Regeln
Das Modul folgt den Richtlinien von Google Search Central zu lokalisierten Versionen:
- Absolute URLs mit Protokoll und Domain jedes Shops; Leerzeichen und unzulässige Zeichen werden kodiert.
- Selbstreferenz und Rückverweise: Jede Version listet alle anderen und sich selbst auf, mit demselben Satz auf allen Versionen.
- Gültige Codes: Sprache nach ISO 639-1, optional Land nach ISO 3166-1 alpha-2, optional Schrift nach ISO 15924.
en-UK, Unterstriche, ein Land allein oderes-419werden mit einem Vorschlag abgelehnt. - Nur vorhandene Versionen: Produkt aktiv und sichtbar, Kategorie aktiv und für Besucher zugänglich, CMS-Seite aktiv und indexierbar, Marke oder Lieferant aktiv, jeweils in die Zielsprache übersetzt.
- Nur kanonische und indexierbare Seiten: keine Tags auf 404-Seiten, noindex-Seiten, gefilterten oder sortierten Listen, Varianten-URLs, Warenkorb, Kundenkonto und Suche, ebenso wenig, wenn das canonical-Tag auf eine andere Adresse verweist.
- Paginierung: Seite 2 einer Kategorie verweist auf Seite 2 der anderen Versionen (einstellbar).
Tag-Vorschau
Geben Sie eine URL Ihres Shops ein oder wählen Sie ein Beispiel (Startseite, Produkt, Kategorie, Seite 2, CMS-Seite). Das Modul liest die Seite vom Server und zeigt die Diagnose (kanonische Seite, noindex, fehlende Version…), jedes Tag mit seiner Prüfung sowie nebeneinander den erwarteten und den tatsächlich ausgegebenen Head. Nur die Domains Ihrer Installation können gelesen werden.


Audit
Das Audit liest eine Stichprobe von Seiten Ihrer eigenen Domains (Startseite, Produkte, Kategorien mit Seite 2, CMS-Seiten, Marken, Lieferanten, weitere Seiten), jeweils in all ihren Versionen, und prüft dann: Antwort 200, Indexierbarkeit, canonical-Tag, Werte, absolute URLs, Selbstreferenz, Rückverweise, Dubletten, x-default und einen einzigen Satz pro Seite. Es zeigt eine Bewertung, die Fehler und Warnungen gruppiert nach Regel mit der jeweils nötigen Korrektur, den Verlauf der Audits und einen CSV-Export.
Wird das Audit mit dem Modul auf „Aus“ gestartet, bewertet es die nativen Tags von PrestaShop: Der folgende Screenshot zeigt dieses Ergebnis in einem Demo-Shop (fehlende Rückverweise auf den Seiten 2, fehlendes x-default).

Das Audit ruft keinen externen Dienst auf und liest nur die in Ihren Shops hinterlegten Adressen. Kann der Server seine eigene Domain nicht erreichen (Docker, NAT, lokales DNS), läuft die Anfrage über die lokale Schnittstelle des Servers mit demselben Hostnamen.
Konflikte und andere Quellen
Die Übersicht listet auf, was neben dem Modul hreflang-Tags erzeugen kann, ohne deren Einstellungen jemals zu ändern:
- das Theme (Classic, Hummingbird und die meisten Themes geben
$urls.alternative_langsaus); - DataFirefly All in One SEO, wenn dessen Option „hreflang verwalten“ aktiv ist: Der Duplikatschutz behält einen einzigen Satz, und eine Schaltfläche lässt Hreflang Manager zuletzt ausführen;
- Sitemaps von DataFirefly Sitemap oder der SEO-Suite, die Alternativen enthalten;
- andere Module mit hreflang-Code, das alte Override der Version 1.0.0, ein in einem Shop der Gruppe deaktiviertes Modul, per HTTP ausgelieferte Shops.
Die Schaltfläche Startseiten jetzt prüfen liest die Startseite jedes Shops wie ein Besucher und zählt Tags und Dubletten.
Einstellungen
- Status: online, Testmodus (Besucher und Suchmaschinen behalten die ursprünglichen Tags, nur Vorschau und Audit sehen die neuen) oder aus.
- Ausgabeort der Tags: automatisch (Theme-Variable, wenn das Theme sie ausgibt, sonst Hook displayHeader), Theme-Variable oder Hook.
- Duplikatschutz und Entfernen der PrestaShop-Tags dort, wo das Modul keine ausgibt (404, noindex, gefilterte Listen…).
- Paginierung, Berücksichtigung des canonical-Tags, weitere Seiten mit Versionen (Bestseller, Neue Produkte, Angebote, Kontakt, Filialen, Marken- und Lieferantenlisten) und zugelassene Modulseiten (module/controller).
- hreflang-XML-Sitemap: optional, eine pro Shop, unter der Adresse
/module/datafireflyhreflang/sitemap. Jede Adresse listet mitxhtml:linkalle ihre Versionen auf, sich selbst eingeschlossen. Melden Sie sie selbst in der Google Search Console oder in robots.txt an. - Cache: Die Alternativen einer Seite werden einmal berechnet und dann mit einer einzigen Abfrage gelesen; sie werden neu berechnet, wenn ein Produkt, eine Kategorie, eine CMS-Seite, eine Marke oder ein Lieferant gespeichert wird, und vollständig, wenn sich eine Version, eine Gruppe, eine Sprache oder ein Shop ändert.

Wenn DataFirefly Sitemap oder die SEO-Suite ebenfalls hreflang in ihre Sitemap schreiben, melden Sie nur eine dieser Sitemaps bei Google an oder prüfen Sie, ob sie dieselben Angaben enthalten.
Sicherheit und Berechtigungen
- Jede Änderung erfordert das Recht „Bearbeiten“ für den Tab Hreflang Manager und das Sicherheitstoken des Back Office; ein Profil mit reinem Lesezugriff kann ansehen, eine Vorschau anzeigen und exportieren.
- Vorschau und Audit lehnen jede Adresse außerhalb der Domains des Shops ab (kein Zugriff auf beliebige URLs).
- Die im Head ausgegebenen URLs werden maskiert; der CSV-Export neutralisiert Zellen, die mit
=,+,-oder@beginnen.
Deinstallation
Die Deinstallation löscht die 6 Tabellen des Moduls (Versionen, Gruppen, Shops der Gruppen, Mapping, Cache, Audits), seine Einstellungen und seinen Tab. Es müssen weder Theme-Dateien noch Overrides bereinigt werden.
Fehlerbehebung
Keine Tags auf einer Seite
Öffnen Sie die Vorschau für diese URL: Die Diagnose nennt den Grund (noindex-Seite, gefilterte Seite, Variantenseite, canonical auf eine andere Adresse, nur eine Version, Sprache ohne Version, Testmodus…).
Doppelte Tags
Aktivieren Sie den Duplikatschutz und sehen Sie dann unter „Konflikte und andere Quellen“ nach: Ein Modul oder das Theme gibt eigene Tags aus.
Fehlende Rückverweise im Audit
Eine Version ist nur auf einer Seite inaktiv, das Modul ist in einem Shop der Gruppe deaktiviert, oder ein Full-Page-Cache liefert eine alte Seite aus. Leeren Sie den Cache des Moduls (Einstellungen) und den des Shops.