Avvia un progetto

Debug del Country Selector

Documentazione WordPress Country SelectorFAQ WordPress Country SelectorVisto 610 volte

A volte il paese dei tuoi utenti non corrisponde a quello rilevato. In questo caso usa questa guida per capire perché il nostro plugin WP Country Selector ha rilevato il paese sbagliato.

Guida passo passo

    1. Apri Chrome DevTools
      Windows / Linux: F12 o Ctrl + Maiusc + I
      macOS: ⌥ Option + ⌘ Cmd + I

    2. Apri la pagina in modalità debug
      Apri il tuo dominio con il parametro aggiuntivo ?country=debug nella barra degli indirizzi e premi Invio:

      https://yourdomain.com?country=debug

    3. Visualizzare l’output JSON

      • Passa alla scheda Console.

      • Ricarica la pagina (F5 o Ctrl / ⌘ + R).

      • Il plugin stampa un oggetto JSON formattato: i dati di debug.

  1. Metodo alternativo
    In DevTools > Network seleziona la richiesta della pagina, poi apri la sottoscheda Preview o Response per vedere lo stesso JSON.

Guida passo passo

2 Glossario dei campi (cosa indica ogni chiave)

Chiave Significato
users_url L’URL su cui si trova il visitatore.
users_country Codice paese ISO a due lettere rilevato per il visitatore.
users_language Lingua del browser del visitatore (ad es. de).
target_URL URL di destinazione verso cui il plugin reindirizzerebbe.
force_redirect 1 = reindirizzamento immediato, 0 = prima mostra la finestra.
force_redirect_seconds Ritardo (secondi) prima del reindirizzamento, se force_redirect = 1.
force_redirect_exclude_logged_in 1 = gli utenti connessi non vengono mai reindirizzati.
logged_in Indica se il visitatore attuale ha effettuato l’accesso.
modal_header Testo mostrato come titolo della finestra.
modal_text HTML del corpo della finestra (messaggio localizzato).
modal_buttons HTML completo dei pulsanti “Vai al paese” e “Resta qui”.
modal_countries Elenco personalizzato facoltativo dei paesi nella finestra (vuoto = elenco predefinito).
show_popup 1 = mostra la finestra, 0 = nascondi la finestra.
is_default true se questa configurazione di mercato è l’alternativa globale.

3 Risoluzione dei problemi

Sintomo Causa probabile Soluzione
Non compare alcun JSON URL errato o parametro in cache Svuota la cache del browser o usa una finestra in incognito; verifica che ?country=debug sia proprio alla fine dell’URL.
Il reindirizzamento parte prima che tu riesca ad aprire DevTools force_redirect = 1 senza ritardo Imposta temporaneamente force_redirect su 0 nelle impostazioni del plugin, oppure premi subito Esc per fermare la pagina, poi apri DevTools e ricarica.
Output troncato o ridotto Chrome comprime gli oggetti lunghi Clicca sul piccolo triangolo ▶ accanto all’oggetto per espanderlo.
Un plugin di sicurezza / ottimizzazione rimuove la query string Cache lato server o firewall Aggiungi country=debug all’elenco delle eccezioni della cache, oppure disattiva brevemente i plugin di ottimizzazione durante il test.

Suggerimento: una volta ottenuto il JSON grezzo, puoi copiarlo dalla console e incollarlo in un formattatore JSON (ad es. jsonlint.com) per leggerlo meglio o condividerlo con il tuo team di supporto.