VibeFox LP Express for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato su 3.0.5.0) o 4.0.2 e successive (testato su 4.1.0.3), con il tema predefinito e il checkout standard di OpenCart.

PHP: 8.0 o successivo.

LP Express: non serve un account API. LP Express non dispone di un'API pubblica dei prezzi e l'estensione non usa l'API di Unisend, quindi inserisci i tuoi prezzi (contrattuali). Crea i pacchi nel tuo account Unisend («Mano siuntos»).

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

Lituania: il paese deve essere attivato in System > Localisation > Countries.

Chiave di licenza VibeFox: acquistata 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. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto OpenCart 3 vfd_lp_express-oc3-(version).ocmod.zip e il pacchetto OpenCart 4 vfd_lp_express.ocmod.zip. Installa solo il pacchetto della tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file vfd_lp_express-oc3-(version).ocmod.zip. L'estensione non aggiunge modifiche OCMOD, quindi non devi aggiornare Extensions > Modifications. Al posto dell'Installer puoi copiare il contenuto della cartella upload del pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo di estensione Shipping. Trova VibeFox LP Express 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 nel campo License key del blocco licenza in cima alla pagina Edit e fai clic su Activate (vedi Chiave di licenza).

5. Compila la tabella dei prezzi (almeno una riga; la prima nuova riga è la Lituania) oppure un costo di riserva. Controlla la riga di stato sui terminal per pacchi in cima alla pagina e aggiungi il tuo elenco di terminal se l'elenco online non è disponibile. Attiva Enable/Disable e fai clic su Save.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file vfd_lp_express.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 LP Express, 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 ai passaggi 4 e 5 di OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni.

All'installazione, l'estensione crea due piccole tabelle (i terminal scelti e l'elenco dei terminal in cache) e registra i propri eventi OpenCart per il checkout e la pagina dell'ordine. Il metodo resta disattivato finché non attivi Enable/Disable e salvi. Se reinstalli l'estensione dopo una disinstallazione, vengono riutilizzate le impostazioni che hai conservato.

Configurazione

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

In cima alla pagina, gli avvisi segnalano i problemi e lo stato dei terminal. Compare un avviso quando non è impostato alcun prezzo o non è disponibile alcun terminal per pacchi, perché in tal caso il metodo non viene mostrato al checkout, e quando il negozio non ha una classe di peso con l'unità kg, perché allora i pesi dei prodotti vengono letti dal nome della loro unità (kg, g, lb, oz) e qualsiasi altra unità come kg. Una riga informativa mostra quanti terminal per 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.

Al salvataggio, un titolo del metodo vuoto o contenente uno dei caratteri < > ; = # { } viene rifiutato con Enter a valid method title., e viene rifiutato anche un titolo di più di 64 caratteri. Viene rifiutato anche un ordinamento che non sia un numero intero. In questi casi non viene salvato nulla. Un importo o un peso che non è un numero (o è negativo) viene segnalato e viene mantenuto il valore precedente. Anche un Minimum weight (kg) maggiore di Maximum weight (kg) (30 kg quando il massimo è vuoto) viene segnalato, perché il metodo non verrebbe mai mostrato; entrambi i pesi mantengono i valori precedenti. I prezzi della tabella che non sono numeri vengono segnalati e lasciati vuoti. Gli altri valori vengono salvati.

Generale

Enable/Disable: mostra o nasconde LP Express al checkout (lo stato di questa estensione). Predefinito: off.

Method title: il nome del metodo di spedizione mostrato ai clienti nel carrello e al checkout. Predefinito: LP Express parcel terminal. Obbligatorio, massimo 64 caratteri.

Tax class: --- None --- (predefinito) significa che i prezzi sotto sono definitivi. Con una classe fiscale, OpenCart aggiunge l'imposta sulla spedizione ai prezzi sotto.

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

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

Price table: una riga per paese di destinazione. Fai clic su Add country per aggiungere una riga e sul pulsante di rimozione per eliminarne una. Scegli * Any other country per ogni paese senza una riga propria. Ogni riga ha un Base price e colonne di peso: 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. Il peso è quello del carrello, oppure quello di un articolo con Per item. Una colonna vuota usa il prezzo base della riga. 0 significa gratuito. Una riga senza alcun prezzo non viene salvata.

Fallback cost: usato quando la tabella dei prezzi non ha una riga (o un prezzo) per il paese di destinazione. Lascialo vuoto per nascondere il metodo in quei 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 moltiplicato per la quantità, e i prezzi vengono sommati.

Free shipping from: il totale del carrello (prodotti che richiedono la spedizione, dopo gli sconti, al netto delle imposte) a partire dal quale LP Express è gratuito. Si applica prima della tabella dei prezzi, quindi copre anche i paesi senza una riga propria. Lascialo vuoto se non c'è 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. Vuoto significa 30 kg, oppure nessun limite quando Ignore shipping zones è attivo.

Minimum cart total: mostra il metodo solo a partire da questo totale del carrello (prodotti che richiedono la spedizione, dopo gli sconti, al netto delle imposte). Lascialo vuoto per mostrarlo sempre.

Geo zone: il metodo viene offerto solo per gli indirizzi in questa zona geografica. All Zones (predefinito) significa ovunque. Le zone geografiche si gestiscono in System > Localisation > Geo Zones. La zona geografica non viene verificata quando Ignore shipping zones è attivo.

Ignore shipping zones: offre LP Express per i paesi elencati sotto, qualunque sia la zona geografica. In questa modalità la zona geografica non viene verificata. Quando è disattivo, i paesi sono definiti dalla zona geografica. Questa opzione è consigliata. Predefinito: off.

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

Terminal per 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 storage/logs/vfd_lpex_debug.log.php (su OpenCart 4 system/storage/logs/vfd_lpex_debug.log.php). Il file non può essere letto dal web. Gli errori, come un elenco di terminal non disponibile o un ordine senza terminal, vengono sempre registrati. Nessun dato del cliente viene registrato. Quando il file raggiunge 5 MB, viene avviato un nuovo log.

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

Remove data on uninstall: se attivo, disinstallando l'estensione vengono eliminati le impostazioni, l'elenco dei terminal salvato, il log e i terminal dei checkout non completati. Se disattivo (predefinito), le impostazioni vengono conservate per una reinstallazione. Il terminal 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 vengono verificati come in un normale salvataggio.

Funzionamento al checkout

Quando OpenCart mostra i metodi di spedizione, chiede all'estensione il prezzo di LP Express. Se è impostata una Geo zone e l'indirizzo è al di fuori di essa, LP Express non viene offerto. Con Ignore shipping zones la zona geografica non viene verificata: LP Express viene offerto solo per i paesi elencati (tutti i paesi quando l'elenco è vuoto). Contano solo i prodotti con Requires Shipping impostato su Yes: gli altri prodotti non aggiungono peso e non sono inclusi nel totale del carrello. Il totale del carrello è il prezzo di questi prodotti dopo lo sconto del coupon e prima delle imposte. Buoni regalo, punti fedeltà e credito del negozio non vengono considerati.

L'estensione verifica 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 per pacchi, il metodo 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 arrotondato ai suoi decimali e mostrato al cliente nella sua valuta, con l'imposta della Tax class selezionata.

L'elenco online dei terminal viene messo in 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. I terminal senza città compaiono sotto Other.

Su OpenCart 4 il cliente fa clic su Choose nel blocco del metodo di spedizione della pagina di checkout e sceglie LP Express nella finestra Shipping method options. I prezzi sono gli stessi di OpenCart 3.

L'estensione 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 tramite corriere non fa parte di questo metodo.

Punti di ritiro

Quando il cliente seleziona LP Express nel passaggio del metodo di spedizione, sotto compare il blocco LP Express parcel terminal con due elenchi: -- Select city -- e -- Select parcel terminal --. L'elenco dei terminal viene caricato solo quando è selezionato LP Express. La città dell'indirizzo di consegna è preselezionata quando corrisponde a una città dell'elenco. Ogni terminal viene mostrato con nome, indirizzo e CAP. La scelta viene salvata subito per il checkout, quindi non si perde quando il checkout si aggiorna.

Il terminal è obbligatorio. Quando il cliente fa clic su Continue, il server verifica di nuovo il terminal rispetto all'elenco. Senza terminal, il checkout mostra Please select an LP Express parcel terminal. Un ID terminal contraffatto o obsoleto viene rifiutato con The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. Se non è possibile caricare alcun terminal, il cliente vede The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method.

Su OpenCart 4 il blocco LP Express parcel terminal con le due liste compare nella finestra Shipping method options, sotto l'opzione LP Express, quando il cliente la seleziona. Il pulsante Continue della finestra non procede senza un terminal valido, con gli stessi messaggi.

L'ID del terminal, il nome e la città vengono salvati con l'ordine. Il pannello LP Express parcel terminal nella pagina dell'ordine del pannello di amministrazione (Sales > Orders, informazioni dell'ordine) mostra la città, il terminal e il suo Terminal ID. Il metodo di spedizione dell'ordine mostra il titolo del metodo, i due punti, la città e il terminal (per esempio LP Express parcel terminal: Kaunas, …), così compare nei dettagli dell'ordine del cliente, nelle e-mail degli ordini e nella fattura. Se un ordine non ha un terminal, la pagina dell'ordine nel pannello di amministrazione mostra No parcel terminal was chosen for this order. Il pannello viene mostrato anche per gli ordini effettuati mentre l'estensione è disattivata. Su OpenCart 4 viene mostrato sopra History. OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna ogni volta che il cliente conferma di nuovo, e il terminal dell'ordine viene aggiornato insieme ad esso. Se il cliente passa quell'ordine a un altro metodo di spedizione, il suo terminal viene rimosso.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco di licenza License — VibeFox LP Express è il primo blocco di Extensions > Extensions > Shipping > VibeFox LP Express > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopo di ciò 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-lp-express e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua del pannello di 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 una modifica 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 dalla 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 LP Express non viene mostrato ai clienti al checkout e non viene calcolata alcuna tariffa. Un utente amministratore connesso al pannello di amministrazione nello stesso browser vede ancora il metodo nel negozio, contrassegnato come (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 dell'amministratore, quindi senza una chiave attiva il metodo è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard del pannello 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 del pannello di amministrazione o la pagina Edit: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. La disinstallazione dell'estensione 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. Controlla la Geo zone (oppure che Ignore shipping zones sia attivo e il paese sia consentito). Apri la pagina dell'estensione: un avviso spiega se non è impostato alcun prezzo o non è disponibile alcun terminal per pacchi. Controlla anche i limiti di peso e il Minimum cart total, e che i prodotti abbiano Requires Shipping impostato su Yes. Con Debug log attivo, il campo Log nella pagina dell'estensione mostra perché il metodo è stato nascosto.

Nessun terminal per pacchi: l'elenco online non è stato caricato e non esistono una copia salvata o un elenco personale. L'estensione riprova ogni 15 minuti. Inserisci il tuo elenco in Own terminal list, oppure scegli Only my own list.

L'elenco dei terminal è obsoleto: fai clic su Save nella pagina dell'estensione. Questo ricarica l'elenco dei terminal. Con il tuo elenco personale, aggiorna tu le righe.

Il cliente non può proseguire: è necessario scegliere un terminal per pacchi. Se il cliente vede il messaggio che l'elenco dei terminal non è temporaneamente disponibile, al momento non ci sono terminal disponibili. Aggiungi il tuo elenco personale.

Il selettore del terminal non compare: il selettore viene aggiunto al passaggio del metodo di spedizione del checkout standard di OpenCart (su OpenCart 4, nella finestra Shipping method options) ed è stato testato con il tema predefinito. Un tema molto modificato o un'estensione di checkout di terzi potrebbe non mostrarlo.

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 OpenCart.

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

Per gli sviluppatori: l'indirizzo dell'elenco dei terminal può essere sostituito con l'impostazione vfd_lpex_feed_url (per i test); 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 LP Express. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart ripristina sempre Enable/Disable, Sort order, Tax class e Geo zone. Gli eventi dell'estensione vengono sempre rimossi e l'elenco dei terminal in cache viene cancellato. Se Remove data on uninstall è attivo, vengono rimosse anche le impostazioni, il log, la copia salvata dell'elenco dei terminal e i terminal dei checkout non completati. Se è disattivo, le altre impostazioni e la copia salvata vengono conservate e riutilizzate quando reinstalli l'estensione. Il terminal salvato negli ordini non viene mai eliminato, e gli ordini esistenti conservano il terminal nel loro metodo di spedizione.

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 LP Express nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso del cestino) per rimuovere il pacchetto caricato.

LP Express è un marchio del suo legittimo proprietario. Questa estensione non è affiliata a LP Express né da essa approvata.