VibeFox SmartPost 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, con l'estensione SimpleXML (inclusa nella maggior parte delle installazioni di PHP).
SmartPost: non serve un account API né una chiave. L'elenco dei punti di ritiro proviene dall'elenco aperto dei luoghi SmartPost. SmartPost non ha un'API pubblica dei prezzi, quindi inserisci le tue tariffe (contrattuali). Crea le spedizioni nel tuo account business SmartPost (SmartPosti).
Paesi: i punti di ritiro SmartPost esistono in Estonia, Lettonia, Lituania e Finlandia. Per gli altri paesi di destinazione il metodo non viene mostrato.
Chiave di licenza VibeFox: si acquista 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_smartpost in /wp-content/plugins/ tramite FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox SmartPost, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.
4. Inserisci la tua chiave di licenza VibeFox nel blocco della licenza in cima alla pagina e fai clic su Activate.
5. Controlla la tabella dei prezzi (i prezzi predefiniti sono già compilati), le dimensioni delle scatole e lo stato dei punti di ritiro in cima alla pagina.
6. Aggiungi VibeFox SmartPost alla zona o alle zone con Estonia, Lettonia, Lituania e/o Finlandia 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 SmartPost. 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 generale.
In cima alla pagina, gli avvisi mostrano i problemi e lo stato dei punti di ritiro. Un avviso rosso compare quando non è impostato alcun prezzo, perché in quel caso il metodo non viene mostrato al checkout. Il blocco Pickup points available at checkout mostra, per ogni paese, quanti punti di ritiro sono disponibili e in quante città. Indica anche quando viene usata una copia salvata dell'elenco perché l'elenco SmartPost non è disponibile in questo momento, quando un paese non è stato caricato affatto e quando un paese non ha prezzi. Il pulsante Refresh pickup point lists now scarica di nuovo gli elenchi e mostra i nuovi numeri.
Generali
Enable/Disable: attiva o disattiva SmartPost 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: SmartPost parcel locker.
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 3.50 o 3,50)
Price table: una riga per ogni paese (Estonia, Lettonia, Lituania, Finlandia) con un prezzo per ogni dimensione di scatola S, M, L e XL, e una colonna Free from. 0 significa gratis. Una cella vuota significa che quella dimensione di scatola non è offerta: il metodo viene nascosto quando il pacco richiede quella scatola. Un paese con tutte le celle vuote non è servito. Free from è il totale del carrello da cui SmartPost è gratis in quel paese; lascialo vuoto se non c'è spedizione gratuita. I prezzi che non sono numeri vengono segnalati dopo il salvataggio e lasciati vuoti. Prezzi predefiniti: Estonia 3.50, Lettonia 4.00, Lituania 4.00, Finlandia 5.00 per ogni scatola.
Box sizes (cm): la dimensione interna di ogni scatola, con il lato più piccolo per primo (Side 1 (smallest), Side 2, Side 3 (largest)). I lati del prodotto vengono ordinati allo stesso modo e confrontati uno a uno, e viene usata la scatola più piccola che entra. I prodotti senza dimensioni entrano nella scatola S. Un pacco che non entra in nessuna scatola nasconde il metodo. Le dimensioni del prodotto vengono convertite dall'unità di misura del negozio. Valori predefiniti: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Le dimensioni che non sono numeri positivi vengono segnalate dopo il salvataggio e non vengono modificate.
Calculation: come viene calcolato il prezzo.
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. Predefinito: 25. 0 significa nessun limite.
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 WooCommerce.
Ignore shipping zones: offre SmartPost per i paesi indicati sotto senza aggiungerlo a una zona. Quando è disattivata, i paesi sono definiti dalle zone di spedizione in cui è stato aggiunto il metodo. È consigliata.
Countries (without zones): i paesi di destinazione per questa modalità, tra Estonia, Lettonia, Lituania e Finlandia. Questo campo viene usato solo quando Ignore shipping zones è attiva. Lascialo vuoto per offrire il metodo in tutti e quattro i paesi.
Punti di ritiro
Pickup point types: quali punti SmartPost può scegliere il cliente: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) e Posti post offices (Finland). Lascialo vuoto per offrire armadietti, box e punti di ritiro per pacchi (predefinito). Quali tipi esistono dipende dal paese: per esempio, la Lettonia ha solo box per pacchi, e gli uffici postali esistono solo in Finlandia.
City order: quando è attiva, le città principali vengono per prime (Tallinn, Riga, Vilnius, Helsinki e altre grandi città), poi le altre in ordine alfabetico. Quando è disattiva, tutte le città sono in ordine alfabetico.
Avanzate
Debug log: registra i dettagli del calcolo dei prezzi e dell'elenco dei punti di ritiro in WooCommerce > Status > Logs (origine vfd-smartpost). Gli errori, come un elenco di punti di ritiro non disponibile, vengono sempre registrati. Non viene registrato alcun dato dei clienti.
Remove data on uninstall: quando è attiva, eliminare il plugin rimuove le impostazioni, i metodi di zona e i punti di ritiro in cache. 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, WooCommerce chiede al plugin una tariffa. Il plugin funziona solo per Estonia, Lettonia, Lituania e Finlandia. Controlla il peso del carrello, il totale minimo del carrello e le classi di spedizione escluse, trova la scatola per il pacco e prende il suo prezzo dalla riga del paese di spedizione. Se la scatola non ha un prezzo, o se il pacco non entra in nessuna scatola, il metodo viene nascosto. Se il paese non ha punti di ritiro (l'elenco non è stato caricato e non esiste una copia salvata), il metodo viene nascosto anche in questo caso, così il cliente non vede mai un checkout che non può essere completato. Se il totale del carrello raggiunge il Free from del paese, il prezzo è 0.
L'elenco dei punti di ritiro di ogni paese viene memorizzato nella cache per 24 ore e viene conservata una copia dell'ultimo elenco valido. Un download non riuscito viene ricordato per 15 minuti, così il checkout non attende l'elenco a ogni aggiornamento. Il timeout del download è di 15 secondi. Grafie diverse della stessa città (per esempio Riga e Rīga) vengono mostrate come un'unica città.
Il metodo funziona con il checkout classico e con i blocchi Carrello e Checkout. È compatibile con l'archiviazione ad alte prestazioni degli ordini di WooCommerce (HPOS). I prezzi sono nella valuta del tuo negozio. Il plugin non converte le valute.
Il plugin non richiede i prezzi di SmartPost, non crea spedizioni, non stampa etichette, non chiama un corriere e non traccia i pacchi. Crea le spedizioni nel tuo account business SmartPost (SmartPosti). La consegna a domicilio tramite corriere (porta a porta) non fa parte di questo metodo, e non c'è una vista mappa.
Punti di ritiro
Quando il cliente seleziona SmartPost, sotto il metodo compaiono due elenchi: -- Select city -- e -- Select pickup point --. Gli elenchi appartengono sempre al paese di spedizione. Nel checkout classico è il paese dell'indirizzo di spedizione, oppure quello dell'indirizzo di fatturazione quando l'ordine non viene spedito a un indirizzo diverso; gli elenchi vengono ricostruiti quando cambia il paese. Nel checkout a blocchi gli elenchi seguono il paese dell'indirizzo di spedizione. La città dell'indirizzo di spedizione viene preselezionata quando corrisponde a una città dell'elenco. Ogni punto viene mostrato con nome e indirizzo. La scelta viene ricordata durante il checkout, quindi non si perde quando il checkout si aggiorna.
Un punto di ritiro è obbligatorio. Nel checkout classico il cliente vede Please select a SmartPost pickup point in the shipping country. Nel checkout a blocchi Place order è bloccato finché non viene scelto un punto. In entrambi i checkout il server verifica di nuovo il punto con l'elenco del paese di spedizione, quindi un ID di punto falsificato o non aggiornato, o un punto di un altro paese, viene rifiutato. Se l'elenco del paese è temporaneamente non disponibile, il cliente vede un messaggio e può scegliere un altro metodo di spedizione.
L'ID, il nome, la città e il paese del punto vengono salvati nell'ordine. Sono mostrati nella schermata dell'ordine sotto l'indirizzo di spedizione (con l'ID del luogo), nella pagina di ricezione dell'ordine, in My account > Orders e nelle e-mail dell'ordine (HTML e testo semplice) come SmartPost pickup point.
Per cambiare il punto di un ordine, apri l'ordine e fai clic su Change accanto a SmartPost pickup point. Scegli una città e un punto del paese di spedizione dell'ordine. Il nuovo punto viene salvato subito e 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 della licenza si trova in cima a WooCommerce > Settings > Shipping > VibeFox SmartPost. 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 posto del dominio. Liberalo nel tuo account vibefox.net.
Senza una chiave attiva, SmartPost non viene mostrato ai clienti al checkout. I gestori del negozio con l'accesso 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 Plugins e nelle pagine di WooCommerce. 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
SmartPost non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia attivo, che il paese di spedizione sia Estonia, Lettonia, Lituania o Finlandia, e che il metodo sia aggiunto alla zona del paese del cliente (oppure che Ignore shipping zones sia attiva e il paese sia consentito). Apri la pagina delle impostazioni: un avviso spiega se non è impostato alcun prezzo, se un paese non ha prezzi o se un paese non ha punti di ritiro. Controlla anche i limiti di peso, Minimum cart total, Excluded shipping classes e le dimensioni delle scatole: un pacco che non entra in nessuna scatola, o una scatola con una cella di prezzo vuota, nasconde il metodo. Con Debug log attivo, WooCommerce > Status > Logs (origine vfd-smartpost) mostra perché il metodo è stato nascosto.
Il cliente vede punti di un altro paese: gli elenchi seguono l'indirizzo di spedizione. Controlla quale paese è inserito nell'indirizzo di spedizione (o in quello di fatturazione, quando l'ordine non viene spedito a un indirizzo diverso). Un punto di un altro paese viene rifiutato al momento dell'ordine.
Nessun punto di ritiro per un paese: l'elenco SmartPost non è stato caricato e non esiste una copia salvata. Il plugin riprova ogni 15 minuti. Più tardi fai clic su Refresh pickup point lists now. Controlla anche che Pickup point types includa un tipo che esiste in quel paese.
L'elenco dei punti di ritiro è obsoleto: fai clic su Refresh pickup point lists now nella pagina delle impostazioni. Gli elenchi vengono comunque scaricati di nuovo ogni 24 ore.
Il cliente non riesce a completare l'ordine: deve essere scelto un punto di ritiro del paese di spedizione. Se il cliente vede "The SmartPost pickup point list is temporarily unavailable", in questo momento non ci sono punti disponibili di quel paese.
In quale valuta sono i prezzi: nella valuta del tuo negozio. Il plugin non converte le valute.
Per sviluppatori: il filtro vfd_smpt_places_url cambia l'URL dell'elenco dei luoghi per un paese (argomenti: URL, codice paese), per esempio per usare uno specchio che restituisce lo stesso XML.
Il blocco della licenza mostra un errore: segui il messaggio del 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. Vengono cancellati solo gli elenchi dei punti di ritiro in cache. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin, insieme alle cache, vengono sempre rimossi. Impostazioni, metodi di zona e copie salvate degli elenchi dei punti di ritiro vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una reinstallazione successiva. Il punto di ritiro salvato negli ordini non viene mai eliminato, e gli ordini esistenti conservano le loro righe di spedizione.
SmartPost e SmartPosti sono marchi dei rispettivi proprietari. Questo plugin non è affiliato a SmartPost né approvato da SmartPost.