VibeFox GIG Logistics for WooCommerce — Guida

Requisiti

WordPress: 5.8 o successivo.

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

PHP: 8.0 o successivo.

Credenziali API di GIG Logistics (solo per le tariffe in tempo reale): le tariffe in tempo reale usano l'API di terze parti di GIG Logistics. GIG Logistics rilascia ai clienti business un nome utente API (di solito un indirizzo e-mail) e una password. Richiedili nella pagina per sviluppatori di GIG Logistics (giglogistics.com/developer). Le credenziali di test funzionano solo con l'API di test. Se usi solo la tabella tariffe e il costo di riserva, non ti servono credenziali API.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona per un solo 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_gig_logistics in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox GIG Logistics, 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 alto nella pagina e fai clic su Activate.

5. Compila la tabella tariffe e/o il costo di riserva. Per le tariffe in tempo reale, inserisci anche nome utente e password API, il telefono del mittente, la città e lo stato di ritiro, e il tasso di conversione valutaria se la valuta del tuo negozio non è NGN (vedi Configurazione).

6. Aggiungi VibeFox GIG Logistics a una zona di spedizione per la Nigeria in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones e scegli i paesi.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox GIG Logistics. Si applicano a tutte le zone di spedizione. Quando aggiungi il metodo a una zona, la finestra della zona ha un solo campo:

Title (zone): il nome che i clienti vedono per questa zona. Lascialo vuoto per usare il Method title globale.

Sopra i campi, la pagina mostra avvisi quando le tariffe in tempo reale non possono essere usate: è inserito solo uno tra nome utente e password API, mancano Sender phone o la città e lo stato di ritiro, oppure la valuta del negozio non è NGN e non è impostato un Currency conversion rate. Ogni volta che salvi le impostazioni, le tariffe e i token API in cache vengono cancellati.

General

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

Method title: il nome del metodo di spedizione mostrato nel carrello e nel checkout. Predefinito: GIG Logistics. Il titolo di una zona lo sostituisce.

Tax status: Taxable aggiunge l'imposta di spedizione del negozio alla tariffa, None non la aggiunge. Scegli None se la tariffa GIG include già tutto ciò che vuoi far pagare.

API GIG Logistics (tariffe in tempo reale) (facoltativo)

Con le credenziali API, la tariffa viene richiesta a GIG Logistics per ogni indirizzo in Nigeria. Senza credenziali, o quando l'API non restituisce una tariffa, vengono usate la tabella tariffe e il costo di riserva.

API username: il tuo nome utente API di terze parti di GIG Logistics, di solito il tuo indirizzo e-mail.

API password: la tua password API di terze parti di GIG Logistics. Viene usata solo per accedere all'API e non viene mai registrata.

Test mode: usa l'API di test (dev) di GIG Logistics. Le credenziali di test funzionano solo con l'API di test. Disattivalo per avere tariffe reali. Predefinito: disattivato.

Currency conversion rate: GIG Logistics restituisce le tariffe in NGN. Se la valuta del tuo negozio non è NGN, inserisci quanto vale un NGN nella valuta del tuo negozio (1 NGN = ? della tua valuta, per esempio 0.0006). Senza di esso, le tariffe GIG in tempo reale non vengono usate. Se la valuta del negozio è NGN, questo campo non serve. Sono accettati sia il punto sia la virgola come separatore decimale.

Indirizzo di ritiro (mittente)

Dove GIG Logistics ritira i pacchi, in Nigeria. Se il tuo negozio si trova in Nigeria, i campi di via, città e stato lasciati vuoti usano l'indirizzo del negozio da WooCommerce > Settings > General.

Sender name: il nome del mittente inviato a GIG Logistics. Se vuoto, viene usato il nome del sito.

Sender phone: il tuo numero di telefono, per esempio 08030000000. GIG Logistics lo richiede per le tariffe in tempo reale.

Street address: l'indirizzo di via del ritiro.

City / area: la città o la zona del ritiro, per esempio Victoria Island. Obbligatorio per le tariffe in tempo reale.

State: lo stato nigeriano dell'indirizzo di ritiro. Per impostazione predefinita si usa lo stato del negozio. Obbligatorio per le tariffe in tempo reale.

Pickup latitude: latitudine facoltativa del punto di ritiro sulla mappa, per esempio 6.4281. GIG Logistics calcola la tariffa in base alla distanza. Se vuoto, le coordinate vengono ricavate dall'indirizzo.

Pickup longitude: longitudine facoltativa del punto di ritiro sulla mappa, per esempio 3.4219.

Address lookup: trova le coordinate sulla mappa degli indirizzi con OpenStreetMap (Nominatim). GIG Logistics calcola la tariffa dalle coordinate di ritiro e consegna. La via, la città e lo stato del cliente vengono inviati a nominatim.openstreetmap.org, e i risultati sono in cache per 30 giorni. Senza questa opzione viene inviato solo il testo dell'indirizzo e GIG Logistics potrebbe non restituire una tariffa. Predefinito: attivo.

Tabella tariffe e costo di riserva

Usata per gli altri paesi, quando le tariffe in tempo reale non sono configurate o quando GIG Logistics non restituisce una tariffa. Le tariffe sono nella valuta del tuo negozio.

Country prices: una tabella con una tariffa base per paese. Fai clic su Add country per aggiungere una riga e sulla croce per rimuoverne una. Scegli * Any other country per tutti i paesi senza una riga propria. Le colonne XS (fino a 1 kg), S (fino a 2 kg), M (fino a 3 kg), L (fino a 5 kg) e XL (oltre 5 kg) sono tariffe facoltative per fascia di peso: una tariffa di fascia superiore a 0 sostituisce la tariffa base per i carrelli di quella fascia. Una tariffa di 0 significa spedizione gratuita. Le celle delle tariffe vuote vengono salvate come 0, quindi compila la tariffa base per ogni riga che aggiungi. I paesi senza riga (quando non c'è una riga *) non ricevono una tariffa da tabella.

Fallback cost: usato quando né GIG Logistics né la tabella forniscono una tariffa. Se vuoto, in quel caso il metodo viene nascosto.

Table / fallback price is: Per order addebita la tariffa una sola volta. Per item (multiplied by the number of items) la moltiplica per il numero di articoli nel carrello. Le tariffe GIG in tempo reale riguardano sempre l'intero ordine.

Condizioni

Free shipping from: il subtotale del carrello da cui la spedizione è gratuita. Se vuoto, non è mai gratuita.

Minimum subtotal: mostra il metodo solo quando il subtotale del carrello raggiunge questo importo. Se vuoto, è sempre mostrato.

Min weight (kg): il peso minimo del carrello in kg. I pesi dei prodotti vengono convertiti dall'unità di peso del negozio. 0 significa nessun limite.

Max weight (kg): il peso massimo del carrello in kg. Predefinito: 30. 0 significa nessun limite.

Excluded shipping classes: nasconde il metodo se il carrello contiene prodotti di queste classi di spedizione di WooCommerce.

Disponibilità senza zone di spedizione

Ignore shipping zones: offre il metodo per i paesi indicati sotto, anche se non è aggiunto a una zona. Quando è disattivato, il metodo appare solo nelle zone di spedizione a cui è stato aggiunto.

Countries: i paesi di destinazione per questa modalità. Se vuoto, si usano tutti i paesi in cui spedisci. Usato solo con Ignore shipping zones.

Avanzate

Debug log: registra i calcoli delle tariffe in WooCommerce > Status > Logs, origine vfd-gig-logistics. Gli errori API vengono sempre registrati, anche con il log disattivato. Non vengono scritti password, token o indirizzi dei clienti.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le sue impostazioni, i metodi di zona e le cache. Disattivare il plugin non cancella mai nulla.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin verifica prima le condizioni: paese di consegna, peso del carrello, subtotale minimo e classi di spedizione escluse. Se il subtotale raggiunge Free shipping from, il metodo viene mostrato con tariffa 0, ma solo se il paese ha una tariffa: una riga in Country prices, un Fallback cost o una tariffa GIG Logistics in tempo reale. GIG Logistics viene interrogata solo quando la tabella e il costo di riserva non forniscono una tariffa.

Poi la tariffa viene presa dalla prima fonte che ne fornisce una. Prima la tariffa GIG Logistics in tempo reale, se sono inserite le credenziali API, l'indirizzo è in Nigeria, il cliente ha inserito una città o uno stato, il telefono, la città e lo stato di ritiro sono impostati e per i negozi non in NGN è impostato un tasso di conversione. Il plugin accede all'API di GIG Logistics e invia gli indirizzi e le coordinate di ritiro e consegna, e gli articoli del carrello con nome, quantità, peso e valore. I prodotti senza peso vengono inviati come 1 kg. La tariffa viene richiesta per la consegna in bike. Secondo, la tabella Country prices. Terzo, il Fallback cost. Se nessuna fonte fornisce una tariffa, il metodo viene nascosto per quel carrello.

Ogni risposta di GIG è in cache per 1 ora, così lo stesso carrello non attiva una nuova richiesta. Una richiesta o un accesso non riusciti sono in cache per 10 minuti, così il checkout non attende GIG Logistics a ogni aggiornamento. Il token di accesso viene conservato per 30 minuti e rinnovato automaticamente quando GIG lo rifiuta. Il timeout dell'API è di 10 secondi, quello della ricerca degli indirizzi di 5 secondi.

Se GIG Logistics restituisce un errore o una tariffa pari a zero, il cliente non vede alcun errore. Viene usata la tariffa della tabella o il costo di riserva, e l'errore viene scritto nel log.

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

Il plugin calcola solo le tariffe. Non crea spedizioni, documenti di trasporto o etichette GIG Logistics, non prenota ritiri, non traccia i pacchi e non permette ai clienti di scegliere un centro di servizio. Gli ordini vengono spediti tramite il tuo account GIG Logistics come al solito. Le tariffe in tempo reale vengono richieste solo per indirizzi in Nigeria. Per gli altri paesi, usa la tabella tariffe.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in alto in WooCommerce > Settings > Shipping > VibeFox GIG Logistics. 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 link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona per un solo 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, GIG Logistics non viene mostrata ai clienti nel checkout. I gestori del negozio che hanno effettuato l'accesso la vedono ancora, contrassegnata con (unlicensed — visible to admins only), 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

GIG Logistics non compare nel checkout: verifica 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). Controlla i limiti di peso, Minimum subtotal e Excluded shipping classes. Verifica che la tabella (il paese o *) o il Fallback cost forniscano una tariffa per il paese.

La tariffa arriva dalla tabella, non da GIG Logistics: le tariffe in tempo reale richiedono nome utente e password API, Sender phone, città e stato di ritiro, un indirizzo di consegna in Nigeria con città o stato e, per i negozi non in NGN, il Currency conversion rate. Controlla gli avvisi in alto nella pagina delle impostazioni. Attiva il Debug log, ricarica il checkout e apri WooCommerce > Status > Logs, origine vfd-gig-logistics, per vedere il motivo. Una richiesta non riuscita viene ritentata dopo 10 minuti.

Login failed nel log: GIG Logistics ha rifiutato il nome utente o la password API. Controllali e verifica Test mode: le credenziali di test funzionano solo con l'API di test. Salva le impostazioni per riprovare subito.

GIG Logistics non restituisce una tariffa: GIG calcola le tariffe in base alla distanza. Tieni attivo Address lookup oppure inserisci Pickup latitude e Pickup longitude. Conferma le tariffe con il tuo account GIG Logistics prima di andare in produzione.

L'imposta viene aggiunta sopra la tariffa GIG: imposta Tax status su None se la tariffa GIG include già tutto ciò che vuoi far pagare.

Le tariffe sembrano obsolete dopo una modifica: salva la pagina delle impostazioni. Questo cancella le tariffe e i token in cache.

Geocoder personalizzato: gli sviluppatori possono fornire una propria ricerca di indirizzi con il filtro vfd_gigl_pre_geocode.

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

Disattivare il 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. Impostazioni, metodi di zona, tariffe in cache, token e ricerche di indirizzi vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una futura reinstallazione. Gli ordini esistenti mantengono le proprie righe di spedizione.

GIG Logistics è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da GIG Logistics.