VibeFox Econt for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

Econt : aucun contrat ni clé API n'est nécessaire. La liste des bureaux est une nomenclature publique d'Econt. Seul le code du pays est envoyé à Econt, aucune donnée client. Renseignez un identifiant et un mot de passe e-Econt uniquement si Econt demande à votre site une autorisation. La connexion e-Econt est décrite sur la page développeurs d'Econt (econt.com/developers).

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier vfd_econt dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Econt, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

5. Définissez les tarifs par pays et vérifiez les autres options (voir la section Configuration). Cliquez sur Load offices from Econt now pour tester la connexion.

6. Ajoutez VibeFox Econt à une zone d'expédition comprenant la Bulgarie et/ou la Roumanie dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore zones et choisissez les pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox Econt. Le tarif et les conditions s'appliquent à toutes les zones d'expédition. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un seul champ :

Title (zone) : le nom que voient les clients pour cette zone. Laissez vide pour utiliser le Name général.

En haut de la page, l'extension affiche des avertissements : l'API de démonstration est activée, aucun tarif n'est défini pour la Bulgarie ou la Roumanie (la méthode n'est alors jamais affichée), ou la dernière demande de bureaux pour un pays a échoué. Les champs numériques acceptent la virgule décimale, par exemple 5,99. Une valeur qui n'est pas un nombre est ignorée et signalée à l'enregistrement.

Général

Enable/Disable : active ou désactive la livraison Econt dans toutes les zones à la fois. Par défaut : activé.

Name : le nom de la méthode d'expédition affiché au paiement. Un Title défini dans la zone le remplace. Par défaut : Econt Express.

Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas. Par défaut : Taxable.

Liste des bureaux Econt

Les bureaux et les Econtomats sont chargés depuis l'API Econt et mis en cache pendant 24 heures.

Demo API : utilise l'API de démonstration d'Econt avec des données de test. Gardez-la désactivée sur une boutique en production. Les bureaux de démonstration ont d'autres identifiants que les réels. En mode démonstration, le compte de test public d'Econt est utilisé si aucune connexion n'est définie.

Econt username : facultatif. Votre identifiant e-Econt pour l'autorisation HTTP Basic.

Econt password : facultatif. Il est stocké dans la base de données WordPress et n'est jamais écrit dans le journal.

Office list : indique combien de bureaux sont en cache par pays et quand ils ont été chargés. Le bouton Load offices from Econt now recharge les listes immédiatement et affiche le résultat. Si un chargement échoue, les bureaux du dernier chargement réussi sont conservés. Sans ce bouton, la liste est chargée automatiquement lors du premier passage au paiement. Modifier Demo API, l'identifiant ou le mot de passe vide les listes en cache.

Sélecteur de bureau sur la page de paiement

Show : les points que les clients peuvent choisir.

City order : affiche d'abord les plus grandes villes (Sofia, Plovdiv, Varna, Bucarest et autres). Lorsqu'elle est désactivée, les villes sont triées par ordre alphabétique. Par défaut : activé.

City list width : la largeur CSS de la liste des villes sur le paiement classique, par exemple 100% ou 300px. Par défaut : 100%.

Office list width : la largeur CSS de la liste des bureaux sur le paiement classique, par exemple 100% ou 400px. Par défaut : 100%.

Tarifs (dans la devise de votre boutique)

L'extension ne demande pas à Econt de tarifs en direct. La Bulgarie utilise l'euro depuis le 1er janvier 2026 ; une boutique bulgare saisit donc normalement des tarifs en EUR.

Price per country : un pays par ligne (ou séparés par des virgules) : code du pays, deux-points, tarif, par exemple BG:5.99 et RO:8.99 (ce sont les valeurs par défaut). La virgule décimale est acceptée : BG:5,99. Un tarif de 0 signifie livraison gratuite. Les entrées dans un autre format sont ignorées et listées dans un message d'erreur à l'enregistrement.

Calculation : Per order facture le tarif une seule fois. Per item (price x quantity) le multiplie par le nombre d'articles expédiables du panier.

Price for other countries : utilisé pour un pays Econt (Bulgarie ou Roumanie) qui n'est pas listé ci-dessus. Vide ou 0 masque la méthode dans ce pays.

Conditions

Free shipping from : le sous-total du panier à partir duquel la livraison est gratuite. Laissez vide pour ne jamais offrir la livraison gratuite.

Minimum subtotal : affiche la méthode seulement lorsque le sous-total du panier atteint au moins ce montant. Laissez vide pour l'afficher toujours.

Minimum weight (kg) : masque la méthode pour les paniers plus légers. Les poids des produits sont convertis de l'unité de votre boutique en kg. Laissez vide pour aucune limite.

Maximum weight (kg) : masque la méthode pour les paniers plus lourds. Laissez vide pour aucune limite.

Hide for shipping classes : masque la méthode si le panier contient un produit de l'une de ces classes d'expédition WooCommerce.

Disponibilité sans zones d'expédition

Ignore zones : propose aussi Econt dans les pays ci-dessous lorsqu'aucune zone ne l'ajoute. Les zones qui contiennent la méthode continuent de fonctionner normalement.

Countries : Bulgarie et/ou Roumanie. Utilisé seulement avec Ignore zones. Laissez vide pour tous les pays Econt vers lesquels votre boutique expédie.

Avancé

Debug log : écrit les messages de débogage dans WooCommerce > Status > Logs, source vfd-econt. Les erreurs de l'API sont toujours journalisées. Aucun mot de passe ni donnée client n'est écrit.

Remove data on uninstall : lorsqu'elle est activée, la suppression de l'extension efface les réglages Econt et les méthodes des zones. La désactivation de l'extension ne supprime jamais les réglages. Les bureaux enregistrés dans les commandes sont toujours conservés.

Fonctionnement sur la page de paiement

La méthode n'est proposée que pour la Bulgarie et la Roumanie. Lorsque le client saisit une adresse de livraison, l'extension vérifie le poids du panier, le sous-total minimum et les classes d'expédition masquées, puis prend le tarif du pays. Si le sous-total du panier atteint Free shipping from, le tarif est de 0. Si aucune liste de bureaux n'est disponible pour le pays, la méthode est masquée, car la livraison se fait toujours dans un bureau.

Lorsque le client sélectionne Econt, deux listes apparaissent sous la méthode : City et Office / Econtomat. La liste des bureaux est chargée une fois par page. Les Econtomats sont signalés dans la liste. Le choix est mémorisé pendant la session. Si la liste des bureaux ne peut pas être chargée, le client voit un message l'invitant à réessayer dans quelques minutes ou à choisir une autre méthode d'expédition.

Le client ne peut pas valider la commande sans choisir un bureau. Côté serveur, l'extension vérifie à nouveau que le bureau existe dans la liste Econt pour le pays de livraison. Le nom du bureau est toujours repris de la liste Econt, jamais du navigateur. Cela fonctionne sur le paiement classique et sur le paiement par blocs. L'extension est compatible avec le stockage de commandes haute performance de WooCommerce (HPOS).

La liste des bureaux est mise en cache pendant 24 heures. Si Econt est injoignable, la dernière liste valide est utilisée et Econt n'est pas interrogé à nouveau pendant 10 minutes. Le délai d'attente de l'API est de 15 secondes.

L'extension n'utilise que des tarifs fixes. Elle ne demande pas à Econt de tarifs en direct, ne crée ni lettres de transport ni étiquettes, ne commande pas de coursiers, ne suit pas les colis, ne gère pas le paiement à la livraison et ne livre pas à une adresse. Seules la Bulgarie et la Roumanie ont une liste de bureaux.

Points de retrait

Le bureau choisi est enregistré avec la commande : la ville, le nom et l'adresse du bureau, et le code de bureau Econt. Utilisez le code de bureau lorsque vous créez l'expédition dans e-Econt.

Écran de commande de l'administration : le bureau et son code sont affichés sous l'adresse de livraison. Cliquez sur Change pour charger la liste des bureaux et choisir une autre ville et un autre bureau. La modification est enregistrée immédiatement, et une note de commande mentionne l'ancien et le nouveau bureau.

Client : le bureau est affiché sur la page de commande du client et sur la page de remerciement, ainsi que dans les e-mails de commande (HTML et texte brut).

Les noms des bureaux sont affichés dans la langue locale (cyrillique pour la Bulgarie) lorsque la langue du site est le bulgare ou le roumain, et en anglais dans les autres cas.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Shipping > VibeFox Econt. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active, et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, Econt n'est pas affiché aux clients sur la page de paiement. Les gestionnaires de la boutique connectés le voient toujours, avec la mention (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié automatiquement en arrière-plan.

Dépannage

Econt n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le pays de livraison est la Bulgarie ou la Roumanie, et que la méthode est ajoutée à la zone de ce pays (ou que Ignore zones est activé et que le pays est autorisé). Vérifiez qu'un tarif est défini pour le pays, les limites de poids, Minimum subtotal et Hide for shipping classes. Consultez la ligne Office list des réglages : la méthode est masquée tant qu'aucune liste de bureaux n'est disponible pour le pays.

La liste des bureaux ne se charge pas : cliquez sur Load offices from Econt now et lisez le résultat, ou l'avertissement en haut de la page des réglages. Les erreurs sont écrites dans WooCommerce > Status > Logs, source vfd-econt. Si Econt exige une autorisation pour votre site, renseignez Econt username et Econt password.

Les clients voient des bureaux de test : Demo API est activé. Désactivez-le sur une boutique en production.

Dans quelle devise sont les tarifs ? Dans la devise de votre boutique.

Autres pays : les développeurs peuvent ajouter des pays avec le filtre vfd_ecn_countries (code à 2 lettres associé à un code à 3 lettres).

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net, puis cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé pour le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

La désactivation de l'extension conserve tous les réglages et supprime seulement le cache des bureaux. Pour la retirer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension, ainsi que les listes de bureaux en cache, sont toujours supprimés. Les réglages et les méthodes de zone ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les bureaux enregistrés dans les commandes sont toujours conservés, et les commandes existantes gardent leurs lignes d'expédition.

Econt est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Econt ni approuvée par Econt.