PS PrestaShop Principiante

Rilevare la lingua e il paese del visitatore (senza reindirizzamento)

Installare, configurare e testare il suggerimento di lingua, valuta e negozio, senza reindirizzamento.

Aggiornato Versione del modulo 2.0.0

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.

Barra in basso: a un visitatore italiano sul negozio francese viene proposta la stessa pagina in italiano, senza reindirizzamento
Barra in basso

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

  1. In Moduli > Gestione moduli, fai clic su Carica un modulo e invia il file ZIP.
  2. Il modulo crea una destinazione per ogni coppia negozio e lingua attiva, poi si apre sull’Assistente di configurazione.
  3. 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.

  1. Rilevamento: numero di negozi, lingue e valute, header del paese ricevuto dal negozio, modulo del server web, file MaxMind e database integrato.
  2. 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.
  3. Valute: attivazione del suggerimento ed elenco dei paesi a cui verrà proposta un’altra valuta.
  4. Aspetto: stile, colori e bandiere, con anteprima in tempo reale.
  5. Attivazione: testare prima, mettere online o lasciare in pausa.
Assistente di configurazione, passo 1: negozi, lingue e valute attivi, fonti di rilevamento del paese e installazione della base verificata
Assistente di configurazione, passo 1
Assistente, passo 2: paesi precompilati per ogni lingua (IT, SM, VA, CH per l'italiano), modificabili prima di salvare
Assistente, passo 2
Assistente, passo 4: stile (barra, toast, finestra di dialogo), colori, bandiere solo per i paesi e anteprima dal vivo
Assistente, passo 4
Assistente, passo 5: impegni (nessun reindirizzamento, cache e hreflang preservati) e scelta tra prima prova, attivazione o pausa
Assistente, passo 5

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.

Geolocalizzazione: fonti in ordine, header CDN di fiducia limitato agli indirizzi del CDN, base integrata fissata con impronta SHA-256
Geolocalizzazione

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.

Corrispondenze: coppie negozio e lingua con paesi e lingue del browser, e valuta suggerita per ogni paese
Corrispondenze

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).
Aspetto: barra, toast o finestra di dialogo su computer e mobile, temi di colore, controllo del contrasto e anteprima dal vivo
Aspetto

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.

Testi del banner per lingua: messaggi di lingua, negozio e valuta, variabili {language}, {country}, {store} e {currency}
Testi del banner per lingua

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.
Regole: priorità lingua del browser e paese, nessun reindirizzamento per i crawler, cache preservata, attesa del banner di consenso
Regole

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.

Simulatore: visitatore dall’Italia con browser in italiano sulla pagina francese, banner ottenuto e punteggio di ogni destinazione
Simulatore

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.

Statistiche su 30 giorni (dati dimostrativi): banner mostrati, accettati, rifiutati, per paese, per destinazione e per tipo di suggerimento
Statistiche su 30 giorni (dati dimostrativi)

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.
Suggerimento di valuta: a un visitatore dagli Stati Uniti che legge l’italiano vengono proposti i prezzi in dollari (USD)
Suggerimento di valuta
Finestra di dialogo accessibile: focus sul pulsante principale, navigazione da tastiera interna, Esc o clic fuori per restare
Finestra di dialogo accessibile
Su smartphone: scheda flottante in basso, pulsanti a tutta larghezza di almeno 44 px, nessuno scorrimento orizzontale
Su smartphone
Multinegozio e multidominio: a un visitatore dal Regno Unito sul negozio francese viene proposto lo UK Store, sul suo dominio
Multinegozio e multidominio

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.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza