# Hreflang Manager : balises hreflang multilingues et multiboutiques

> Présentation Hreflang Manager écrit les balises de vos pages pour indiquer à Google les versions linguistiques et régionales d'une même page. Il n'en écrit qu'un seul jeu par page, uniquement…

- Page: <https://www.datafirefly.com/documentation/datafireflyhreflang/>
- Langue: fr
- Mis à jour le: 2026-11-14
- Autres langues: [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), [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/documentation/llms.txt>

## Présentation

Hreflang Manager écrit les balises `` de vos pages pour indiquer à Google les versions linguistiques et régionales d'une même page. Il n'en écrit qu'un seul jeu par page, uniquement sur les pages canoniques et indexables, et seulement vers les versions qui existent vraiment.

Compatible PrestaShop 1.7.8 à 9.x, monoboutique et multiboutique (un ou plusieurs domaines). La version 2.0.0 ne contient aucun override et ne modifie aucun fichier du thème.

![Vue d'ensemble de Hreflang Manager : score, versions actives et détection des conflits (thème, SEO, sitemaps, override)](https://www.datafirefly.com/wp-content/uploads/2026/11/vue-ensemble-conflits-datafireflyhreflang-fr.webp)

Vue d'ensemble de Hreflang Manager

## Nouveautés de la version 2.0

- **Plus d'override** : le module fonctionne avec des hooks. L'override de FrontController de la 1.0.0 est retiré à la mise à jour.
- **Un seul jeu de balises** : écrit dans la variable du thème ou par le hook displayHeader, avec un garde-fou qui retire les doublons.
- **Versions vérifiées** : rien vers un produit inactif, non traduit ou absent d'une boutique ; rien sur les 404, pages noindex, listes filtrées et déclinaisons.
- **Back-office repensé** : assistant de configuration, carte langue × pays → boutique, aperçu des balises, audit avec score, détection des conflits, mode test.
- Sitemap XML hreflang facultatif, cache par page, compatibilité PrestaShop 1.7.8 et interface en 8 langues.

## Installation et mise à jour

1. Dans **Modules > Gestionnaire de modules**, cliquez sur **Installer un module** et envoyez le fichier ZIP.
2. Le module s'ouvre dans **Paramètres de la boutique > Trafic et SEO > Hreflang Manager**.
3. Tant qu'aucune version n'est configurée, il ne change rien à vos pages. Lancez l'**Assistant de configuration**.

La mise à jour depuis la 1.0.0 conserve vos versions et vos groupes. Les valeurs mal écrites sont corrigées quand la correction est certaine (`en_UK` devient `en-GB`, `fr_BE` devient `fr-BE`), un seul x-default est gardé par groupe, l'ancien override est retiré par la procédure de PrestaShop et le menu passe sous Trafic et SEO. Un rapport s'affiche dans la vue d'ensemble.

En multiboutique, installez le module dans le contexte « Toutes les boutiques » et vérifiez qu'il est activé sur chaque boutique d'un groupe : sinon, ses pages ne renvoient pas vers les autres versions et Google ignore les paires. Le détecteur de conflits le signale.

## Assistant de configuration

L'assistant lit vos boutiques, leurs domaines (HTTP ou HTTPS), leur pays et leurs langues actives, puis propose une valeur hreflang pour chaque couple boutique et langue :

- une langue vendue dans une seule boutique reçoit la langue seule (`fr`) : elle vise tous les francophones ;
- une langue vendue dans plusieurs boutiques reçoit le pays de chaque boutique (`fr-FR`, `fr-BE`) pour que Google montre la bonne boutique ;
- le x-default proposé est la langue principale de la boutique par défaut.

Les valeurs sont vérifiées pendant la saisie. Rien ne change sur vos pages avant d'enregistrer.

![Assistant de configuration : boutiques, domaines et langues détectés, valeurs hreflang et x-default proposées](https://www.datafirefly.com/wp-content/uploads/2026/11/assistant-configuration-datafireflyhreflang-fr.webp)

Assistant de configuration

## Versions, groupes et carte

Chaque ligne est une version : une boutique, une langue, une valeur hreflang, une origine publique facultative (si la boutique est servie sous un autre domaine), un interrupteur actif et le choix du x-default. Une seule version x-default par groupe.

La **carte langue × pays → boutique** montre quelle boutique sert quel marché. Les versions grisées ne sont pas imprimées (inactives, ou langue désactivée dans la boutique).

Les **groupes** relient des boutiques qui pointent les unes vers les autres. Le contenu est apparié par id (catalogue partagé) ou uniquement par **mapping manuel** (catalogues séparés). Le mapping relie deux ids d'un produit, d'une catégorie, d'une page CMS, d'une marque ou d'un fournisseur ; il fonctionne dans les deux sens et reste cohérent dans tout le groupe.

![Versions et carte langue × pays → boutique, avec validation des codes hreflang en direct](https://www.datafirefly.com/wp-content/uploads/2026/11/versions-carte-langues-pays-datafireflyhreflang-fr.webp)

Versions et carte langue × pays → boutique, avec validation des codes hreflang en direct

## Règles appliquées

Le module suit les consignes de Google Search Central sur les versions localisées :

- **URL absolues** avec le protocole et le domaine de chaque boutique ; espaces et caractères interdits encodés.
- **Auto-référence** et **liens retour** : chaque version liste toutes les autres et elle-même, avec le même jeu sur toutes les versions.
- **Codes valides** : langue ISO 639-1, pays ISO 3166-1 alpha-2 facultatif, script ISO 15924 facultatif. `en-UK`, les underscores, un pays seul ou `es-419` sont refusés avec une suggestion.
- **Versions existantes uniquement** : produit actif et visible, catégorie active et accessible aux visiteurs, page CMS active et indexable, marque ou fournisseur actif, traduits dans la langue cible.
- **Pages canoniques et indexables uniquement** : aucune balise sur les 404, pages noindex, listes filtrées ou triées, URL de déclinaison, panier, compte et recherche, ni quand la balise canonical désigne une autre adresse.
- **Pagination** : la page 2 d'une catégorie pointe vers la page 2 des autres versions (réglable).

## Aperçu des balises

Saisissez une URL de votre boutique ou choisissez un exemple (accueil, produit, catégorie, page 2, page CMS). Le module lit la page depuis le serveur et affiche le diagnostic (page canonique, noindex, version absente…), chaque balise avec son contrôle et, côte à côte, le head attendu et le head réellement imprimé. Seuls les domaines de votre installation peuvent être lus.

![Aperçu des balises d'une page produit : balises attendues et affichées, contrôle de chaque alternative](https://www.datafirefly.com/wp-content/uploads/2026/11/apercu-balises-datafireflyhreflang-fr.webp)

Aperçu des balises d'une page produit

![Extrait du code source de la section head : balises hreflang attendues et réellement affichées par la page](https://www.datafirefly.com/wp-content/uploads/2026/11/code-source-head-datafireflyhreflang-fr.webp)

Extrait du code source de la section head

## Audit

L'audit lit un échantillon de pages de vos propres domaines (accueil, produits, catégories avec page 2, pages CMS, marques, fournisseurs, autres pages), chacune dans toutes ses versions, puis vérifie : réponse 200, indexable, balise canonical, valeurs, URL absolues, auto-référence, liens retour, doublons, x-default et un seul jeu par page. Il affiche un score, les erreurs et avertissements regroupés par règle avec la correction à apporter, l'historique des audits et un export CSV.

Lancé avec le module sur « Désactivé », l'audit évalue les balises natives de PrestaShop : la capture ci-dessous montre ce résultat sur une boutique de démonstration (liens retour manquants sur les pages 2, x-default absent).

![Audit hreflang des balises natives de PrestaShop : score, erreurs, avertissements et corrections proposées](https://www.datafirefly.com/wp-content/uploads/2026/11/audit-score-erreurs-datafireflyhreflang-fr.webp)

Audit hreflang des balises natives de PrestaShop

L'audit n'appelle aucun service externe et ne lit que les adresses déclarées dans vos boutiques. Si le serveur ne peut pas joindre son propre domaine (Docker, NAT, DNS local), la requête passe par l'interface locale du serveur avec le même nom d'hôte.

## Conflits et autres sources

La vue d'ensemble liste ce qui peut produire des balises hreflang en plus du module, sans jamais modifier leurs réglages :

- le **thème** (Classic, Hummingbird et la plupart des thèmes impriment `$urls.alternative_langs`) ;
- **DataFirefly All in One SEO** si son option « Gérer hreflang » est active : le garde-fou garde un seul jeu et un bouton exécute Hreflang Manager en dernier ;
- les sitemaps de **DataFirefly Sitemap** ou de la suite SEO qui contiennent des alternatives ;
- les autres modules contenant du code hreflang, l'ancien override de la 1.0.0, un module désactivé dans une boutique du groupe, les boutiques servies en HTTP.

Le bouton **Vérifier les pages d'accueil maintenant** lit l'accueil de chaque boutique comme un visiteur et compte les balises et doublons.

## Réglages

- **État** : en ligne, mode test (visiteurs et moteurs gardent les balises d'origine, seuls l'aperçu et l'audit voient les nouvelles) ou désactivé.
- **Où imprimer les balises** : automatique (variable du thème si le thème l'imprime, sinon hook displayHeader), variable du thème ou hook.
- **Garde-fou anti-doublons** et **retrait des balises PrestaShop** là où le module n'en imprime pas (404, noindex, listes filtrées…).
- **Pagination**, **respect de la balise canonical**, autres pages avec versions (meilleures ventes, nouveautés, promotions, contact, magasins, listes des marques et des fournisseurs) et pages de modules autorisées (module/contrôleur).
- **Sitemap XML hreflang** : facultatif, un par boutique, à l'adresse `/module/datafireflyhreflang/sitemap`. Chaque adresse liste toutes ses versions avec `xhtml:link`, elle-même comprise. Déclarez-le vous-même dans Google Search Console ou robots.txt.
- **Cache** : les alternatives d'une page sont calculées une fois puis lues en une requête ; elles sont recalculées quand un produit, une catégorie, une page CMS, une marque ou un fournisseur est enregistré, et entièrement quand une version, un groupe, une langue ou une boutique change.

![Réglages : sortie unique, garde-fou anti-doublons, pagination, sitemap XML hreflang et cache](https://www.datafirefly.com/wp-content/uploads/2026/11/reglages-sitemap-cache-datafireflyhreflang-fr.webp)

Réglages

Si DataFirefly Sitemap ou la suite SEO mettent aussi des hreflang dans leur sitemap, déclarez un seul de ces sitemaps à Google, ou vérifiez qu'ils disent la même chose.

## Sécurité et droits

- Chaque modification demande le droit « Modifier » sur l'onglet Hreflang Manager et le jeton de sécurité du back-office ; un profil en lecture seule peut consulter, prévisualiser et exporter.
- L'aperçu et l'audit refusent toute adresse hors des domaines de la boutique (pas d'accès à une URL arbitraire).
- Les URL imprimées dans le head sont échappées ; l'export CSV neutralise les cellules qui commencent par `=`, `+`, `-` ou `@`.

## Désinstallation

La désinstallation supprime les 6 tables du module (versions, groupes, boutiques des groupes, mapping, cache, audits), ses réglages et son onglet. Aucun fichier du thème ni override n'est à nettoyer.

## Dépannage

### Aucune balise sur une page

Ouvrez l'aperçu sur cette URL : le diagnostic donne la raison (page noindex, filtrée, de déclinaison, canonical vers une autre adresse, version unique, langue sans version, mode test…).

### Des balises en double

Activez le garde-fou anti-doublons, puis consultez « Conflits et autres sources » : un module ou le thème imprime ses propres balises.

### Liens retour manquants dans l'audit

Une version est inactive d'un seul côté, le module est désactivé dans une boutique du groupe, ou un cache pleine page sert une ancienne page. Videz le cache du module (Réglages) et celui de la boutique.
