VibeFox Mondial Relay 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.
Account Mondial Relay: il codice Enseigne e la Private Key si ottengono con un account business Mondial Relay: vedi la sezione per i professionisti di mondialrelay.fr, la tua area clienti "Connect" o il tuo contatto commerciale. Il selettore della mappa richiede solo il codice Enseigne. L'elenco dei punti più vicini richiede entrambi. Per i test, Mondial Relay fornisce il codice Enseigne BDTEST13 con la Private Key PrivateK.
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_mondialrelay in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Mondial Relay, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugins.
4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.
5. Inserisci il tuo codice Enseigne e, per la modalità elenco, la Private Key. Compila Country prices.
6. Aggiungi VibeFox Mondial Relay alle zone dei paesi di consegna in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore shipping zones.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Mondial Relay. 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 di questa opzione al checkout. Lascialo vuoto per usare il Name globale.
Gli avvisi in cima alla pagina segnalano i problemi che nascondono il metodo: codice Enseigne mancante, Private Key mancante in modalità elenco e nessun prezzo per Francia, Belgio o Spagna.
Generale
Enable/Disable: attiva o disattiva Mondial Relay a livello globale.
Name: il nome del metodo di spedizione mostrato ai clienti al checkout. Predefinito: Mondial Relay Point Relais.
Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non la aggiunge.
Account Mondial Relay
Brand code (Enseigne): obbligatorio, fino a 8 caratteri, per esempio BDTEST13 per i test. Usato dalla mappa dei punti di ritiro e dal Web Service. Senza di esso i clienti non possono scegliere un Point Relais, quindi il metodo non viene mostrato al checkout.
Private Key: necessaria solo per il selettore List of nearest points. Quando il codice Enseigne e la Private Key sono impostati, la connessione al Web Service di Mondial Relay viene testata ogni volta che salvi le impostazioni, e un messaggio indica se sono validi.
Selettore del punto di ritiro
Selector: come il cliente sceglie un Point Relais.
Tariffe (nella valuta del tuo negozio)
Country prices: prezzo per paese di destinazione e peso del pacco. Fai clic su + Add country per aggiungere una riga e sulla croce per rimuoverne una. Usa la riga * Default per tutti gli altri paesi. Ogni riga ha un Price e le colonne di peso: XS fino a 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg e XL oltre 5 kg. Una colonna di peso vuota o pari a 0 usa la colonna Price. Decimali con punto o virgola (4.90 o 4,90). Le righe senza alcun prezzo vengono eliminate al salvataggio, e i valori che non sono numeri vengono segnalati e lasciati vuoti.
Fallback cost: usato per i paesi senza una riga nella tabella. Lascialo vuoto per nascondere il metodo per quei paesi.
Calculation type: come viene calcolato il prezzo.
Free shipping from: il subtotale del carrello (dopo gli sconti, senza imposte) a partire dal quale la spedizione è gratuita. Lascialo vuoto se non vuoi la spedizione gratuita.
Disponibilità
Min weight (kg): nasconde il metodo quando il carrello pesa meno. 0 significa nessun limite.
Max weight (kg): nasconde il metodo quando il carrello pesa di più. Mondial Relay accetta pacchi fino a 30 kg nei Points Relais. Predefinito: 30. 0 significa nessun limite.
Minimum subtotal: mostra il metodo solo quando il subtotale del carrello è almeno questo importo. Lascialo vuoto per mostrarlo sempre.
Disabled shipping classes: nasconde il metodo quando il carrello contiene articoli di queste classi di spedizione di WooCommerce.
Ignore shipping zones: offre il metodo per i paesi indicati sotto, oppure per tutti i paesi supportati se l'elenco è vuoto, anche quando nessuna zona di spedizione li include.
Countries (ignore zones): i paesi di destinazione per questa modalità. Questo campo viene usato solo quando Ignore shipping zones è attivo.
Avanzate
Debug log: registra il calcolo delle tariffe e le chiamate al Web Service in WooCommerce > Status > Logs (origine vfd-mondialrelay). Gli errori vengono sempre registrati, anche con questa opzione disattivata. Nessuna chiave né dato del cliente viene registrato.
Remove data on uninstall: se attiva, eliminando il plugin vengono rimosse le impostazioni e i metodi delle zone. La disattivazione non elimina mai nulla. I punti di ritiro salvati negli ordini vengono conservati.
Come funziona al checkout
Il metodo viene offerto solo per i paesi con Points Relais: Francia, Belgio, Lussemburgo, Spagna, Portogallo e Paesi Bassi. Viene nascosto quando il cliente non potrebbe scegliere un punto: senza codice Enseigne, o in modalità elenco senza Private Key.
Quando il cliente inserisce un indirizzo di consegna, WooCommerce chiede al plugin una tariffa. Il plugin controlla il peso del carrello, il subtotale minimo e le classi di spedizione escluse. Il prezzo viene dalla riga del paese (o dalla riga *): la colonna di peso, altrimenti Price. Senza riga viene usato il costo di ripiego. Se non c'è un prezzo, il metodo viene nascosto. Se il subtotale raggiunge Free shipping from, il prezzo diventa 0.
Il metodo funziona nel checkout classico e nei blocchi Carrello e Checkout. È compatibile con High-Performance Order Storage (HPOS) di WooCommerce.
Il plugin non richiede tariffe in tempo reale: Mondial Relay non dispone di un'API pubblica per le tariffe. Non crea spedizioni, non stampa etichette e non traccia i pacchi. Crea le spedizioni nel tuo spazio "Connect" di Mondial Relay usando il numero del Point Relais mostrato nell'ordine. La consegna a domicilio (Domicile) non viene offerta.
Punti di ritiro
Modalità mappa: quando il cliente seleziona Mondial Relay, sotto il metodo appare il pulsante Choose a Point Relais. Apre la mappa ufficiale di Mondial Relay per il paese di consegna, il codice postale e il peso del pacco. Dopo che il cliente ha scelto un punto, questo viene mostrato come Selected: e il pulsante cambia in Change Point Relais. Il widget della mappa viene caricato da widget.mondialrelay.com e la sua libreria di mappe da unpkg.com solo quando il cliente apre la mappa. Menzionalo nella tua informativa sulla privacy.
Modalità elenco: un menu a tendina - Choose a Point Relais - mostra i 10 punti più vicini al codice postale di consegna, con la distanza. Il punto scelto viene mostrato con i suoi orari di apertura. L'elenco viene caricato dal tuo server, quindi nessuno script di terze parti viene eseguito nel browser. Gli elenchi sono memorizzati nella cache per 12 ore, una risposta vuota per 1 ora e una richiesta non riuscita viene ricordata per 5 minuti. Il timeout del Web Service è di 10 secondi. Se l'elenco non è disponibile, il cliente vede "The list of pickup points is not available right now. Please use the map." e viene offerta la mappa.
Un punto è obbligatorio. Senza di esso, il cliente vede Please choose a Mondial Relay pickup point. e l'ordine non viene effettuato. Un punto in un paese diverso da quello dell'indirizzo di consegna viene rifiutato. In modalità elenco il punto viene inoltre verificato con l'elenco per l'indirizzo.
Numero del Point Relais, paese, nome e indirizzo vengono salvati nell'ordine. Sono mostrati nella schermata dell'ordine sotto l'indirizzo di spedizione (con il numero del Point Relais), nella pagina di ringraziamento, in My account > Orders e nelle e-mail dell'ordine (HTML e testo semplice) come Mondial Relay pickup point.
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 Mondial Relay. 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 di dominio. Liberalo dal tuo account vibefox.net.
Senza una chiave attiva, Mondial Relay non viene mostrato ai clienti al checkout. Gli amministratori del negozio con l'accesso lo vedono ancora, contrassegnato come (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Sulla pagina Plugins 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 supporto richiedono il rinnovo. Lo stato viene ricontrollato automaticamente in background.
Risoluzione dei problemi
Mondial Relay non compare al checkout: verifica 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 consentito). Controlla gli avvisi in cima alla pagina delle impostazioni: il metodo viene nascosto senza codice Enseigne, in modalità elenco senza Private Key, per un paese senza prezzo, fuori dai limiti di peso e subtotale, e per i paesi senza Points Relais.
Test del Web Service fallito dopo il salvataggio: il messaggio mostra l'errore di Mondial Relay, per esempio un codice Enseigne o una chiave di sicurezza non validi. Verifica il codice Enseigne e la Private Key con Mondial Relay.
L'elenco dei punti è vuoto o non disponibile: il cliente deve prima inserire un codice postale. Se il Web Service non funziona, al suo posto viene offerta la mappa. Attiva Debug log e apri WooCommerce > Status > Logs, origine vfd-mondialrelay, per il motivo.
La mappa non si apre: la mappa viene caricata da widget.mondialrelay.com e unpkg.com. Verifica che un blocco di privacy o script non li blocchi. Gli sviluppatori possono cambiare gli URL degli script con i filtri vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url e vfd_mrel_leaflet_style_url. L'elenco dei paesi supportati può essere modificato con il filtro vfd_mrel_supported_countries.
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. 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 e metodi delle zone vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una futura reinstallazione. I punti di ritiro salvati negli ordini vengono conservati, e gli ordini esistenti mantengono le loro righe di spedizione.
Mondial Relay è un marchio del rispettivo proprietario. Questo plugin non è affiliato né approvato da Mondial Relay.