Rilevare la lingua e il paese del visitatore (senza reindirizzamento)
Installare, configurare e testare il suggerimento di lingua, valuta e negozio, senza reindirizzamento.
Panoramica
Il modulo rileva il paese del visitatore e le lingue del browser, quindi propone, in un banner non bloccante, la stessa pagina nella lingua, nella valuta o nel negozio giusti. Non reindirizza mai: il visitatore mantiene il controllo, i crawler ricevono la pagina richiesta e i tuoi tag hreflang restano invariati.
Compatibile con PrestaShop da 1.7.8 a 9.x, negozio singolo, multinegozio e multidominio. Non viene caricato nulla sul negozio quando ha una sola lingua e una sola valuta.

Novità della versione 2.0
- Assistente di configurazione in cinque passaggi, con i paesi precompilati per ogni lingua.
- Modalità test: il banner compare solo nel tuo browser, aperto con un link firmato valido 24 ore.
- Suggerimento di valuta: a un visitatore che vede ancora la valuta predefinita viene proposta quella del suo paese, se vendi in quella valuta.
- Header CDN attendibili: un header viene usato solo dopo che lo hai scelto, eventualmente limitato agli indirizzi del tuo CDN.
- Database integrato con versione fissa e verificato (impronta SHA-256), fonti di rilevamento riordinabili, caricamento di file .mmdb.
- Nuovi stili (barra in alto o in basso, toast, finestra di dialogo accessibile), controllo del contrasto, bandiere riservate ai paesi.
- Statistiche protette contro la ripetizione delle richieste (token monouso, limite orario) e rifiuti conteggiati per paese.
Installazione e aggiornamento
- In Moduli > Gestione moduli, fai clic su Carica un modulo e invia il file ZIP.
- Il modulo crea una destinazione per ogni coppia negozio e lingua attiva, poi si apre sull’Assistente di configurazione.
- Dopo una nuova installazione il modulo è in modalità test: i tuoi visitatori non vedono nulla finché non lo metti online.
L’aggiornamento dalla 1.0, 1.1 o 1.2 conserva destinazioni, testi, colori e statistiche. Due modifiche intenzionali: nessun header CDN viene usato finché non lo confermi in Geolocalizzazione (un avviso ti segnala quando ne viene ricevuto uno) e il suggerimento di valuta resta disattivato finché non lo attivi.
In multinegozio, installa il modulo nel contesto «Tutti i negozi» e verifica che sia attivo su ogni negozio di destinazione: memorizza la scelta del visitatore al suo arrivo.
Assistente di configurazione
L’assistente raccoglie in cinque passaggi ciò che va impostato all’inizio. Puoi saltarlo e riaprirlo in qualsiasi momento dalla sua scheda.
- Rilevamento: numero di negozi, lingue e valute, header del paese ricevuto dal negozio, modulo del server web, file MaxMind e database integrato.
- Lingue e paesi: per ogni destinazione sono precompilati i paesi in cui si parla la lingua (GB, US, IE, CA, AU… per l’inglese). Modificali prima di salvare.
- Valute: attivazione del suggerimento ed elenco dei paesi a cui verrà proposta un’altra valuta.
- Aspetto: stile, colori e bandiere, con anteprima in tempo reale.
- Attivazione: testare prima, mettere online o lasciare in pausa.




Geolocalizzazione
La lingua del browser è sempre nota. Il paese serve a suggerire un negozio o una valuta. Sono disponibili quattro fonti; vince la prima che conosce il paese e ne imposti l’ordine con le frecce:
- Header CDN (Cloudflare, CloudFront, Vercel, App Engine, Fastly o X-Country-Code);
- Modulo del server web (mod_geoip, mod_maxminddb, geoip2 di nginx);
- File MaxMind GeoLite2 o GeoIP2, nella posizione prevista da PrestaShop o nel percorso che indichi;
- Database integrato, installato dal modulo.
L’indirizzo IP viene usato solo per la ricerca, in memoria: non viene mai salvato né inviato a terzi.
Un header come X-Country-Code può essere inviato da chiunque. Sceglilo solo se tutte le richieste passano da quel CDN e, preferibilmente, inserisci gli indirizzi del CDN in Accettalo solo da questi indirizzi. Vengono confrontati con l’indirizzo che si connette al server web, mai con X-Forwarded-For.
Database integrato
Il pulsante Installa il database scarica una versione fissa del database geo-whois-asn-country del progetto ip-location-db (circa 7,5 MB, IPv4 e IPv6) da jsDelivr, o da unpkg in alternativa. Prima di sostituire il file, il modulo ne verifica la dimensione esatta e l’impronta SHA-256; un file non corrispondente viene scartato e il database attuale viene mantenuto. Il file è salvato in var/dflocalesuggest/, protetto dall’accesso web. La copia precedente può essere ripristinata.
Questi dati sono pubblicati con licenza CC BY 4.0 (dati dei registri internet NRO): l’attribuzione è richiesta se ripubblichi i dati. Poiché la distribuzione npm del progetto non viene più aggiornata, viene indicata la data dei dati: per la massima precisione, preferisci l’header del tuo CDN o un file MaxMind aggiornato.
Fonte personalizzata e caricamento di file
In Il tuo database puoi inserire l’indirizzo HTTPS di un file .mmdb con la sua impronta SHA-256 (o l’indirizzo del file .sha256 pubblicato dalla fonte); un file non verificato non viene mai installato. L’aggiornamento pianificato viene eseguito dal cron del tuo server con l’indirizzo segreto indicato, mai da un visitatore. Senza connessioni in uscita, carica direttamente un file .mmdb.

Corrispondenze
Ogni riga è una coppia negozio e lingua che il banner può suggerire: etichetta mostrata, paesi (codici ISO, vuoto = tutti), lingue del browser (de, de-at, en-gb…) e ordine di precedenza in caso di parità, tramite trascinamento. Suggerisci i paesi compila le destinazioni senza paesi, Aggiungi le coppie mancanti crea le righe dei nuovi negozi o delle nuove lingue.
La tabella Valute elenca i paesi la cui valuta è attiva nei tuoi negozi. Per ciascuno: automatica (la valuta impostata sul paese in PrestaShop, altrimenti la valuta in uso in quel paese), una valuta specifica o nessun suggerimento.

Aspetto
Su computer: barra in basso, barra in alto, toast a sinistra o a destra, oppure finestra di dialogo. Su mobile: scheda flottante, barre o finestra di dialogo. Tutti gli stili si sovrappongono alla pagina: nulla si sposta quando compaiono. La finestra di dialogo richiede una risposta prima di proseguire; riservala ai negozi in cui trovarsi in quello sbagliato costa caro.
- Colori: cinque temi e quattro colori liberi. Il contrasto viene calcolato in tempo reale e segnalato sotto 4,5:1.
- Bandiere: «Solo paesi» (predefinito) mostra una bandiera per un negozio o una valuta, mai per una lingua.
- Promemoria compatto, ritardo di visualizzazione e durata di memorizzazione di «Resta qui» (30 giorni per impostazione predefinita, nell’archiviazione locale del browser, senza cookie).

Testi
Il banner è scritto nella lingua suggerita: un visitatore tedesco lo legge in tedesco sul tuo negozio francese. Un suggerimento di sola valuta è scritto nella lingua della pagina. Ogni lingua ha i propri messaggi di lingua, negozio e valuta, con le variabili {language}, {country}, {store}, {currency} e {currency_name}. Un campo vuoto usa il testo integrato.

Regole
- Lingua all’interno di un negozio: decide la lingua del browser; il paese serve solo in caso di parità.
- Tra negozi: vince il paese (il negozio che spedisce al visitatore, con i suoi prezzi) oppure vince la lingua.
- Valuta: decide il paese, solo finché il visitatore vede ancora la valuta predefinita.
- Rispetto dei visitatori multilingue, banner nascosto ai clienti connessi, pagine senza banner (carrello e checkout per impostazione predefinita), attesa del banner di consenso, limite orario delle statistiche, eventi Google Tag Manager.

Test prima della messa online
Il Simulatore mostra, per una pagina, un paese e delle lingue del browser, il banner risultante, il suo link e il punteggio di ogni destinazione. Fornisce un link di anteprima valido un’ora. In modalità test, apri una volta il link di test indicato in Statistiche: il banner compare quindi in quel browser per 24 ore con il rilevamento reale, senza conteggiare nulla. I visitatori non vedono nulla.

Statistiche
Banner mostrati (una volta per visita e per suggerimento), accettati, rifiutati, tassi di accettazione e di rifiuto, attività giornaliera, classifiche per paese, per destinazione e per tipo di suggerimento, su 7, 30, 90 giorni o un anno, con esportazione CSV. Ogni banner viene conteggiato una sola volta; crawler e richieste ripetute vengono ignorati. Non viene memorizzato alcun indirizzo IP, cookie o identificativo cliente.

Lato visitatore
- Nessun reindirizzamento, né per i visitatori né per i crawler: Google sconsiglia di reindirizzare in base alla lingua o all’indirizzo IP. I crawler non vedono mai il banner, che porta l’attributo
data-nosnippet. - Il link suggerito è la stessa pagina nell’altra lingua o nell’altro negozio, identica all’alternativa hreflang della pagina.
- L’HTML della pagina è lo stesso per tutti; il suggerimento arriva da una richiesta separata che non viene mai messa in cache. Il modulo funziona dietro una cache a pagina intera.
- Barra e toast non prendono il focus; Esc chiude il banner; la finestra di dialogo mantiene il focus al suo interno e lo restituisce alla pagina alla chiusura.




Per gli sviluppatori
Eventi DOM su document: dfls:shown, dfls:accept, dfls:dismiss (con lingua, negozio, paese, tipo e valuta). Opzione dataLayer per Google Tag Manager. L’hook PHP actionDflocalesuggestResponse riceve la risposta per riferimento; vengono mantenuti solo gli URL dei tuoi negozi.
Risoluzione dei problemi
Il banner non compare
Controlla lo stato (in pausa, test o online), che almeno due destinazioni siano valide o che sia attiva una seconda valuta, che la pagina non sia esclusa e che questo browser non abbia già rifiutato o accettato un suggerimento (svuota l’archiviazione locale del sito). Il simulatore indica perché una destinazione viene scartata.
Il paese resta «Sconosciuto»
È normale da un IP locale o privato, o senza alcuna fonte di rilevamento. Apri la scheda Geolocalizzazione: mostra quale fonte è attiva e il paese rilevato per te.
Il download del database non riesce
Il messaggio indica la causa: connessione in uscita bloccata (consenti HTTPS verso cdn.jsdelivr.net e unpkg.com, oppure carica il file), cartella non scrivibile, estensione cURL mancante o impronta non corrispondente.