VibeFox Econt 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.
Econt: non serve un contratto o una chiave API. L'elenco degli uffici è una nomenclatura pubblica di Econt. A Econt viene inviato solo il codice del paese, nessun dato del cliente. Inserisci un nome utente e una password e-Econt solo se Econt chiede al tuo sito un'autorizzazione. L'accesso e-Econt è descritto nella pagina per sviluppatori di Econt (econt.com/developers).
Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un 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_econt in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Shipping > VibeFox Econt, 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. Imposta le tariffe per paese e controlla le altre opzioni (vedi Configurazione). Fai clic su Load offices from Econt now per verificare la connessione.
6. Aggiungi VibeFox Econt a una zona di spedizione con Bulgaria e/o Romania in WooCommerce > Settings > Shipping > Shipping zones, oppure attiva Ignore zones e scegli i paesi.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Shipping > VibeFox Econt. Tariffa e condizioni 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 i clienti vedono per questa zona. Lascialo vuoto per usare il Name generale.
In cima alla pagina il plugin mostra avvisi: l'API demo è attiva, non è impostata alcuna tariffa per Bulgaria o Romania (il metodo allora non viene mostrato mai), oppure l'ultima richiesta di uffici per un paese è fallita. I campi numerici accettano la virgola decimale, per esempio 5,99. Un valore che non è un numero viene ignorato e segnalato al salvataggio.
Generale
Enable/Disable: attiva o disattiva la consegna Econt in tutte le zone contemporaneamente. Predefinito: attivo.
Name: il nome del metodo di spedizione mostrato al checkout. Un Title impostato nella zona lo sostituisce. Predefinito: Econt Express.
Tax status: Taxable aggiunge l'imposta di WooCommerce al costo di spedizione, None non la aggiunge. Predefinito: Taxable.
Elenco degli uffici Econt
Uffici ed Econtomat vengono caricati dall'API Econt e memorizzati nella cache per 24 ore.
Demo API: usa l'API demo di Econt con dati di prova. Tienila disattivata in un negozio attivo. Gli uffici demo hanno ID diversi da quelli reali. In modalità demo, se non è impostato un accesso, si usa l'account di prova pubblico di Econt.
Econt username: facoltativo. Il tuo accesso e-Econt per l'autorizzazione HTTP Basic.
Econt password: facoltativo. Viene salvata nel database di WordPress e non viene mai scritta nel registro.
Office list: mostra quanti uffici sono in cache per paese e quando sono stati caricati. Il pulsante Load offices from Econt now ricarica subito gli elenchi e mostra il risultato. Se un caricamento fallisce, restano gli uffici dell'ultimo caricamento riuscito. Senza questo pulsante, l'elenco viene caricato automaticamente al primo checkout. Se cambi Demo API, il nome utente o la password, gli elenchi in cache vengono cancellati.
Selettore dell'ufficio al checkout
Show: quali punti possono scegliere i clienti.
City order: mostra prima le città più grandi (Sofia, Plovdiv, Varna, Bucarest e altre). Se disattivato, le città sono ordinate alfabeticamente. Predefinito: attivo.
City list width: la larghezza CSS dell'elenco delle città nel checkout classico, per esempio 100% o 300px. Predefinito: 100%.
Office list width: la larghezza CSS dell'elenco degli uffici nel checkout classico, per esempio 100% o 400px. Predefinito: 100%.
Tariffe (nella valuta del tuo negozio)
Il plugin non chiede a Econt tariffe in tempo reale. La Bulgaria usa l'euro dal 1° gennaio 2026, quindi un negozio bulgaro di solito inserisce tariffe in EUR.
Price per country: un paese per riga (o separati da virgole): codice del paese, due punti, tariffa, per esempio BG:5.99 e RO:8.99 (sono i valori predefiniti). Va bene anche la virgola decimale: BG:5,99. Una tariffa di 0 significa consegna gratuita. Le voci in un altro formato vengono ignorate ed elencate in un messaggio di errore al salvataggio.
Calculation: Per order addebita la tariffa una sola volta. Per item (price x quantity) la moltiplica per il numero di articoli spedibili nel carrello.
Price for other countries: usata per un paese Econt (Bulgaria o Romania) che non è elencato sopra. Vuoto o 0 nasconde lì il metodo.
Condizioni
Free shipping from: il subtotale del carrello da cui la consegna è gratuita. Lascialo vuoto per non offrire mai la consegna gratuita.
Minimum subtotal: mostra il metodo solo quando il subtotale del carrello è almeno questo importo. Lascialo vuoto per mostrarlo sempre.
Minimum weight (kg): nasconde il metodo per carrelli più leggeri. I pesi dei prodotti vengono convertiti dall'unità del negozio in kg. Lascialo vuoto per nessun limite.
Maximum weight (kg): nasconde il metodo per carrelli più pesanti. Lascialo vuoto per nessun limite.
Hide for shipping classes: nasconde il metodo se il carrello contiene un prodotto di una di queste classi di spedizione di WooCommerce.
Disponibilità senza zone di spedizione
Ignore zones: offre Econt anche nei paesi sotto indicati quando nessuna zona lo aggiunge. Le zone che contengono il metodo continuano a funzionare come di consueto.
Countries: Bulgaria e/o Romania. Si usa solo con Ignore zones. Lascialo vuoto per tutti i paesi Econt verso cui spedisce il tuo negozio.
Avanzate
Debug log: scrive i messaggi di debug in WooCommerce > Status > Logs, origine vfd-econt. Gli errori dell'API vengono sempre registrati. Non vengono scritte password né dati dei clienti.
Remove data on uninstall: se attivo, eliminando il plugin si rimuovono le impostazioni Econt e i metodi nelle zone. La disattivazione del plugin non elimina mai le impostazioni. Gli uffici salvati negli ordini vengono sempre conservati.
Come funziona al checkout
Il metodo viene offerto solo per Bulgaria e Romania. Quando il cliente inserisce un indirizzo di spedizione, il plugin verifica il peso del carrello, il subtotale minimo e le classi di spedizione nascoste, poi prende la tariffa del paese. Se il subtotale del carrello raggiunge Free shipping from, la tariffa è 0. Se per il paese non è disponibile alcun elenco di uffici, il metodo viene nascosto, perché la consegna avviene sempre presso un ufficio.
Quando il cliente seleziona Econt, sotto il metodo compaiono due elenchi: City e Office / Econtomat. L'elenco degli uffici viene caricato una volta per pagina. Gli Econtomat sono contrassegnati nell'elenco. La scelta viene ricordata durante la sessione. Se l'elenco degli uffici non può essere caricato, il cliente vede un messaggio che lo invita a riprovare tra qualche minuto o a scegliere un altro metodo di spedizione.
Il cliente non può completare l'ordine senza scegliere un ufficio. Sul server il plugin controlla di nuovo che l'ufficio esista nell'elenco Econt per il paese di spedizione. Il nome dell'ufficio viene sempre preso dall'elenco Econt, mai dal browser. Funziona nel checkout classico e in quello a blocchi. Il plugin è compatibile con l'archiviazione ad alte prestazioni degli ordini di WooCommerce (HPOS).
L'elenco degli uffici viene memorizzato nella cache per 24 ore. Se Econt non risponde, si usa l'ultimo elenco valido e Econt non viene interrogata di nuovo per 10 minuti. Il timeout dell'API è di 15 secondi.
Il plugin usa solo tariffe fisse. Non chiede a Econt tariffe in tempo reale, non crea lettere di vettura né etichette, non prenota corrieri, non traccia le spedizioni, non gestisce il contrassegno e non consegna a un indirizzo. Solo Bulgaria e Romania hanno un elenco di uffici.
Punti di ritiro
L'ufficio scelto viene salvato con l'ordine: la città, il nome e l'indirizzo dell'ufficio e il codice ufficio Econt. Usa il codice ufficio quando crei la spedizione in e-Econt.
Schermata dell'ordine in amministrazione: l'ufficio e il codice ufficio sono mostrati sotto l'indirizzo di spedizione. Fai clic su Change per caricare l'elenco degli uffici e scegliere un'altra città e un altro ufficio. La modifica viene salvata subito e una nota dell'ordine registra il vecchio e il nuovo ufficio.
Cliente: l'ufficio viene mostrato nella pagina dell'ordine del cliente e nella pagina di ringraziamento, e nelle e-mail degli ordini (HTML e testo semplice).
I nomi degli uffici vengono mostrati nella lingua locale (cirillico per la Bulgaria) quando la lingua del sito è il bulgaro o il rumeno, e in inglese negli altri casi.
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 Econt. 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 dominio. Rimuovere la chiave da un sito non libera lo slot del dominio. Liberalo nel tuo account vibefox.net.
Senza una chiave attiva, Econt non viene mostrato ai clienti al checkout. Gli amministratori del negozio che hanno effettuato l'accesso lo vedono ancora, contrassegnato con (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 vengono modificati.
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
Econt non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che il paese di consegna sia Bulgaria o Romania e che il metodo sia aggiunto alla zona di quel paese (oppure che Ignore zones sia attivo e il paese sia consentito). Controlla che per il paese sia impostata una tariffa, i limiti di peso, Minimum subtotal e Hide for shipping classes. Controlla la riga Office list nelle impostazioni: il metodo è nascosto finché non c'è un elenco di uffici per il paese.
L'elenco degli uffici non si carica: fai clic su Load offices from Econt now e leggi il risultato, oppure l'avviso in cima alla pagina delle impostazioni. Gli errori vengono scritti in WooCommerce > Status > Logs, origine vfd-econt. Se Econt richiede un'autorizzazione per il tuo sito, compila Econt username e Econt password.
I clienti vedono uffici di prova: Demo API è attiva. Disattivala in un negozio attivo.
In quale valuta sono le tariffe? Nella valuta del tuo negozio.
Altri paesi: gli sviluppatori possono aggiungere paesi con il filtro vfd_ecn_countries (codice a 2 lettere associato a un codice a 3 lettere).
Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera uno slot 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 risponde, il plugin continua a funzionare con l'ultimo stato noto.
Disinstallazione
Disattivare il plugin mantiene tutte le impostazioni e cancella solo la cache degli uffici. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin, così come gli elenchi degli uffici in cache, vengono sempre rimossi. Impostazioni e metodi di zona vengono rimossi solo se Remove data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Gli uffici salvati negli ordini vengono sempre conservati, e gli ordini esistenti mantengono le loro righe di spedizione.
Econt è un marchio del rispettivo proprietario. Questo plugin non è affiliato a Econt né approvato da Econt.