Sprache und Land des Besuchers erkennen (ohne Weiterleitung)
Sprach-, Währungs- und Shopvorschlag installieren, einrichten und testen, ohne Weiterleitung.
Überblick
Das Modul erkennt das Land und die Browsersprachen des Besuchers und bietet ihm dann in einem nicht blockierenden Banner dieselbe Seite in der passenden Sprache, Währung oder im passenden Shop an. Es leitet nie weiter: Der Besucher behält die Kontrolle, Crawler erhalten die angeforderte Seite und Ihre hreflang-Tags bleiben unverändert.
Kompatibel mit PrestaShop 1.7.8 bis 9.x, Einzelshop, Multishop und Multidomain. Hat der Shop nur eine Sprache und eine Währung, wird nichts geladen.

Neu in Version 2.0
- Einrichtungsassistent in fünf Schritten, mit vorausgefüllten Ländern für jede Sprache.
- Testmodus: Das Banner erscheint nur in Ihrem eigenen Browser, geöffnet über einen signierten Link, der 24 Stunden gültig ist.
- Währungsvorschlag: Einem Besucher, der noch die Standardwährung sieht, wird die Währung seines Landes angeboten, sofern Sie darin verkaufen.
- Vertrauenswürdige CDN-Header: Ein Header wird erst verwendet, wenn Sie ihn ausgewählt haben, optional beschränkt auf die Adressen Ihres CDN.
- Fixierte und geprüfte integrierte Datenbank (SHA-256-Fingerabdruck), sortierbare Erkennungsquellen, Upload von .mmdb-Dateien.
- Neue Stile (Leiste oben oder unten, Toast, barrierefreier Dialog), Kontrastprüfung, Flaggen nur für Länder.
- Statistiken gegen Wiederholung geschützt (Einmal-Token, stündliche Obergrenze) und Ablehnungen pro Land gezählt.
Installation und Aktualisierung
- Klicken Sie unter Module > Modul-Manager auf Modul hochladen und laden Sie die ZIP-Datei hoch.
- Das Modul legt für jedes aktive Paar aus Shop und Sprache ein Ziel an und öffnet sich dann im Einrichtungsassistenten.
- Nach einer Neuinstallation befindet sich das Modul im Testmodus: Ihre Besucher sehen nichts, bis Sie es live schalten.
Bei einer Aktualisierung von 1.0, 1.1 oder 1.2 bleiben Ihre Ziele, Texte, Farben und Statistiken erhalten. Zwei bewusste Änderungen: Kein CDN-Header wird verwendet, bis Sie ihn unter Geolokalisierung bestätigen (ein Hinweis informiert Sie, wenn einer empfangen wird), und der Währungsvorschlag bleibt deaktiviert, bis Sie ihn einschalten.
Installieren Sie das Modul in einer Multishop-Umgebung im Kontext „Alle Shops“ und prüfen Sie, dass es in jedem Ziel-Shop aktiviert ist: Es übernimmt die Wahl des Besuchers bei der Ankunft.
Einrichtungsassistent
Der Assistent fasst in fünf Schritten zusammen, was zu Beginn eingestellt werden muss. Sie können ihn überspringen und jederzeit über seinen Tab erneut öffnen.
- Erkennung: Anzahl der Shops, Sprachen und Währungen, vom Shop empfangener Länder-Header, Webserver-Modul, MaxMind-Datei und integrierte Datenbank.
- Sprachen und Länder: Für jedes Ziel sind die Länder vorausgefüllt, in denen die Sprache gesprochen wird (GB, US, IE, CA, AU… für Englisch). Passen Sie sie vor dem Speichern an.
- Währungen: Aktivierung des Vorschlags und Liste der Länder, denen eine andere Währung angeboten wird.
- Darstellung: Stil, Farben und Flaggen, mit Live-Vorschau.
- Aktivierung: zuerst testen, live schalten oder pausiert lassen.




Geolokalisierung
Die Browsersprache ist immer bekannt. Das Land wird verwendet, um einen Shop oder eine Währung vorzuschlagen. Vier Quellen stehen zur Verfügung; die erste, die das Land kennt, gilt, und Sie legen ihre Reihenfolge mit den Pfeilen fest:
- CDN-Header (Cloudflare, CloudFront, Vercel, App Engine, Fastly oder X-Country-Code);
- Webserver-Modul (mod_geoip, mod_maxminddb, nginx geoip2);
- MaxMind-Datei GeoLite2 oder GeoIP2, am Speicherort von PrestaShop oder unter dem von Ihnen angegebenen Pfad;
- Integrierte Datenbank, über das Modul installiert.
Die IP-Adresse wird nur für die Abfrage im Arbeitsspeicher verwendet: Sie wird nie gespeichert oder an Dritte übermittelt.
Ein Header wie X-Country-Code kann von jedem gesendet werden. Wählen Sie ihn nur, wenn jede Anfrage über dieses CDN läuft, und tragen Sie die Adressen des CDN möglichst unter Nur von diesen Adressen akzeptieren ein. Sie werden mit der Adresse verglichen, die sich mit dem Webserver verbindet, nie mit X-Forwarded-For.
Integrierte Datenbank
Die Schaltfläche Datenbank installieren lädt eine feste Version der Datenbank geo-whois-asn-country aus dem Projekt ip-location-db (etwa 7,5 MB, IPv4 und IPv6) von jsDelivr herunter, ersatzweise von unpkg. Bevor die Datei ersetzt wird, prüft das Modul ihre genaue Größe und ihren SHA-256-Fingerabdruck; eine Datei, die nicht übereinstimmt, wird verworfen und die aktuelle Datenbank bleibt erhalten. Die Datei wird in var/dflocalesuggest/ gespeichert, geschützt vor Webzugriff. Die vorherige Kopie kann wiederhergestellt werden.
Diese Daten werden unter der Lizenz CC BY 4.0 veröffentlicht (Daten der NRO-Internetregistrierungsstellen): Bei einer Weiterveröffentlichung der Daten ist eine Namensnennung erforderlich. Da die npm-Distribution des Projekts nicht mehr aktualisiert wird, wird das Datum der Daten angezeigt: Für die beste Genauigkeit sollten Sie Ihren CDN-Header oder eine aktuelle MaxMind-Datei bevorzugen.
Eigene Quelle und Datei-Upload
Unter Eigene Datenbank können Sie die HTTPS-Adresse einer .mmdb-Datei mit ihrem SHA-256-Fingerabdruck eingeben (oder die Adresse der von der Quelle veröffentlichten .sha256-Datei); eine nicht geprüfte Datei wird nie installiert. Die geplante Aktualisierung wird vom cron Ihres Servers über die angezeigte geheime Adresse ausgeführt, nie durch einen Besucher. Ohne ausgehende Verbindungen laden Sie eine .mmdb-Datei direkt hoch.

Zuordnung
Jede Zeile ist ein Paar aus Shop und Sprache, das das Banner vorschlagen kann: angezeigte Bezeichnung, Länder (ISO-Codes, leer = alle), Browsersprachen (de, de-at, en-gb…) und Rangfolge bei Gleichstand per Drag-and-drop. Länder vorschlagen füllt die Ziele ohne Länder aus, Fehlende Paare hinzufügen legt die Zeilen neuer Shops oder Sprachen an.
Die Tabelle Währungen listet die Länder auf, deren Währung in Ihren Shops aktiv ist. Für jedes: automatisch (die im Land in PrestaShop hinterlegte Währung, andernfalls die in diesem Land verwendete Währung), eine bestimmte Währung oder nie eine vorschlagen.

Darstellung
Auf dem Computer: Leiste unten, Leiste oben, Toast links oder rechts oder Dialog. Auf dem Smartphone: schwebende Karte, Leisten oder Dialog. Jeder Stil schwebt über der Seite: Beim Erscheinen verschiebt sich nichts. Der Dialog verlangt eine Antwort, bevor es weitergeht; verwenden Sie ihn für Shops, in denen ein Aufenthalt im falschen Shop kostspielig ist.
- Farben: fünf Themes und vier frei wählbare Farben. Der Kontrast wird live berechnet und unter 4,5:1 markiert.
- Flaggen: „Nur Länder“ (Standard) zeigt eine Flagge für einen Shop oder eine Währung, nie für eine Sprache.
- Kompakte Erinnerung, Anzeigeverzögerung und wie lange „Hier bleiben“ gespeichert wird (standardmäßig 30 Tage, im lokalen Speicher des Browsers, ohne Cookie).

Texte
Das Banner ist in der vorgeschlagenen Sprache verfasst: Ein deutscher Besucher liest es in Ihrem französischen Shop auf Deutsch. Ein reiner Währungsvorschlag ist in der Sprache der Seite verfasst. Jede Sprache hat ihre Meldungen für Sprache, Shop und Währung, mit den Variablen {language}, {country}, {store}, {currency} und {currency_name}. Ein leeres Feld greift auf den integrierten Text zurück.

Regeln
- Sprache innerhalb eines Shops: Die Browsersprache entscheidet; das Land gibt nur bei Gleichstand den Ausschlag.
- Zwischen Shops: Das Land gewinnt (der Shop, der an den Besucher liefert, mit seinen Preisen) oder die Sprache gewinnt.
- Währung: Das Land entscheidet, nur solange der Besucher noch die Standardwährung sieht.
- Berücksichtigung mehrsprachiger Besucher, Ausblenden für angemeldete Kunden, Seiten ohne Banner (standardmäßig Warenkorb und Kasse), Warten auf das Consent-Banner, stündliche Obergrenze für Statistiken, Google Tag Manager-Ereignisse.

Testen vor dem Livegang
Der Simulator zeigt für eine Seite, ein Land und Browsersprachen das resultierende Banner, seinen Link und die Punktzahl jedes Ziels. Er stellt einen Vorschaulink bereit, der eine Stunde gültig ist. Öffnen Sie im Testmodus einmal den unter Statistiken angezeigten Testlink: Das Banner erscheint dann 24 Stunden lang in diesem Browser mit der echten Erkennung, und nichts wird gezählt. Besucher sehen nichts.

Statistiken
Angezeigte Banner (einmal pro Besuch und Vorschlag), angenommene, abgelehnte, Annahme- und Ablehnungsquoten, tägliche Aktivität, Ranglisten nach Land, nach Ziel und nach Art des Vorschlags, über 7, 30, 90 Tage oder ein Jahr, mit CSV-Export. Jedes Banner wird nur einmal gezählt; Crawler und wiederholte Anfragen werden ignoriert. Es werden keine IP-Adresse, kein Cookie und keine Kundenkennung gespeichert.

Auf Besucherseite
- Keine Weiterleitung, weder für Besucher noch für Crawler: Google rät davon ab, nach Sprache oder IP-Adresse weiterzuleiten. Crawler sehen das Banner nie, es trägt
data-nosnippet. - Der vorgeschlagene Link ist dieselbe Seite in der anderen Sprache oder im anderen Shop, identisch mit der hreflang-Alternative der Seite.
- Das HTML der Seite ist für alle gleich; der Vorschlag stammt aus einer separaten Anfrage, die nie zwischengespeichert wird. Das Modul funktioniert hinter einem Full-Page-Cache.
- Leiste und Toast übernehmen nicht den Fokus; Escape schließt das Banner; der Dialog hält den Fokus in sich und gibt ihn beim Schließen an die Seite zurück.




Für Entwickler
DOM-Ereignisse auf document: dfls:shown, dfls:accept, dfls:dismiss (mit Sprache, Shop, Land, Art und Währung). Option dataLayer für Google Tag Manager. Der PHP-Hook actionDflocalesuggestResponse erhält die Antwort per Referenz; nur die URLs Ihrer Shops werden übernommen.
Fehlerbehebung
Das Banner erscheint nicht
Prüfen Sie den Status (pausiert, Test oder live), dass mindestens zwei Ziele gültig sind oder eine zweite Währung aktiv ist, dass die Seite nicht ausgeschlossen ist und dass dieser Browser nicht bereits einen Vorschlag abgelehnt oder angenommen hat (leeren Sie den lokalen Speicher der Website). Der Simulator zeigt Ihnen, warum ein Ziel übersprungen wird.
Das Land bleibt „Unbekannt“
Das ist normal bei einer lokalen oder privaten IP oder ohne Erkennungsquelle. Öffnen Sie den Tab Geolokalisierung: Er zeigt, welche Quelle aktiv ist und welches Land für Sie erkannt wurde.
Der Download der Datenbank schlägt fehl
Die Meldung nennt die Ursache: ausgehende Verbindung blockiert (erlauben Sie HTTPS zu cdn.jsdelivr.net und unpkg.com oder laden Sie die Datei hoch), Ordner nicht beschreibbar, fehlende cURL-Erweiterung oder abweichender Fingerabdruck.