VibeFox LP Express for PrestaShop — Guida

Requisiti

PrestaShop: da 8.0 a 9.x.

PHP: 8.0 o successivo. Il modulo rifiuta di installarsi su versioni di PHP più vecchie.

LP Express: non serve un account API. LP Express non ha un'API pubblica dei prezzi e il modulo non usa l'API di Unisend, quindi inserisci le tue tariffe (contrattuali). Crea i pacchi nel tuo account Unisend ("Mano siuntos").

Elenco dei terminal pacchi: il modulo usa l'elenco pubblico dei terminal LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Non serve alcuna chiave. Se questo elenco online non è disponibile, il modulo usa l'ultima copia scaricata, se presente, altrimenti il tuo elenco personale. Tieniti pronto a inserire il tuo elenco (vedi Configurazione).

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

Installazione

1. Nel back office vai su Modules > Module Manager e clicca su Upload a module. Scegli il file ZIP del modulo.

2. Al termine del caricamento, clicca su Configure, oppure trova VibeFox LP Express più tardi nell'elenco dei moduli e clicca su Configure.

3. Incolla la tua chiave di licenza VibeFox in License key nel blocco licenza in cima alla pagina Configure e clicca su Activate (vedi Chiave di licenza).

4. Compila la tabella dei prezzi (almeno una riga) oppure il 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. Clicca su Save.

All'installazione il modulo crea il corriere LP Express parcel terminal con il testo dei tempi di consegna Delivery to an LP Express parcel terminal. Il corriere viene assegnato alla zona Lituania e a tutti i gruppi di clienti. Puoi aggiungere zone e modificare gruppi di clienti, tempi di consegna, logo e limiti di dimensione in Shipping > Carriers. Non impostare lì i prezzi: il prezzo proviene sempre dal modulo.

Configurazione

Tutte le impostazioni si trovano nella pagina del modulo: Modules > Module Manager > VibeFox LP Express > Configure. Ogni sezione ha il proprio pulsante Save, che salva l'intera pagina. Ogni salvataggio ricarica anche l'elenco dei terminal.

In cima alla pagina, degli avvisi mostrano i problemi e lo stato dei terminal. Compare un avviso quando non è impostato alcun prezzo o non è disponibile alcun terminal pacchi, perché in tal caso il corriere non viene mostrato al checkout; quando il corriere è stato eliminato; e quando l'unità di peso del negozio non è una di quelle riconosciute dal modulo (kg, g, lb, oz), perché in tal caso i pesi dei prodotti vengono letti come kg. 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) oppure il tuo elenco personale.

Quando salvi, un titolo del metodo vuoto o non valido come nome del corriere viene rifiutato con Enter a valid method title., e viene rifiutato anche un titolo di più di 64 caratteri. In entrambi i casi non viene salvato nulla. Un importo o un peso che non è un numero (o che è negativo) viene segnalato e viene mantenuto il valore precedente. Anche un Minimum weight (kg) superiore a Maximum weight (kg) (30 kg quando il massimo è vuoto) viene segnalato, perché il corriere non verrebbe mai mostrato, e entrambi i pesi mantengono i valori precedenti. I prezzi della tabella che non sono numeri vengono segnalati e lasciati vuoti.

Generale

Enable/Disable: attiva o disattiva LP Express. È lo stesso interruttore dello stato del corriere in Shipping > Carriers.

Method title: il nome del corriere mostrato ai clienti nel carrello e al checkout. Predefinito: LP Express parcel terminal. Obbligatorio.

Tax status: None significa che i prezzi sotto sono definitivi. Taxable con una regola fiscale (un'opzione per ogni regola fiscale del tuo negozio) significa che PrestaShop aggiunge quell'imposta di spedizione ai prezzi sotto. È la regola fiscale del corriere.

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

Price table: una riga per ogni paese di destinazione. Clicca su + Add country per aggiungere una riga e sull'icona del cestino per rimuoverla. Scegli * Any other country per tutti i paesi 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 il peso di un articolo con Per item. Una colonna vuota usa il prezzo base della riga. 0 significa gratuito.

Fallback cost: usato quando la tabella dei prezzi non ha una riga per il paese di destinazione. Lascia vuoto il campo per nascondere il corriere per questi paesi.

Calculation: come viene calcolato il prezzo.

Per order (tier by total cart weight): un prezzo per il carrello, con la colonna di peso scelta in base al peso totale del carrello. È l'opzione predefinita.

Per item (each item priced by its own weight x quantity): ogni prodotto viene prezzato in base al proprio peso e moltiplicato per la sua quantità, e i prezzi vengono sommati.

Free shipping from: il totale del carrello (prodotti che richiedono spedizione, dopo gli sconti, IVA esclusa) a partire dal quale LP Express è gratuito. Lascia vuoto per nessuna spedizione gratuita.

Disponibilità

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

Maximum weight (kg): nasconde il corriere quando il carrello è più pesante. I terminal LP Express accettano pacchi fino a 30 kg. Predefinito: 30. 0 significa nessun limite. Vuoto significa 30 kg nelle zone del corriere, e nessun limite solo per i paesi di Ignore shipping zones al di fuori di esse.

Minimum cart total: mostra il corriere solo a partire da questo totale del carrello (prodotti che richiedono spedizione, dopo gli sconti, IVA esclusa). Lascia vuoto per mostrarlo sempre.

Ignore shipping zones: offri LP Express per i paesi indicati di seguito senza impostare tu le zone. Il corriere viene allora collegato a ogni zona attiva (anche a quelle create in seguito). Le zone che il corriere aveva prima restano consentite per tutti i loro paesi. Quando disattivi di nuovo l'opzione, il corriere riottiene le zone che aveva prima. Quando è disattivata, i paesi sono definiti dalle zone del corriere in Shipping > Carriers. Questa modalità è consigliata.

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 corriere in tutti i paesi.

Terminal pacchi

Terminal list: da dove provengono i terminal.

LP Express online list: l'elenco online viene scaricato una volta al giorno. Quando non può essere caricato, si usa l'ultima copia scaricata, poi il tuo elenco personale qui sotto. È l'opzione predefinita.

Only my own list: vengono offerti solo i terminal che inserisci qui sotto.

Avanzate

Debug log: scrive i dettagli del calcolo dei prezzi e dell'elenco dei terminal in logs/vfd_lpex_debug.log.php, nella cartella del modulo. Il file non può essere aperto dal web. Gli errori, come un elenco di terminal non disponibile, vengono sempre registrati. Nessun dato del cliente viene registrato.

Log: mostra la dimensione e le ultime voci del registro. Clicca su Clear log per svuotarlo.

Remove data on uninstall: se attivo, disinstallando il modulo vengono eliminati le impostazioni, il corriere e l'elenco dei terminal salvato. Se disattivo, disinstallando si disattiva solo il corriere. Il terminal salvato negli ordini viene sempre conservato.

Come funziona al checkout

Nel passaggio di spedizione PrestaShop chiede al modulo il prezzo di LP Express. Contano solo i prodotti fisici: i prodotti virtuali non aggiungono peso e non sono inclusi nel totale del carrello. Il modulo verifica i paesi di Ignore shipping zones, il peso del carrello e il totale minimo del carrello. 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'è un prezzo, o non è disponibile alcun terminal pacchi, il corriere viene nascosto, così il cliente non vede mai un checkout che non si può completare.

Prezzi e importi sono nella valuta predefinita del tuo negozio. Il prezzo viene poi mostrato nella valuta del carrello del cliente, usando il tasso di cambio di PrestaShop.

L'elenco online dei terminal viene memorizzato nella cache per 24 ore. Un download non riuscito 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.

Se modifichi il corriere in Shipping > Carriers dopo che ha degli ordini, PrestaShop lo salva come una nuova versione del corriere. Il modulo segue automaticamente la nuova versione.

Il modulo 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 corriere.

Punti di ritiro

Quando il cliente seleziona LP Express, sotto il corriere compare il blocco LP Express parcel terminal con 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 salvata subito nel carrello, quindi non va persa quando il checkout si aggiorna. Funziona con i temi Classic e Hummingbird.

Un terminal è obbligatorio. Senza, Continue nel passaggio di spedizione e Place order mostrano Please select an LP Express parcel terminal. Quando il cliente clicca su Continue, il server verifica di nuovo il terminal nell'elenco, quindi un ID terminal falsificato o non aggiornato viene rifiutato con The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.

L'ID, il nome e la città del terminal vengono salvati con l'ordine. Sono mostrati nel blocco LP Express parcel terminal della pagina dell'ordine nel back office (con Terminal ID), nella pagina di conferma dell'ordine e nei dettagli dell'ordine del cliente. Nell'e-mail di conferma dell'ordine e nell'e-mail di nuovo ordine al commerciante vengono aggiunti al nome del corriere come LP Express parcel terminal: seguito dal terminal. Se un ordine non ha un terminal, la pagina dell'ordine nel back office mostra No parcel terminal was chosen for this order.

Chiave di licenza

Il modulo funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza License — VibeFox LP Express è il primo blocco di Modules > Module Manager > VibeFox LP Express > Configure, sopra le impostazioni. Incolla la chiave in License key e clicca 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 di essi ci sono la riga Product: presta-shipping-lp-express e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo i dipendenti con l'autorizzazione Configure per il modulo possono modificare la chiave. I testi del blocco seguono la lingua del back office (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco spiega 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 aver cambiato l'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, clicca su Check now. Se il server delle licenze non è raggiungibile, il modulo continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: il dominio del negozio principale, anche in una configurazione multistore. 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 corriere LP Express non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. La vetrina di PrestaShop non sa che hai effettuato l'accesso al back office, quindi il corriere viene nascosto anche a te: puoi configurare il modulo prima di acquistare una chiave, ma non puoi provarlo al checkout. Un promemoria compare in Modules > Module Manager, nella scheda Alerts. Gli ordini esistenti non vengono modificati.

Quando una licenza scade, il modulo continua a funzionare, ma gli aggiornamenti e l'assistenza richiedono un rinnovo. Lo stato viene ricontrollato automaticamente mentre lavori nel back office: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. Disinstallare o reimpostare il modulo rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

LP Express non compare al checkout: verifica che la licenza sia attiva e che Enable/Disable sia attivo. In Shipping > Carriers verifica che il corriere copra la zona del paese del cliente e il gruppo del cliente (oppure che Ignore shipping zones sia attivo e il paese sia consentito). Apri la pagina del modulo: un avviso spiega se non è impostato alcun prezzo o non è disponibile alcun terminal pacchi. Controlla anche i limiti di peso e il Minimum cart total. I prodotti possono anche essere limitati a determinati corrieri nella pagina del prodotto. Con Debug log attivo, il campo Log nella pagina del modulo mostra perché il corriere è stato nascosto.

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

L'elenco dei terminal è obsoleto: clicca su Save nella pagina del modulo. Questo ricarica l'elenco dei terminal. Con il tuo elenco personale, aggiorna tu le righe.

Il cliente non può proseguire: deve essere scelto un terminal pacchi. Se il cliente vede The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., al momento non ci sono terminal disponibili. Aggiungi il tuo elenco personale.

In quale valuta sono i prezzi: nella valuta predefinita del tuo negozio. I clienti che pagano in un'altra valuta vedono il prezzo convertito con il tasso di cambio di PrestaShop.

La pagina dice che il corriere LP Express non è stato trovato: il corriere è stato eliminato in Shipping > Carriers. Reimposta il modulo in Modules > Module Manager per ricrearlo.

Disinstallazione

Vai in Modules > Module Manager, apri il menu accanto a VibeFox LP Express e scegli Uninstall. La chiave di licenza e lo stato della licenza vengono sempre rimossi. L'elenco dei terminal in cache viene sempre cancellato. Se Remove data on uninstall è attivo, il corriere viene eliminato (gli ordini conservano la cronologia), e vengono rimosse le impostazioni, il registro e la copia salvata dell'elenco dei terminal. Se è disattivo, il corriere viene solo disattivato e tutte le impostazioni e la copia salvata vengono conservate. Reinstallare il modulo ridà al corriere salvato lo stato che aveva. Il terminal salvato negli ordini non viene mai eliminato.

LP Express è un marchio del rispettivo proprietario. Questo modulo non è affiliato a LP Express né da essa approvato.