VibeFox GIG Logistics for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Identifiants de l'API GIG Logistics (uniquement pour les tarifs en temps réel) : les tarifs en temps réel utilisent l'API tierce de GIG Logistics. GIG Logistics délivre aux clients professionnels un nom d'utilisateur d'API (généralement une adresse e-mail) et un mot de passe. Demandez-les sur la page développeur de GIG Logistics (giglogistics.com/developer). Les identifiants de test ne fonctionnent qu'avec l'API de test. Si vous n'utilisez que la grille tarifaire et le coût de secours, vous n'avez pas besoin d'identifiants API.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne pour 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_gig_logistics dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

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

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

5. Renseignez la grille tarifaire et/ou le coût de secours. Pour les tarifs en temps réel, saisissez aussi le nom d'utilisateur et le mot de passe de l'API, le téléphone de l'expéditeur, la ville et l'État d'enlèvement, ainsi que le taux de conversion de devise si la devise de votre boutique n'est pas NGN (voir Configuration).

6. Ajoutez VibeFox GIG Logistics à une zone d'expédition pour le Nigeria dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones et choisissez les pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox GIG Logistics. 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 que voient les clients pour cette zone. Laissez vide pour utiliser le Method title général.

Au-dessus des champs, la page affiche des avertissements lorsque les tarifs en temps réel ne peuvent pas être utilisés : un seul des deux identifiants API (nom d'utilisateur ou mot de passe) est saisi, Sender phone ou la ville et l'État d'enlèvement sont manquants, ou la devise de la boutique n'est pas NGN et aucun Currency conversion rate n'est défini. À chaque enregistrement des réglages, les tarifs et jetons API en cache sont effacés.

General

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

Method title : le nom du mode d'expédition affiché dans le panier et au paiement. Par défaut : GIG Logistics. Le titre d'une zone le remplace.

Tax status : Taxable ajoute la taxe d'expédition de votre boutique au coût, None ne l'ajoute pas. Choisissez None si le tarif GIG inclut déjà tout ce que vous voulez facturer.

API GIG Logistics (tarifs en temps réel) (facultatif)

Avec des identifiants API, le tarif est demandé à GIG Logistics pour chaque adresse au Nigeria. Sans identifiants, ou lorsque l'API ne donne pas de tarif, la grille tarifaire et le coût de secours sont utilisés.

API username : votre nom d'utilisateur de l'API tierce GIG Logistics, généralement votre adresse e-mail.

API password : votre mot de passe de l'API tierce GIG Logistics. Il sert uniquement à se connecter à l'API et n'est jamais journalisé.

Test mode : utilise l'API de test (dev) de GIG Logistics. Les identifiants de test ne fonctionnent qu'avec l'API de test. Désactivez-le pour obtenir des tarifs réels. Par défaut : désactivé.

Currency conversion rate : GIG Logistics renvoie les tarifs en NGN. Si la devise de votre boutique n'est pas NGN, indiquez la valeur d'un NGN dans la devise de votre boutique (1 NGN = ? de votre devise, par exemple 0.0006). Sans lui, les tarifs GIG en temps réel ne sont pas utilisés. Si la devise de votre boutique est NGN, ce champ n'est pas nécessaire. Le point et la virgule sont tous deux acceptés comme séparateur décimal.

Adresse d'enlèvement (expéditeur)

Lieu où GIG Logistics récupère les colis, au Nigeria. Si votre boutique est au Nigeria, les champs de rue, de ville et d'État laissés vides utilisent l'adresse de la boutique issue de WooCommerce > Settings > General.

Sender name : le nom de l'expéditeur transmis à GIG Logistics. Vide : le nom du site est utilisé.

Sender phone : votre numéro de téléphone, par exemple 08030000000. GIG Logistics l'exige pour les tarifs en temps réel.

Street address : l'adresse de rue de l'enlèvement.

City / area : la ville ou le quartier d'enlèvement, par exemple Victoria Island. Obligatoire pour les tarifs en temps réel.

State : l'État nigérian de l'adresse d'enlèvement. Par défaut, l'État de la boutique est utilisé. Obligatoire pour les tarifs en temps réel.

Pickup latitude : latitude facultative du point d'enlèvement sur la carte, par exemple 6.4281. GIG Logistics calcule le tarif selon la distance. Vide : les coordonnées sont déterminées à partir de l'adresse.

Pickup longitude : longitude facultative du point d'enlèvement sur la carte, par exemple 3.4219.

Address lookup : recherche les coordonnées cartographiques des adresses avec OpenStreetMap (Nominatim). GIG Logistics calcule le tarif à partir des coordonnées d'enlèvement et de livraison. La rue, la ville et l'État du client sont envoyés à nominatim.openstreetmap.org, et les résultats sont mis en cache pendant 30 jours. Sans cette option, seul le texte de l'adresse est envoyé, et GIG Logistics peut ne pas renvoyer de tarif. Par défaut : activé.

Grille tarifaire et coût de secours

Utilisée pour les autres pays, lorsque les tarifs en temps réel ne sont pas configurés ou lorsque GIG Logistics ne donne pas de tarif. Les tarifs sont exprimés dans la devise de votre boutique.

Country prices : un tableau avec un tarif de base par pays. Cliquez sur Add country pour ajouter une ligne et sur la croix pour en supprimer une. Choisissez * Any other country pour tous les pays sans ligne propre. Les colonnes XS (jusqu'à 1 kg), S (jusqu'à 2 kg), M (jusqu'à 3 kg), L (jusqu'à 5 kg) et XL (au-delà de 5 kg) sont des tarifs facultatifs par tranche de poids : un tarif de tranche supérieur à 0 remplace le tarif de base pour les paniers de cette tranche. Un tarif de 0 signifie livraison gratuite. Les cellules de tarif vides sont enregistrées comme 0 ; renseignez donc le tarif de base de chaque ligne ajoutée. Les pays sans ligne (lorsqu'il n'existe pas de ligne *) n'ont pas de tarif de grille.

Fallback cost : utilisé lorsque ni GIG Logistics ni la grille ne donnent de tarif. Vide : le mode d'expédition est masqué dans ce cas.

Table / fallback price is : Per order facture le tarif une seule fois. Per item (multiplied by the number of items) le multiplie par le nombre d'articles du panier. Les tarifs GIG en temps réel concernent toujours la commande entière.

Conditions

Free shipping from : le sous-total du panier à partir duquel la livraison est gratuite. Vide : jamais gratuite.

Minimum subtotal : affiche la méthode seulement lorsque le sous-total du panier atteint ce montant. Vide : toujours affichée.

Min weight (kg) : le poids minimal du panier en kg. Les poids des produits sont convertis depuis l'unité de poids de votre boutique. 0 signifie sans limite.

Max weight (kg) : le poids maximal du panier en kg. Par défaut : 30. 0 signifie sans limite.

Excluded shipping classes : masque la méthode si le panier contient des produits de ces classes d'expédition WooCommerce.

Disponibilité sans zones d'expédition

Ignore shipping zones : propose la méthode pour les pays indiqués ci-dessous, même si elle n'est pas ajoutée à une zone. Lorsque cette option est désactivée, la méthode n'apparaît que dans les zones d'expédition auxquelles elle a été ajoutée.

Countries : les pays de destination pour ce mode. Vide : tous les pays vers lesquels vous expédiez. Utilisé uniquement avec Ignore shipping zones.

Avancé

Debug log : journalise les calculs de tarifs dans WooCommerce > Status > Logs, source vfd-gig-logistics. Les erreurs de l'API sont toujours journalisées, même lorsque le journal est désactivé. Aucun mot de passe, jeton ni adresse de client n'est écrit.

Remove data on uninstall : lorsque cette option est activée, la suppression de l'extension efface ses réglages, ses méthodes de zone et ses caches. La désactivation de l'extension ne supprime jamais rien.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie d'abord les conditions : pays de livraison, poids du panier, sous-total minimal et classes d'expédition exclues. Si le sous-total atteint Free shipping from, la méthode s'affiche au tarif de 0, mais seulement si le pays a un tarif : une ligne dans Country prices, un Fallback cost ou un tarif GIG Logistics en temps réel. GIG Logistics n'est interrogé que lorsque la grille et le coût de secours ne donnent pas de tarif.

Le tarif est ensuite pris dans la première source qui en donne un. D'abord le tarif GIG Logistics en temps réel, si des identifiants API sont saisis, si l'adresse est au Nigeria, si le client a saisi une ville ou un État, si le téléphone, la ville et l'État d'enlèvement sont renseignés, et si un taux de conversion est défini pour les boutiques qui n'utilisent pas NGN. L'extension se connecte à l'API GIG Logistics et envoie les adresses et coordonnées d'enlèvement et de livraison ainsi que les articles du panier avec leurs noms, quantités, poids et valeurs. Les produits sans poids sont envoyés comme 1 kg. Le tarif est demandé pour une livraison en bike. Ensuite, la grille Country prices. Puis le Fallback cost. Si aucune source ne donne de tarif, le mode d'expédition est masqué pour ce panier.

Chaque réponse de GIG est mise en cache pendant 1 heure, afin que le même panier ne déclenche pas une nouvelle requête. Une requête échouée ou une connexion échouée est mise en cache pendant 10 minutes, pour que le paiement n'attende pas GIG Logistics à chaque actualisation. Le jeton de connexion est conservé pendant 30 minutes et renouvelé automatiquement lorsque GIG le refuse. Le délai d'attente de l'API est de 10 secondes, celui de la recherche d'adresse de 5 secondes.

Si GIG Logistics renvoie une erreur ou un tarif nul, le client ne voit aucune erreur. Le tarif de la grille ou le coût de secours est utilisé, et l'erreur est journalisée.

La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS).

L'extension calcule uniquement les tarifs. Elle ne crée pas d'expéditions, de bordereaux ou d'étiquettes GIG Logistics, ne réserve pas d'enlèvements, ne suit pas les colis et ne permet pas aux clients de choisir un centre de service. Les commandes sont expédiées via votre compte GIG Logistics comme d'habitude. Les tarifs en temps réel ne sont demandés que pour les adresses au Nigeria. Pour les autres pays, utilisez la grille tarifaire.

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 GIG Logistics. 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 pour 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, GIG Logistics n'est pas affiché aux clients au paiement. Les gestionnaires de la boutique connectés 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 Extensions 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. Le statut est vérifié de nouveau automatiquement en arrière-plan.

Dépannage

GIG Logistics 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 subtotal et Excluded shipping classes. Vérifiez que la grille (le pays ou *) ou le Fallback cost donne un tarif pour le pays.

Le tarif vient de la grille, pas de GIG Logistics : les tarifs en temps réel nécessitent le nom d'utilisateur et le mot de passe de l'API, le Sender phone, la ville et l'État d'enlèvement, une adresse de livraison au Nigeria avec une ville ou un État et, pour les boutiques qui n'utilisent pas NGN, le Currency conversion rate. Consultez les avertissements en haut de la page de réglages. Activez le Debug log, rechargez le paiement et ouvrez WooCommerce > Status > Logs, source vfd-gig-logistics, pour voir la raison. Une requête échouée est relancée après 10 minutes.

Login failed dans le journal : GIG Logistics a refusé le nom d'utilisateur ou le mot de passe de l'API. Vérifiez-les et vérifiez Test mode : les identifiants de test ne fonctionnent qu'avec l'API de test. Enregistrez les réglages pour relancer immédiatement.

GIG Logistics ne renvoie pas de tarif : GIG calcule les tarifs selon la distance. Gardez Address lookup activé, ou saisissez Pickup latitude et Pickup longitude. Confirmez les tarifs avec votre compte GIG Logistics avant la mise en production.

La taxe s'ajoute au tarif GIG : réglez Tax status sur None si le tarif GIG inclut déjà tout ce que vous voulez facturer.

Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les tarifs et jetons en cache.

Géocodeur personnalisé : les développeurs peuvent fournir leur propre recherche d'adresse avec le filtre vfd_gigl_pre_geocode.

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 statut 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 le statut de licence de cette extension sont toujours supprimés. Les réglages, méthodes de zone, tarifs en cache, jetons et recherches d'adresses ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les commandes existantes conservent leurs lignes d'expédition.

GIG Logistics est une marque commerciale de son titulaire respectif. Cette extension n'est ni affiliée à GIG Logistics, ni approuvée par GIG Logistics.