Widget mappa per Shopify

Perché una sezione del tema è meglio di un'app Shopify

La maggior parte delle app “mappa” chiede un'installazione, i permessi sui dati del tuo negozio e un canone mensile — per quello che alla fine è un solo iframe. Questa è l'alternativa onesta: un unico file Liquid che vive nel tuo tema. Non chiede permessi sul negozio, non aggiunge script alle tue pagine, non invia dati a nessuno e non costa nulla. Le uniche richieste esterne fatte dai tuoi visitatori sono l'iframe della mappa in sandbox da whatismylocation.ai e le sue tile OpenStreetMap: nessun cookie di Google, nessuna zavorra da banner di consenso. E se il servizio fosse irraggiungibile, l'iframe non si carica in silenzio, senza rompere la pagina. Cancella il file della sezione e ogni traccia sparisce.

Scarica whatismylocation-shopify-sections.zip — entrambe le sezioni più un README, pochi kilobyte. Poi segui i passaggi di installazione qui sotto.

Installazione in circa due minuti

Due parti: incolli il file una volta sola, poi lo usi come qualsiasi sezione integrata.

Incolla il file: pannello Shopify ▸ Negozio online ▸ Temi ▸ ⋯ ▸ Modifica codice. Nella barra laterale sinistra, sotto Sections, clicca Aggiungi una nuova sezione, chiamala whatismylocation-map, cancella il contenuto segnaposto e incolla tutto il contenuto di whatismylocation-map.liquid — il blocco {% schema %} in fondo è ciò che costruisce il pannello delle impostazioni, quindi deve essere incluso. Salva.

Usala: apri l'editor del tema (Personalizza), vai alla pagina contatti (o a qualsiasi altra pagina), premi Aggiungi sezione e scegli WhatIsMyLocation Map. Il pannello delle impostazioni compare a sinistra; finché non inserisci le coordinate, la sezione mostra un segnaposto gentile che ti dice esattamente cosa serve.

Prendi le coordinate dal generatore di mappa da incorporare — digita il tuo indirizzo, poi trascina il pin sul tuo ingresso prima di copiare. La sezione salva le coordinate finali, così il pin non potrà più spostarsi.

Le filiali sono blocchi

I negozi con più sedi hanno la parte migliore: nell'editor del tema ogni filiale è un blocco — premi Aggiungi filiale, inserisci latitudine, longitudine, un'etichetta e un indirizzo, e riordinale trascinandole (fino a 10). La mappa si adatta automaticamente a tutte le filiali e i pin sono numerati per corrispondere all'elenco. I visitatori ottengono il pannello delle sedi — una fisarmonica accanto alla mappa su desktop, una striscia di schede scorrevoli su telefono, con indicazioni stradali per ogni filiale e icone opzionali “Apri in Google Maps / Apple Maps”. Il layout del pannello (auto, laterale, in basso, nessuno) e l'animazione di transizione (fluida, dissolvenza, vivace, nessuna — chi ha attivato la riduzione del movimento vede sempre la versione istantanea) sono menu a tendina nello stesso pannello.

Ogni impostazione, spiegata

Lo stesso zip include whatismylocation-widget.liquid — il widget trova-la-mia-posizione come seconda sezione (tema, modalità compatta o completa, altezza), per pagine di consegna e cerca-negozi.

Risoluzione dei problemi

La sezione non compare sotto Aggiungi sezione. Il file deve stare in Sections (non in Snippets o Assets) e devi incollare il file intero — se il blocco {% schema %} è stato tagliato, Shopify rifiuta o nasconde la sezione. Incolla di nuovo tutto il file e salva.

Errore “Invalid schema” al salvataggio. Un incolla parziale — di solito manca una parentesi graffa di chiusura perché la selezione si è fermata una riga prima della fine. Incolla di nuovo il file completo; non modificare lo schema a mano se non conosci Liquid.

La mappa è grigia. Le tile della mappa arrivano da tile.openstreetmap.org; un ad-blocker aggressivo o una rete aziendale possono bloccarle. Prova da telefono con la rete dati — i tuoi clienti quasi certamente la vedono bene.

Il pin non è sulla mia porta. Ricrea le coordinate con il generatore, trascina il pin sul tuo ingresso e incolla i nuovi valori nelle impostazioni della sezione.

Le modifiche non si vedono sul negozio online. Hai modificato un tema in bozza o non pubblicato — fai la modifica nel tema pubblicato (oppure pubblica quello che hai modificato). Il widget in sé non ha nulla in cache.