# Hreflang Manager: hreflang-Tags für mehrsprachige Shops und Multishop

> Überblick Hreflang Manager schreibt die Tags 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…

- Seite: <https://www.datafirefly.com/de/documentation/datafireflyhreflang/>
- Sprache: de
- Aktualisiert am: 2026-11-14
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/datafireflyhreflang/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflyhreflang/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflyhreflang/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflyhreflang/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflyhreflang/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafireflyhreflang/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafireflyhreflang/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Überblick

Hreflang Manager schreibt die Tags `` 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.

![Übersicht von Hreflang Manager: Score, aktive Versionen und Konflikterkennung (Theme, SEO, Sitemaps, Override)](https://www.datafirefly.com/wp-content/uploads/2026/11/uebersicht-konflikte-datafireflyhreflang-de.webp)

Übersicht von Hreflang Manager

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

1. Klicken Sie unter **Module > Modulmanager** auf **Modul hochladen** und laden Sie die ZIP-Datei hoch.
2. Das Modul befindet sich unter **Shopparameter > Traffic & SEO > Hreflang Manager**.
3. 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.

![Einrichtungsassistent: erkannte Shops, Domains und Sprachen mit vorgeschlagenen hreflang-Werten und x-default](https://www.datafirefly.com/wp-content/uploads/2026/11/einrichtungsassistent-datafireflyhreflang-de.webp)

Einrichtungsassistent

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

![Versionen und Karte Sprache × Land → Shop, mit Live-Prüfung der hreflang-Werte](https://www.datafirefly.com/wp-content/uploads/2026/11/versionen-karte-sprachen-laender-datafireflyhreflang-de.webp)

Versionen und Karte Sprache × Land → Shop, mit Live-Prüfung der hreflang-Werte

## 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 oder `es-419` werden 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.

![Tag-Vorschau einer Produktseite: erwartete und ausgegebene Tags, jede Alternative geprüft](https://www.datafirefly.com/wp-content/uploads/2026/11/tag-vorschau-datafireflyhreflang-de.webp)

Tag-Vorschau einer Produktseite

![Auszug aus dem Quellcode des head-Bereichs: erwartete hreflang-Tags und die von der Seite ausgegebenen Tags](https://www.datafirefly.com/wp-content/uploads/2026/11/head-quellcode-datafireflyhreflang-de.webp)

Auszug aus dem Quellcode des head-Bereichs

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

![hreflang-Audit der nativen PrestaShop-Tags: Score, Fehler, Warnungen und vorgeschlagene Korrekturen](https://www.datafirefly.com/wp-content/uploads/2026/11/audit-score-fehler-datafireflyhreflang-de.webp)

hreflang-Audit der nativen PrestaShop-Tags

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_langs` aus);
- **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 mit `xhtml:link` alle 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.

![Einstellungen: einheitliche Ausgabe, Duplikatschutz, Paginierung, hreflang-XML-Sitemap und Cache](https://www.datafirefly.com/wp-content/uploads/2026/11/einstellungen-sitemap-cache-datafireflyhreflang-de.webp)

Einstellungen

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.
