My Maps location : posizioni e categorie

1. Ottieni una chiave API di Google Maps

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 l'API: https://developers.google.com/maps/documentation/javascript/get-api-key

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

Il primo passo è quello di creare un progetto e quindi digitare il nome del progetto.

Se desidero consentire tutte le richieste da miodominio, il modello da seguire è * .joomunited.com / *
Se desideri consentire solo un singolo dominio, ad esempio miodominio.com, il modello sarà joomunited.com/*

In un ambiente localhost, puoi inserire qualsiasi chiave valida e funzionerà senza alcun riferimento al dominio.

La chiave API viene quindi generata, questa è la chiave che devi copiare per aggiungerla a My Maps location .

Aggiungi la chiave a My Maps Location .

Da Componenti > My Maps Location > Visualizzazione opzione , puoi aggiungere una chiave nella configurazione.

Incolla la chiave.

Resume passo dopo passo:

Quindi i passaggi che seguo sono

Vai alla Console API di Google
Crea o seleziona un progetto
Fare clic su Continua per abilitare l'API e tutti i servizi correlati
Nella pagina Credenziali, ottieni una chiave del browser (e imposta le credenziali API)
Per prevenire il furto di quote, proteggi la tua chiave API seguendo queste best practice

2. Gestisci le categorie di località

Le posizioni sono classificate in categorie. Tali categorie possono essere visualizzate come filtro in frontend o utilizzate come parametro predefinito in una voce di menu per caricare alcune posizioni categorizzate.

Se disponi di molte località, ti consigliamo di utilizzare le categorie.
È possibile creare categorie e sottocategorie. Per creare una categoria, vai in My Maps location > Categoria e fai clic su Nuovo

Quindi dalla schermata della categoria dovrai aggiungere un titolo e una categoria principale nel caso in cui desideri creare una sottocategoria

È inoltre possibile definire un indicatore predefinito per la posizione nella categoria utilizzando la scheda Selezione indicatore

Nota: per impostazione predefinita viene creata una categoria denominata "La mia categoria" che consente di iniziare ad aggiungere posizioni direttamente dopo l'installazione

3. Creare una posizione

Per creare una posizione, vai in My Maps location > Posizioni > Nuovo

Ci sono 3 campi obbligatori:

Nome del luogo
Categoria del luogo
Dettagli posizione (indirizzo)

Per l'indirizzo hai 3 soluzioni per aggiungerlo:

Usa il campo di ricerca (consigliato)
Navigare sulla mappa e utilizzare il cursore per indicare una posizione
Inserisci un indirizzo (deve essere valido Google Maps)

Per aggiungere una posizione con il motore di ricerca, digitare il nome del luogo che si desidera aggiungere.

Selezionando, i campi di latitudine e longitudine verranno riempiti automaticamente. Le mie mappe sono integrate anche con Google Places! Significa che puoi cercare un negozio o qualsiasi altra cosa sia registrata su Google Maps, il nostro componente riceverà tutte le informazioni sul luogo.

Puoi anche muoverti sulla mappa e mettere un indicatore direttamente, il risultato sarà lo stesso e otterrai una latitudine e una longitudine riempite automaticamente.

Fai attenzione con il campo dell'indirizzo e il codice postale se lo compili manualmente, deve corrispondere a un indirizzo noto di Google Maps.

Tutte le altre informazioni sulla posizione (descrizione, ore, ...) vengono visualizzate nella vista dettagliata della posizione.

Il collegamento di contatto nell'edizione dei dettagli della posizione è la possibilità di aggiungere un collegamento di contatto, mailto o URL per posizione. Sul frontend sarà presente un pulsante di contatto che aprirà l'URL o eseguirà l'azione mailto.

4. Altre informazioni sulla posizione

Su ogni posizione è possibile aggiungere un'immagine e un marcatore.

Immagine della posizione: l' immagine verrà visualizzata come miniatura nella descrizione comando della posizione e di dimensioni maggiori nella pagina dei dettagli della posizione.
Usa l'icona della categoria: usa l'icona che inserisci nel campo della categoria delle mie posizioni sulla mappa
Marker Background: scegli il colore per il tuo marker di sfondo
L'indicatore verrà visualizzato sulla mappa come icona dell'indicatore di posizione. Hai anche alcuni bei set di indicatori per le tue posizioni inclusi nell'estensione My Maps Location .
Usa un collegamento personalizzato sovrascriverà il collegamento ai dettagli della posizione con un URL personalizzato.

My Maps location utilizza la funzione multilingue nativa di Joomla. È possibile definire una lingua in categorie di località e in località. Al cambio di lingua, le posizioni verranno filtrate come qualsiasi altro contenuto di Joomla per visualizzare il contenuto approvato dalla lingua.

Il campo della descrizione della posizione è uno dei più importanti.
Verrà visualizzato nella pagina dei dettagli della posizione e, a seconda del tema, come testo introduttivo della posizione nei risultati di ricerca. Ancora più importante, la descrizione è un editor WYSIWYG con tutti i plugin caricati all'interno, significa che puoi tutto ciò che vuoi (immagini, video ...).

Ecco il testo introduttivo visualizzato nei risultati della ricerca della posizione.

Il campo tag è lo stesso sistema di tag di Joomla. Puoi aggiungere tag e sotto-tag quindi caricarlo nel frontend come filtro. Per gestire tutti i tag, basta caricare il componente tag Joomla: Menu Componente > Tag
Sul frontend, a seconda della configurazione, i tag possono essere visualizzati come checkbox (come sotto) o come un elenco a discesa.

My Maps Location ha campi aggiuntivi per compilare meta informazioni (per motori di ricerca). Questi campi vengono caricati nella pagina dei dettagli della posizione.

5. Visualizza posizioni sul frontend

Per visualizzare le tue posizioni sul frontend puoi usare:

Un menu per visualizzare il motore di ricerca della posizione, la posizione singola o la categoria di posizioni
Un modulo per visualizzare un campo di ricerca o selezionare un set di posizioni
Un pulsante dell'editor per visualizzare posizioni singole o multiple in qualsiasi editor

Dal menu manager di Joomla, aggiungi un elemento e seleziona come tipo "Ricerca e visualizzazione posizione". Visualizzerà il motore di ricerca della posizione con i filtri.
Seleziona "Vista dei dettagli della posizione" per visualizzare una singola posizione predefinita.

Se selezioni “Ricerca e visualizzazione posizione” hai alcuni parametri di visualizzazione. Alcuni potrebbero sovrascrivere i parametri dei componenti predefiniti.

Dalla scheda principale del menu è possibile configurare:

Inserisci indirizzo: puoi forzare la visualizzazione di un indirizzo predefinito al caricamento della pagina. Può essere lasciato vuoto
Distanza: la distanza per bloccare la ricerca, facendo riferimento all'indirizzo sopra. Può essere lasciato come -1 (predefinito)
Categoria: carica una categoria specifica di località
Limite di ricerca: limita il numero di risultati di ricerca. 10 restituirà solo i primi 10 risultati nella ricerca della posizione
Ordinamento: ordina i risultati della ricerca per data, titolo, distanza (impostazione predefinita)

Quindi, nella scheda del menu My Maps Location , puoi impostare:

Seleziona Componente: My Maps Location o tutte le integrazioni di terze parti come K2, Jomsocial ...
ID categoria predefinito (estensioni di terze parti): categoria predefinita da caricare quando viene utilizzata un'estensione di terze parti, come K2, Hikashop o Adsmanager, ID elenco CB per comunity builder
Posizioni delle categorie secondarie : vengono visualizzate anche come posizioni dei risultati di ricerca da sottocategorie, non solo da quella selezionata sopra
Tema: seleziona uno dei 3 temi predefiniti, a larghezza intera e barra laterale del tema di visualizzazione della ricerca e dei risultati disponibile per la voce di menu
Fornitore di mappe: seleziona Google Maps, Bing Maps, Mapbox, OpenStreetMap, Baidu o Mapquest per applicare uno stile alle tue mappe
Abilita tag di ricerca : consente di eseguire query di ricerca utilizzando i nomi dei tag di posizione
Disegni: a seconda dell'origine della mappa, sono disponibili diversi tipi e colori di mappa
Livello mappa: aggiungi alcuni dati (livello) alle tue mappe. Sono disponibili il livello KML, il livello Traffico, il livello Trasporto pubblico e il livello Biciclette.
Google Map Layer Url: utilizza il livello dati per memorizzare i tuoi dati personalizzati o per visualizzare i dati GeoJSON su una mappa di Google
Tipo di Bing Maps: se Bing Maps è il fornitore della tua mappa, seleziona l'aspetto e i dati di Bing Maps
Tipo di OpenStreetMap: se OpenStreetMap è il tuo fornitore di mappe, puoi aggiungere alcuni dati (layer) alle tue mappe
Descrizione comando posizione: al caricamento della mappa, apri automaticamente la descrizione comando posizione dopo la ricerca della posizione
Zoom mappa: consente di definire un livello di zoom predefinito sulla mappa
Opzioni di larghezza e altezza della mappa e dei risultati di ricerca

Display frontend basato sul tema

Risultato per un singolo display di ricerca della posizione:

Visualizza le posizioni utilizzando un modulo

My maps location viene fornita con 2 moduli per le posizioni native + altri per l'integrazione di terze parti (come un modulo per visualizzare le posizioni degli elementi K2)

Il modulo Mappa ti consente di visualizzare le tue posizioni con gli stessi filtri del menu ma in una posizione modulo. Le posizioni verranno visualizzate come Mappa o Elenco. È possibile selezionare un insieme di località o selezionare categorie di località.

My Maps Location – Il modulo di ricerca visualizzerà un motore di ricerca con alcuni filtri come opzione come la larghezza della mappa o il componente in cui verrà ricercata la posizione (cerca la posizione K2 solo per un esempio).

Modulo display sul frontend:

Visualizza le posizioni utilizzando un pulsante dell'editor

Il pulsante dell'editor verrà caricato nel tuo editor Joomla (di solito negli articoli o nei moduli personalizzati HTML).
Vedrai il pulsante nella parte inferiore del tuo editor. Al clic vedrai una lightbox che ti consente di selezionare una o più posizioni che hai aggiunto in precedenza.

Quindi puoi selezionare una o più posizioni e premere il pulsante per aggiungerla al tuo articolo.
Se non specifichi alcun livello di zoom, verrà caricato automaticamente per adattarsi alla tua area di posizione. Il codice del tag che vedrai nel tuo editor WYSIWYG sarà come questo modello: {mymaplocations mapid width height}

Es: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} questo codice visualizzerà una mappa con l'ID della posizione = 1, con il 58% di larghezza, 400 px di altezza, zoom 10 volte e tipo Google. Utilizzo della virgola per aggiungere più di una posizione in una mappa. Es: {mymaplocation id = 1 width = 58% height = 400px zoom = 10 type = google} l'ID località = 1, 2, 3.