Wykrywanie języka i kraju odwiedzającego (bez przekierowania)
Instalacja, konfiguracja i testowanie sugestii języka, waluty i sklepu, bez przekierowań.
Przegląd
Moduł wykrywa kraj odwiedzającego i języki jego przeglądarki, a następnie w nieblokującym banerze proponuje tę samą stronę we właściwym języku, walucie lub sklepie. Nigdy nie przekierowuje: odwiedzający zachowuje kontrolę, roboty indeksujące otrzymują żądaną stronę, a Twoje tagi hreflang pozostają bez zmian.
Zgodny z PrestaShop od 1.7.8 do 9.x, w trybie jednego sklepu, multisklepu i wielu domen. Jeśli sklep ma tylko jeden język i jedną walutę, moduł niczego w nim nie ładuje.

Nowości w wersji 2.0
- Asystent konfiguracji w pięciu krokach, z krajami wstępnie uzupełnionymi dla każdego języka.
- Tryb testowy: baner pojawia się tylko w Twojej przeglądarce, otwartej podpisanym linkiem ważnym 24 godziny.
- Sugestia waluty: odwiedzającemu, który nadal widzi walutę domyślną, proponowana jest waluta jego kraju, jeśli w niej sprzedajesz.
- Zaufane nagłówki CDN: nagłówek jest używany dopiero po jego wybraniu, opcjonalnie tylko z adresów Twojego CDN.
- Przypięta i weryfikowana wbudowana baza danych (skrót SHA-256), źródła wykrywania z możliwością zmiany kolejności, przesyłanie pliku .mmdb.
- Nowe style (pasek u góry lub u dołu, toast, dostępne okno dialogowe), kontrola kontrastu, flagi zarezerwowane dla krajów.
- Statystyki chronione przed ponownym odtwarzaniem żądań (jednorazowy token, limit godzinowy) i odmowy liczone według kraju.
Instalacja i aktualizacja
- W Moduły > Menedżer modułów kliknij Prześlij moduł i wyślij plik ZIP.
- Moduł tworzy jedno miejsce docelowe dla każdej aktywnej pary sklep–język, a następnie otwiera Asystenta konfiguracji.
- Po nowej instalacji moduł działa w trybie testowym: odwiedzający nic nie widzą, dopóki nie uruchomisz go na żywo.
Aktualizacja z wersji 1.0, 1.1 lub 1.2 zachowuje miejsca docelowe, teksty, kolory i statystyki. Dwie zamierzone zmiany: żaden nagłówek CDN nie jest używany, dopóki nie potwierdzisz go w zakładce Geolokalizacja (komunikat informuje, gdy sklep go odbiera), a sugestia waluty pozostaje wyłączona, dopóki jej nie włączysz.
W konfiguracji multisklepu zainstaluj moduł w kontekście „Wszystkie sklepy” i sprawdź, czy jest włączony w każdym sklepie docelowym: zapamiętuje on wybór odwiedzającego po jego przybyciu.
Asystent konfiguracji
Asystent zbiera w pięciu krokach wszystko, co trzeba ustawić na początku. Możesz go pominąć i w dowolnym momencie otworzyć ponownie z jego zakładki.
- Wykrywanie: liczba sklepów, języków i walut, nagłówek kraju odbierany przez sklep, moduł serwera WWW, plik MaxMind i wbudowana baza danych.
- Języki i kraje: dla każdego miejsca docelowego wstępnie uzupełniane są kraje, w których mówi się danym językiem (GB, US, IE, CA, AU… dla angielskiego). Dostosuj je przed zapisaniem.
- Waluty: włączenie sugestii i lista krajów, którym zostanie zaproponowana inna waluta.
- Wygląd: styl, kolory i flagi, z podglądem na żywo.
- Aktywacja: najpierw przetestuj, uruchom na żywo lub pozostaw wstrzymany.




Geolokalizacja
Język przeglądarki jest zawsze znany. Kraj służy do zasugerowania sklepu lub waluty. Dostępne są cztery źródła; wygrywa pierwsze, które zna kraj, a ich kolejność ustawiasz strzałkami:
- Nagłówek CDN (Cloudflare, CloudFront, Vercel, App Engine, Fastly lub X-Country-Code);
- Moduł serwera WWW (mod_geoip, mod_maxminddb, nginx geoip2);
- Plik MaxMind GeoLite2 lub GeoIP2, w lokalizacji używanej przez PrestaShop lub pod wskazaną przez Ciebie ścieżką;
- Wbudowana baza danych, instalowana z poziomu modułu.
Adres IP jest używany wyłącznie do wyszukiwania, w pamięci: nigdy nie jest zapisywany ani przekazywany osobom trzecim.
Nagłówek taki jak X-Country-Code może wysłać każdy. Wybierz go tylko wtedy, gdy wszystkie żądania przechodzą przez ten CDN, a najlepiej wpisz adresy CDN w polu Akceptuj go tylko z tych adresów. Są one porównywane z adresem łączącym się z serwerem WWW, nigdy z X-Forwarded-For.
Wbudowana baza danych
Przycisk Zainstaluj bazę pobiera ustaloną wersję bazy geo-whois-asn-country z projektu ip-location-db (ok. 7,5 MB, IPv4 i IPv6) z jsDelivr lub zapasowo z unpkg. Przed zastąpieniem pliku moduł sprawdza jego dokładny rozmiar i skrót SHA-256; niezgodny plik jest odrzucany, a obecna baza zostaje zachowana. Plik jest przechowywany w var/dflocalesuggest/, chronionym przed dostępem z sieci. Poprzednią kopię można przywrócić.
Dane te są publikowane na licencji CC BY 4.0 (dane z rejestrów internetowych NRO): przy ich ponownej publikacji wymagane jest podanie źródła. Ponieważ dystrybucja npm projektu nie jest już aktualizowana, wyświetlana jest data danych: aby uzyskać największą dokładność, wybierz nagłówek swojego CDN lub aktualny plik MaxMind.
Własne źródło i przesyłanie pliku
W sekcji Własna baza możesz podać adres HTTPS pliku .mmdb wraz z jego skrótem SHA-256 (lub adres pliku .sha256 publikowanego przez źródło); niezweryfikowany plik nigdy nie jest instalowany. Zaplanowaną aktualizację uruchamia cron Twojego serwera za pomocą wyświetlonego tajnego adresu, nigdy odwiedzający. Bez połączeń wychodzących prześlij plik .mmdb bezpośrednio.

Mapowanie
Każdy wiersz to para sklep–język, którą baner może zasugerować: wyświetlana etykieta, kraje (kody ISO, puste = wszystkie), języki przeglądarki (de, de-at, en-gb…) oraz kolejność rozstrzygania remisów ustawiana metodą przeciągnij i upuść. Zasugeruj kraje uzupełnia miejsca docelowe bez krajów, Dodaj brakujące pary tworzy wiersze dla nowych sklepów lub języków.
Tabela Waluty zawiera kraje, których waluta jest aktywna w Twoich sklepach. Dla każdego z nich: automatycznie (waluta ustawiona dla kraju w PrestaShop, a w przeciwnym razie waluta używana w tym kraju), określona waluta lub brak sugestii.

Wygląd
Na komputerze: pasek u dołu, pasek u góry, toast po lewej lub prawej albo okno dialogowe. Na urządzeniach mobilnych: pływająca karta, paski lub okno dialogowe. Każdy styl unosi się nad stroną: po jego pojawieniu się nic się nie przesuwa. Okno dialogowe wymaga odpowiedzi przed kontynuowaniem; stosuj je w sklepach, w których trafienie do niewłaściwego sklepu jest kosztowne.
- Kolory: pięć motywów i cztery dowolne kolory. Kontrast jest obliczany na żywo i sygnalizowany poniżej 4,5:1.
- Flagi: „Tylko kraje” (domyślnie) wyświetla flagę dla sklepu lub waluty, nigdy dla języka.
- Kompaktowe przypomnienie, opóźnienie wyświetlania i czas zapamiętywania wyboru „Zostań tutaj” (domyślnie 30 dni, w pamięci lokalnej przeglądarki, bez pliku cookie).

Teksty
Baner jest napisany w sugerowanym języku: odwiedzający z Niemiec czyta go po niemiecku w Twoim francuskim sklepie. Sama sugestia waluty jest napisana w języku strony. Każdy język ma własne komunikaty dotyczące języka, sklepu i waluty, ze zmiennymi {language}, {country}, {store}, {currency} i {currency_name}. Jeśli pole jest puste, używany jest tekst wbudowany.

Reguły
- Język w obrębie sklepu: decyduje język przeglądarki; kraj rozstrzyga tylko remisy.
- Między sklepami: wygrywa kraj (sklep, który wysyła do odwiedzającego, z jego cenami) lub wygrywa język.
- Waluta: decyduje kraj, tylko dopóki odwiedzający widzi walutę domyślną.
- Uwzględnianie odwiedzających wielojęzycznych, ukrywanie banera przed zalogowanymi klientami, strony bez banera (domyślnie koszyk i realizacja zamówienia), oczekiwanie na baner zgody, godzinowy limit statystyk, zdarzenia Google Tag Manager.

Testowanie przed uruchomieniem
Symulator pokazuje dla danej strony, kraju i języków przeglądarki wynikowy baner, jego link oraz wynik punktowy każdego miejsca docelowego. Udostępnia link podglądu ważny przez godzinę. W trybie testowym otwórz raz link testowy wyświetlany w zakładce Statystyki: baner pojawi się wtedy w tej przeglądarce na 24 godziny z rzeczywistym wykrywaniem, a nic nie zostanie zliczone. Odwiedzający nic nie widzą.

Statystyki
Wyświetlone banery (raz na wizytę i sugestię), zaakceptowane, odrzucone, wskaźniki akceptacji i odmów, dzienna aktywność, rankingi według kraju, miejsca docelowego i rodzaju sugestii, za 7, 30, 90 dni lub rok, z eksportem do CSV. Każdy baner jest liczony tylko raz; roboty i powtórzone żądania są ignorowane. Nie jest przechowywany żaden adres IP, plik cookie ani identyfikator klienta.

Po stronie odwiedzającego
- Brak przekierowań, zarówno dla odwiedzających, jak i dla robotów: Google odradza przekierowywanie na podstawie języka lub adresu IP. Roboty nigdy nie widzą banera, który ma atrybut
data-nosnippet. - Sugerowany link prowadzi do tej samej strony w innym języku lub sklepie i jest identyczny z alternatywną wersją hreflang strony.
- Kod HTML strony jest taki sam dla wszystkich; sugestia pochodzi z osobnego żądania, które nigdy nie jest buforowane. Moduł działa za pamięcią podręczną całych stron.
- Pasek i toast nie przejmują fokusu; klawisz Escape zamyka baner; okno dialogowe utrzymuje fokus wewnątrz i po zamknięciu zwraca go stronie.




Dla programistów
Zdarzenia DOM na document: dfls:shown, dfls:accept, dfls:dismiss (z językiem, sklepem, krajem, rodzajem i walutą). Opcja dataLayer dla Google Tag Manager. Hook PHP actionDflocalesuggestResponse otrzymuje odpowiedź przez referencję; zachowywane są tylko adresy URL Twoich sklepów.
Rozwiązywanie problemów
Baner się nie pojawia
Sprawdź stan (wstrzymany, testowy lub na żywo), czy co najmniej dwa miejsca docelowe są prawidłowe lub czy aktywna jest druga waluta, czy strona nie jest wykluczona i czy ta przeglądarka nie odrzuciła lub nie zaakceptowała już sugestii (wyczyść pamięć lokalną witryny). Symulator wskazuje, dlaczego miejsce docelowe jest pomijane.
Kraj pozostaje „Nieznany”
To normalne w przypadku lokalnego lub prywatnego adresu IP albo przy braku jakiegokolwiek źródła wykrywania. Otwórz zakładkę Geolokalizacja: pokazuje, które źródło jest aktywne i jaki kraj wykryto dla Ciebie.
Pobieranie bazy danych kończy się błędem
Komunikat podaje przyczynę: zablokowane połączenie wychodzące (zezwól na HTTPS do cdn.jsdelivr.net i unpkg.com lub prześlij plik), katalog bez uprawnień do zapisu, brak rozszerzenia cURL lub niezgodny skrót.