PS PrestaShop Débutant

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.

Mis à jour Version du module 2.0.0

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.

Barre en bas : un visiteur français sur la page anglaise se voit proposer la même page en français, sans redirection
Barre en bas

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

  1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier ZIP.
  2. Le module crée une destination par couple boutique et langue actif, puis s’ouvre sur l’Assistant de configuration.
  3. 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.

  1. 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.
  2. 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.
  3. Devises : activation de la suggestion et liste des pays qui se verront proposer une autre devise.
  4. Apparence : style, couleurs et drapeaux, avec aperçu en direct.
  5. Activation : tester d’abord, mettre en ligne ou laisser en pause.
Assistant de configuration, étape 1 : boutiques, langues et devises actives, sources de détection du pays et installation de la base vérifiée
Assistant de configuration, étape 1
Assistant, étape 2 : pays pré-remplis pour chaque langue (FR, BE, CH, LU, CA… pour le français), modifiables avant l'enregistrement
Assistant, étape 2
Assistant, étape 4 : style (barre, toast, fenêtre de dialogue), couleurs, drapeaux pour les pays uniquement et aperçu en direct
Assistant, étape 4
Assistant, étape 5 : engagements (aucune redirection, cache et hreflang préservés) et choix tester d'abord, mettre en ligne ou laisser en pause
Assistant, étape 5

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.

Géolocalisation : sources dans l'ordre, en-tête CDN de confiance limité aux adresses du CDN, base intégrée épinglée avec empreinte SHA-256
Géolocalisation

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.

Correspondances : couples boutique et langue avec leurs pays, langues du navigateur, et devise suggérée pour chaque pays
Correspondances

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).
Apparence : barre, toast ou fenêtre de dialogue sur ordinateur et mobile, thèmes de couleurs, contrôle du contraste et aperçu en direct
Apparence

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

Textes du bandeau par langue : messages de langue, de boutique et de devise, variables {language}, {country}, {store} et {currency}
Textes du bandeau par langue

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.
Règles : priorité langue du navigateur et pays, aucune redirection pour les robots, cache préservé, attente du bandeau de consentement
Règles

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.

Simulateur : visiteur venant de France avec un navigateur en français sur la page anglaise, bandeau obtenu et score de chaque destination
Simulateur

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

Statistiques sur 30 jours (données de démonstration) : bandeaux affichés, acceptés, refusés, par pays, par destination et par type de suggestion
Statistiques sur 30 jours (données de démonstration)

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.
Suggestion de devise : un visiteur des États-Unis qui lit le français se voit proposer d'afficher les prix en dollars (USD)
Suggestion de devise
Fenêtre de dialogue accessible : focus sur le bouton principal, navigation au clavier confinée, Échap ou clic à côté pour rester
Fenêtre de dialogue accessible
Sur mobile : carte flottante en bas d'écran, boutons pleine largeur de 44 px minimum, sans défilement horizontal
Sur mobile
Multiboutique et multidomaine : un visiteur de France sur la boutique britannique se voit proposer la Boutique France, sur son propre domaine
Multiboutique et multidomaine

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.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support