# Hreflang Manager: meertalige en multistore hreflang-tags

> Overzicht Hreflang Manager schrijft de tags van uw pagina's om Google de taal- en regioversies van dezelfde pagina aan te geven. Hij schrijft er maar één set per pagina, alleen…

- Pagina: <https://www.datafirefly.com/nl/documentation/datafireflyhreflang/>
- Taal: nl
- Bijgewerkt op: 2026-11-14
- Andere talen: [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), [de](https://www.datafirefly.com/de/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/nl/documentation/llms.txt>

## Overzicht

Hreflang Manager schrijft de tags `` van uw pagina's om Google de taal- en regioversies van dezelfde pagina aan te geven. Hij schrijft er maar één set per pagina, alleen op canonieke en indexeerbare pagina's, en alleen naar versies die echt bestaan.

Compatibel met PrestaShop 1.7.8 tot 9.x, enkele winkel en multistore (één of meer domeinen). Versie 2.0.0 bevat geen override en wijzigt geen enkel themabestand.

![Overzicht van Hreflang Manager: score, actieve versies en detectie van conflicten (thema, SEO, sitemaps, override)](https://www.datafirefly.com/wp-content/uploads/2026/11/overzicht-conflicten-datafireflyhreflang-nl.webp)

Overzicht van Hreflang Manager

## Nieuw in versie 2.0

- **Geen override meer**: de module werkt met hooks. De FrontController-override van 1.0.0 wordt bij de update verwijderd.
- **Eén set tags**: geschreven in de themavariabele of via de hook displayHeader, met een beveiliging die dubbele tags verwijdert.
- **Gecontroleerde versies**: niets naar een product dat inactief, niet vertaald of niet aanwezig in een winkel is; niets op 404's, noindex-pagina's, gefilterde lijsten en combinaties.
- **Vernieuwde back office**: configuratie-assistent, kaart taal × land → winkel, voorbeeld van de tags, audit met score, detectie van conflicten, testmodus.
- Optionele hreflang XML-sitemap, cache per pagina, compatibiliteit met PrestaShop 1.7.8 en interface in 8 talen.

## Installatie en update

1. Klik in **Modules > Modulebeheer** op **Een module uploaden** en upload het ZIP-bestand.
2. De module opent in **Winkelparameters > Verkeer & SEO > Hreflang Manager**.
3. Zolang er geen versie is geconfigureerd, verandert hij niets aan uw pagina's. Start de **Configuratie-assistent**.

De update vanaf 1.0.0 behoudt uw versies en groepen. Verkeerd geschreven waarden worden gecorrigeerd wanneer de correctie zeker is (`en_UK` wordt `en-GB`, `fr_BE` wordt `fr-BE`), per groep wordt één x-default behouden, de oude override wordt verwijderd via de procedure van PrestaShop en het menu verhuist naar Verkeer & SEO. Er verschijnt een rapport in het overzicht.

Installeer de module bij multistore in de context „Alle winkels” en controleer of hij is ingeschakeld in elke winkel van een groep: anders verwijzen de pagina's daarvan niet naar de andere versies en negeert Google de paren. De conflictdetector meldt dit.

## Configuratie-assistent

De assistent leest uw winkels, hun domeinen (HTTP of HTTPS), hun land en hun actieve talen, en stelt vervolgens een hreflang-waarde voor voor elke combinatie van winkel en taal:

- een taal die in maar één winkel wordt verkocht, krijgt alleen de taal (`fr`): die is gericht op alle Franstaligen;
- een taal die in meerdere winkels wordt verkocht, krijgt het land van elke winkel (`fr-FR`, `fr-BE`) zodat Google de juiste winkel toont;
- de voorgestelde x-default is de hoofdtaal van de standaardwinkel.

De waarden worden tijdens het invoeren gecontroleerd. Er verandert niets aan uw pagina's voordat u opslaat.

![Configuratie-assistent: gedetecteerde winkels, domeinen en talen met voorgestelde hreflang-waarden en x-default](https://www.datafirefly.com/wp-content/uploads/2026/11/configuratie-assistent-datafireflyhreflang-nl.webp)

Configuratie-assistent

## Versies, groepen en kaart

Elke regel is een versie: een winkel, een taal, een hreflang-waarde, een optionele openbare oorsprong (als de winkel onder een ander domein wordt aangeboden), een schakelaar actief en de keuze voor x-default. Eén x-default-versie per groep.

De **kaart taal × land → winkel** toont welke winkel welke markt bedient. Grijs weergegeven versies worden niet afgedrukt (inactief, of taal uitgeschakeld in de winkel).

**Groepen** verbinden winkels die naar elkaar verwijzen. Inhoud wordt gekoppeld op id (gedeelde catalogus) of uitsluitend via **handmatige mapping** (gescheiden catalogi). De mapping verbindt twee id's van een product, een categorie, een CMS-pagina, een merk of een leverancier; hij werkt in beide richtingen en blijft consistent in de hele groep.

![Versies en kaart taal × land → winkel, met directe controle van de hreflang-waarden](https://www.datafirefly.com/wp-content/uploads/2026/11/versies-kaart-talen-landen-datafireflyhreflang-nl.webp)

Versies en kaart taal × land → winkel, met directe controle van de hreflang-waarden

## Toegepaste regels

De module volgt de richtlijnen van Google Search Central voor gelokaliseerde versies:

- **Absolute URL's** met het protocol en het domein van elke winkel; spaties en ongeldige tekens worden gecodeerd.
- **Zelfverwijzing** en **terugkoppelingen**: elke versie vermeldt alle andere en zichzelf, met dezelfde set op alle versies.
- **Geldige codes**: taal ISO 639-1, optioneel land ISO 3166-1 alpha-2, optioneel schrift ISO 15924. `en-UK`, underscores, alleen een land of `es-419` worden geweigerd met een suggestie.
- **Alleen bestaande versies**: product actief en zichtbaar, categorie actief en toegankelijk voor bezoekers, CMS-pagina actief en indexeerbaar, merk of leverancier actief, vertaald in de doeltaal.
- **Alleen canonieke en indexeerbare pagina's**: geen tags op 404's, noindex-pagina's, gefilterde of gesorteerde lijsten, combinatie-URL's, winkelwagen, account en zoeken, en ook niet wanneer de canonical-tag naar een ander adres verwijst.
- **Paginering**: pagina 2 van een categorie verwijst naar pagina 2 van de andere versies (instelbaar).

## Voorbeeld van de tags

Voer een URL van uw winkel in of kies een voorbeeld (startpagina, product, categorie, pagina 2, CMS-pagina). De module leest de pagina vanaf de server en toont de diagnose (canonieke pagina, noindex, ontbrekende versie…), elke tag met de bijbehorende controle en, naast elkaar, de verwachte head en de werkelijk afgedrukte head. Alleen de domeinen van uw installatie kunnen worden gelezen.

![Tag-voorbeeld van een productpagina: verwachte en weergegeven tags, elke alternatieve versie gecontroleerd](https://www.datafirefly.com/wp-content/uploads/2026/11/tag-voorbeeld-datafireflyhreflang-nl.webp)

Tag-voorbeeld van een productpagina

![Fragment van de broncode van de head-sectie: verwachte hreflang-tags en de tags die de pagina weergeeft](https://www.datafirefly.com/wp-content/uploads/2026/11/head-broncode-datafireflyhreflang-nl.webp)

Fragment van de broncode van de head-sectie

## Audit

De audit leest een steekproef van pagina's van uw eigen domeinen (startpagina, producten, categorieën met pagina 2, CMS-pagina's, merken, leveranciers, overige pagina's), elk in al zijn versies, en controleert vervolgens: respons 200, indexeerbaar, canonical-tag, waarden, absolute URL's, zelfverwijzing, terugkoppelingen, dubbele tags, x-default en één set per pagina. Hij toont een score, de fouten en waarschuwingen gegroepeerd per regel met de benodigde correctie, de geschiedenis van de audits en een CSV-export.

Wordt de audit gestart met de module op „Uit”, dan beoordeelt hij de native tags van PrestaShop: de schermafbeelding hieronder toont dit resultaat op een demowinkel (ontbrekende terugkoppelingen op pagina's 2, x-default ontbreekt).

![hreflang-audit van de standaardtags van PrestaShop: score, fouten, waarschuwingen en voorgestelde correcties](https://www.datafirefly.com/wp-content/uploads/2026/11/audit-score-fouten-datafireflyhreflang-nl.webp)

hreflang-audit van de standaardtags van PrestaShop

De audit roept geen externe dienst aan en leest alleen de adressen die in uw winkels zijn opgegeven. Als de server zijn eigen domein niet kan bereiken (Docker, NAT, lokale DNS), loopt het verzoek via de lokale interface van de server met dezelfde hostnaam.

## Conflicten en andere bronnen

Het overzicht toont wat naast de module hreflang-tags kan produceren, zonder ooit de instellingen daarvan te wijzigen:

- het **thema** (Classic, Hummingbird en de meeste thema's drukken `$urls.alternative_langs` af);
- **DataFirefly All in One SEO** als de optie „hreflang beheren” actief is: de beveiliging behoudt één set en een knop laat Hreflang Manager als laatste uitvoeren;
- de sitemaps van **DataFirefly Sitemap** of van de SEO-suite die alternatieven bevatten;
- andere modules met hreflang-code, de oude override van 1.0.0, een module die is uitgeschakeld in een winkel van de groep, winkels die via HTTP worden aangeboden.

De knop **Startpagina's nu controleren** leest de startpagina van elke winkel zoals een bezoeker en telt de tags en dubbele tags.

## Instellingen

- **Status**: online, testmodus (bezoekers en zoekmachines behouden de oorspronkelijke tags, alleen het voorbeeld en de audit zien de nieuwe) of uit.
- **Waar de tags worden afgedrukt**: automatisch (themavariabele als het thema die afdrukt, anders hook displayHeader), themavariabele of hook.
- **Beveiliging tegen dubbele tags** en **verwijdering van PrestaShop-tags** waar de module er geen afdrukt (404, noindex, gefilterde lijsten…).
- **Paginering**, **respect voor de canonical-tag**, overige pagina's met versies (bestsellers, nieuwe producten, aanbiedingen, contact, winkels, lijsten van merken en leveranciers) en toegestane modulepagina's (module/controller).
- **Hreflang XML-sitemap**: optioneel, één per winkel, op het adres `/module/datafireflyhreflang/sitemap`. Elk adres vermeldt al zijn versies met `xhtml:link`, zichzelf inbegrepen. Dien hem zelf in via Google Search Console of robots.txt.
- **Cache**: de alternatieven van een pagina worden één keer berekend en daarna met één query gelezen; ze worden opnieuw berekend wanneer een product, categorie, CMS-pagina, merk of leverancier wordt opgeslagen, en volledig wanneer een versie, groep, taal of winkel verandert.

![Instellingen: één set tags, duplicaatbeveiliging, paginering, hreflang-XML-sitemap en cache](https://www.datafirefly.com/wp-content/uploads/2026/11/instellingen-sitemap-cache-datafireflyhreflang-nl.webp)

Instellingen

Als DataFirefly Sitemap of de SEO-suite ook hreflang in hun sitemap opnemen, dien dan maar één van deze sitemaps in bij Google, of controleer of ze hetzelfde aangeven.

## Beveiliging en rechten

- Elke wijziging vereist het recht „Wijzigen” op het tabblad Hreflang Manager en het beveiligingstoken van de back office; een profiel met alleen leesrechten kan raadplegen, voorbeelden bekijken en exporteren.
- Het voorbeeld en de audit weigeren elk adres buiten de domeinen van de winkel (geen toegang tot een willekeurige URL).
- De in de head afgedrukte URL's worden ge-escaped; de CSV-export neutraliseert cellen die beginnen met `=`, `+`, `-` of `@`.

## Verwijderen

Bij het verwijderen worden de 6 tabellen van de module (versies, groepen, winkels van de groepen, mapping, cache, audits), de instellingen en het tabblad verwijderd. Er hoeven geen themabestanden of overrides te worden opgeschoond.

## Problemen oplossen

### Geen tags op een pagina

Open het voorbeeld voor deze URL: de diagnose geeft de reden (noindex-pagina, gefilterd, combinatie, canonical naar een ander adres, enkele versie, taal zonder versie, testmodus…).

### Dubbele tags

Schakel de beveiliging tegen dubbele tags in en bekijk daarna „Conflicten en andere bronnen”: een module of het thema drukt eigen tags af.

### Ontbrekende terugkoppelingen in de audit

Een versie is aan één kant inactief, de module is uitgeschakeld in een winkel van de groep, of een full-page cache levert een oude pagina. Leeg de cache van de module (Instellingen) en die van de winkel.
