Cosa mostra il modulo al cliente
Tabella dei corrieri
Elenco di tutti i metodi di consegna che possono recapitare il prodotto visualizzato nella zona del visitatore. La tabella ha tre colonne — Corriere, Informazioni e Prezzo — e in ogni riga si trovano:
- corriere — come logo oppure come nome, a scelta nella configurazione;
- tempo di consegna — il campo “ritardo” inserito per il corriere in PrestaShop (in modalità logo, nella stessa colonna compare anche il nome del corriere);
- prezzo — calcolato per questo prodotto, questa zona e questo gruppo clienti, oppure la parola “Gratuita” quando la consegna non costa nulla.
Se per il prodotto non esiste nemmeno un metodo di consegna, il modulo, invece di una tabella vuota, mostra la breve frase “Nessun metodo di consegna per questo prodotto.”.
Sotto la tabella il modulo aggiunge l’informazione sulla soglia di consegna gratuita nel formato “Per acquisti superiori a importo o peso consegna gratuita!” — se il negozio ha impostato tale soglia — nonché un testo personalizzato del venditore, separato per ogni lingua, inserito nell’editor WYSIWYG.
Badge della consegna più economica
Una riga nel formato “La consegna parte da X”, con icona e facoltativamente con il tempo di consegna su una seconda riga. Il badge è gestito indipendentemente dalla tabella — si può attivare solo il badge, solo la tabella oppure entrambi contemporaneamente, ciascuno in un punto diverso della pagina.
Elenco completo delle funzioni
Visualizzazione e posizionamento
- Tabella dei corrieri nelle schede della pagina prodotto (
displayProductExtraContent), nel footer della pagina prodotto (displayFooterProduct) oppure in qualsiasi punto del template tramite{hook h='displayCustomHookTable'}. - Badge presso i pulsanti di acquisto (
displayProductActions), nel blocco delle informazioni aggiuntive (displayProductAdditionalInfo) oppure in qualsiasi punto tramite{hook h='displayCustomHookBadge'}. - Interruttore logo del corriere oppure suo nome nella prima colonna della tabella.
- Opzione “il più economico, ma non gratuito” — il badge mostra allora la consegna a pagamento più economica invece di quella gratuita, quando il negozio ha un corriere a 0 zł.
- Interruttore del tempo di consegna sul badge.
- Testo personalizzato sotto la tabella nell’editor WYSIWYG, separato per ogni lingua del negozio.
- Nascondere i corrieri selezionati — quelli selezionati nell’elenco non compariranno né nella tabella né nel badge. Utile per il “ritiro in sede” a 0 zł, che altrimenti vince sempre nel badge e pubblicizza una consegna gratuita che in realtà non è una consegna.
Calcolo del prezzo
- Prezzo calcolato per un prodotto specifico e un visitatore specifico: peso e prezzo del prodotto, zona di consegna, gruppo clienti, valuta e lingua.
- Varianti del prodotto incluse nel calcolo: peso e prezzo della combinazione vengono aggiunti come fa il carrello di PrestaShop.
- Aggiornamento senza ricaricare la pagina — dopo la selezione della variante, tabella e badge vengono ricalcolati via AJAX.
- Vengono considerati i corrieri assegnati al prodotto, gli intervalli di peso e di prezzo, il supplemento di gestione e il costo di spedizione aggiuntivo del prodotto.
- I corrieri gestiti da moduli di spedizione (corrieri con API proprie) vengono interrogati sul prezzo come nel carrello; il rifiuto di tale modulo significa che il corriere scompare dalla tabella, non che la consegna sia gratuita.
- Imposta secondo l’impostazione del gruppo clienti — lordo oppure netto, esattamente come il prezzo del prodotto accanto.
- Soglia di consegna gratuita confrontata a scelta: con l’intero carrello aumentato del prodotto visualizzato (come lo calcola l’ordine) oppure con il solo prodotto.
- Compatibilità con il modulo Free Delivery Pro (
pdfreedeliverypro), se installato e attivo — la soglia di consegna gratuita sotto la tabella viene allora presa dalle sue impostazioni.
Zona di consegna e database GeoIP
- Cliente registrato con indirizzo — prezzi per la zona del suo indirizzo di consegna.
- Ospite senza indirizzo — paese riconosciuto dall’indirizzo IP nel database GeoIP, e da questo la zona.
- Database assente oppure indirizzo sconosciuto — zona del paese predefinito del negozio. Il modulo funziona anche senza database GeoIP; in tal caso questo passaggio viene semplicemente saltato.
- Database DB-IP Lite (licenza CC BY 4.0), scaricato con un solo pulsante dalla scheda GeoIP nel pannello, aggiornato alla fonte ogni mese.
- L’intestazione del modulo avvisa quando il database ha più di 60 giorni — l’età viene letta dalla data di compilazione salvata nel database stesso, non dalla data del file.
- Il download è resistente alle interruzioni: il nuovo database sostituisce quello vecchio solo dopo l’estrazione e la verifica che sia apribile.
- La cartella con il database viene protetta dall’accesso dalla rete con il file
.htaccess; sui server nginx bisogna aggiungere una regola lato hosting, cosa che il modulo ha indicato esplicitamente nella configurazione.
Prestazioni
- Il calcolo del prezzo effettuato viene memorizzato in una tabella propria del modulo, con una chiave che comprende prodotto, variante, zona, paese, gruppi clienti, impostazione fiscale, negozio, lingua, valuta e lato della soglia di consegna gratuita.
- Tempo di conservazione impostabile in ore, predefinito un giorno; il valore 0 disattiva completamente la memorizzazione.
- Pulsante “Cancella ora” con contatore dei calcoli salvati.
- I calcoli salvati vengono invalidati automaticamente in caso di modifica del corriere, del prodotto, della combinazione, del prezzo promozionale e al salvataggio delle impostazioni del modulo stesso.
- Il calcolo del prezzo dipendente dal modulo di spedizione del corriere non viene memorizzato — tali prezzi sono reali per un solo cliente e per nessun altro.
- Misurato con il contatore delle query della sessione MySQL, con corriere a pagamento: la versione precedente del modulo eseguiva 23 + 5,00 × N query per un singolo calcolo (N = numero di corrieri attivi), la versione 2.0.0 ne esegue 24 + 3,00 × N, e il ritorno alla stessa pagina prodotto — una query. Su una vera pagina prodotto il costo marginale è ancora più basso, perché la pagina recupera comunque la maggior parte dei dati di cui il calcolo ha bisogno.
Pannello di amministrazione
- Quattro schede: Badge, Tabella dei corrieri, GeoIP e Istruzioni.
- Ogni scheda salva esclusivamente le proprie impostazioni — il salvataggio del badge non tocca la tabella e viceversa.
- L’intestazione mostra in tempo reale lo stato di entrambe le funzioni, la presenza e l’età del database GeoIP nonché l’ambito in cui stai lavorando (negozio, gruppo di negozi oppure tutti i negozi).
- La scheda Istruzioni contiene inserti pronti
{hook}da copiare e spiega per quale zona vengono calcolati i prezzi. - Avviso quando la posizione selezionata non mostra nulla, finché l’inserto non viene aggiunto al template del tema.
- Un dipendente con permesso di sola lettura dei moduli vedrà la schermata, ma non salverà nulla.
Multistore e traduzioni
- Ogni impostazione viene salvata separatamente per ogni negozio.
- Il salvataggio nel contesto “tutti i negozi” imposta un valore comune, usato dai negozi senza impostazioni proprie; il negozio che ha salvato le proprie le mantiene.
- La schermata elenca per nome i negozi che mantengono impostazioni proprie e li collega, affinché il salvataggio “per tutti” non si riveli una silenziosa mancanza di modifica.
- Interfaccia in inglese e polacco; tutti i testi visibili al cliente possono essere modificati in Internazionale → Traduzioni.
Come il modulo determina il prezzo di consegna
- Verifica se il prodotto è disponibile per l’ordine e se il carrello non è interamente virtuale.
- Determina la zona di consegna: indirizzo del cliente registrato → GeoIP → paese predefinito del negozio.
- Recupera i corrieri disponibili per questa zona e questo gruppo clienti, tenendo conto dell’assegnazione dei corrieri al prodotto.
- Per ciascuno calcola il prezzo in base a peso e prezzo del prodotto con la variante, intervalli tariffari, supplementi e imposta.
- Esclude i corrieri che non gestiscono quel peso o quel prezzo, nonché quelli nascosti dal venditore.
- Ordina in modo crescente per prezzo e seleziona il più economico per il badge.
Dati personali e GDPR
Il modulo legge l’indirizzo IP del visitatore esclusivamente per determinarne il paese. La lettura avviene sul tuo server, da un file nella cartella del modulo — l’indirizzo IP non viene salvato nel database del negozio e non viene inviato da nessuna parte. L’unica connessione in uscita che il modulo stabilisce è il download del database GeoIP, e solo quando premi il pulsante nel pannello. Se utilizzi il database GeoIP, menziona questo trattamento nella politica sulla privacy del negozio.
Requisiti tecnici
| PrestaShop | 1.7.0 – 9.x |
|---|---|
| PHP | 7.0 – 8.5 |
| Database | MySQL 5.6+ / MariaDB 10.x+ |
| Dipendenze | nessuna — senza Composer e senza librerie PHP esterne |
| Dimensione del pacchetto | circa 410 kB (database GeoIP scaricato separatamente, circa 120 MB) |
| Multistore | sì, impostazioni separate per ogni negozio |
| Lingue dell’interfaccia | inglese, polacco |
| Versione del modulo | 2.0.0 |
Cosa il modulo non fa
- Non crea corrieri né modifica i loro listini — mostra ciò che hai configurato in PrestaShop.
- Non modifica il prezzo di consegna nel carrello né nell’ordine — lo calcola esclusivamente per la pagina prodotto.
- Non mostra nulla per un carrello interamente virtuale (solo file da scaricare) — in tal caso non c’è nulla da calcolare.
- Non richiede il database GeoIP — senza di esso l’ospite vede i prezzi per il paese predefinito del negozio.
Installazione
- Carica il pacchetto in Moduli → Gestione moduli → Carica un modulo.
- Installa e apri Configura.
- Scegli dove deve comparire la tabella e dove il badge.
- Facoltativamente, nella scheda GeoIP: scarica il database di geolocalizzazione.