Documentazione
Come faccio ad abilitare il plugin?
Installa il file zip sul tuo sito WordPress. Gravity Forms deve essere già attivo.
Passaggio 1: Installazione
Accedi a WordPress e vai su Plugin → Aggiungi plugin → Carica plugin. Installa il file zip e attivalo.
Fase 2: Impostazioni
Vai a Geofence → Impostazioni, O Moduli → Impostazioni → Geofence. Stessa schermata.
Le chiavi sono facoltative. Saltate questo passaggio se utilizzate solo i codici postali.
- Chiave API di Google – necessario per disegnare aree sulla mappa. Attiva l'API JavaScript di Maps e limita la chiave al tuo sito. Le aree dei codici postali non necessitano di una chiave. Se già utilizzi Completamento automatico indirizzi per Gravity Forms, possiamo usare quel tasto finché non ne inserisci uno qui.
- Cerca le coordinate e un Chiave API di geocodifica – solo se desideri che venga visualizzata un'area sulla mappa a partire da un indirizzo digitato. Questa deve essere una chiave diversa da quella sopra, con l'API di geocodifica attiva e senza restrizioni sul referrer HTTP. In alternativa, limita la ricerca tramite IP. Le aree con codice postale non utilizzano mai questa opzione.
Passaggio 3: Crea le tue aree
Vai a Geofence → Geofence, O Moduli → Geofence. Aggiungine uno, dagli un titolo, scegli i codici postali o una forma della mappa e impostalo Ordine. Posiziona le aree più piccole sopra quelle più grandi.
Passo 4: Attivalo per il modulo
Apri il modulo, quindi Impostazioni → Geofence.
- Accendere Abilita la geolocalizzazione.
- Seleziona le aree di tuo interesse.
- Scegli il Campo indirizzo (un campo Indirizzo o un campo Testo su riga singola).
- Scegliere Bloccare l'invio o Avvisa, ma consenti l'invio.
- Cambiare il Messaggio fuori area se lo desideri. L'impostazione predefinita è "Siamo spiacenti, al momento non forniamo assistenza per questo indirizzo".“
- Opzionale: impostare Negozio Zona corrispondente in in un campo di testo nascosto o a riga singola. Questo è il campo che verrà letto dalle notifiche e dalla logica condizionale.
Salva le modifiche.
Passo 5: Prezzi (solo se vendi prodotti tramite il modulo)
Nello stesso modulo, apri Impostazioni → Prezzi geofencing. Salva prima la scheda Geofence in modo che le tue aree vengano visualizzate qui. Per ogni prodotto con un prezzo fisso, scegli se viene venduto in tutte le aree del modulo o solo in alcune e digita un prezzo diverso dove non è il prezzo base. Sotto Quando l'indirizzo non corrisponde a nessuna geofence, scegli Blocca l'ordine (l'impostazione predefinita) o Prezzi base di addebito.
Passo 6: Notifiche
Apri Impostazioni → Notifiche. Aggiungi una notifica per area e imposta la logica condizionale sul campo zona. Se il campo è Little Rock, invia a littlerock@…
Ecco fatto. Ripetete il passaggio 4 su qualsiasi altro modulo che lo richieda.
Dettagli tecnici
aree del codice postale
Incolla i codici postali o ZIP, uno per riga o separati da virgole. Le righe vuote vengono ignorate. Una riga che inizia con # è un appunto per te stesso.
- Esatto –
90210corrisponde a quel codice. - Inizia con –
606*corrisponde a qualsiasi codice che inizia con606. - Allineare –
10001-10005corrisponde a ogni numero in quell'intervallo, inclusi gli estremi. Entrambi gli estremi devono avere lo stesso numero di cifre.
Le lettere maiuscole non contano. Gli spazi e i trattini vengono ignorati nei modelli esatti e “iniziano con”, quindi 90210-1234 partite 90210, e SW1A 1AA partite SW1A1AA. Gli intervalli vengono letti prima di tale operazione di pulizia, quindi un intervallo con trattino non viene mai trattato come un codice postale con trattino.
Le aree postali vengono verificate confrontandole con l'indirizzo fornito. Non viene mai effettuata alcuna chiamata a un'API di mappatura.
Aree disegnate su una mappa
Quando modifichi la geofence, disegna l'area su una mappa di Google. Queste aree corrispondono a un punto sulla mappa, non solo al codice postale.
Quel punto deriva da Completamento automatico indirizzi per Gravity Forms se si trova nello stesso campo indirizzo o da una ricerca se hai attivato Cerca le coordinate e abbiamo aggiunto una chiave API di geocodifica. Non è necessario utilizzare il completamento automatico degli indirizzi.
Ordine: vince chi si presenta per primo
Se un modulo ha più di un'area, le testiamo nell'ordine mostrato in Impostazioni modulo → Geofence. La prima che corrisponde è la zona. Metti prima l'area più piccola in modo che un'area generica più ampia non la inglobi. Lo stesso ordine viene utilizzato per selezionare i prezzi quando due aree si sovrappongono.
Impostazioni su ciascun modulo
Ogni modulo ha la sua scheda Geofence. Nulla funziona finché non lo attivi. Abilita la geolocalizzazione per quel modulo.
Si selezionano le aree, il campo indirizzo, se bloccare o avvisare, il messaggio di fuori area (testo semplice, visualizzato accanto all'indirizzo) e un campo facoltativo per memorizzare il nome dell'area.
Salva il nome dell'area, quindi instrada l'e-mail
Negozio Zona corrispondente in Scrive il titolo dell'area in un campo di testo nascosto o a riga singola. Il campo nascosto è la scelta più comune. I campi numerici non sono disponibili, perché il valore è un nome e non un numero.
Se si trovano in una zona, il campo detiene quel titolo (ad esempio Little RockSe si trovano al di fuori di ogni area selezionata, il campo è vuoto. Applica una logica condizionale a quel campo per mostrare o nascondere parti del modulo e crea una notifica per ogni area.
Gravity Forms legge quel campo come qualsiasi altro, quindi il suo tag di unione funziona anche in una notifica, insieme al {pb_geo:*} tag sotto.
Il controllo in tempo reale e l'invio del controllo
Il controllo durante la digitazione è per loro. Aggiorna il campo dell'area, l'avviso e i prezzi.
Quando inviano il modulo, verifichiamo nuovamente l'indirizzo confrontandolo con i dati salvati. Non ci fidiamo di ciò che il browser ha inviato. A questo secondo controllo seguono il blocco e l'avviso.
Le aree postali vengono sempre controllate dall'indirizzo inviato. Le aree disegnate sulla mappa vengono controllate allo stesso modo quando Cerca le coordinate è attivo. Se il punto sulla mappa proviene solo dal browser (Completamento automatico indirizzo, con la ricerca disattivata), qualcuno potrebbe modificarlo. Aggiungi anche un'area postale o attiva la ricerca se hai bisogno di un punto di arresto fisso.
Quando non riusciamo a inserire l'indirizzo
Se le aree richiedono informazioni che l'indirizzo non possiede (solo aree disegnate sulla mappa, senza indicazione della posizione sulla mappa stessa) o se la ricerca fallisce, consentiamo comunque l'invio. Tale voce viene registrata come non selezionata, non come esterna.
I moduli che vendono prodotti sono l'eccezione. Lì, Quando l'indirizzo non corrisponde a nessuna geofence decide, ed è impostato su blocco per impostazione predefinita, quindi un indirizzo che non siamo riusciti a inserire non può effettuare un ordine finché non modifichi tale impostazione.
Il valore "interno" è No sia quando si trovano al di fuori di ogni area, sia quando non è stato possibile verificare. Il motivo è ciò che distingue questi casi. Se non abbiamo mai verificato la voce, il campo "interno" viene lasciato vuoto, in modo che non sembri un No categorico.
Prezzi diversi a seconda della zona.
Impostazioni modulo → La determinazione dei prezzi tramite geofencing funziona sui campi prodotto di Gravity Forms che hanno un prezzo fisso (prodotto singolo e prodotto nascosto). Non modifica i prodotti a tendina, i prezzi calcolati o i campi in cui il cliente digita il prezzo.
Il prezzo indicato nel campo del prodotto è il prezzo base. Per ciascuno dei prodotti che scegli:
- Venduto in ogni area geografica definita in questo modulo, O
- Venduto esclusivamente in determinate aree geografiche.
Quindi aggiungi un Sovrascrittura del prezzo nelle aree che applicano un prezzo diverso. Le aree senza override mantengono il prezzo base. Un prodotto non offerto in quell'area viene escluso dal totale e rifiutato se si tenta di inviarlo. Per nasconderlo anche dal modulo, è possibile applicare una logica condizionale al campo dell'area salvata.
Quando l'indirizzo non corrisponde a nessuna geofence (fuori da ogni area, altrimenti non potremmo collocarlo) puoi Blocca l'ordine o Prezzi base di addebito. L'opzione "Blocca" è quella predefinita e si applica indipendentemente dal fatto che tu abbia scelto "Blocca" o "Avvisa" nella scheda Geofence.
I prezzi e il totale del modulo si aggiornano automaticamente al variare dell'indirizzo. Il prezzo effettivamente addebitato viene salvato nella voce dell'ordine, quindi anche dopo una modifica del prezzo, un ordine precedente mostrerà ancora l'importo pagato. Prova un indirizzo Nella stessa schermata viene verificato se l'indirizzo digitato corrisponde alle impostazioni salvate più di recente.
Voci, tag e chi può vedere cosa
Geofence → Voci Questo elenco mostra gli ordini provenienti dalle aree assegnate a quella persona, per ogni modulo che utilizza una geofence. È possibile filtrare per area e per tag. Aprendo una voce, si possono visualizzare la posizione dell'ordine, gli articoli ordinati ai relativi prezzi e il testo inserito.
Imposta l'elenco dei tag una sola volta in Geofence → Impostazioni → Etichette di ingresso (uno per riga). Gli utenti applicano questi tag nella schermata di inserimento, quindi le stesse parole funzionano in ogni area.
Nella schermata Utenti compaiono due ruoli:
- Gestore di geofencing – definisce le aree loro assegnate e i prezzi (inclusi Geofence → Prezzi, (che non richiede l'accesso a Gravity Forms).
- Visualizzatore di ingressi geofence – legge, etichetta e annota le voci provenienti dalle aree a loro assegnate.
Assegnare le persone nel Utenti assegnati casella quando modifichi un'area. Le chiavi di Google rimangono all'amministratore del sito.
Un esempio pratico
Cinque zone postali. In tutte e cinque vengono offerti due servizi, ciascuno al proprio prezzo. Un terzo servizio viene offerto solo in tre di esse, sempre al proprio prezzo. Il cliente sceglie la combinazione di servizi offerta dalla zona corrispondente e l'ordine non può essere effettuato da un indirizzo non coperto dal servizio scelto.
Il nome dell'area viene salvato nel modulo. Viene inviata una notifica quando il campo corrisponde a North Little Rock. Viene inviata un'altra notifica quando corrisponde a Lake County.
Unisci tag
Questi campi recuperano i valori salvati nell'inserimento. Utilizzali nelle notifiche, nelle conferme e in qualsiasi altro campo con tag di unione di Gravity Forms.
{pb_geo:fence_title} – il nome dell'area (lo stesso testo scritto in Store Matched Zone In). Vuoto quando non è stata trovata alcuna area corrispondente.
{pb_geo:fence_id} – l'ID dell'area. Vuoto quando non viene trovata alcuna area corrispondente.
{pb_geo:inside} – Sì o No. Vuoto se non abbiamo mai controllato la voce, quindi non suona come un “esterno” sicuro.”
{pb_geo:reason} – perché abbiamo deciso che:
- All'interno di una geofence
- Al di fuori di ogni geofence
- Impossibile verificare: l'indirizzo non aveva codice postale o coordinate corrispondenti.
- Impossibile verificare: non sono state selezionate geofence utilizzabili per questo modulo.
- Rifiutato: l'indirizzo inviato non era in un formato leggibile da questo plugin.
Domande frequenti
Ho bisogno di una chiave API di Google?
Serve solo per disegnare aree sulla mappa o per cercare un indirizzo digitato. Le aree con codice postale non richiedono alcun tasto e non chiamano Google. Il tasto Maps è per l'editor. Il tasto Geocodifica viene utilizzato solo quando è attiva l'opzione Cerca coordinate.
Quali formati di codice postale sono supportati?
Codici esatti, prefissi come 606*, e intervalli numerici come 10001-10005. Un solo schema per riga, oppure virgole. Vedi le aree dei codici postali nella sezione Dettagli delle caratteristiche.
Cosa succede se più di un'area corrisponde?
Utilizziamo il primo in ordine. Si applicano i prezzi di quella zona.
Posso avvisare le persone senza bloccarle?
Sì. Scegli Avvisa, ma consenti l'invio. Il tuo messaggio viene ancora visualizzato accanto all'indirizzo e il nome dell'area viene ancora compilato quando corrispondono, quindi gli indirizzi email e i campi nascosti funzionano ancora. Un'eccezione: in un modulo che vende prodotti, Quando l'indirizzo non corrisponde a nessuna geofence è impostato su blocco per impostazione predefinita, ed è questa impostazione che decide se un indirizzo non corrispondente può essere ordinato.
Come faccio a inviare email diverse a seconda dell'area geografica?
Salva il nome dell'area in un campo nascosto o di testo, quindi aggiungi una notifica per ciascuna area con una logica condizionale su tale campo.
Il controllo durante la digitazione è sufficiente per bloccare una persona?
No. Quel controllo è per la persona che compila il modulo. Decidiamo se bloccare la richiesta al momento dell'invio.
E se non si riesce a individuare l'indirizzo?
Su un modulo senza prodotti, lo lasciamo passare e contrassegniamo la voce come non selezionata anziché esterna. Su un modulo che vende prodotti, il Quando l'indirizzo non corrisponde a nessuna geofence Le impostazioni lo decidono e, di default, bloccano l'accesso. In ogni caso, il motivo indicato nella voce spiega cosa è successo.
Funziona anche con moduli multipagina?
Sì. Controlliamo solo la pagina che stanno inviando, quindi il risultato successivo nella prima pagina non verrà rifiutato a causa di un indirizzo o di un prodotto presente in una pagina successiva.
Quali prodotti possono avere un prezzo diverso a seconda della zona?
Campi prodotto con prezzo fisso (prodotto singolo e prodotto nascosto). Non sono inclusi i prodotti a tendina, i prezzi calcolati o i campi "proponi il tuo prezzo".
Ho bisogno della funzione di completamento automatico degli indirizzi per Gravity Forms?
No. Se entrambi i plugin si trovano sullo stesso campo indirizzo, riutilizziamo la posizione che hanno già selezionato, quindi un'area disegnata sulla mappa non necessita di una seconda ricerca. Le aree postali non ne hanno mai bisogno. Le aree disegnate sulla mappa possono invece utilizzare la funzione "Ricerca coordinate".
Posso utilizzarlo su più di un modulo?
Sì. Le aree sono riutilizzabili. Ogni modulo ha il proprio interruttore di attivazione/disattivazione, elenco delle aree, campo indirizzo, opzione blocca o avvisa, messaggio, campo area salvata e prezzi.
L'avviso è scomparso nella pagina memorizzata nella cache. Il modulo è ancora selezionato?
Sì. L'avviso in tempo reale può disattivarsi se una pagina rimane nella cache per più di un giorno. Continuiamo comunque a verificare l'indirizzo quando viene inviato e a bloccare la pagina se hai impostato il blocco. Se la cache conserva le pagine per più di un giorno, escludi dalla cache le pagine dei moduli geolocalizzati oppure riduci il tempo di permanenza nella cache.