Détecter la langue et le pays du visiteur (sans redirection)
Installer, configurer et tester la suggestion de langue, de devise et de boutique, sans redirection.
Présentation
Le module détecte le pays du visiteur et les langues de son navigateur, puis propose, dans un bandeau non bloquant, la même page dans la bonne langue, la bonne devise ou la bonne boutique. Il ne redirige jamais : le visiteur garde le contrôle, les robots reçoivent la page demandée et vos balises hreflang restent telles quelles.
Compatible PrestaShop 1.7.8 à 9.x, monoboutique, multiboutique et multidomaine. Rien n’est chargé sur la boutique s’il n’existe qu’une langue et qu’une devise.

Nouveautés de la version 2.0
- Assistant de configuration en cinq étapes, avec les pays pré-remplis pour chaque langue.
- Mode test : le bandeau n’apparaît que dans votre navigateur, ouvert avec un lien signé valable 24 heures.
- Suggestion de devise : un visiteur qui voit encore la devise par défaut se voit proposer celle de son pays, si vous vendez dans cette devise.
- En-têtes CDN de confiance : un en-tête n’est utilisé qu’une fois choisi par vous, éventuellement limité aux adresses de votre CDN.
- Base intégrée épinglée et vérifiée (empreinte SHA-256), sources de détection réordonnables, envoi d’un fichier .mmdb.
- Nouveaux styles (barre en haut ou en bas, toast, fenêtre de dialogue accessible), contrôle du contraste, drapeaux réservés aux pays.
- Statistiques protégées contre le rejeu (jeton à usage unique, plafond horaire) et refus comptés par pays.
Installation et mise à jour
- Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier ZIP.
- Le module crée une destination par couple boutique et langue actif, puis s’ouvre sur l’Assistant de configuration.
- Après une installation neuve, le module est en mode test : vos visiteurs ne voient rien tant que vous ne le mettez pas en ligne.
La mise à jour depuis la 1.0, la 1.1 ou la 1.2 conserve vos destinations, textes, couleurs et statistiques. Deux changements volontaires : aucun en-tête CDN n’est utilisé tant que vous ne l’avez pas confirmé dans Géolocalisation (un encadré vous le signale s’il en reçoit un), et la suggestion de devise reste désactivée jusqu’à ce que vous l’activiez.
En multiboutique, installez le module dans le contexte « Toutes les boutiques » et vérifiez qu’il est activé sur chaque boutique de destination : il mémorise le choix du visiteur à son arrivée.
Assistant de configuration
L’assistant réunit en cinq étapes ce qu’il faut régler au départ. Vous pouvez le passer et le rouvrir à tout moment depuis son onglet.
- Détection : nombre de boutiques, de langues et de devises, en-tête pays reçu par la boutique, module du serveur web, fichier MaxMind et base intégrée.
- Langues et pays : pour chaque destination, les pays où la langue est parlée sont pré-remplis (FR, BE, CH, LU, CA… pour le français). Ajustez-les avant d’enregistrer.
- Devises : activation de la suggestion et liste des pays qui se verront proposer une autre devise.
- Apparence : style, couleurs et drapeaux, avec aperçu en direct.
- Activation : tester d’abord, mettre en ligne ou laisser en pause.




Géolocalisation
La langue du navigateur est toujours connue. Le pays sert à suggérer une boutique ou une devise. Quatre sources sont possibles ; la première qui connaît le pays l’emporte et vous réglez leur ordre avec les flèches :
- En-tête du CDN (Cloudflare, CloudFront, Vercel, App Engine, Fastly ou X-Country-Code) ;
- Module du serveur web (mod_geoip, mod_maxminddb, geoip2 de nginx) ;
- Fichier MaxMind GeoLite2 ou GeoIP2, à l’emplacement de PrestaShop ou au chemin que vous indiquez ;
- Base intégrée, installée depuis le module.
L’adresse IP ne sert qu’à la recherche, en mémoire : elle n’est jamais enregistrée ni envoyée à un tiers.
Un en-tête comme X-Country-Code peut être envoyé par n’importe qui. Choisissez-en un seulement si toutes les requêtes passent par ce CDN et, de préférence, indiquez les adresses du CDN dans Ne l’accepter que depuis ces adresses. Elles sont comparées à l’adresse qui se connecte au serveur web, jamais à X-Forwarded-For.
Base intégrée
Le bouton Installer la base télécharge une version figée de la base geo-whois-asn-country du projet ip-location-db (environ 7,5 Mo, IPv4 et IPv6) depuis jsDelivr, ou unpkg en secours. Avant de remplacer le fichier, le module vérifie sa taille exacte et son empreinte SHA-256 ; un fichier non conforme est écarté et la base actuelle est conservée. Le fichier est stocké dans var/dflocalesuggest/, protégé contre l’accès depuis le web. La copie précédente reste restaurable.
Ces données sont publiées sous licence CC BY 4.0 (données des registres internet NRO) : l’attribution est demandée si vous republiez les données. La distribution npm du projet n’étant plus mise à jour, la date des données est affichée : pour une précision maximale, préférez l’en-tête de votre CDN ou un fichier MaxMind tenu à jour.
Source personnalisée et envoi de fichier
Dans Votre propre base, vous pouvez indiquer une adresse HTTPS d’un fichier .mmdb avec son empreinte SHA-256 (ou l’adresse du fichier .sha256 publié par la source) ; un fichier non vérifié n’est jamais installé. La mise à jour planifiée est lancée par le cron de votre serveur avec l’adresse secrète affichée, jamais par un visiteur. Sans connexion sortante, envoyez directement un fichier .mmdb.

Correspondances
Chaque ligne est un couple boutique et langue que le bandeau peut proposer : libellé affiché, pays (codes ISO, vide = tous), langues du navigateur (de, de-at, en-gb…) et ordre de départage par glisser-déposer. Suggérer les pays remplit les destinations sans pays, Ajouter les couples manquants crée les lignes des nouvelles boutiques ou langues.
Le tableau Devises liste les pays dont la devise est active dans vos boutiques. Pour chacun : automatique (la devise réglée sur le pays dans PrestaShop, sinon la devise en usage dans ce pays), une devise précise, ou jamais de suggestion.

Apparence
Sur ordinateur : barre en bas, barre en haut, toast à gauche ou à droite, ou fenêtre de dialogue. Sur mobile : carte flottante, barres ou dialogue. Tous les styles flottent au-dessus de la page : rien ne bouge à l’affichage. La fenêtre de dialogue demande une réponse avant de continuer ; réservez-la aux boutiques pour lesquelles se tromper coûte cher.
- Couleurs : cinq thèmes et quatre couleurs libres. Le contraste est calculé en direct et signalé en dessous de 4,5:1.
- Drapeaux : « Pays uniquement » (par défaut) n’affiche un drapeau que pour une boutique ou une devise, jamais pour une langue.
- Rappel compact, délai d’affichage et durée de mémorisation de « Rester ici » (30 jours par défaut, dans le stockage local du navigateur, sans cookie).

Textes
Le bandeau est rédigé dans la langue suggérée : un visiteur allemand le lit en allemand sur votre boutique française. Une suggestion de devise seule est rédigée dans la langue de la page. Chaque langue a ses messages de langue, de boutique et de devise, avec les variables {language}, {country}, {store}, {currency} et {currency_name}. Un champ vide reprend le texte intégré.

Règles
- Langue dans une boutique : la langue du navigateur décide ; le pays ne sert qu’à départager.
- Entre boutiques : le pays l’emporte (boutique qui livre le visiteur, avec ses prix) ou la langue l’emporte.
- Devise : le pays décide, seulement tant que le visiteur voit la devise par défaut.
- Respect des visiteurs multilingues, masquage pour les clients connectés, pages sans bandeau (panier et tunnel par défaut), attente du bandeau de consentement, plafond horaire des statistiques, événements Google Tag Manager.

Tester avant la mise en ligne
Le Simulateur indique, pour une page, un pays et des langues de navigateur, le bandeau obtenu, son lien et le score de chaque destination. Il fournit un lien d’aperçu valable une heure. En mode test, ouvrez une fois le lien de test affiché dans les Statistiques : le bandeau apparaît alors dans ce navigateur pendant 24 heures avec la vraie détection, sans rien compter. Les visiteurs ne voient rien.

Statistiques
Bandeaux affichés (une fois par visite et par suggestion), acceptés, refusés, taux d’acceptation et de refus, activité quotidienne, classements par pays, par destination et par type de suggestion, sur 7, 30, 90 jours ou un an, avec export CSV. Chaque bandeau n’est compté qu’une fois, les robots et les requêtes rejouées sont ignorés. Aucune IP, aucun cookie, aucun identifiant client n’est stocké.

Côté visiteur
- Aucune redirection, pour les visiteurs comme pour les robots : Google déconseille de rediriger selon la langue ou l’adresse IP. Les robots ne voient pas le bandeau, qui porte
data-nosnippet. - Le lien proposé est la même page dans l’autre langue ou boutique, identique à l’alternative hreflang de la page.
- Le HTML des pages est le même pour tous ; la suggestion vient d’une requête séparée, jamais mise en cache. Le module fonctionne derrière un cache pleine page.
- Barre et toast ne prennent pas le focus ; Échap ferme le bandeau ; la fenêtre de dialogue garde le focus à l’intérieur et le rend à la page à la fermeture.




Pour les développeurs
Événements DOM sur document : dfls:shown, dfls:accept, dfls:dismiss (avec la langue, la boutique, le pays, le type et la devise). Option dataLayer pour Google Tag Manager. Le hook PHP actionDflocalesuggestResponse reçoit la réponse par référence ; seules les URL de vos boutiques sont conservées.
Dépannage
Le bandeau n’apparaît pas
Vérifiez l’état (en pause, test ou en ligne), qu’au moins deux destinations sont valides ou qu’une seconde devise est active, que la page n’est pas exclue et que ce navigateur n’a pas déjà refusé ou accepté une suggestion (videz le stockage local du site). Le simulateur indique pourquoi une destination est écartée.
Le pays reste « Inconnu »
C’est normal depuis une IP locale ou privée, ou sans source de détection. Consultez l’onglet Géolocalisation : il indique quelle source est active et le pays détecté pour vous.
Le téléchargement de la base échoue
Le message indique la cause : connexion sortante bloquée (autorisez HTTPS vers cdn.jsdelivr.net et unpkg.com, ou envoyez le fichier), dossier non accessible en écriture, extension cURL absente ou empreinte non conforme.