VibeFox GLS ParcelShop for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Il plugin non si attiva senza di esso.

PHP: 8.0 o successivo.

GLS: il plugin non usa né richiede un account GLS o una chiave API. La mappa dei ParcelShop è pubblica. Per spedire i pacchi ai ParcelShop scelti serve un contratto con GLS.

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

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. Puoi anche caricare la cartella vfd_gls_parcelshop in /wp-content/plugins/ tramite FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Imposta il nome e i tuoi prezzi: almeno una riga di Country prices (per esempio * Default) oppure un Fallback cost (vedi Configurazione).

6. Aggiungi VibeFox GLS ParcelShop a una zona di spedizione in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones.

Configurazione

Tutte le impostazioni si trovano in una sola pagina: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Valgono per tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title (zone): il nome del metodo di spedizione che il cliente vede in questa zona. Lascialo vuoto per usare il Name generale.

Gli avvisi in cima alla pagina delle impostazioni segnalano problemi di configurazione, per esempio quando non è impostato alcun prezzo o quando nessuno dei paesi selezionati è coperto dalla mappa GLS. I numeri non validi vengono rifiutati con un messaggio e viene mantenuto il valore precedente.

Generali

La sezione elenca i paesi coperti dalla mappa GLS. Il metodo non viene offerto per gli altri paesi di destinazione.

Enable/Disable: attiva o disattiva il metodo in tutte le zone contemporaneamente. Predefinito: attivo.

Name: il nome del metodo di spedizione mostrato al cliente. Una zona può sostituirlo con un proprio Title. Predefinito: GLS ParcelShop.

Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non l'aggiunge. Predefinito: Taxable.

Prezzi

I prezzi si inseriscono nella valuta del tuo negozio. I decimali possono usare la virgola o il punto (4,99 o 4.99).

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 e sulla croce per rimuoverne una. 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. Viene usata 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 che non hanno una riga propria. Le nuove righe partono con 0 in tutte le colonne, e una riga con tutti i prezzi a 0 corrisponde a una spedizione gratuita, quindi compila i prezzi prima di salvare.

Fallback cost: il prezzo usato quando la tabella non ha una riga per il paese di destinazione e non c'è una riga * Default. Lascialo vuoto per nascondere il metodo per quei paesi.

Free shipping from: il subtotale del carrello (dopo gli sconti, senza imposte) a partire dal quale la spedizione verso GLS ParcelShop è gratuita. Lascialo vuoto se la spedizione non è mai gratuita.

Disponibilità

Minimum weight (kg): nasconde il metodo quando il carrello pesa meno. Il peso viene convertito dall'unità di peso del tuo negozio. Vuoto o 0 significa nessun limite.

Maximum weight (kg): nasconde il metodo quando il carrello pesa di più. Predefinito: 20. I GLS ParcelShop di solito accettano pacchi fino a 20 kg, quindi verifica nel tuo contratto GLS. Vuoto o 0 significa nessun limite.

Minimum cart subtotal: offre il metodo solo quando il subtotale del carrello (dopo gli sconti, senza imposte) raggiunge questo importo. Lascialo vuoto se non c'è un minimo.

Excluded shipping classes: nasconde il metodo quando nel carrello c'è un prodotto di una di queste classi di spedizione di WooCommerce.

Ignore shipping zones: se attivo, il metodo viene offerto per i paesi selezionati qui sotto, anche se non è aggiunto alla zona di spedizione corrispondente. Se disattivo, viene offerto solo nelle zone a cui è aggiunto. Predefinito: disattivo.

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: registra il calcolo delle tariffe e le scelte dei ParcelShop in WooCommerce > Status > Logs (origine vfd-gls-parcelshop). Non viene registrato alcun dato personale del cliente. Disattiva il registro quando hai finito.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le impostazioni e le istanze di zona di questo metodo. Disattivare il plugin non elimina mai nulla. Il ParcelShop salvato negli ordini viene sempre conservato.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di spedizione, WooCommerce chiede al plugin una tariffa. Il plugin controlla prima le condizioni: paese di consegna coperto dalla mappa GLS, peso del carrello, subtotale minimo del carrello e classi di spedizione escluse. 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.

Quando il cliente seleziona GLS ParcelShop, sotto il metodo compare un pulsante Select GLS ParcelShop. Apre la mappa ufficiale dei GLS ParcelShop per il paese di spedizione. Dopo la scelta di un ParcelShop, vengono mostrati il suo nome e il suo indirizzo, e il pulsante diventa Change ParcelShop. La scelta viene ricordata nella sessione del cliente, quindi resta anche dopo un aggiornamento del checkout o un ricaricamento della pagina.

Al momento dell'ordine il plugin verifica che sia stato scelto un ParcelShop e che si trovi nel paese di spedizione. Altrimenti il cliente vede Seleziona un GLS ParcelShop, per favore. oppure Il GLS ParcelShop selezionato non si trova nel tuo paese di spedizione. Scegli di nuovo un ParcelShop, per favore., e l'ordine non viene effettuato. Se lo script della mappa GLS non può essere caricato, il cliente vede un messaggio che lo invita a ricaricare la pagina o a scegliere un altro metodo di spedizione.

La mappa GLS viene eseguita nel browser del cliente. Nella pagina del checkout il plugin 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.

Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin non ottiene 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 presso GLS. Comunica l'ID del ParcelShop dell'ordine a GLS nel modo che usi di solito (MyGLS, il tuo software GLS o un altro plugin).

Punti di ritiro

Il ParcelShop scelto viene salvato con l'ordine: il suo ID, il suo nome con l'indirizzo e il suo paese.

Schermata dell'ordine nell'area di amministrazione: il nome e l'indirizzo del ParcelShop, con l'ID e il paese del ParcelShop, vengono mostrati sotto l'indirizzo di spedizione. Se un ordine GLS ParcelShop non ha un ParcelShop, la schermata mostra Per questo ordine non è stato selezionato alcun ParcelShop.

Pagine del cliente: il ParcelShop viene mostrato nella pagina di ringraziamento e nella pagina di visualizzazione dell'ordine nell'account del cliente.

E-mail: il ParcelShop viene aggiunto alle e-mail dell'ordine, in HTML e in testo semplice. Le e-mail inviate all'amministratore del negozio includono anche l'ID del ParcelShop.

Gli sviluppatori possono leggere il ParcelShop dai metadati dell'ordine _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name e _vfd_glps_parcelshop_country.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino alla quale la licenza è attiva e il tuo dominio. Usa Check now per controllare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il collegamento Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un dominio. Rimuovere la chiave da un sito non libera il suo posto per il dominio. Libera il posto nel tuo account vibefox.net.

Senza una chiave attiva, GLS ParcelShop non viene mostrato ai clienti al checkout. I gestori del negozio che hanno effettuato l'accesso lo vedono ancora, contrassegnato come (senza licenza — visibile solo agli amministratori), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene controllato di nuovo automaticamente in background.

Risoluzione dei problemi

GLS ParcelShop non appare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo e che il metodo sia aggiunto alla zona del paese del cliente (oppure che Ignore shipping zones sia attivo e il paese sia consentito). 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, Minimum cart subtotal e Excluded shipping classes. Attiva Debug log per vedere il motivo in WooCommerce > Status > Logs.

La mappa non si apre: il cliente vede «Impossibile caricare la mappa GLS ParcelShop...» quando lo script GLS è bloccato, per esempio da un blocco di pubblicità o della privacy, da una content security policy o da un'interruzione di GLS. Consenti map.gls-croatia.com nella tua content security policy.

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 dà una consegna gratuita.

La tabella o un campo non sono stati salvati: un valore non è un numero valido. Il messaggio in cima alla pagina indica il valore. Usa cifre con la virgola o il punto come separatore decimale.

Filtri per sviluppatori: vfd_glps_map_countries modifica l'elenco dei paesi della mappa GLS, vfd_glps_widget_url modifica l'URL dello script della mappa GLS.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera un posto nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

La disattivazione del plugin conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi, insieme alle vecchie cache e al file di registro della versione 1.0. Le impostazioni e le istanze di zona del metodo vengono rimosse solo se Remove data on uninstall era attivo. Altrimenti restano disponibili per una successiva reinstallazione. Il ParcelShop salvato negli ordini viene sempre conservato, e gli ordini esistenti mantengono le proprie righe di spedizione.

GLS è un marchio del rispettivo proprietario. Questo plugin non è affiliato a GLS né approvato da GLS.