DataFirefly Dealer Locator: modalità catalogo e mappa dei rivenditori

Questo modulo trasforma un negozio PrestaShop 8 o 9 in una vetrina di marca: disattiva la vendita online su tutto o parte del catalogo, aggiunge un pulsante Dove acquistare nelle schede prodotto e pubblica un elenco di rivenditori con mappa, orari, modulo di contatto e una pagina per ogni rivenditore.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e invia il file ZIP.
2. Il modulo crea il menu Vendi > Rete di rivenditori con tre voci: Rivenditori, Richieste di contatto e Impostazioni.
3. La pagina dell’elenco viene creata automaticamente con un URL tradotto per lingua: /dove-acquistare, /where-to-buy, /ou-acheter, /donde-comprar e così via.

Per aggiornare, basta caricare il nuovo ZIP: gli script di aggiornamento aggiungono le colonne e gli hook mancanti. Se l’elenco o le pagine dei rivenditori restituiscono un errore 404, salva una volta Parametri negozio > Traffico e SEO per rigenerare il file .htaccess.

Compatibilità: PrestaShop da 8.0 a 9.x, multinegozio, nessuna dipendenza Composer. Traduzioni incluse in inglese, francese, spagnolo, tedesco, italiano, olandese, polacco e portoghese.

Configurare la modalità catalogo

Apri Rete di rivenditori > Impostazioni, blocco Modalità catalogo. La modalità catalogo viene applicata al volo: l’impostazione nativa di PrestaShop non viene mai modificata e tutto torna normale se disattivi il modulo.

Vendita online

• Attivata: la modalità catalogo è spenta, il modulo funziona solo come elenco.
• Disattivata per tutto il catalogo: nessun prodotto può più essere aggiunto al carrello.
• Disattivata solo per la selezione: solo le categorie, marche e prodotti scelti sotto passano in modalità catalogo.
• Disattivata per tutto tranne la selezione: la selezione resta in vendita online, il resto passa in modalità catalogo.

Prezzi, messaggio e carrello

• Nascondi i prezzi: se disattivato, i prezzi restano visibili. Puoi allora mostrare un’etichetta sotto il prezzo, per impostazione predefinita Prezzo consigliato al pubblico.
• Messaggio sulla scheda prodotto: testo mostrato sopra il pulsante, ad esempio Questo prodotto è venduto esclusivamente nella nostra rete di rivenditori autorizzati. Lascia vuoto per nasconderlo.
• Reindirizza il carrello e il checkout all’elenco dei rivenditori: in modalità catalogo completa, le pagine carrello e ordine rimandano all’elenco.

Il carrello è bloccato lato server: un’aggiunta forzata tramite un URL viene rifiutata.

Gruppi di clienti esenti

Seleziona i gruppi che possono continuare a ordinare online. Esempio: un gruppo Rivenditori che ordina la merce sul sito mentre il pubblico vede solo il catalogo.

Il pulsante Dove acquistare

Blocco Pulsante Dove acquistare delle impostazioni:

• Prodotti interessati: solo i prodotti che non si possono acquistare online, oppure tutti i prodotti.
• Testo del pulsante, traducibile.
• Al clic: aprire una finestra con la mappa e i rivenditori del prodotto, oppure andare all’elenco filtrato sul prodotto.
• Mostra la disponibilità sotto il pulsante: Disponibile presso 14 rivenditori e poi il rivenditore più vicino non appena il visitatore ha già fatto una ricerca per località.
• Mostra i rivenditori online: i rivenditori di tipo Rivenditore online compaiono a parte, con un pulsante verso il prodotto sul loro negozio.

Il pulsante elenca solo i rivenditori che propongono il prodotto (scheda Prodotti venduti di ogni rivenditore). La finestra si apre sull’ultima città cercata dal visitatore.

Elenco e mappa

Blocco Elenco rivenditori e mappa:

• Testo introduttivo sopra la ricerca e colore di accento di pulsanti, marcatori e raggruppamenti.
• Centro e zoom predefiniti della mappa, unità (km o miglia), scelte del raggio, raggio predefinito (0 = nessun limite) e numero massimo di risultati.
• Stile della mappa: CARTO Voyager, CARTO Positron, OpenStreetMap o server di tile personalizzato (URL https con {z}, {x} e {y}).
• Chiedi prima di caricare la mappa: per il GDPR, il server di tile riceve l’IP del visitatore solo dopo un clic.
• Raggruppa i marcatori vicini e un colore di marcatore per tipo, con legenda sulla mappa.
• Elenco completo dei rivenditori per paese sotto la mappa, leggibile dai motori di ricerca.
• Una pagina per ogni rivenditore: vedi più avanti.

Il visitatore cerca per città o CAP, oppure usa la propria posizione. Può filtrare per tipo di rivenditore e selezionare Aperto ora. Su mobile, un pulsante alterna tra elenco e mappa. La mappa Leaflet è ospitata nel modulo: non serve nessuna chiave API.

Geocodifica

La geocodifica trasforma un indirizzo o una città in coordinate. I risultati sono memorizzati nella cache del database.

• OpenStreetMap Nominatim: gratuito, limitato a una richiesta al secondo. Inserisci l’email di contatto, consigliata dalla policy di utilizzo di Nominatim.
• Google Geocoding API: richiede una chiave API Google.
• Limita le ricerche a questi paesi: codici ISO separati da virgole, ad esempio it,ch,fr.

Gestire i rivenditori

Menu Rete di rivenditori > Rivenditori. La scheda di un rivenditore ha quattro schede.

Generale

• Nome, tipo (negozio, distributore, showroom, centro assistenza, rivenditore online), logo (JPG, PNG, WebP o GIF, massimo 2 MB).
• Partner: badge Partner ufficiale, mostrato per primo quando non è indicata una posizione.
• Telefono, sito web ed email: l’email riceve le richieste di contatto e non viene mai mostrata quando il modulo di contatto è attivo.
• Link al prodotto sul negozio del rivenditore: facoltativo, aggiunge un pulsante Acquista online. Tag disponibili: {reference} {ean13} {upc} {mpn} {name} {id_product}. Esempio: https://shop.example.com/search?q={ean13}
• Accesso all’area rivenditore: email di un account cliente esistente (vedi Area rivenditore).

Indirizzo e mappa

Il rivenditore viene posizionato sulla mappa automaticamente al salvataggio. Il pulsante Trova la posizione dall’indirizzo rilancia la geocodifica, e puoi cliccare sulla mappa o trascinare il marcatore per regolare la posizione.

Descrizione e orari

Descrizione multilingua, griglia degli orari su 7 giorni con due fasce al giorno (la seconda serve per la pausa pranzo), pulsanti per copiare il lunedì sugli altri giorni e campo Da sapere per festività o chiusure stagionali. Un giorno vuoto significa chiuso. Gli orari alimentano il badge e il filtro Aperto ora, calcolati nel fuso orario del negozio.

Prodotti venduti

Scegli Tutta la gamma oppure una selezione di categorie, marche e prodotti. Solo i rivenditori che propongono un prodotto compaiono nel suo pulsante Dove acquistare.

Importazione ed esportazione CSV

Pulsante Importa CSV dell’elenco dei rivenditori. Formato: UTF-8, separato da punto e virgola, prima riga con i nomi delle colonne. Il modo più semplice è esportare prima i tuoi rivenditori per ottenere un file pronto all’uso.

Colonne: id;name;type;active;featured;address1;address2;postcode;city;country_iso;phone;email;website;product_url;latitude;longitude;scope;categories;manufacturers;products;description;hours;opening

• Solo name è obbligatorio. Lascia id vuoto per creare un rivenditore, oppure seleziona l’aggiornamento dei rivenditori esistenti.
• type: retailer, distributor, showroom, service oppure online. country_iso: codice di due lettere.
• scope: 0 per tutta la gamma, 1 per le categorie, marche e prodotti indicati, separati da una barra verticale: 3|8|12.
• opening: numero del giorno (1 = lunedì) poi fasce orarie, giorni separati da una barra: 1=09:00-12:00,14:00-19:00/2=09:00-19:00/6=10:00-18:00

Dopo un’importazione senza coordinate, clicca su Posiziona sulla mappa i rivenditori importati: la geocodifica avviene in blocchi, un indirizzo al secondo. Tieni la pagina aperta durante l’operazione.

Richieste di contatto

Blocco Richieste di contatto delle impostazioni: attiva il modulo su ogni rivenditore, l’invio via email al rivenditore, una copia al tuo indirizzo, il testo della casella di consenso e la pagina dell’informativa sulla privacy.

Il modulo è protetto contro lo spam (campo trappola, tempo minimo, cinque invii all’ora per indirizzo IP). Le richieste sono elencate in Rete di rivenditori > Richieste di contatto, con filtri, vista dettagliata, stato gestita o da gestire ed esportazione CSV.

Area rivenditore

Attiva Area rivenditore nell’account cliente, poi inserisci nella scheda di un rivenditore l’email di un account cliente esistente. Dopo l’accesso, questo cliente vede un riquadro Area rivenditore in Il mio account. Può:

• modificare telefono, sito web, orari, campo Da sapere e descrizione nella propria lingua;
• leggere le richieste di contatto e segnarle come gestite;
• vedere le statistiche degli ultimi 30 giorni: visite al sito, clic sul telefono, indicazioni, richieste.

Indirizzo e posizione sulla mappa restano gestiti dal marchio. Uno stesso account può gestire più rivenditori.

Pagine rivenditore e SEO

Con l’opzione Una pagina per ogni rivenditore, ogni rivenditore (tranne quelli online) ha una pagina come /dove-acquistare/12/lumiere-co-lyon: indirizzo, mappa, orari, descrizione, modulo di contatto e rivenditori vicini. Le pagine contengono dati strutturati Store con orari schema.org e un URL canonico, e reindirizzano con un 301 se cambiano nome o città. Vengono aggiunte automaticamente alla sitemap se il modulo Google Sitemap (gsitemap) è installato.

Statistiche

La pagina di configurazione mostra l’attività degli ultimi 30 giorni: rivenditori più contattati con il dettaglio dei clic (sito, telefono, indicazioni, acquisto online, richieste) e prodotti con più clic su Dove acquistare.

Integrazione nel tema

Il pulsante viene mostrato automaticamente tramite l’hook displayProductAdditionalInfo. Per posizionarlo altrove, usa il widget:

• ricerca rivenditori: {widget name='dfdealerlocator'}
• pulsante Dove acquistare di un prodotto: {widget name='dfdealerlocator' id_product=$product.id}

Risoluzione dei problemi

La mappa resta grigia

Il server di tile è probabilmente bloccato da una policy di sicurezza (CSP) o da un firewall. Autorizza il dominio dello stile scelto (basemaps.cartocdn.com o tile.openstreetmap.org) oppure usa un server personalizzato.

Il pulsante Dove acquistare non compare

Verifica che il tema richiami l’hook displayProductAdditionalInfo nella scheda prodotto e che l’impostazione Prodotti interessati corrisponda al prodotto provato. Altrimenti inserisci il widget nel template del prodotto.

Un indirizzo non viene trovato

Compila almeno la città o il CAP e il paese, poi clicca su Trova la posizione dall’indirizzo. Se l’indirizzo resta introvabile, posiziona il marcatore a mano sulla mappa.

Errore 404 sull’elenco o su una pagina rivenditore

Rigenera il .htaccess salvando Traffico e SEO e verifica che l’URL semplificato della pagina module-dfdealerlocator-directory sia compilato in ogni lingua.