Salta al contenuto principale

WP Location Finder: Configurazione API mappa

1. Come creare una API per le mappe?

1.1 Ottieni la chiave API di Google Maps e i servizi API

Ogni volta che utilizzi le API di Google Maps, se il tuo dominio è stato creato dopo il 22 giugno 2016, devi includere una chiave per convalidare la tua richiesta.
Ottieni una chiave e abilita le API: https://developers.google.com/maps/documentation/javascript/get-api-key

Ulteriori informazioni: https://developers.google.com/maps/documentation/javascript/usage?hl=it

Innanzitutto, accedi alla console di Google Cloud , seleziona un progetto o creane uno nuovo. Quindi fai clic sul pulsante "+ Crea credenziali" e seleziona l'opzione  "Chiave API" .

 

crea-chiave-api

 

Quindi segui il passaggio successivo e clicca sul Crea per ottenere una nuova chiave API. Salvala per il passaggio successivo.

 

chiave-api-creata

 

Inoltre, è necessario abilitare alcuni servizi API obbligatori. Nella Google Console, vai su API e servizi e li troverai come mostrato di seguito:

  • API JavaScript delle mappe
  • API di geocodifica
  • API di geolocalizzazione
  • API dei luoghi
  • API delle indicazioni

 

abilitare-servizi-api

 

1.2 Come creare un ID Google Map?

Per creare un ID mappa, accedi alla pagina Gestione mappe . Fai clic sul pulsante Crea ID mappa

 

crea-nuovo-id-mappa

 

Quindi, nella pagina Crea nuovo ID mappa, procedi come segue:

  • Nome: inserisci il nome dell'ID della mappa.
  • Descrizione: descrivi a cosa serve l'ID mappa (facoltativo)
  • Tipo di mappa: seleziona JavaScript e scegli anche un tipo di mappa Raster (predefinito) o Vettoriale.

 

nuovi campi ID mappa

 

Ricordati di cliccare sul Salva per visualizzare il tuo nuovo ID mappa. Conservalo per le impostazioni.

 

map-id-created

 

Nota: un ID mappa è un identificatore univoco che rappresenta le impostazioni di stile e configurazione di Google Maps archiviate in Google Cloud. Utilizza l'ID mappa "DEMO_MAP_ID" a scopo di test se non disponi di un ID mappa.

 

1.3 Come creare un token OpenStreetMap?

Inizia visitando questa pagina per registrare un nuovo account o accedere a quello esistente. Questo passaggio è essenziale prima di poter generare token di accesso.

Una volta effettuato l'accesso, cerca l' "Token di accesso" nelle impostazioni utente o nel menu dell'account e selezionala. All'interno della sezione Token di accesso, individua e seleziona l' "Crea token di accesso" per avviare il processo di generazione del token. Tutti i campi per la creazione del token saranno visibili direttamente nella pagina Token di accesso. Per creare il tuo token:

  • Inserisci un nome descrittivo nel "Etichetta" per aiutarti a identificare questo token in seguito.
  • Lascia vuoti i due campi aggiuntivi sottostanti (le impostazioni predefinite sono sufficienti per la maggior parte degli utenti)
  • Fai clic sul "Crea" per generare il tuo nuovo token di accesso

 

token di accesso

 

Il tuo nuovo token di accesso verrà visualizzato una volta creato. Assicurati di copiare questo token e di conservarlo in modo sicuro, poiché ti servirà nei passaggi di configurazione successivi.

 

generato da token

 

2. Sezione impostazioni principali

Fornitore di mappe

Accedi al menu Ricerca posizione > Impostazioni > Impostazioni principali per configurare le preferenze del fornitore di mappe. Troverai due opzioni disponibili: Google e OpenStreetMap.

Se scegli Google Maps come provider, dovrai configurare i seguenti campi obbligatori con le credenziali ottenute nei passaggi di configurazione precedenti:

  • Chiave API di Google Maps: la chiave API di Google Maps è obbligatoria. Torna al passaggio 1.1 se non sai come creare una nuova chiave API.
  • ID mappa: L'ID mappa è un identificatore univoco che rappresenta le impostazioni di stile e configurazione di Google Maps archiviate in Google Cloud.
    È obbligatorio averne uno; è possibile mantenere quello predefinito (DEMO_MAP_ID) se non necessario.
  • Zoom predefinito della mappa: livello di zoom predefinito sulla mappa al primo caricamento (imposta lo zoom automatico su 0)
  • Tipo di mappa: Roadmap, Satellite, Ibrida, Terreno.
  • Livello mappe: KML, Traffico, Trasporti pubblici, Ciclismo.

 

impostazioni di riempimento

 

Se selezioni OpenStreetMap come provider, dovrai inserire il token di accesso ottenuto al passaggio 1.3:

  • Token di accesso alla geocodifica: il token di accesso LocationIQ è necessario per la funzionalità di completamento automatico degli indirizzi.
  • Zoom predefinito della mappa: livello di zoom predefinito sulla mappa al primo caricamento (imposta lo zoom automatico su 0)
  • Tipo di mappa: Predefinita, OpenStreetMap HOT, Carto Light, Carto Dark,...
  • Livello di tile personalizzato: inserisci il tuo livello personalizzato.

 

Fornitore di OpenStreetMap

 

Dopo aver configurato le impostazioni del tuo fornitore di mappe, scoprirai diverse funzionalità di personalizzazione che funzionano sia con Google Maps sia con OpenStreetMap per migliorare la funzionalità della tua mappa e l'esperienza utente:

  • Ricerca del nome della località
  • Filtro categoria di visualizzazione
  • Visualizza filtro paese
  • Filtro raggio di visualizzazione
  • Unità di distanza: km/mi
  • Distanza per la ricerca del raggio: distanza nello strumento di ricerca del raggio
  • Filtro tag di visualizzazione
  • Apri i dettagli della posizione in una nuova scheda

 

impostazioni dettagliate della mappa

 

Visualizzazione della mappa

Le posizioni che hai creato verranno visualizzate sulla mappa nella Impostazioni .

 

impostazione-visualizzazione-mappa

 

Posizione unica

  • Aggiungi campi del negozio: aggiungi alcuni campi specifici a ciascuna sede, come i nomi dei negozi e gli orari di apertura.

 

Immagine a colori e pennarello

Qui puoi regolare il colore e l'immagine predefinita del marcatore.

 

impostazione del marcatore del colore della posizione

 

3. Impostazioni AI

Per utilizzare questa funzione, vai su Impostazioni plugin > Impostazioni IA > scheda Prezzi per ottenere i crediti. Fai clic sul Ottieni crediti IA ora e completa la procedura di acquisto.

 

ottenere-credito-ai

 

Dopo aver acquistato i crediti, torna alle Impostazioni IA > scheda Impostazioni > sezione Limiti di lunghezza dei contenuti per configurare le seguenti opzioni:

  • Lunghezza del titolo AI: imposta il numero massimo di parole per i titoli generati
  • Lunghezza della descrizione AI: imposta il numero massimo di parole per le descrizioni generate

 

piano di impostazione dell'intelligenza artificiale

 

Nella delle impostazioni globali dell'IA , puoi personalizzare la lingua per i contenuti generati dall'IA. Abilita l' opzione Quota IA nella barra superiore per visualizzare i crediti rimanenti nella barra superiore di WordPress.

 

credito-sulla-barra-superiore

 

Una volta completata la configurazione, è possibile accedere alla funzionalità di ottimizzazione AI dalla vista " Tutte le sedi" o dalla vista di una singola sede. Fare clic sul pulsante " Ottimizzazione AI" nella parte superiore della pagina, quindi selezionare il pulsante " Genera " nella finestra popup per creare o popolare automaticamente i dati SEO.

 

pulsante di ottimizzazione ai

 

4. Posizioni di importazione/esportazione

Posizioni di importazione

Per iniziare a importare le tue posizioni, vai su Menu Ricerca posizioni > Impostazioni > Sezione Importa. Seleziona il tuo CSV o KML dal campo appropriato in base al formato dei tuoi dati.

 

posizioni di importazione

 

Hai bisogno di un modello? Clicca sul Scarica il file CSV di esempio" per ottenere il nostro file di esempio e visualizzare il formato corretto. Puoi anche selezionare l' "Aggiorna le posizioni esistenti se corrispondono, oppure aggiungi nuove posizioni non esistenti" se desideri aggiornare i dati attuali e contemporaneamente aggiungere nuove voci.

Posizioni di esportazione

Quando sei pronto per esportare le tue posizioni esistenti, vai alla Esporta . Da lì, fai clic sul "Esporta in CSV" o "Esporta in KML" a seconda del formato di cui hai bisogno.

 

luoghi di esportazione

 

Sincronizzazione

Per impostare la sincronizzazione automatica dei file CSV, vai su Impostazioni e poi su Importa/Esporta > scheda Sincronizzazione, seleziona il tuo file CSV dalla Libreria multimediale. Abilita l' "Abilita sincronizzazione automatica" e specifica la frequenza di aggiornamento desiderata nel "Intervallo di sincronizzazione (minuti)" .

Il sistema importerà automaticamente i dati agli intervalli da te scelti, aggiornando le posizioni esistenti quando vengono trovate corrispondenze e creando nuove voci per dati aggiuntivi.

 

posizioni di sincronizzazione

 

5. Controllo degli accessi

Per gestire le autorizzazioni di accesso (creazione, modifica, eliminazione, pubblicazione) per ciascun ruolo utente, vai su Impostazioni > Controllo accessi.

 

controllo degli accessi

 

WP Location Finder: Installazione

1. Installare

Per installare il nostro plugin, dovresti usare l'installer standard di WordPress oppure decomprimere e mettere l'intera cartella in /wp-content/plugin.

 

caricamento-plugin

 

Quindi fai clic su Attiva pluginper visualizzare WP Location Finder nel menu a sinistra di WordPress.

WP Location Finder è accessibile tramite un menu dedicato a sinistra. 

D'ora in poi, assicurati di accedere al tuo account JoomUnited prima di utilizzare il plugin.

 

licenza di accesso joomunited

 

2. Aggiorna il plugin

 

Per aggiornare WP Location Finder, puoi utilizzare l'aggiornamento predefinito di WordPress. In alternativa, puoi disinstallare e reinstallare la nuova versione scaricando un file .zip da www.joomunited.com. In ogni caso, non perderai alcun contenuto perché tutto è memorizzato nel database.

 

wp-location-finder-install

 

Assicuratevi di avere sempre la versione più recente per evitare problemi di sicurezza e stabilità.

Per aggiornare la versione a pagamento, è necessario accedere al proprio account JoomUnited. Se non si è ancora effettuato l'accesso, è sufficiente cliccare sul link "Collega il tuo account JoomUnited per aggiornare" o "Accedi a JoomUnited"

 

aggiornamento wp-location-finder

 

Inserisci il tuo nome utente e la password dell'account JoomUnited. Dopo aver effettuato l'accesso, apparirà il link "Aggiorna ora" su cui potrai cliccare per aggiornare a una nuova versione

 

aggiornamento wp-location-finder

 

Infine, puoi aggiornare tutti i plugin commerciali di JoomUnited dallo standard WordPress aggiornato.

 

wp-location-finder-aggiornato

 

WP Location Finder: impostazione della ricerca e delle posizioni

1. Crea una posizione

Per creare una nuova posizione, vai su Ricerca posizioni > Tutte le posizioni. Fai clic sul pulsante " Aggiungi nuova posizione" 

 

aggiungi-nuova-posizione

 

Successivamente, verrà visualizzata la pagina Aggiungi nuova posizione, con due pannelli principali: a sinistra il campo dei dettagli e a destra la mappa. Di seguito sono riportati i campi in cui è possibile inserire o selezionare un valore.

 

  • Nome della posizione: inserisci il nome dell'indirizzo.
  • URL: verrà generato dopo la pubblicazione.
  • Descrizione della posizione: 
  • Ricerca posizione: digita un indirizzo nel campo di ricerca per ottenere un valore per latitudine e longitudine.

 

aggiungi-nuovo-campo-posizione

 

In alternativa, utilizzare la sezione di inserimento manuale degli indirizzi sotto la mappa: fare clic sulla freccia per espandere tutti i campi.

 

indirizzo-inserimento-manuale

 

Scorrere verso il basso per ottenere opzioni più dettagliate sulla posizione.

  • Immagine caratteristica: scegli l'immagine rappresentativa della posizione.
  • Galleria immagini: carica immagini per la posizione.
  • Immagine del marcatore: seleziona nel set di icone o carica la tua icona.

 

posizione-icona-immagine

 

  • URL del contatto della posizione
  • URL di sostituzione della posizione
  • Tag: tag di posizione di input.
  • Titolo SEO della posizione
  • Meta descrizione SEO della posizione

 

dettagli sulla posizione

 

Quindi, puoi selezionare una/più categorie per la posizione.

 

seleziona-categoria-posizione

 

Successivamente, nella sezione Pubblica, puoi impostare questi campi:

  • Stato: scegli uno dei 3 stati: Bozza, In attesa di revisione, Pubblicato
  • Visibilità: Pubblica, Protetta da password, Privata
  • Ora di pubblicazione: Immediatamente, Pubblicazione programmata
  • Shortcode: utilizzalo per pubblicare ovunque sul tuo sito.

 

posizione-pubblica-sezione

 

Campi del negozio

Per utilizzare questa funzione per visualizzare gli orari di apertura ai clienti, è necessario innanzitutto abilitare l'opzione nelle impostazioni. Una volta fatto ciò, sarà possibile visualizzare la Campi negozio durante la creazione di una nuova sede.

 

campo-negozio-con-posizione-singola

 

Posizione di anteprima

Per visualizzare un'anteprima della tua posizione sul front-end, vai semplicemente alla Pubblica e fai clic sul pulsante "Anteprima" .

 

anteprima-posizione

 

2. Generatore di codici abbreviati

Per generare uno shortcode per la mappa, vai su Menu Ricerca posizione > Generatore di shortcode. Puoi impostare alcune opzioni qui sotto in Tipo di visualizzazione:

  • Ricerca posizione: [wplf type_of_view="location_search" default_address="Parigi, Francia" categories="16" tags="27" map_zoom="Auto"]
  • Visualizzazione mappa soltanto: [wplf type_of_view="map_view" default_address="Parigi, Francia" categories="16" tags="27" map_zoom="Auto"]
  • Posizione singola: [wplf id="578" map_zoom="Auto"]
  • Modulo di invio frontend: [wplf_submission]
  • Le mie posizioni (frontend): [wplf_my_locations items_per_page="8"]

 

generatore di codici brevi-ricerca-posizione

 

In base al tipo di visualizzazione selezionato, verrà visualizzata un'anteprima che mostra come apparirà nel frontend. Lo shortcode generato apparirà nell'angolo in basso a sinistra, e potrai copiarlo e inserirlo ovunque nella tua pagina.

 

3. Categorie di posizione

Per gestire le categorie di località, vai su  Menu Ricerca Località > Categorie di località.  Da questa sezione, puoi gestire facilmente le tue categorie di località: aggiungerle, modificarle o rimuoverle a seconda delle necessità!

 

aggiungi-categorie-di-posizione

 

4. Tag di posizione

Per gestire i tag di posizione, vai su  Menu Ricerca posizione > Tag di posizione. Da questa sezione, puoi gestire facilmente i tuoi tag di posizione: aggiungerli, modificarli o rimuoverli a seconda delle necessità!

 

aggiungi-tag-di-posizione

 

An Error Occurred: Whoops, looks like something went wrong.

Sorry, there was a problem we could not recover from.

The server returned a "500 - Whoops, looks like something went wrong."

Help me resolve this