VibeFox GLS ParcelShop for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato con la versione 3.0.5.0) oppure 4.0.2 e successive (testato con la versione 4.1.0.3), con il tema predefinito e il suo checkout in una sola pagina.

PHP: 8.0 o successivo.

GLS: l'estensione non utilizza né richiede un account GLS o una chiave API. La mappa dei ParcelShop è pubblica. Ti serve un contratto con GLS per spedire i pacchi ai ParcelShop scelti.

Politica di sicurezza dei contenuti: se il tuo negozio invia una politica di sicurezza dei contenuti, consenti map.gls-croatia.com, da cui viene caricato lo script della mappa GLS.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Estrailo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 vfd_gls_parcelshop-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 vfd_gls_parcelshop.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nell'area di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file vfd_gls_parcelshop-oc3-(version).ocmod.zip. L'estensione non aggiunge modifiche OCMOD, quindi non devi aggiornare Extensions > Modifications. Invece dell'installer, puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella radice del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo di estensione Shipping. Trova VibeFox GLS ParcelShop e fai clic su Install (il pulsante verde +).

3. Fai clic su Edit (il pulsante con la matita) per aprire la pagina delle impostazioni.

4. Inserisci la tua chiave di licenza VibeFox in License key nel blocco di licenza in cima alla pagina Edit e fai clic su Activate (vedi License key).

5. Imposta i prezzi: almeno una riga di Country prices (per esempio * Default) oppure un Fallback cost (vedi Configurazione). Attiva Enable/Disable e fai clic su Save.

OpenCart 4

1. Nell'area di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file vfd_gls_parcelshop.ocmod.zip. Non rinominare il file: OpenCart 4 ricava il codice dell'estensione dal nome del file, e un pacchetto rinominato non funziona.

2. Il pacchetto compare nell'elenco delle estensioni installate nella stessa pagina. Fai clic su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo di estensione Shipping. Trova VibeFox GLS ParcelShop, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza e le impostazioni come nei passi 4 e 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni.

Dopo l'installazione il metodo resta disattivato finché non attivi Enable/Disable e salvi. Se reinstalli l'estensione dopo una disinstallazione, vengono riutilizzate le impostazioni che avevi conservato.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit. Le sezioni sono elencate a sinistra. Un pulsante Save in fondo salva l'intera pagina senza ricaricarla. Solo gli utenti amministratori con il permesso di modifica per questa estensione possono salvare le impostazioni.

Gli avvisi in cima alla pagina, e di nuovo dopo ogni salvataggio, segnalano problemi di configurazione: nessun prezzo impostato, alcuni o tutti i Countries (ignore zones mode) selezionati non sono coperti dalla mappa GLS, oppure l'unità di peso del negozio non è riconosciuta dall'estensione e non esiste una classe di peso in kg (aggiungine una in System > Localisation > Weight Classes). Un numero non valido o negativo viene rifiutato con un messaggio che indica il campo, per esempio Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. Gli altri campi vengono comunque salvati. Un Name, un ordine di visualizzazione, una classe fiscale o una zona geografica non validi vengono rifiutati allo stesso modo.

Generale

La sezione elenca i paesi coperti dalla mappa GLS: Austria, Belgio, Bulgaria, Croazia, Repubblica Ceca, Danimarca, Finlandia, Francia, Germania, Grecia, Ungheria, Italia, Lussemburgo, Paesi Bassi, Polonia, Portogallo, Romania, Serbia, Slovacchia, Slovenia e Spagna. Il metodo non viene offerto per gli altri paesi di destinazione.

Enable/Disable: mostra o nasconde GLS ParcelShop al checkout. Predefinito: disattivato.

Name: il nome del metodo di spedizione mostrato al cliente. Predefinito: GLS ParcelShop. Obbligatorio, al massimo 64 caratteri, senza i caratteri < > ; = # { }.

Tax status: None (shipping is not taxed), oppure la classe fiscale da applicare quando la spedizione è tassabile.

Sort order: la posizione tra i metodi di spedizione al checkout. Un numero intero.

Prezzi

I prezzi si inseriscono nella valuta predefinita del tuo negozio, IVA esclusa. I decimali possono usare la virgola o il punto (4,99 oppure 4.99). Il prezzo viene mostrato al cliente nella sua valuta.

Calculation type: come viene applicato il prezzo.

Country prices: una tabella con una riga per ogni paese di destinazione. Fai clic su Add country per aggiungere una riga. Ogni riga ha un Country, un Price e cinque colonne di peso: XS fino a 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg e XL oltre 5 kg. Si usa la colonna corrispondente al peso del carrello. Una colonna di peso lasciata a 0 usa la colonna Price. La riga * Default viene usata per i paesi senza una riga propria. Una riga con tutti i prezzi a 0 corrisponde a una consegna gratuita, quindi scegli il paese e compila i prezzi prima di salvare. Se un valore della tabella non è un numero valido di 0 o più, l'intera tabella non viene salvata e il messaggio elenca i valori errati.

Fallback cost: il prezzo usato quando la tabella non ha una riga per il paese di destinazione né una riga * Default. Lascialo vuoto per nascondere il metodo per questi paesi.

Free shipping from: il subtotale del carrello (dopo gli sconti, IVA esclusa) a partire dal quale la consegna con GLS ParcelShop è gratuita. Lascialo vuoto se la consegna non è mai gratuita.

Disponibilità

Minimum weight (kg): nasconde il metodo quando il carrello pesa meno. Il peso viene convertito dalle classi di peso dei prodotti. Vuoto o 0 significa nessun limite.

Maximum weight (kg): nasconde il metodo quando il carrello pesa di più. Predefinito: 20. I ParcelShop GLS di solito accettano pacchi fino a 20 kg, quindi verifica il tuo contratto GLS. Vuoto o 0 significa nessun limite. Se il minimo è maggiore del massimo, entrambi i pesi vengono rifiutati con un messaggio e vengono mantenuti i valori precedenti.

Minimum cart subtotal: offre il metodo solo quando il subtotale del carrello (dopo gli sconti, IVA esclusa) raggiunge questo importo. Lascialo vuoto per nessun minimo.

Geo zone: offre il metodo solo per gli indirizzi di questa zona geografica. All zones significa nessun limite. Non viene usata quando Ignore shipping zones è attivo. Le zone geografiche si gestiscono in System > Localisation > Geo Zones.

Ignore shipping zones: quando è attivo, il metodo viene offerto per i paesi selezionati sotto (tutti i paesi della mappa GLS se l'elenco è vuoto), indipendentemente dalla zona geografica. Quando è disattivo, viene offerto solo nella zona geografica indicata sopra. Predefinito: disattivato.

Countries (ignore zones mode): i paesi di destinazione per questa modalità. Lascialo vuoto per usare tutti i paesi della mappa GLS. I paesi non coperti dalla mappa GLS vengono saltati. Questo campo viene usato solo quando Ignore shipping zones è attivo.

Avanzate

Debug log: scrive i calcoli delle tariffe e le scelte dei ParcelShop in storage/logs/vfd_glps_debug.log.php (su OpenCart 4 system/storage/logs/vfd_glps_debug.log.php). Il file non può essere letto dal web. Gli errori vengono sempre registrati. Non vengono registrati dati personali dei clienti. Disattiva il registro quando hai finito. Quando il file raggiunge 5 MB, viene spostato in vfd_glps_debug.old.log.php e ne viene avviato uno nuovo.

Log: mostra la dimensione e le ultime voci del registro di debug. Fai clic su Clear log per svuotarlo.

Remove data on uninstall: quando è attivo, disinstallando l'estensione vengono eliminate le impostazioni e il registro. Quando è disattivo, tutto viene conservato per una reinstallazione. Il ParcelShop salvato negli ordini viene sempre conservato.

Importa / Esporta

Export: fai clic su Download JSON per salvare le impostazioni in un file JSON.

Import: incolla un JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni, per esempio su un altro negozio. I valori non validi vengono segnalati e non vengono importati.

Come funziona al checkout

Quando OpenCart mostra i metodi di spedizione, chiede all'estensione il prezzo di GLS ParcelShop. Se è impostata una Geo zone (e Ignore shipping zones è disattivo) e l'indirizzo è al di fuori di essa, il metodo non viene offerto. Contano solo i prodotti con Requires Shipping impostato su Yes: gli altri prodotti non aggiungono peso e non sono inclusi nel subtotale del carrello. Il subtotale è il prezzo di questi prodotti dopo lo sconto del coupon, IVA esclusa. L'estensione verifica poi le condizioni: paese di consegna coperto dalla mappa GLS (e selezionato in Countries (ignore zones mode) quando quella modalità è attiva), peso del carrello e subtotale minimo del carrello. Se il subtotale del carrello raggiunge Free shipping from, la consegna è gratuita. Altrimenti il prezzo viene preso dalla riga del paese (o dalla riga * Default) e dalla colonna di peso, oppure da Fallback cost. Se non viene trovato alcun prezzo, il metodo viene nascosto. Il prezzo viene arrotondato ai decimali della valuta predefinita e mostrato con l'imposta della Tax status selezionata.

Quando il cliente seleziona GLS ParcelShop, sotto il metodo compare un riquadro GLS ParcelShop con un pulsante Select GLS ParcelShop. Il pulsante apre la mappa ufficiale dei GLS ParcelShop per il paese di consegna. Un ParcelShop di un altro paese viene rifiutato subito. Dopo la scelta del ParcelShop vengono mostrati nome e indirizzo e il pulsante cambia in Change ParcelShop. La scelta viene mantenuta nella sessione del cliente, quindi resta anche quando il passaggio della spedizione viene ricaricato. Se l'indirizzo di consegna cambia in un altro paese, il cliente deve scegliere di nuovo un ParcelShop.

Quando il cliente fa clic su Continue nel passaggio del metodo di consegna, l'estensione verifica che sia stato scelto un ParcelShop e che si trovi nel paese di consegna. In caso contrario il cliente vede Please select a GLS ParcelShop. oppure The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. e resta in quel passaggio. Se il ParcelShop non può essere salvato, il cliente vede The ParcelShop could not be saved. Please try again. Se lo script della mappa GLS non può essere caricato, il cliente vede The GLS ParcelShop map could not be loaded. Please reload the page or choose another shipping method.

Su OpenCart 4 il cliente fa clic su Choose nel blocco del metodo di spedizione della pagina di checkout e sceglie GLS ParcelShop nella finestra Shipping method options. Il riquadro GLS ParcelShop con il pulsante Select GLS ParcelShop compare in quella finestra sotto il metodo, e la mappa GLS si apre sopra la finestra. Il pulsante Continue della finestra non prosegue senza un ParcelShop valido, con gli stessi messaggi. OpenCart 4 conserva un unico ordine per il checkout e lo aggiorna ogni volta che il cliente conferma di nuovo, e il ParcelShop dell'ordine viene aggiornato insieme ad esso.

La mappa GLS viene eseguita nel browser del cliente. Nella pagina del checkout l'estensione carica lo script della mappa GLS da map.gls-croatia.com, e la mappa carica da GLS i dati dei ParcelShop e i riquadri della mappa. GLS riceve i normali dati della richiesta del visitatore (indirizzo IP, browser). Dal tuo server non viene inviato nulla a GLS. Un errore dell'estensione non interrompe mai il checkout per gli altri metodi di spedizione; viene scritto nel registro.

L'estensione non recupera le tariffe GLS in tempo reale, non crea spedizioni GLS, non stampa etichette e non traccia i pacchi. Non dispone di un elenco dei ParcelShop sul tuo server, quindi non può verificare l'ID del ParcelShop rispetto a GLS. Trasmetti l'ID del ParcelShop dell'ordine a GLS nel modo abituale (MyGLS, il tuo software GLS o un'altra estensione).

Punti di ritiro

Al momento dell'ordine, il ParcelShop scelto al checkout viene salvato con l'ordine: il suo ID, il nome con l'indirizzo e il paese. Dopo il completamento dell'ordine la scelta viene cancellata, così il carrello successivo inizia senza ParcelShop.

Shipping method name: il ParcelShop viene aggiunto al nome del metodo di spedizione dell'ordine, per esempio GLS ParcelShop: name, address (prima il nome del metodo, poi il ParcelShop) (OpenCart 3 conserva al massimo 128 caratteri di questo nome, OpenCart 4 al massimo 255). Così il ParcelShop compare nell'e-mail di conferma dell'ordine inviata al cliente, nella pagina dell'ordine in Order History del cliente e in Sales > Orders. OpenCart non mostra il metodo di spedizione nella pagina di ordine completato.

Admin order page: in Sales > Orders, un pannello GLS ParcelShop mostra nome e indirizzo del ParcelShop con il ParcelShop ID e il paese. Se un ordine GLS ParcelShop non ha un ParcelShop, il pannello mostra No ParcelShop was selected for this order. Il pannello mostra soltanto il ParcelShop; non può essere modificato da lì.

E-mail al commerciante: l'e-mail di avviso di nuovo ordine inviata al negozio include il ParcelShop con il suo ParcelShop ID nel blocco dei commenti.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox GLS ParcelShop è il primo blocco di Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto ci sono la riga Product: opencart-shipping-gls-parcelshop e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso di modifica per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco indica il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached o License expired on seguito da una data. Dopo un cambio dell'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un solo dominio: l'indirizzo del negozio nella configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, il metodo di spedizione GLS ParcelShop non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. Un utente amministratore che ha effettuato l'accesso all'area di amministrazione nello stesso browser vede comunque il metodo nel negozio, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso all'area di amministrazione, quindi senza una chiave attiva il metodo è nascosto a tutti. Dopo che hai aperto una volta la pagina Edit, nella pagina Dashboard dell'area di amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente quando apri la Dashboard o la pagina Edit dell'amministrazione: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta a settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

GLS ParcelShop non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable sia attivo. Controlla Geo zone, oppure Ignore shipping zones e Countries (ignore zones mode). Verifica che il paese di destinazione sia uno dei paesi della mappa GLS e che abbia un prezzo (una riga del paese, la riga * Default o Fallback cost). Controlla i limiti di peso e Minimum cart subtotal, e che i prodotti abbiano Requires Shipping impostato su Yes. Attiva Debug log e guarda il campo Log per vedere il motivo.

La mappa non si apre: il cliente vede "The GLS ParcelShop map could not be loaded..." quando lo script GLS viene bloccato, per esempio da un blocco pubblicità o privacy, da una politica di sicurezza dei contenuti o da un'interruzione di GLS. Consenti map.gls-croatia.com nella tua politica di sicurezza dei contenuti.

Il riquadro del ParcelShop non compare sotto il metodo: l'estensione è stata testata con il tema predefinito di OpenCart e il suo checkout. Un tema o un'estensione di checkout che sostituisce il passaggio del metodo di spedizione potrebbe non mostrare il riquadro.

La consegna è gratuita per un paese per errore: controlla la riga di quel paese in Country prices. Una riga in cui Price e tutte le colonne di peso sono 0 corrisponde a una consegna gratuita.

La tabella o un campo non è stato salvato: un valore non è un numero valido di 0 o più. Il messaggio in cima alla pagina indica il valore. Usa cifre con la virgola o il punto come separatore decimale.

Un ordine mostra No ParcelShop was selected for this order: l'ordine è stato effettuato senza un ParcelShop del paese di consegna. Il motivo è scritto nel registro. Chiedi il ParcelShop al cliente e consegnalo a GLS manualmente.

La pagina dice "Warning: You do not have permission to modify VibeFox GLS ParcelShop!": il tuo gruppo di utenti amministratori può soltanto visualizzare le impostazioni. Concedi al gruppo il permesso di modifica per extension/shipping/vfd_gls_parcelshop (OpenCart 3) o extension/vfd_gls_parcelshop/shipping/vfd_gls_parcelshop (OpenCart 4) in System > Users > User Groups.

Per gli sviluppatori: l'indirizzo dello script della mappa GLS può essere sostituito con l'impostazione vfd_glps_widget_url; non ha un campo nella pagina delle impostazioni.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Shipping e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox GLS ParcelShop. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart ripristina sempre Enable/Disable, Sort order, Tax status e Geo zone. L'estensione rimuove sempre i propri eventi. Se Remove data on uninstall è attivo, vengono eliminate anche le altre impostazioni e il registro di debug. Se è disattivo, vengono conservate e riutilizzate quando reinstalli l'estensione. Un ParcelShop scelto in un carrello aperto resta nella sessione del cliente fino alla scadenza. Il ParcelShop salvato negli ordini viene sempre conservato, e gli ordini esistenti mantengono il loro metodo di spedizione e il loro costo.

Su OpenCart 4, per rimuovere anche i file dell'estensione, vai su Extensions > Installer dopo la disinstallazione e fai clic su Uninstall (il pulsante arancione −) accanto a VibeFox GLS ParcelShop nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per eliminare il pacchetto caricato.

GLS è un marchio del suo titolare. Questa estensione non è affiliata a GLS né approvata da GLS.