PS PrestaShop Beginner

Taal en land van de bezoeker detecteren (zonder redirect)

De taal-, valuta- en winkelsuggestie installeren, instellen en testen, zonder omleiding.

Bijgewerkt Moduleversie 2.0.0

Overzicht

De module detecteert het land en de browsertalen van de bezoeker en biedt vervolgens, in een niet-blokkerende banner, dezelfde pagina aan in de juiste taal, valuta of winkel. De module leidt nooit door: de bezoeker houdt de controle, crawlers krijgen de pagina die ze hebben opgevraagd en uw hreflang-tags blijven ongewijzigd.

Compatibel met PrestaShop 1.7.8 tot 9.x, enkele winkel, multistore en multidomein. Er wordt niets geladen in de winkel wanneer deze één taal en één valuta heeft.

Balk onderaan: een Nederlandse bezoeker in de Franse winkel krijgt dezelfde pagina in het Nederlands voorgesteld, zonder omleiding
Balk onderaan

Nieuw in versie 2.0

  • Configuratieassistent in vijf stappen, met vooraf ingevulde landen voor elke taal.
  • Testmodus: de banner verschijnt alleen in uw eigen browser, geopend via een ondertekende link die 24 uur geldig is.
  • Valutasuggestie: een bezoeker die nog de standaardvaluta ziet, krijgt de valuta van zijn land aangeboden, als u daarin verkoopt.
  • Vertrouwde CDN-headers: een header wordt pas gebruikt nadat u deze hebt gekozen, optioneel beperkt tot de adressen van uw CDN.
  • Vastgezette en geverifieerde ingebouwde database (SHA-256-vingerafdruk), herschikbare detectiebronnen, upload van .mmdb-bestanden.
  • Nieuwe stijlen (balk boven of onder, toast, toegankelijk dialoogvenster), contrastcontrole, vlaggen alleen voor landen.
  • Statistieken beschermd tegen herhaling (eenmalig token, plafond per uur) en weigeringen geteld per land.

Installatie en upgrade

  1. Klik in Modules > Modulebeheer op Een module uploaden en verstuur het ZIP-bestand.
  2. De module maakt een bestemming aan voor elk actief paar van winkel en taal en opent vervolgens op de Configuratieassistent.
  3. Na een nieuwe installatie staat de module in testmodus: uw bezoekers zien niets totdat u de module live zet.

Bij een upgrade vanaf 1.0, 1.1 of 1.2 blijven uw bestemmingen, teksten, kleuren en statistieken behouden. Twee bewuste wijzigingen: er wordt geen CDN-header gebruikt totdat u deze bevestigt in Geolocatie (een melding laat u weten wanneer er een wordt ontvangen), en de valutasuggestie blijft uitgeschakeld totdat u deze inschakelt.

Installeer de module bij een multistore-configuratie in de context „Alle winkels” en controleer of deze is ingeschakeld in elke bestemmingswinkel: de module onthoudt de keuze van de bezoeker bij aankomst.

Configuratie-assistent

De assistent bundelt in vijf stappen wat bij de start moet worden ingesteld. U kunt deze overslaan en op elk moment opnieuw openen via het bijbehorende tabblad.

  1. Detectie: aantal winkels, talen en valuta’s, door de winkel ontvangen landheader, webservermodule, MaxMind-bestand en ingebouwde database.
  2. Talen en landen: voor elke bestemming zijn de landen waar de taal wordt gesproken vooraf ingevuld (GB, US, IE, CA, AU… voor Engels). Pas ze aan voordat u opslaat.
  3. Valuta’s: het inschakelen van de suggestie en de lijst met landen die een andere valuta krijgen aangeboden.
  4. Weergave: stijl, kleuren en vlaggen, met een live voorbeeld.
  5. Activering: eerst testen, live zetten of gepauzeerd laten.
Configuratie-assistent, stap 1: actieve winkels, talen en valuta, bronnen voor landdetectie en installatie van de gecontroleerde database
Configuratie-assistent, stap 1
Assistent, stap 2: vooraf ingevulde landen per taal (NL, BE, SR… voor het Nederlands), aan te passen vóór het opslaan
Assistent, stap 2
Assistent, stap 4: stijl (balk, toast, dialoog), kleuren, vlaggen alleen voor landen en live voorbeeld
Assistent, stap 4
Assistent, stap 5: afspraken (geen omleiding, cache en hreflang behouden) en keuze tussen eerst testen, live zetten of gepauzeerd laten
Assistent, stap 5

Geolocatie

De browsertaal is altijd bekend. Het land wordt gebruikt om een winkel of een valuta voor te stellen. Er zijn vier bronnen beschikbaar; de eerste die het land kent, geldt, en u bepaalt hun volgorde met de pijlen:

  • CDN-header (Cloudflare, CloudFront, Vercel, App Engine, Fastly of X-Country-Code);
  • Webservermodule (mod_geoip, mod_maxminddb, nginx geoip2);
  • MaxMind-bestand GeoLite2 of GeoIP2, op de locatie van PrestaShop of op het pad dat u opgeeft;
  • Ingebouwde database, geïnstalleerd vanuit de module.

Het IP-adres wordt alleen in het geheugen gebruikt voor de opzoeking: het wordt nooit opgeslagen of naar derden verzonden.

Een header zoals X-Country-Code kan door iedereen worden verzonden. Kies er alleen een als elk verzoek via dat CDN verloopt en vul bij voorkeur de adressen van het CDN in bij Alleen van deze adressen accepteren. Ze worden vergeleken met het adres dat verbinding maakt met de webserver, nooit met X-Forwarded-For.

Ingebouwde database

De knop Database installeren downloadt een vaste versie van de database geo-whois-asn-country van het project ip-location-db (ongeveer 7,5 MB, IPv4 en IPv6) via jsDelivr, of unpkg als alternatief. Voordat het bestand wordt vervangen, controleert de module de exacte grootte en de SHA-256-vingerafdruk; een bestand dat niet overeenkomt, wordt verworpen en de huidige database blijft behouden. Het bestand wordt opgeslagen in var/dflocalesuggest/, beschermd tegen webtoegang. De vorige kopie kan worden hersteld.

Deze gegevens worden gepubliceerd onder de licentie CC BY 4.0 (gegevens van de NRO-internetregisters): naamsvermelding is verplicht als u de gegevens opnieuw publiceert. Omdat de npm-distributie van het project niet meer wordt bijgewerkt, wordt de datum van de gegevens weergegeven: voor de beste nauwkeurigheid geeft u de voorkeur aan uw CDN-header of een actueel MaxMind-bestand.

Eigen bron en bestandsupload

In Eigen database kunt u het HTTPS-adres van een .mmdb-bestand invoeren met de SHA-256-vingerafdruk (of het adres van het .sha256-bestand dat door de bron is gepubliceerd); een niet-geverifieerd bestand wordt nooit geïnstalleerd. De geplande update wordt uitgevoerd door de cron van uw server via het getoonde geheime adres, nooit door een bezoeker. Zonder uitgaande verbindingen uploadt u rechtstreeks een .mmdb-bestand.

Geolocatie: bronnen op volgorde, vertrouwde CDN-header beperkt tot de CDN-adressen, vastgezette ingebouwde database met SHA-256-vingerafdruk
Geolocatie

Afstemming

Elke rij is een paar van winkel en taal dat de banner kan voorstellen: getoond label, landen (ISO-codes, leeg = alle), browsertalen (de, de-at, en-gb…) en volgorde bij gelijkspel via slepen en neerzetten. Landen voorstellen vult de bestemmingen zonder landen in, Ontbrekende combinaties toevoegen maakt de rijen voor nieuwe winkels of talen aan.

De tabel Valuta’s toont de landen waarvan de valuta actief is in uw winkels. Voor elk land: automatisch (de valuta die in PrestaShop voor het land is ingesteld, anders de valuta die in dat land wordt gebruikt), een specifieke valuta, of nooit een valuta voorstellen.

Afstemming: combinaties van winkel en taal met hun landen en browsertalen, en de voorgestelde valuta per land
Afstemming

Weergave

Op de computer: balk onder, balk boven, toast links of rechts, of dialoogvenster. Op mobiel: zwevende kaart, balken of dialoogvenster. Elke stijl zweeft boven de pagina: er verschuift niets wanneer de banner verschijnt. Het dialoogvenster vraagt om een antwoord voordat de bezoeker verdergaat; gebruik het voor winkels waar in de verkeerde winkel terechtkomen kostbaar is.

  • Kleuren: vijf thema’s en vier vrij te kiezen kleuren. Het contrast wordt live berekend en gemarkeerd onder 4,5:1.
  • Vlaggen: „Alleen landen” (standaard) toont een vlag voor een winkel of een valuta, nooit voor een taal.
  • Compacte herinnering, weergavevertraging en hoe lang „Hier blijven” wordt onthouden (standaard 30 dagen, in de lokale opslag van de browser, zonder cookie).
Weergave: balk, toast of dialoog op computer en mobiel, kleurthema’s, contrastcontrole en live voorbeeld
Weergave

Teksten

De banner wordt geschreven in de voorgestelde taal: een Duitse bezoeker leest hem in het Duits in uw Franse winkel. Een losse valutasuggestie wordt geschreven in de taal van de pagina. Elke taal heeft eigen berichten voor taal, winkel en valuta, met de variabelen {language}, {country}, {store}, {currency} en {currency_name}. Een leeg veld valt terug op de ingebouwde tekst.

Bannerteksten per taal: taal-, winkel- en valutameldingen, variabelen {language}, {country}, {store} en {currency}
Bannerteksten per taal

Regels

  • Taal binnen een winkel: de browsertaal beslist; het land geeft alleen de doorslag bij gelijkspel.
  • Tussen winkels: het land wint (de winkel die naar de bezoeker levert, met zijn prijzen) of de taal wint.
  • Valuta: het land beslist, alleen zolang de bezoeker nog de standaardvaluta ziet.
  • Rekening houden met meertalige bezoekers, verbergen voor ingelogde klanten, pagina’s zonder banner (standaard winkelwagen en afrekenen), wachten op de toestemmingsbanner, plafond per uur voor statistieken, Google Tag Manager-events.
Regels: prioriteit van browsertaal en land, geen omleiding voor crawlers, cache behouden, wachten op de toestemmingsbanner
Regels

Testen voordat u live gaat

De Simulator toont voor een pagina, een land en browsertalen de resulterende banner, de link ervan en de score van elke bestemming. Hij biedt een voorbeeldlink die één uur geldig is. Open in testmodus eenmaal de testlink die in Statistieken wordt getoond: de banner verschijnt dan 24 uur lang in die browser met de echte detectie, en er wordt niets geteld. Bezoekers zien niets.

Simulator: bezoeker uit Nederland met een Nederlandstalige browser op de Franse pagina, resulterende banner en score van elke bestemming
Simulator

Statistieken

Getoonde banners (één keer per bezoek en suggestie), geaccepteerd, geweigerd, acceptatie- en weigeringspercentages, dagelijkse activiteit, ranglijsten per land, per bestemming en per soort suggestie, over 7, 30, 90 dagen of één jaar, met CSV-export. Elke banner wordt maar één keer geteld; crawlers en herhaalde verzoeken worden genegeerd. Er wordt geen IP-adres, cookie of klant-ID opgeslagen.

Statistieken over 30 dagen (demogegevens): getoonde, geaccepteerde en geweigerde banners per land, bestemming en soort suggestie
Statistieken over 30 dagen (demogegevens)

Aan de kant van de bezoeker

  • Geen doorverwijzing, voor bezoekers noch crawlers: Google raadt af om door te verwijzen op basis van taal of IP-adres. Crawlers zien de banner nooit; deze bevat data-nosnippet.
  • De voorgestelde link is dezelfde pagina in de andere taal of winkel, identiek aan het hreflang-alternatief van de pagina.
  • De HTML van de pagina is voor iedereen hetzelfde; de suggestie komt uit een apart verzoek dat nooit in de cache wordt opgeslagen. De module werkt achter een full-page cache.
  • Balk en toast nemen de focus niet over; Escape sluit de banner; het dialoogvenster houdt de focus binnen en geeft deze bij het sluiten terug aan de pagina.
Valutasuggestie: een bezoeker uit de Verenigde Staten die Nederlands leest, krijgt prijzen in dollars (USD) voorgesteld
Valutasuggestie
Toegankelijke dialoog: focus op de hoofdknop, toetsenbordnavigatie blijft binnen de dialoog, Escape of klik ernaast om te blijven
Toegankelijke dialoog
Op mobiel: zwevende kaart onderaan, knoppen over de volle breedte van minstens 44 px, geen horizontaal scrollen
Op mobiel
Multistore en multidomein: een bezoeker uit het Verenigd Koninkrijk in de Franse winkel krijgt de UK Store op zijn eigen domein voorgesteld
Multistore en multidomein

Voor ontwikkelaars

DOM-events op document: dfls:shown, dfls:accept, dfls:dismiss (met taal, winkel, land, soort en valuta). Optie dataLayer voor Google Tag Manager. De PHP-hook actionDflocalesuggestResponse ontvangt het antwoord per referentie; alleen de URL’s van uw winkels worden behouden.

Probleemoplossing

De banner verschijnt niet

Controleer de status (gepauzeerd, test of live), dat ten minste twee bestemmingen geldig zijn of een tweede valuta actief is, dat de pagina niet is uitgesloten en dat deze browser niet al een suggestie heeft geweigerd of geaccepteerd (wis de lokale opslag van de site). De simulator vertelt u waarom een bestemming wordt overgeslagen.

Het land blijft „Onbekend”

Dit is normaal vanaf een lokaal of privé-IP-adres, of zonder detectiebron. Open het tabblad Geolocatie: het toont welke bron actief is en welk land voor u is gedetecteerd.

Het downloaden van de database mislukt

Het bericht geeft de oorzaak aan: uitgaande verbinding geblokkeerd (sta HTTPS naar cdn.jsdelivr.net en unpkg.com toe, of upload het bestand), map niet beschrijfbaar, ontbrekende cURL-extensie of afwijkende vingerafdruk.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support