VibeFox Bob Go for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec 3.0.5.0) ou 4.0.2 et ultérieur (testé avec 4.1.0.3).

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 API. Vous avez besoin d'un compte Bob Go (bobgo.co.za), de votre boutique installée comme canal de vente WooCommerce dans votre compte Bob Go (Sales channels) et de « Rates at checkout » activé pour ce canal. Les services, les prix et les règles se configurent sur 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

Le téléchargement est un seul fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 vfd_bob_go-oc3-(version).ocmod.zip et le paquet OpenCart 4 vfd_bob_go.ocmod.zip. N'installez que le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier vfd_bob_go-oc3-(version).ocmod.zip. L'extension n'ajoute aucune modification OCMOD : vous n'avez donc pas besoin d'actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload du paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type d'extension Shipping. Repérez VibeFox Bob Go et cliquez sur Install (le bouton vert +).

3. Cliquez sur Edit (le bouton crayon) pour ouvrir la page de configuration.

4. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Edit, puis cliquez sur Activate (voir Clé de licence).

5. Dans votre compte Bob Go, installez votre boutique comme canal de vente. Activez « Rates at checkout » pour ce canal et configurez vos services et vos prix.

6. Sur la page Edit, 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). Activez Enable Bob Go et cliquez sur Save.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier vfd_bob_go.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 tire le code de l'extension du nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées, sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type Shipping. Repérez VibeFox Bob Go, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton crayon).

4. Configurez Bob Go, saisissez la clé de licence et les réglages comme aux étapes 4 à 6 pour OpenCart 3. La page des réglages et ses champs sont identiques dans les deux versions.

Après l'installation, la méthode reste désactivée tant que vous n'activez pas Enable Bob Go et n'enregistrez pas. Par défaut, elle utilise les tarifs Bob Go en temps réel. Si vous réinstallez l'extension après une désinstallation, les réglages Bob Go que vous avez conservés sont de nouveau utilisés.

Configuration

Tous les réglages se trouvent sur la page de l'extension : Extensions > Extensions > Shipping > VibeFox Bob Go > Edit. Les sections sont listées à gauche. Un seul bouton Save enregistre toute la page sans la recharger. Chaque enregistrement vide aussi le cache des tarifs Bob Go. Les nombres acceptent un point ou une virgule comme séparateur décimal. Si une valeur est incorrecte, rien n'est enregistré et la page indique la raison : un Method title vide ou de plus de 64 caractères, une valeur qui n'est pas un nombre ("…" must be a number.), un montant ou un poids négatif ("…" must be a number of 0 or more.), un ZAR conversion rate égal ou inférieur à 0, un Minimum weight (kg) supérieur au Maximum weight (kg), ou une classe de taxe ou une zone géographique inconnue. Seuls les utilisateurs administrateurs disposant de l'autorisation de modification pour cette extension peuvent enregistrer les réglages.

Au-dessus des réglages, la page signale quand les tarifs en temps réel ne peuvent pas fonctionner : Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., lorsque l'Afrique du Sud n'a aucune zone (province) dans votre boutique, ou lorsque la boutique n'a pas de classe de poids avec l'unité « kg » ni de classe de longueur avec l'unité « cm ». Dans ce dernier cas, les poids et dimensions sont convertis d'après le nom de l'unité de leur classe (kg, g, lb, oz ; cm, mm, m, in), et les autres unités sont lues comme kg ou cm.

Général

Les réglages s'appliquent à chaque zone géographique. Au moment du paiement, chaque service Bob Go est une option de livraison distincte sous le titre de la méthode.

Enable Bob Go : affiche ou masque Bob Go au moment du paiement. Par défaut : désactivé.

Method title : le nom de la méthode de livraison affiché au client. Les services Bob Go, par exemple « The Courier Guy - Economy », sont listés en dessous avec leurs noms Bob Go. Par défaut : Bob Go. Obligatoire, 64 caractères maximum.

Shipping cost : la manière dont le prix est calculé.

La raison de l'absence de tarifs en temps réel est écrite dans le journal. Elle n'est jamais affichée au client.

Sort order : la position de Bob Go parmi les méthodes de livraison au moment du paiement. Un nombre entier.

Compte Bob Go

Cette section explique ce dont vous avez besoin sur Bob Go, avec des liens vers votre compte Bob Go, Sales channels et Rates at checkout. Elle affiche aussi 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 403), ou request failed avec le code d'erreur, ou no connection.

Store domain : Bob Go identifie votre boutique par son domaine. Laissez ce champ vide pour utiliser le domaine de votre boutique, qui est indiqué dans la description du champ. Saisissez un autre domaine uniquement si votre canal sur Bob Go est installé sous une adresse différente, par exemple example.co.za/shop pour une boutique placée dans un sous-dossier. Le protocole et la barre oblique finale sont supprimés.

ZAR conversion rate : Bob Go cote en rands sud-africains (ZAR). Si la devise par défaut de votre boutique n'est pas le ZAR, indiquez combien vaut 1 ZAR dans votre devise, par exemple 0.05. Les tarifs sont convertis avec ce taux, et les prix des produits sont envoyés à Bob Go en ZAR. Laissez le champ vide pour ne pas utiliser les tarifs Bob Go en temps réel dans votre devise (les prix fixes fonctionnent toujours). Le taux doit être supérieur à 0. Si la devise de votre boutique est le ZAR, laissez le champ vide.

Delivery dates : affiche la plage de dates de livraison estimée fournie par Bob Go à côté de chaque service au moment du paiement. L'estimation est toujours enregistrée avec la commande et visible sur la page de commande.

Expédition depuis (adresse d'origine)

L'adresse d'origine est envoyée à Bob Go avec chaque demande de tarifs. L'adresse de la boutique dans OpenCart est un texte libre : seuls le pays et la région de votre boutique (System > Settings > Store > Local) sont utilisés. Si le pays de la boutique est le pays d'origine, une province vide est reprise de la région de la boutique. Saisissez ici la ville, le code postal et la rue.

Origin country : le pays depuis lequel vous expédiez. Par défaut : South Africa. Bob Go livre uniquement en Afrique du Sud.

Origin province : une province sud-africaine, ou Store region (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 depuis laquelle vous expédiez, par exemple 123 Main Street.

Prix fixes (utilisés lorsque Shipping cost est sur Fixed prices (below), et en solution de secours lorsque Bob Go ne renvoie aucun tarif)

Price per country : une ligne par pays : un code pays de 2 lettres, un signe égal et le prix dans la devise par défaut de votre boutique, hors taxes, par exemple ZA=99.99. Utilisez * pour tous les autres pays, par exemple *=199.99 sur la ligne suivante. Les lignes dans un autre format sont supprimées à l'enregistrement, et la page les liste dans un avertissement.

Flat price : le prix pour les pays sans ligne ci-dessus. Laissez le champ vide pour masquer la méthode pour ces pays.

Fixed price applies : Per order (par défaut) 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'expédition complète.

Conditions

Minimum weight (kg) : masque la méthode en dessous de ce poids de panier. 0 signifie aucune limite (par défaut).

Maximum weight (kg) : masque la méthode au-dessus de ce poids de panier. 0 signifie aucune limite (par défaut).

Minimum order amount : n'affiche la méthode que lorsque le sous-total des produits à expédier (après le coupon, hors taxes) atteint ce montant. Laissez le champ vide pour toujours l'afficher.

Free shipping : active la livraison gratuite lorsque le montant de commande indiqué ci-dessous est atteint.

Free shipping from : le sous-total des produits à expédier (après le coupon, hors taxes) à partir duquel la livraison est gratuite. Utilisé uniquement lorsque Free shipping est activé. Bob Go n'est alors pas interrogé pour les tarifs.

Tax class : la classe de taxe des frais de port, ou No tax (par défaut). Les tarifs Bob Go incluent généralement déjà la TVA. Dans ce cas, laissez No tax afin que la taxe ne soit pas appliquée deux fois sur la livraison.

Geo zone : proposer Bob Go uniquement pour les adresses de cette zone géographique. All zones (par défaut) signifie aucune limite. Non utilisé lorsque Ignore shipping zones est activé. Les zones géographiques sont gérées dans System > Localisation > Geo Zones.

Disponibilité sans zones de livraison

Ignore shipping zones : lorsqu'il est activé, la zone géographique n'est pas vérifiée et la méthode est proposée pour les pays ci-dessous.

Countries : les pays de destination pour ce mode. Laissez le champ vide pour autoriser tous les pays. Utilisé uniquement lorsque Ignore shipping zones est activé.

Avancé

Debug log : écrit les calculs de tarifs et les requêtes vers Bob Go dans storage/logs/vfd_bobg_debug.log.php. Ce fichier ne peut pas être lu depuis le web. Les adresses des clients ne sont pas journalisées. Les erreurs de Bob Go sont journalisées même lorsque cette option est désactivée. Désactivez le journal lorsque vous avez terminé. Lorsque le fichier atteint 5 Mo, il est déplacé vers vfd_bobg_debug.old.log.php et un nouveau journal est commencé.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Remove data on uninstall : lorsqu'il est activé, la désinstallation de l'extension supprime les réglages Bob Go, les tarifs en cache et les journaux. Le service Bob Go enregistré avec les commandes est conservé. Lorsqu'il est désactivé (par défaut), tout est conservé pour une réinstallation.

Import / Export

Export : cliquez sur Download JSON pour enregistrer les réglages dans un fichier JSON.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les réglages, par exemple sur une autre boutique. Les valeurs sont vérifiées comme lors d'un enregistrement normal.

Fonctionnement au moment du paiement

Lorsque OpenCart affiche les méthodes de livraison, il demande à l'extension les tarifs Bob Go. Si une Geo zone est définie (et que Ignore shipping zones est désactivé) et que l'adresse se trouve en dehors, Bob Go n'est pas proposé. Seuls les produits dont Requires Shipping est sur Yes comptent : les autres produits n'ajoutent aucun poids et ne sont pas inclus dans le montant de la commande. L'extension vérifie ensuite le pays de destination (avec Ignore shipping zones), le poids du panier et le Minimum order amount. Le montant de commande correspond au prix des produits à expédier, après la remise du coupon et avant taxes. Les cartes cadeaux, les points de fidélité et les avoirs de la boutique ne sont pas pris en compte. Si la livraison gratuite s'applique, le client voit Bob Go (free) (le titre de votre méthode) 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 (avec la province) et les articles du panier : prix des produits en ZAR, poids et dimensions, et le modèle du produit comme SKU. Pour les adresses sud-africaines, la zone OpenCart est envoyée sous forme de code de province (EC, FS, GP, KZN, LP, MP, NC, NW, WC). Les tarifs en temps réel ne sont demandés qu'après que le client a saisi une ville ou un code postal. Les tarifs en ZAR sont convertis avec le ZAR conversion rate lorsque la devise de votre boutique n'est pas le ZAR. Le prix est calculé dans votre devise par défaut, arrondi à ses décimales, puis affiché au client dans sa devise, avec la taxe de la Tax class sélectionnée.

Sous le titre de la méthode, le client voit une option par service Bob Go, avec son nom, son prix et, si Delivery dates est activé, les dates de livraison estimées entre parenthèses. Le client choisit un service comme toute autre option de livraison d'OpenCart. Avec un prix fixe, il n'y a qu'une seule option portant le titre de la méthode.

Sur OpenCart 4, le client clique sur Choose dans le bloc du mode de livraison de la page de paiement et choisit un service Bob Go dans la fenêtre Shipping method options, par exemple SkyNet - Overnight (by 17/10/2026) avec son prix. La méthode fonctionne comme sur OpenCart 3.

Les tarifs sont mis en cache pendant 1 heure par demande complète, afin que le même panier ne déclenche pas une 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, en mode de secours, le prix fixe est utilisé. La raison est écrite dans le journal.

L'extension n'affiche que des tarifs. Elle ne crée ni envois, ni lettres de transport, ni étiquettes, ne suit pas les colis, ne synchronise pas les commandes avec Bob Go et n'envoie pas de notifications. Pour l'exécution des expéditions, utilisez le tableau de bord de Bob Go. Il n'y a pas de sélection de point relais ou de consigne. Bob Go livre uniquement en Afrique du Sud.

Commandes

Le nom du service choisi est la méthode de livraison de la commande ; il apparaît donc dans les e-mails de commande, dans Sales > Orders et dans le compte du client. Lorsque la commande est passée, le service Bob Go, son code et l'estimation de livraison sont aussi enregistrés avec la commande. Les modifications ultérieures du panier ou des prix Bob Go ne les changent pas. Sur OpenCart 4, le paiement conserve une seule commande : si le client revient en arrière et confirme à nouveau la commande avec un autre service Bob Go, le service enregistré est mis à jour, et avec une autre méthode de livraison ou un prix fixe, il est supprimé.

Dans l'administration, la page de commande sous Sales > Orders affiche un bloc Bob Go avec Bob Go service (nom et code) et Estimated delivery. Le client voit Bob Go service et Estimated delivery sur la page de détail de commande de son compte. Les commandes à prix fixe ou en livraison gratuite n'ont pas de service Bob Go.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Bob Go est le premier bloc de Extensions > Extensions > Shipping > VibeFox Bob Go > Edit, au-dessus des réglages. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) et les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. Plus bas figurent la ligne Product: opencart-shipping-bob-go et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant de l'autorisation de modification pour l'extension peuvent changer la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

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

Sans clé active, Bob Go n'est pas affiché aux clients au moment du paiement et aucun tarif n'est calculé. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours la méthode dans la boutique, marquée (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, donc sans clé active la méthode est masquée pour tout le monde. Une fois la page Edit ouverte une fois, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. 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. Le statut est vérifié à nouveau automatiquement lorsque vous ouvrez le Dashboard ou la page Edit de l'administration : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de la licence.

Dépannage

Bob Go n'apparaît pas au moment du paiement : vérifiez que la licence est active et que Enable Bob Go est activé. Vérifiez la Geo zone, ou activez Ignore shipping zones et vérifiez Countries. Vérifiez les limites de poids et le Minimum order amount. En mode prix fixe, vérifiez que le pays, * ou le Flat price a un prix. Vérifiez que les produits ont Requires Shipping sur Yes.

Aucun tarif Bob Go n'est affiché : ouvrez la page de l'extension. La section Compte Bob Go affiche la dernière réponse de Bob Go. « The WooCommerce channel is not installed on Bob Go » (HTTP 404) signifie que le domaine de la boutique n'est pas un canal de vente sur Bob Go : vérifiez le Store domain. « Rates at checkout is not enabled » (HTTP 401) signifie que la fonction est désactivée pour le canal. Vérifiez aussi que le client a saisi une ville ou un code postal et, pour les boutiques qui ne sont pas en ZAR, que le ZAR conversion rate est défini. Activez le Debug log, rechargez le paiement et consultez le champ Log. 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 rands : Bob Go cote en ZAR. Indiquez combien vaut 1 ZAR dans la devise de votre boutique. Sans cette valeur, l'extension ne demande aucun tarif à Bob Go. Les prix fixes fonctionnent toujours.

La page signale que l'Afrique du Sud n'a aucune zone : ajoutez les provinces d'Afrique du Sud dans System > Localisation > Zones, sinon Bob Go ne reçoit aucune province pour les adresses sud-africaines.

La taxe est appliquée deux fois sur la livraison : les tarifs Bob Go incluent normalement la TVA. Réglez Tax class sur No tax.

Les tarifs semblent obsolètes après une modification : cliquez sur Save sur la page de l'extension. Cela vide le cache des tarifs Bob Go. Les modifications faites dans votre compte Bob Go sont prises en compte après le cache de 1 heure ou lorsque vous enregistrez les réglages.

La page indique « Warning: You do not have permission to modify VibeFox Bob Go! » : le groupe d'utilisateurs de votre administration ne peut probablement que consulter les réglages. Accordez au groupe l'autorisation de modification pour extension/shipping/vfd_bob_go (OpenCart 3) ou extension/vfd_bob_go/shipping/vfd_bob_go (OpenCart 4) dans System > Users > User Groups.

Pour les développeurs : l'adresse de l'API Bob Go peut être remplacée par le réglage vfd_bobg_api_url (pour les tests) ; il n'a pas de champ sur la page de réglages.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Shipping et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Bob Go. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart réinitialise toujours Enable Bob Go, Sort order, Tax class et Geo zone. Les tarifs en cache sont toujours supprimés. Si Remove data on uninstall est activé, les réglages Bob Go et le journal sont aussi supprimés. S'il est désactivé, les autres réglages sont conservés et réutilisés lors d'une nouvelle installation de l'extension. Le service Bob Go enregistré avec les commandes est toujours conservé, et les commandes existantes gardent leur méthode de livraison et leur coût.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Bob Go dans la liste des extensions installées, puis sur Delete (le bouton rouge corbeille) pour supprimer le paquet envoyé.

Bob Go est une marque commerciale de son propriétaire respectif. Cette extension n'est pas affiliée à Bob Go et n'est pas approuvée par Bob Go.