VibeFox Mondial Relay 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.
Compte Mondial Relay : le code Enseigne et la Private Key sont fournis avec un compte professionnel Mondial Relay : voir la rubrique professionnels de mondialrelay.fr, votre espace client « Connect » ou votre contact commercial. Le sélecteur de carte n'a besoin que du code Enseigne. La liste des points les plus proches nécessite les deux. Pour les tests, Mondial Relay fournit le code Enseigne BDTEST13 avec la Private Key PrivateK.
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_mondialrelay dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Mondial Relay, 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. Saisissez votre code Enseigne et, pour le mode liste, la Private Key. Renseignez Country prices.
6. Ajoutez VibeFox Mondial Relay aux zones de vos pays de livraison dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones.
Configuration
Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox Mondial Relay. Ils s'appliquent à toutes les zones d'expédition. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne contient qu'un champ :
Title (zone) : le nom de cette option au paiement. Laissez vide pour utiliser le Name général.
Les avertissements en haut de la page signalent les problèmes qui masquent la méthode : code Enseigne manquant, Private Key manquante en mode liste et aucun prix pour la France, la Belgique ou l'Espagne.
Général
Enable/Disable : active ou désactive Mondial Relay globalement.
Name : le nom de la méthode d'expédition affiché aux clients au paiement. Par défaut : Mondial Relay Point Relais.
Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.
Compte Mondial Relay
Brand code (Enseigne) : obligatoire, jusqu'à 8 caractères, par exemple BDTEST13 pour les tests. Utilisé par la carte des points relais et par le Web Service. Sans lui, les clients ne peuvent pas choisir de Point Relais et la méthode n'est pas affichée au paiement.
Private Key : nécessaire uniquement pour le sélecteur List of nearest points. Lorsque le code Enseigne et la Private Key sont renseignés, la connexion au Web Service Mondial Relay est testée à chaque enregistrement des réglages, et un message indique si elles sont valides.
Sélecteur de point relais
Selector : la façon dont le client choisit un Point Relais.
Tarifs (dans la devise de votre boutique)
Country prices : prix par pays de destination et poids du colis. Cliquez sur + Add country pour ajouter une ligne et sur la croix pour en supprimer une. Utilisez la ligne * Default pour tous les autres pays. Chaque ligne comporte une colonne Price et des colonnes de poids : XS jusqu'à 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg et XL au-delà de 5 kg. Une colonne de poids vide ou à 0 utilise la colonne Price. Décimales avec un point ou une virgule (4.90 ou 4,90). Les lignes sans aucun prix sont supprimées à l'enregistrement, et les valeurs qui ne sont pas des nombres sont signalées et laissées vides.
Fallback cost : utilisé pour les pays sans ligne dans la grille. Laissez vide pour masquer la méthode pour ces pays.
Calculation type : la façon dont le prix est calculé.
Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison est gratuite. Laissez vide pour ne pas proposer de livraison gratuite.
Disponibilité
Min weight (kg) : masque la méthode lorsque le panier pèse moins. 0 signifie sans limite.
Max weight (kg) : masque la méthode lorsque le panier pèse davantage. Mondial Relay accepte les colis jusqu'à 30 kg en Points Relais. Par défaut : 30. 0 signifie sans limite.
Minimum subtotal : n'affiche la méthode que lorsque le sous-total du panier atteint au moins ce montant. Laissez vide pour toujours l'afficher.
Disabled shipping classes : masque la méthode lorsque le panier contient des articles appartenant à ces classes d'expédition WooCommerce.
Ignore shipping zones : propose la méthode pour les pays indiqués ci-dessous, ou pour tous les pays pris en charge si la liste est vide, même lorsqu'aucune zone d'expédition ne les contient.
Countries (ignore zones) : les pays de destination pour ce mode. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé.
Avancé
Debug log : enregistre le calcul des tarifs et les appels au Web Service dans WooCommerce > Status > Logs (source vfd-mondialrelay). Les erreurs sont toujours journalisées, même si cette option est désactivée. Aucune clé ni donnée client n'est journalisée.
Remove data on uninstall : lorsque l'option est activée, la suppression de l'extension efface les réglages et les méthodes des zones. La désactivation ne supprime jamais rien. Les points relais enregistrés dans les commandes sont conservés.
Fonctionnement au paiement
La méthode n'est proposée que pour les pays disposant de Points Relais : France, Belgique, Luxembourg, Espagne, Portugal et Pays-Bas. Elle est masquée lorsque le client ne pourrait pas choisir de point : sans code Enseigne, ou en mode liste sans Private Key.
Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension contrôle le poids du panier, le sous-total minimum et les classes d'expédition exclues. Le prix provient de la ligne du pays (ou de la ligne *) : la colonne de poids, sinon Price. Sans ligne, les frais de repli sont utilisés. S'il n'y a pas de prix, la méthode est masquée. Si le sous-total atteint Free shipping from, le prix devient 0.
La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec High-Performance Order Storage (HPOS) de WooCommerce.
L'extension ne demande pas de tarifs en temps réel : Mondial Relay ne propose pas d'API publique de tarifs. Elle ne crée pas d'envois, n'imprime pas d'étiquettes et ne suit pas les colis. Créez les envois dans votre espace « Connect » Mondial Relay en utilisant le numéro de Point Relais affiché dans la commande. La livraison à domicile (Domicile) n'est pas proposée.
Points relais
Mode carte : lorsque le client sélectionne Mondial Relay, le bouton Choose a Point Relais apparaît sous la méthode. Il ouvre la carte officielle de Mondial Relay pour le pays de livraison, le code postal et le poids du colis. Une fois le point choisi par le client, il est affiché sous Selected: et le bouton devient Change Point Relais. Le widget de carte est chargé depuis widget.mondialrelay.com et sa bibliothèque de cartes depuis unpkg.com uniquement lorsque le client ouvre la carte. Mentionnez-le dans votre politique de confidentialité.
Mode liste : une liste déroulante - Choose a Point Relais - affiche les 10 points les plus proches du code postal de livraison, avec leur distance. Le point choisi est affiché avec ses horaires d'ouverture. La liste est chargée par votre serveur : aucun script tiers ne s'exécute donc dans le navigateur. Les listes sont mises en cache pendant 12 heures, une réponse vide pendant 1 heure, et une requête en échec est retenue pendant 5 minutes. Le délai d'attente du Web Service est de 10 secondes. Si la liste n'est pas disponible, le client voit « The list of pickup points is not available right now. Please use the map. » et la carte lui est proposée.
Un point est obligatoire. Sans point, le client voit Please choose a Mondial Relay pickup point. et la commande n'est pas validée. Un point situé dans un autre pays que l'adresse de livraison est refusé. En mode liste, le point est également vérifié par rapport à la liste de l'adresse.
Le numéro, le pays, le nom et l'adresse du Point Relais sont enregistrés dans la commande. Ils sont affichés sur l'écran de commande sous l'adresse de livraison (avec le numéro du Point Relais), sur la page de confirmation, dans My account > Orders et dans les e-mails de commande (HTML et texte brut) sous le libellé Mondial Relay pickup point.
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 Mondial Relay. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche l'état, par exemple la date jusqu'à laquelle la licence est active et votre domaine. Utilisez Check now pour vérifier à nouveau l'état, 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, Mondial Relay n'est pas affiché aux clients au paiement. Les gestionnaires connectés de la boutique 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 le support nécessitent un renouvellement. L'état est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
Mondial Relay n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la méthode est ajoutée à la zone du pays du client (ou que Ignore shipping zones est activé et le pays autorisé). Consultez les avertissements en haut de la page des réglages : la méthode est masquée sans code Enseigne, en mode liste sans Private Key, pour un pays sans prix, en dehors des limites de poids et de sous-total, et pour les pays sans Points Relais.
Le test du Web Service a échoué après l'enregistrement : le message affiche l'erreur de Mondial Relay, par exemple un code Enseigne ou une clé de sécurité invalide. Vérifiez le code Enseigne et la Private Key auprès de Mondial Relay.
La liste des points est vide ou indisponible : le client doit d'abord saisir un code postal. Si le Web Service échoue, la carte est proposée à la place. Activez Debug log et ouvrez WooCommerce > Status > Logs, source vfd-mondialrelay, pour connaître la raison.
La carte ne s'ouvre pas : la carte est chargée depuis widget.mondialrelay.com et unpkg.com. Vérifiez qu'un bloqueur de confidentialité ou de scripts ne les bloque pas. Les développeurs peuvent modifier les URL des scripts avec les filtres vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url et vfd_mrel_leaflet_style_url. La liste des pays pris en charge peut être modifiée avec le filtre vfd_mrel_supported_countries.
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 et 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 état connu.
Désinstallation
La désactivation de l'extension conserve tous les réglages. Seules les listes de points relais en cache sont effacées. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et l'état de licence de cette extension, ainsi que les caches, sont toujours supprimés. Les réglages et les méthodes des zones ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les points relais enregistrés dans les commandes sont conservés, et les commandes existantes gardent leurs lignes d'expédition.
Mondial Relay est une marque de son titulaire respectif. Cette extension n'est ni affiliée à Mondial Relay ni approuvée par Mondial Relay.