VibeFox GLS ParcelShop for WooCommerce — Aide
Prérequis
WordPress : 5.8 ou ultérieur.
WooCommerce : 7.0 ou ultérieur, installé et actif. L'extension refuse de s'activer sans lui.
PHP : 8.0 ou ultérieur.
GLS : l'extension n'utilise ni ne nécessite de compte GLS ni de clé d'API. La carte des points relais est publique. Vous avez besoin d'un contrat avec GLS pour expédier les colis vers les points relais choisis.
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_gls_parcelshop dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, 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 le nom et vos tarifs : au moins une ligne de Country prices (par exemple * Default) ou un Fallback cost (voir Configuration).
6. Ajoutez VibeFox GLS ParcelShop à une zone 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 GLS ParcelShop. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez le mode de livraison à une zone, la fenêtre de la zone ne contient qu'un seul champ :
Title (zone) : le nom du mode de livraison que le client voit dans cette zone. Laissez-le vide pour utiliser le Name général.
Des avertissements en haut de la page des réglages signalent les problèmes de configuration, par exemple lorsqu'aucun tarif n'est défini ou qu'aucun des pays sélectionnés n'est couvert par la carte GLS. Les nombres non valides sont refusés avec un message, et la valeur précédente est conservée.
Général
Cette section liste les pays couverts par la carte GLS. Le mode de livraison n'est pas proposé pour les autres pays de destination.
Enable/Disable : active ou désactive le mode de livraison dans toutes les zones à la fois. Par défaut : activé.
Name : le nom du mode de livraison affiché au client. Une zone peut le remplacer par son propre Title. Par défaut : GLS ParcelShop.
Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas. Par défaut : Taxable.
Tarifs
Les tarifs sont saisis dans la devise de votre boutique. Les décimales peuvent utiliser la virgule ou le point (4,99 ou 4.99).
Calculation type : la manière dont le tarif est appliqué.
Country prices : un tableau avec une ligne par pays de destination. Cliquez sur + Add country pour ajouter une ligne, et sur la croix pour en supprimer une. Chaque ligne comporte un Country, un Price et cinq 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. La colonne correspondant au poids du panier est utilisée. Une colonne de poids laissée à 0 utilise la colonne Price. La ligne * Default sert aux pays qui n'ont pas de ligne propre. Les nouvelles lignes commencent avec 0 dans chaque colonne, et une ligne dont tous les tarifs sont à 0 correspond à une livraison gratuite. Renseignez donc les tarifs avant d'enregistrer.
Fallback cost : le tarif utilisé lorsque le tableau n'a pas de ligne pour le pays de destination et pas de ligne * Default. Laissez-le vide pour masquer le mode de livraison pour ces pays.
Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison GLS ParcelShop est gratuite. Laissez-le vide si la livraison n'est jamais gratuite.
Disponibilité
Minimum weight (kg) : masque le mode de livraison lorsque le panier pèse moins. Le poids est converti à partir de l'unité de poids de votre boutique. Vide ou 0 signifie pas de limite.
Maximum weight (kg) : masque le mode de livraison lorsque le panier pèse plus. Par défaut : 20. Les points relais GLS acceptent en général les colis jusqu'à 20 kg, vérifiez donc votre contrat GLS. Vide ou 0 signifie pas de limite.
Minimum cart subtotal : propose le mode de livraison uniquement lorsque le sous-total du panier (après remises, hors taxes) atteint ce montant. Laissez-le vide s'il n'y a pas de minimum.
Excluded shipping classes : masque le mode de livraison lorsque le panier contient un produit appartenant à l'une de ces classes de livraison WooCommerce.
Ignore shipping zones : lorsque l'option est activée, le mode de livraison est proposé pour les pays sélectionnés ci-dessous, même s'il n'est pas ajouté à la zone de livraison correspondante. Lorsqu'elle est désactivée, il n'est proposé que dans les zones auxquelles il est ajouté. Par défaut : désactivé.
Countries (ignore zones mode) : les pays de destination pour ce mode. Laissez-le vide pour utiliser tous les pays de la carte GLS. Les pays non couverts par la carte GLS sont ignorés. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé.
Avancé
Debug log : consigne le calcul des tarifs et les choix de points relais dans WooCommerce > Status > Logs (source vfd-gls-parcelshop). Aucune donnée personnelle du client n'est consignée. Désactivez le journal une fois vos tests terminés.
Remove data on uninstall : lorsque l'option est activée, la suppression de l'extension supprime les réglages et les instances de zone de ce mode. La désactivation de l'extension ne supprime jamais rien. Le point relais enregistré dans les commandes est toujours conservé.
Fonctionnement sur la page de 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 couvert par la carte GLS, poids du panier, sous-total minimum du panier et classes de livraison exclues. Si le sous-total du panier atteint Free shipping from, la livraison est gratuite. Sinon, le tarif est tiré de la ligne du pays (ou de la ligne * Default) et de la colonne de poids, ou de Fallback cost. Si aucun tarif n'est trouvé, le mode de livraison est masqué.
Lorsque le client sélectionne GLS ParcelShop, un bouton Select GLS ParcelShop apparaît sous le mode de livraison. Il ouvre la carte officielle des points relais GLS pour le pays de livraison. Une fois un point relais choisi, son nom et son adresse s'affichent, et le bouton devient Change ParcelShop. Le choix est conservé dans la session du client, il reste donc après une mise à jour de la page de paiement ou un rechargement de la page.
Lors de la validation de la commande, l'extension vérifie qu'un point relais a été choisi et qu'il se trouve dans le pays de livraison. Sinon, le client voit Veuillez sélectionner un point relais GLS ParcelShop. ou Le point relais GLS ParcelShop sélectionné ne se trouve pas dans votre pays de livraison. Veuillez choisir à nouveau un point relais., et la commande n'est pas passée. Si le script de la carte GLS ne peut pas être chargé, le client voit un message l'invitant à recharger la page ou à choisir un autre mode de livraison.
La carte GLS s'exécute dans le navigateur du client. Sur la page de paiement, l'extension charge le script de la carte GLS depuis map.gls-croatia.com, et la carte charge les données des points relais et les tuiles de la carte depuis GLS. GLS reçoit les données habituelles de la requête du visiteur (adresse IP, navigateur). Rien n'est envoyé de votre serveur à GLS.
Le mode de livraison fonctionne sur la page de paiement classique et dans les blocs Panier et Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).
L'extension n'obtient pas de tarifs GLS en temps réel, ne crée pas d'envois GLS, n'imprime pas d'étiquettes et ne suit pas les colis. Elle ne dispose pas de liste des points relais sur votre serveur, elle ne peut donc pas vérifier l'identifiant du point relais auprès de GLS. Transmettez l'identifiant du point relais de la commande à GLS de la manière habituelle (MyGLS, votre logiciel GLS ou une autre extension).
Points relais
Le point relais choisi est enregistré avec la commande : son identifiant, son nom avec l'adresse et son pays.
Écran d'administration de la commande : le nom et l'adresse du point relais, avec son identifiant et son pays, sont affichés sous l'adresse de livraison. Si une commande GLS ParcelShop n'a pas de point relais, l'écran affiche Aucun point relais n'a été sélectionné pour cette commande.
Pages client : le point relais est affiché sur la page de remerciement et sur la page d'affichage de la commande dans le compte client.
E-mails : le point relais est ajouté aux e-mails de commande, en HTML et en texte brut. Les e-mails envoyés à l'administrateur de la boutique incluent également l'identifiant du point relais.
Les développeurs peuvent lire le point relais à partir des métadonnées de commande _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name et _vfd_glps_parcelshop_country.
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 GLS ParcelShop. 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 sa place de domaine. Libérez la place dans votre compte vibefox.net.
Sans clé active, GLS ParcelShop n'est pas affiché aux clients sur la page de paiement. Les gestionnaires de la boutique connectés le voient toujours, marqué (non licencié — visible uniquement par les administrateurs), 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
GLS ParcelShop n'apparaît pas sur la page de paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode de livraison est ajouté à la zone du pays du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Vérifiez que le pays de destination fait partie des pays de la carte GLS et qu'il a un tarif (une ligne de pays, la ligne * Default ou Fallback cost). Vérifiez les limites de poids, Minimum cart subtotal et Excluded shipping classes. Activez Debug log pour voir la raison dans WooCommerce > Status > Logs.
La carte ne s'ouvre pas : le client voit « La carte GLS ParcelShop n'a pas pu être chargée... » lorsque le script GLS est bloqué, par exemple par un bloqueur de publicités ou de confidentialité, une politique de sécurité du contenu ou une panne de GLS. Autorisez map.gls-croatia.com dans votre politique de sécurité du contenu.
La livraison est gratuite pour un pays par erreur : vérifiez la ligne de ce pays dans Country prices. Une ligne dont le Price et toutes les colonnes de poids sont à 0 donne une livraison gratuite.
Le tableau ou un champ n'a pas été enregistré : une valeur n'est pas un nombre valide. Le message en haut de la page indique la valeur concernée. Utilisez des chiffres avec une virgule ou un point comme séparateur décimal.
Filtres pour développeurs : vfd_glps_map_countries modifie la liste des pays de la carte GLS, vfd_glps_widget_url modifie l'URL du script de la carte GLS.
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 une place 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, ainsi que les anciens caches et le fichier journal de la version 1.0. Les réglages et les instances de zone du mode de livraison ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Le point relais enregistré dans les commandes est toujours conservé, et les commandes existantes gardent leurs lignes de livraison.
GLS est une marque déposée de son propriétaire. Cette extension n'est ni affiliée à GLS ni approuvée par GLS.