VibeFox Omniva 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.

Omniva: non serve un account API. Omniva non dispone di un'API pubblica dei prezzi. L'API OMX di Omniva è disponibile solo ai clienti con contratto e questo plugin non la usa, quindi inserisci le tue tariffe (contrattuali). Registra i pacchi nel tuo account business Omniva.

Parcel machine list: il plugin scarica il file aperto delle sedi Omniva da omniva.ee (non servono chiave né contratto). Il tuo server deve poter effettuare richieste HTTPS in uscita verso www.omniva.ee.

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_omniva in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Omniva, 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 (vedi Chiave di licenza).

5. Controlla i prezzi per paese e formato del pacco, i formati dei pacchi e la riga di stato Parcel machine list.

6. Aggiungi VibeFox Omniva alla zona Estonia, Lettonia e/o Lituania in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones e scegli i paesi.

Configurazione

Tutte le impostazioni sono in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Omniva. 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 il cliente vede per questa zona. Lascialo vuoto per usare il Method title generale.

In cima alla pagina, degli avvisi segnalano i problemi. Un avviso rosso compare quando non è impostato alcun prezzo oppure quando l'elenco dei punti di ritiro non può essere scaricato e non esiste una copia memorizzata: in tal caso il metodo non viene mostrato al checkout. Un avviso giallo compare quando l'elenco non può essere aggiornato in questo momento e viene usata la copia memorizzata. I numeri che non possono essere letti vengono segnalati dopo il salvataggio e non vengono salvati.

Generali

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

Method title: il nome del metodo di spedizione mostrato ai clienti. Il Title di un metodo di zona lo sostituisce. Predefinito: Omniva parcel machine.

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

Prezzi (nella valuta del tuo negozio; i decimali possono essere scritti come 3.50 o 3,50)

Price by parcel size: una riga per ciascun paese (Estonia, Lettonia e Lituania), con le colonne S, M, L, XL e Free from. Inserisci il prezzo di ogni formato di pacco Omniva per il paese di destinazione. Una cella vuota significa che quel formato non è offerto per il paese: il metodo viene nascosto quando il pacco ne ha bisogno. 0 significa gratuito. Free from è il totale del carrello (dopo gli sconti, come mostrato nel carrello) da cui la consegna in quel paese è gratuita; lascialo vuoto se non ci sono spedizioni gratuite. Finché non salvi i tuoi prezzi, la tabella parte da 3.50 per l'Estonia e 4.00 per Lettonia e Lituania. Quando le tasse di WooCommerce sono attive, un piccolo pulsante -% accanto a ogni prezzo toglie dal prezzo inserito l'IVA del paese del tuo negozio (per i prezzi che conosci IVA inclusa).

Calculation: come vengono determinati il formato del pacco e il prezzo.

Parcel sizes (cm): le dimensioni massime di ogni formato, come Smallest side, Middle side e Largest side. Le dimensioni del prodotto vengono ordinate allo stesso modo e confrontate affiancate; i valori vengono ordinati al salvataggio. Le dimensioni del prodotto vengono convertite dall'unità del negozio in cm. I prodotti senza dimensioni rientrano nel formato S. Se nessun formato va bene, il metodo viene nascosto. Valori predefiniti: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Verificali con i formati attuali di Omniva.

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 (o, con Per item, un articolo) è più pesante. I punti di ritiro Omniva accettano pacchi fino a 30 kg. Predefinito: 30. 0 significa nessun limite. L'unità di peso del negozio viene convertita in kg.

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

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

Ignore shipping zones: offre Omniva per i paesi indicati sotto senza aggiungerlo a una zona. Quando è disattivato, i paesi sono definiti dalle zone di spedizione a cui è aggiunto il metodo. Si consiglia di lasciarlo disattivato.

Countries (without zones): i paesi di destinazione per questa modalità. Questo campo viene usato solo quando Ignore shipping zones è attivo. Lascialo vuoto per tutti i paesi di spedizione. In ogni modalità Omniva viene offerto solo dove ha punti di ritiro: Estonia, Lettonia e Lituania.

Punti di ritiro

Post offices: offre anche gli uffici postali Omniva nello stesso elenco. Omniva elenca gli uffici postali per l'Estonia. Disattivato per impostazione predefinita.

City order: mostra prima le città più grandi (Tallinn, Riga, Vilnius e altre), poi le restanti in ordine alfabetico. Attivo per impostazione predefinita. Quando è disattivato, le città sono ordinate alfabeticamente.

Parcel machine list: una riga di stato con il numero di punti di ritiro per paese (e di uffici postali, se attivati) e l'ora dell'ultimo download da omniva.ee. Fai clic su Update the list now per scaricare subito l'elenco; se omniva.ee non risponde, si mantiene la copia memorizzata.

Avanzate

Debug log: registra i dettagli del calcolo dei prezzi e dell'elenco dei punti di ritiro in WooCommerce > Status > Logs (origine vfd-omniva). Gli errori, come un elenco di punti di ritiro non disponibile, vengono sempre registrati. Nessun dato dei clienti viene registrato.

Remove data on uninstall: quando è attivo, eliminando il plugin vengono rimosse le impostazioni, i metodi di zona e l'elenco memorizzato dei punti di ritiro. Disattivare il plugin non elimina mai le impostazioni. Il punto di ritiro salvato negli ordini viene conservato.

Come funziona al checkout

Quando il cliente inserisce un indirizzo di consegna in Estonia, Lettonia o Lituania, WooCommerce chiede al plugin una tariffa. Il plugin verifica il peso del carrello, il totale minimo e le classi di spedizione escluse, poi determina il formato del pacco dalle dimensioni del prodotto. Se il pacco non rientra in nessun formato, o il formato non ha un prezzo per il paese, o non è disponibile alcun punto di ritiro, il metodo viene nascosto, così il cliente non vede mai un checkout che non si può completare. Se il totale del carrello raggiunge il Free from del paese, il prezzo è 0. Il formato del pacco viene salvato nella riga di spedizione dell'ordine come Omniva parcel size.

L'elenco dei punti di ritiro viene scaricato da omniva.ee una volta al giorno e memorizzato nel database di WordPress, non nella cartella del plugin. Se il download fallisce, la copia memorizzata continua a funzionare e il tentativo successivo viene fatto dopo 15 minuti, così il checkout non attende omniva.ee a ogni aggiornamento. Il timeout del download è di 15 secondi.

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 i prezzi a Omniva, non registra spedizioni, non stampa etichette, non chiama un corriere né traccia i pacchi. Registra i pacchi nel tuo account business Omniva. La consegna a domicilio tramite corriere non fa parte di questo metodo.

Punti di ritiro

Quando il cliente seleziona Omniva, sotto il metodo compaiono due elenchi: -- Select city -- e -- Select parcel machine --. Vengono mostrate solo le città e i punti di ritiro del paese di consegna; quando il cliente cambia paese, cambiano anche gli elenchi. In Estonia le città sono contee, e Tallinn, Tartu e Pärnu compaiono separatamente; in Lettonia e Lituania sono città e comuni. La città dell'indirizzo di spedizione viene preselezionata quando corrisponde a una città dell'elenco. Ogni punto di ritiro è mostrato con il nome e l'indirizzo. La scelta viene ricordata durante il checkout, quindi non si perde quando il checkout si aggiorna.

Il punto di ritiro è obbligatorio. Nel checkout classico il cliente vede Please select an Omniva parcel machine. Nel checkout a blocchi Place order è bloccato finché non viene scelto un punto di ritiro. In entrambi, il server verifica di nuovo il punto di ritiro rispetto all'elenco, quindi un ID contraffatto o un punto di un altro paese viene rifiutato.

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

Per cambiare il punto di ritiro di un ordine, apri l'ordine in WooCommerce > Orders, fai clic su Change accanto al punto di ritiro, scegli una città e un punto di ritiro del paese di consegna dell'ordine, poi fai clic su Save parcel machine. Una nota dell'ordine registra il punto precedente e quello nuovo.

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 Omniva. 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 sul dominio. Liberalo dal tuo account vibefox.net.

Senza una chiave attiva, Omniva non viene mostrato ai clienti al checkout. I gestori del negozio connessi lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e provare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin 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

Omniva non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che il paese di consegna sia Estonia, Lettonia o Lituania 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 se non è disponibile alcun elenco di punti di ritiro. Controlla anche le dimensioni dei prodotti (un pacco più grande del formato XL, o un formato con una cella di prezzo vuota, nasconde il metodo), i limiti di peso, il Minimum cart total e le Excluded shipping classes. Con Debug log attivo, WooCommerce > Status > Logs (origine vfd-omniva) mostra perché il metodo è stato nascosto.

Nessun punto di ritiro: l'elenco non è stato scaricato da omniva.ee e non esiste una copia memorizzata. Il plugin riprova ogni 15 minuti. Fai clic su Update the list now; se fallisce, verifica che il tuo server riesca a raggiungere www.omniva.ee e controlla l'errore in WooCommerce > Status > Logs.

Manca un nuovo punto di ritiro: l'elenco viene aggiornato una volta al giorno. Fai clic su Update the list now per scaricarlo subito.

Viene addebitato il prezzo sbagliato: il prezzo dipende dal formato del pacco determinato dalle dimensioni del prodotto. Controlla le dimensioni dei prodotti, Calculation e Parcel sizes (cm). Con Debug log attivo, il registro mostra il formato scelto e il prezzo.

Il cliente non può completare l'ordine: è necessario scegliere un punto di ritiro. Se il cliente vede il messaggio «The Omniva parcel machine list is temporarily unavailable», in questo momento non ci sono punti di ritiro disponibili; vedi «Nessun punto di ritiro».

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

Per gli sviluppatori: il filtro vfd_omniva_locations_url modifica l'indirizzo del file delle sedi (CSV nel formato Omniva), e vfd_omniva_countries modifica l'elenco dei paesi di destinazione (predefinito EE, LV, LT).

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 e l'elenco memorizzato dei punti di ritiro. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza, lo stato della licenza e le cache di questo plugin vengono sempre rimossi. Impostazioni, metodi di zona ed elenco memorizzato dei punti di ritiro vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano disponibili per una reinstallazione successiva. Il punto di ritiro salvato negli ordini non viene mai eliminato, e gli ordini esistenti mantengono le proprie righe di spedizione.

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