VibeFox Bob Go for WooCommerce — Aide
Prérequis
WordPress : 5.8 ou ultérieur.
WooCommerce : 5.0 ou ultérieur, installé et actif. L'extension refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
Compte Bob Go (pour les tarifs en temps réel uniquement) : Bob Go n'utilise pas de clés d'API. Il vous faut un compte Bob Go (bobgo.co.za), votre boutique WooCommerce installée comme canal de vente dans votre compte Bob Go (Sales channels) et « Rates at checkout » activé pour ce canal, avec vos services et vos prix configurés dans Bob Go. Si vous n'utilisez que des prix fixes, vous n'avez pas besoin de compte Bob Go.
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_bob_go dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Dans votre compte Bob Go, installez votre boutique WooCommerce comme canal de vente. Activez « Rates at checkout » pour ce canal et configurez vos services et vos prix.
4. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Bob Go, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.
5. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
6. Vérifiez le domaine de la boutique, l'adresse d'origine (expédition) et, si la devise de votre boutique n'est pas le ZAR, le taux de conversion en ZAR (voir Configuration).
7. Ajoutez VibeFox Bob Go à une zone de livraison pour l'Afrique du Sud 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 Bob Go. Ils s'appliquent à toutes les zones de livraison. À chaque enregistrement des réglages, les tarifs Bob Go mis en cache sont effacés. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un seul champ :
Title (zone) : le nom affiché pour les prix fixes et la livraison gratuite dans cette zone. Laissez-le vide pour utiliser le Method title général. Les tarifs Bob Go en temps réel sont toujours affichés avec les noms de services configurés dans Bob Go.
Général
Enable/Disable : active ou désactive la méthode dans toutes les zones à la fois.
Method title : affiché au client pour les prix fixes et la livraison gratuite. Une zone peut le remplacer. Les tarifs Bob Go en temps réel sont affichés avec les noms de services de Bob Go, par exemple « The Courier Guy - Economy ». Par défaut : Bob Go.
Shipping cost : le mode de calcul du prix.
La raison de l'absence de tarifs en temps réel est écrite dans le journal. Elle n'est jamais affichée au client.
Compte Bob Go
Cette section affiche la dernière réponse de Bob Go pour le domaine de votre boutique : connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) ou une autre erreur. Si la devise de votre boutique n'est pas le ZAR et qu'aucun taux de conversion n'est défini, elle indique aussi que les tarifs en temps réel ne sont pas demandés.
Store domain : Bob Go identifie votre boutique par son domaine. Laissez-le vide pour utiliser le domaine de votre site. Saisissez un autre domaine uniquement si votre canal dans Bob Go est installé à une autre adresse, par exemple example.co.za/shop pour une boutique dans un sous-dossier.
ZAR conversion rate : Bob Go cote en rand sud-africain (ZAR). Si la devise de votre boutique n'est pas le ZAR, saisissez la valeur de 1 ZAR dans la devise de votre boutique, par exemple 0.05 pour l'EUR. Les tarifs sont convertis avec ce taux, et les prix des produits sont envoyés à Bob Go en ZAR. Laissez-le vide pour ne pas utiliser les tarifs Bob Go en temps réel dans votre devise (les prix fixes fonctionnent toujours). Si la devise de votre boutique est le ZAR, laissez-le vide. Le point et la virgule sont tous deux acceptés comme séparateur décimal.
Delivery dates : affiche la plage de dates de livraison estimée par Bob Go dans le nom du tarif. L'estimation est toujours enregistrée avec la commande et visible sur l'écran de commande.
Expédition depuis (adresse d'origine)
L'adresse d'origine est envoyée à Bob Go avec chaque demande de tarifs. Si l'adresse de votre boutique dans WooCommerce > Settings > General se trouve dans le même pays, les champs vides sont repris de cette adresse.
Origin country : le pays depuis lequel vous expédiez. Par défaut : Afrique du Sud. Bob Go expédie uniquement en Afrique du Sud.
Origin province : une province sud-africaine, ou Store province (if in South Africa).
Origin city / suburb : la ville ou le quartier depuis lequel vous expédiez, par exemple Johannesburg.
Origin postal code : le code postal depuis lequel vous expédiez, par exemple 2001.
Origin street address : l'adresse de la rue depuis laquelle vous expédiez.
Prix fixes (utilisés en mode fixe et comme solution de repli lorsque Bob Go ne renvoie aucun tarif)
Price per country : une ligne par pays : un code pays à 2 lettres, un signe égal et le prix dans la devise de votre boutique, par exemple ZA=99.99. Utilisez * pour tous les autres pays, par exemple *=199.99. Les lignes d'un autre format sont supprimées à l'enregistrement.
Flat price : le prix dans la devise de votre boutique pour les pays sans ligne ci-dessus. Laissez-le vide pour masquer la méthode pour ces pays.
Fixed price applies : Per order facture le prix une seule fois. Per item (price × quantity) le multiplie par le nombre d'articles du panier. Les tarifs Bob Go en temps réel concernent toujours l'envoi complet.
Conditions
Minimum weight (kg) : masque la méthode si le poids du panier est inférieur à cette valeur. 0 signifie sans limite.
Maximum weight (kg) : masque la méthode si le poids du panier dépasse cette valeur. 0 signifie sans limite (par défaut).
Minimum order amount : n'affiche la méthode que lorsque le sous-total du panier (après remises, avant taxes) atteint au moins ce montant. Laissez vide pour l'afficher dans tous les cas.
Excluded shipping classes : masque la méthode si le panier contient un produit appartenant à l'une de ces classes d'expédition WooCommerce.
Free shipping : active la livraison gratuite lorsque le montant de commande indiqué ci-dessous est atteint.
Free shipping from : le sous-total du panier (après remises, avant taxes) à partir duquel la livraison est gratuite. Utilisé uniquement lorsque Free shipping est activé. Bob Go n'est alors pas interrogé.
Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas. Les tarifs Bob Go incluent généralement déjà la TVA. Dans ce cas, choisissez None pour ne pas facturer la taxe deux fois.
Disponibilité sans zones de livraison
Ignore shipping zones : propose Bob Go pour les pays indiqués ci-dessous, même s'il n'est pas ajouté à une zone de livraison.
Countries : les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays vers lesquels vous expédiez. Utilisé uniquement lorsque Ignore shipping zones est activé.
Avancé
Debug log : enregistre les calculs de tarifs et les requêtes vers Bob Go dans WooCommerce > Status > Logs, source « vfd_bob_go ». Les adresses des clients ne sont pas enregistrées. Les erreurs de l'API sont enregistrées même lorsque cette option est désactivée.
Remove data on uninstall : lorsqu'elle est activée, la suppression de l'extension efface tous les réglages Bob Go, les méthodes de zone et les tarifs en cache. La désactivation de l'extension ne supprime jamais rien.
Fonctionnement au moment du paiement
Lorsque le client saisit une adresse de livraison, l'extension vérifie le poids du panier, Minimum order amount et Excluded shipping classes. Si la livraison gratuite s'applique, le client voit la méthode Bob Go (free) et aucune requête n'est envoyée à Bob Go.
Dans les modes en temps réel, l'extension envoie à Bob Go le domaine de votre boutique, les adresses d'origine et de livraison ainsi que les articles du panier, avec les prix des produits en ZAR. Les tarifs en temps réel ne sont demandés qu'après que le client a saisi une ville ou un code postal. Chaque service renvoyé par Bob Go s'affiche comme une option de livraison distincte, avec son nom Bob Go et, si Delivery dates est activé, les dates de livraison estimées. Les tarifs en ZAR sont convertis avec le ZAR conversion rate lorsque la devise de votre boutique n'est pas le ZAR.
Les tarifs sont mis en cache pendant 1 heure par panier et adresse, afin que le même panier ne déclenche pas de nouvelle requête. Une requête échouée est mise en cache pendant 5 minutes, et le délai d'attente est de 12 secondes, afin qu'une panne de Bob Go ne ralentisse pas chaque mise à jour du paiement. Une requête échouée ne bloque jamais le paiement : la méthode est masquée, ou le prix fixe est utilisé en mode de repli. La raison est enregistrée dans le journal WooCommerce.
Le code du service Bob Go choisi et l'estimation de livraison sont enregistrés avec la ligne de livraison de la commande et affichés sur l'écran de commande sous Bob Go service et Estimated delivery.
La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec WooCommerce High-Performance Order Storage (HPOS).
L'extension n'affiche que des tarifs. Elle ne crée ni envois, ni lettres de voiture, ni étiquettes, ne suit pas les colis, ne synchronise pas les commandes avec Bob Go et n'envoie pas de notifications par e-mail. Pour l'exécution des commandes, utilisez le tableau de bord Bob Go (ou la synchronisation de commandes propre à Bob Go). Elle ne propose ni sélection de point relais ou de consigne (Bob Box, Pargo), ni champ de quartier supplémentaire au paiement. Bob Go n'expédie qu'en Afrique du Sud.
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 Bob Go. 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, ainsi que 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 l'emplacement de domaine associé. Libérez l'emplacement dans votre compte vibefox.net.
Sans clé active, Bob Go n'est pas affiché aux clients au moment du paiement. Les gestionnaires connectés de la boutique le voient toujours, marqué (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. L'état est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
Bob Go 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 que le pays est autorisé). Vérifiez les limites de poids, Minimum order amount et Excluded shipping classes. En mode fixe, vérifiez que le pays, * ou Flat price a un prix.
Aucun tarif Bob Go ne s'affiche : ouvrez les réglages de l'extension. La section Bob Go account affiche la dernière réponse de Bob Go. « Channel is not installed » (HTTP 404) signifie que le domaine de la boutique n'est pas un canal de vente dans Bob Go : vérifiez Store domain. « Rates at checkout is not enabled » (HTTP 401) signifie que la fonction est désactivée pour ce canal. Assurez-vous aussi que le client a saisi une ville ou un code postal et, pour les boutiques qui ne sont pas en ZAR, que ZAR conversion rate est défini. Activez Debug log et ouvrez WooCommerce > Status > Logs (source « vfd_bob_go ») pour les détails. Avec Bob Go live rates, fixed prices if Bob Go returns no rates, les clients obtiennent toujours le prix fixe pendant que vous corrigez le problème.
Ma boutique n'est pas en rand : Bob Go cote en ZAR. Saisissez la valeur de 1 ZAR dans la devise de votre boutique (par exemple 0.05 pour l'EUR). Sans cela, l'extension ne demande pas de tarifs à Bob Go. Les prix fixes fonctionnent toujours.
La taxe est facturée deux fois sur la livraison : les tarifs Bob Go incluent normalement la TVA. Réglez Tax status sur None.
Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les tarifs Bob Go mis en cache. Les modifications de votre compte Bob Go sont prises en compte après le cache d'1 heure ou lorsque vous enregistrez les réglages.
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 toutes les donné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 sont toujours supprimés. Les réglages, les méthodes de zone et les tarifs en cache ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs lignes de livraison.
Bob Go est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Bob Go ni approuvée par Bob Go.