VibeFox LP Express 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.

LP Express: non serve un account API. LP Express non ha un'API pubblica dei prezzi. L'API Unisend è disponibile solo per i clienti con contratto e non viene usata da questo plugin, quindi inserisci i tuoi prezzi (contrattuali). Crea i pacchi nel tuo account Unisend ("Mano siuntos").

Elenco dei terminal pacchi: il plugin usa l'elenco pubblico dei terminal LP Express, lo stesso usato dai vecchi plugin LP Express. Alla data della versione 1.1.0 questo elenco online non era disponibile. Finché non lo è, il plugin usa l'ultima copia scaricata se disponibile, altrimenti il tuo elenco personale. Tieniti pronto a inserire il tuo elenco (vedi Configurazione).

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su 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_lp_express in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox LP Express, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

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

5. Compila la tabella dei prezzi (almeno una riga) o un costo di riserva. Controlla la riga di stato sui terminal pacchi in cima alla pagina e aggiungi il tuo elenco di terminal se l'elenco online non è disponibile.

6. Aggiungi VibeFox LP Express alla tua zona Lituania 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 LP Express. 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 che i clienti vedono per questa zona. Lascialo vuoto per usare il Method title globale.

In cima alla pagina, gli avvisi mostrano i problemi e lo stato dei terminal. Un avviso rosso compare quando non è impostato alcun prezzo o non è disponibile alcun terminal pacchi, perché in quel caso il metodo non viene mostrato al checkout. Una riga informativa mostra quanti terminal pacchi in quante città sono disponibili e da quale fonte: l'elenco online, una copia salvata dell'elenco online (con la sua data) o il tuo elenco personale.

Generale

Enable/Disable: attiva o disattiva LP Express in tutte le zone contemporaneamente.

Method title: il nome del metodo di spedizione mostrato ai clienti. Il titolo di un metodo di zona lo sostituisce. Predefinito: LP Express parcel terminal.

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

Prezzi (nella valuta del tuo negozio; i decimali possono essere scritti come 2.99 o 2,99)

Price table: una riga per ogni paese di destinazione. Fai clic su + Add country per aggiungere una riga e sulla croce (×) per rimuoverla. Scegli * Any other country per ogni paese senza una riga propria. Ogni riga ha un Base price e colonne di peso: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) e XL (>5 kg). Il peso è quello del carrello, oppure quello di un articolo con Per item. Una colonna vuota usa il prezzo base della riga. 0 significa gratis. I prezzi che non sono numeri vengono segnalati dopo il salvataggio e lasciati vuoti.

Fallback cost: usato quando la tabella dei prezzi non ha una riga per il paese di destinazione. Lascialo vuoto per nascondere il metodo in quei paesi.

Calculation: come viene calcolato il prezzo.

Free shipping from: il totale del carrello (dopo gli sconti, come mostrato nel carrello) da cui LP Express è gratuito. Lascialo vuoto per nessuna spedizione gratuita.

Disponibilità

Minimum weight (kg): nasconde il metodo quando il carrello è più leggero. Vuoto o 0 significa nessun limite.

Maximum weight (kg): nasconde il metodo quando il carrello è più pesante. I terminal LP Express accettano pacchi fino a 30 kg. Predefinito: 30. 0 significa nessun limite.

Minimum cart total: mostra il metodo solo a partire da questo totale del carrello. Lascialo vuoto per mostrarlo sempre.

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

Ignore shipping zones: offre LP Express per i paesi indicati sotto senza aggiungerlo a una zona. Quando è disattivato, i paesi sono definiti dalle zone di spedizione in cui è aggiunto il metodo. È consigliato.

Countries (without zones): i paesi di destinazione per questa modalità. Questo campo viene usato solo quando Ignore shipping zones è attivo. Lascialo vuoto per offrire il metodo per qualsiasi destinazione.

Terminal pacchi

Terminal list: da dove provengono i terminal.

Own terminal list: un terminal per riga nel formato ID | Name | City | Address | ZIP, per esempio 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID e City sono obbligatori. Le righe che iniziano con # vengono ignorate. Usa gli ID dei terminal che si aspetta il tuo account Unisend.

Il salvataggio delle impostazioni ricarica l'elenco dei terminal.

Avanzate

Debug log: registra il calcolo dei prezzi e i dettagli dell'elenco dei terminal in WooCommerce > Status > Logs (origine vfd-lp-express). Gli errori, come un elenco di terminal non disponibile, vengono sempre registrati. Non viene registrato alcun dato dei clienti.

Remove data on uninstall: se attivo, eliminando il plugin vengono rimosse le impostazioni, i metodi di zona e i terminal in cache. La disattivazione del plugin non elimina mai le impostazioni. Il terminal salvato negli ordini viene conservato.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin controlla il peso del carrello, il totale minimo del carrello e le classi di spedizione escluse. Se non è disponibile alcun terminal pacchi, il metodo viene nascosto, così il cliente non vede mai un checkout che non si può completare. Se si applica la spedizione gratuita, il prezzo è 0. Altrimenti il prezzo viene dalla riga del paese (o dalla riga *): la colonna di peso, altrimenti il prezzo base, altrimenti il costo di riserva. Se non c'è alcun prezzo, il metodo viene nascosto.

L'elenco online dei terminal viene memorizzato nella cache per 24 ore. Un download fallito viene ricordato per 15 minuti, così il checkout non attende l'elenco a ogni aggiornamento. Il timeout del download è di 10 secondi. Vengono offerti solo i terminal attivi dell'elenco.

Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con WooCommerce High-Performance Order Storage (HPOS). I prezzi sono nella valuta del tuo negozio. Il plugin non converte le valute.

Il plugin non richiede prezzi a LP Express o Unisend, non crea spedizioni, non stampa etichette, non chiama un corriere e non traccia i pacchi. Crea i pacchi nel tuo account Unisend ("Mano siuntos"). La consegna a domicilio (porta a porta) non fa parte di questo metodo.

Punti di ritiro

Quando il cliente seleziona LP Express, sotto il metodo compaiono due elenchi: -- Select city -- e -- Select parcel terminal --. La città dell'indirizzo di spedizione viene preselezionata quando corrisponde a una città dell'elenco. Ogni terminal viene mostrato con nome, indirizzo e CAP. La scelta viene ricordata durante il checkout, quindi non si perde quando il checkout si aggiorna.

Un terminal è obbligatorio. Nel checkout classico il cliente vede Please select an LP Express parcel terminal. Nel checkout a blocchi, Place order è bloccato finché non viene scelto un terminal. In entrambi i checkout il server verifica di nuovo il terminal con l'elenco, quindi un ID terminal falsificato o non aggiornato viene rifiutato.

L'ID, il nome e la città del terminal vengono salvati nell'ordine. Sono mostrati nella schermata dell'ordine sotto l'indirizzo di spedizione (con l'ID del terminal), nella pagina di ordine ricevuto, in My account > Orders e nelle e-mail dell'ordine (HTML e testo semplice) come LP Express parcel terminal.

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 LP Express. 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 su un solo dominio. Rimuovere la chiave da un sito non libera il suo posto per il dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, LP Express non viene mostrato ai clienti al checkout. I gestori del negozio che hanno effettuato l'accesso lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare il plugin prima di acquistare una chiave. Sulla pagina Plugin e sulle pagine di WooCommerce compare un promemoria. Gli ordini esistenti non sono interessati.

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

Risoluzione dei problemi

LP Express non compare 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). Apri la pagina delle impostazioni: un avviso rosso spiega se non è impostato alcun prezzo o non è disponibile alcun terminal pacchi. Controlla anche i limiti di peso, il Minimum cart total e le Excluded shipping classes. Con Debug log attivo, WooCommerce > Status > Logs (origine vfd-lp-express) mostra perché il metodo è stato nascosto.

Nessun terminal pacchi: l'elenco online non è stato caricato e non c'è una copia salvata né un elenco personale. Il plugin riprova ogni 15 minuti. Inserisci il tuo elenco in Own terminal list, oppure scegli Only my own list.

L'elenco dei terminal è obsoleto: salva la pagina delle impostazioni. Questo ricarica l'elenco dei terminal. Con il tuo elenco personale, aggiorna tu le righe.

Il cliente non riesce a completare l'ordine: deve essere scelto un terminal pacchi. Se il cliente vede "The LP Express parcel terminal list is temporarily unavailable", al momento non ci sono terminal disponibili. Aggiungi il tuo elenco.

In quale valuta sono i prezzi: nella valuta del tuo negozio. Il plugin non converte le valute.

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 mantiene tutte le impostazioni. Viene cancellato solo l'elenco dei terminal in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugin. La chiave di licenza e lo stato della licenza di questo plugin e le cache vengono sempre rimossi. Impostazioni, metodi di zona e la copia salvata dell'elenco dei terminal vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una reinstallazione futura. Il terminal salvato negli ordini non viene mai eliminato, e gli ordini esistenti mantengono le loro righe di spedizione.

LP Express è un marchio di proprietà del rispettivo titolare. Questo plugin non è affiliato né approvato da LP Express.