VibeFox Packeta 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.
Clé API Packeta : vous la trouvez dans l'espace client de Packeta (client.packeta.com), sous Client support. Elle comporte 16 lettres et chiffres. Le widget en a besoin pour s'ouvrir au paiement ; la méthode n'est donc affichée aux clients qu'après la saisie de la clé API.
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_packeta dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Packeta, 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, puis cliquez sur Activate.
5. Saisissez votre API key Packeta et vos tarifs : au moins une ligne Country prices (par exemple * Default) ou un Fallback cost. Enregistrez. La page indique si Packeta a accepté la clé.
6. Ajoutez VibeFox Packeta à vos zones de livraison pour la République tchèque, la Slovaquie, la Hongrie ou la Roumanie, 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 Packeta. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un champ :
Title (zone) : le nom que les clients voient dans cette zone. Laissez-le vide pour utiliser le Name général.
La méthode n'est proposée que pour les pays du réseau de points relais propre à Packeta : CZ, SK, HU et RO. Au-dessus des réglages, la page affiche le résultat de la vérification de la clé API ainsi que des avertissements, par exemple l'absence de clé API, de prix, ou des pays sélectionnés hors du réseau Packeta.
Tous les prix et limites acceptent la virgule ou le point comme séparateur décimal (4,99 ou 4.99). Un nombre non valide est refusé avec un message, et la valeur précédente est conservée.
Général
Enable/Disable : active ou désactive la méthode dans toutes les zones à la fois.
Name : le nom de la méthode de livraison affiché au client. Une zone peut le remplacer par son propre Title. Par défaut : Packeta pickup point.
API key : votre clé API Packeta, disponible dans client.packeta.com > Client support. Vous pouvez aussi coller le mot de passe API de 32 caractères : seuls ses 16 premiers caractères, qui constituent la clé API, sont enregistrés. La clé API est publique : elle est envoyée au navigateur du client pour ouvrir le widget. Lorsque vous enregistrez une nouvelle clé, elle est vérifiée auprès du flux transporteurs de Packeta, et la page affiche Packeta API key verified ou indique que Packeta l'a refusée. Si la vérification ne peut pas être effectuée, la clé est enregistrée et vérifiée à nouveau lors de votre prochain enregistrement.
Widget language : la langue du widget des points relais. Store / visitor language (par défaut) suit la langue de la page. Vous pouvez aussi la fixer sur le tchèque, le slovaque, le hongrois, le roumain, l'anglais, l'allemand, le polonais ou l'ukrainien.
Pickup point types : les points Packeta proposés par le widget.
Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.
Tarifs
Packeta ne propose pas d'API publique de tarifs. Les prix proviennent de ce tableau et sont saisis dans la devise de la boutique.
Calculation type : Per order facture le prix une seule fois. Per item (price x quantity) le multiplie par le nombre d'articles livrables du panier.
Country prices : un prix par pays de destination et par poids du colis. Cliquez sur + Add country pour ajouter une ligne, et sur la croix pour en supprimer une. Chaque ligne comporte un Price et des colonnes de poids : XS jusqu'à 1 kg, S de 1 à 2 kg, M de 2 à 3 kg, L de 3 à 5 kg et XL au-delà de 5 kg. Une colonne de poids laissée à 0 utilise la colonne Price. La ligne * Default s'applique aux pays sans ligne propre. Une nouvelle ligne commence en * Default avec tous les prix à 0, ce qui signifie livraison gratuite. Choisissez le pays et saisissez les prix avant d'enregistrer, ou supprimez la ligne. Si un même pays figure dans deux lignes, seule la première est conservée à l'enregistrement.
Fallback cost : utilisé lorsque le tableau des pays n'a pas de ligne pour la destination et qu'il n'existe pas de ligne * Default. Laissez-le vide pour ne pas proposer la méthode à cet endroit.
Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison Packeta est gratuite. Il ne s'applique que là où un prix est défini : une ligne de pays, la ligne * Default ou le coût de repli. Laissez-le vide pour ne jamais proposer la livraison gratuite.
Disponibilité
Minimum weight (kg) : masque la méthode lorsque le panier pèse moins. Le poids du panier est converti à partir de l'unité de poids de votre boutique. Vide ou 0 signifie aucune limite.
Maximum weight (kg) : masque la méthode lorsque le panier pèse plus. Par défaut : 15. Les points relais et les Z-BOX Packeta acceptent en général les colis jusqu'à 15 kg ; vérifiez votre contrat avec Packeta. Vide ou 0 signifie aucune limite.
Minimum cart subtotal : ne proposer la méthode que lorsque le sous-total du panier (après remises, hors taxes) atteint ce montant.
Excluded shipping classes : masque la méthode lorsque le panier contient un produit appartenant à l'une de ces classes de livraison WooCommerce.
Ignore shipping zones : lorsqu'elle est activée, la méthode est proposée pour les pays sélectionnés ci-dessous, même si elle n'est pas ajoutée à la zone de livraison correspondante. Lorsqu'elle est désactivée, la méthode n'est proposée que dans les zones auxquelles elle a été ajoutée.
Countries (ignore zones mode) : les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays Packeta. Les pays situés hors du réseau de points relais Packeta sont ignorés. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé.
Avancé
Debug log : enregistre les calculs de tarifs et les choix de points relais dans WooCommerce > Status > Logs (source « vfd-packeta »). Aucune donnée personnelle des clients ni aucune clé API n'est journalisée. Les échecs de vérification de la clé API sont toujours journalisés. Désactivez le journal une fois vos tests terminés.
Remove data on uninstall : lorsqu'elle est activée, la suppression de l'extension efface les réglages et les instances de zone de cette méthode. La désactivation de l'extension ne supprime jamais rien. Le point relais enregistré dans les commandes est toujours conservé.
Fonctionnement au paiement
Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie les conditions : pays de livraison dans le réseau Packeta, clé API, poids du panier, sous-total minimum du panier et classes de livraison exclues. Le prix provient du tableau des pays, puis du coût de repli. S'il n'existe aucun prix, la méthode est masquée. Si la livraison gratuite s'applique, le client voit la méthode sans frais.
Lorsque le client sélectionne la méthode Packeta, un bouton Choose pickup point apparaît en dessous. Il ouvre dans le navigateur du client le widget officiel de Packeta, avec le pays de destination, le poids du panier, les types de points choisis et la langue du widget. Après le choix d'un point par le client, son nom et son adresse s'affichent sous la méthode, et le bouton devient Change pickup point. Le choix est conservé dans la session du client lorsque le paiement se met à jour ou que la page est rechargée.
Votre serveur n'interroge pas Packeta au moment du paiement. Le script du widget est chargé depuis widget.packeta.com. S'il est bloqué (par un bloqueur de publicités ou de confidentialité, une politique de sécurité du contenu ou une panne de Packeta), le client voit le message « The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method. »
La méthode fonctionne sur le paiement classique ainsi que sur les blocs Panier et Paiement. Elle est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS).
Les prix Packeta ne sont pas demandés en direct ; ils proviennent de votre tableau. L'extension ne crée pas d'envois Packeta, n'imprime pas d'étiquettes et ne suit pas les colis. Elle ne propose pas non plus la livraison à domicile ni les points relais d'autres transporteurs partenaires par défaut. Transmettez l'identifiant du point relais de la commande à Packeta comme d'habitude, par exemple par import dans client.packeta.com.
Points relais
Le point relais est obligatoire. Si le client passe la commande sans en choisir un, le paiement s'arrête avec le message « Please choose a Packeta pickup point. ». Si le point choisi se trouve dans un autre pays que l'adresse de livraison, le paiement s'arrête avec le message « The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again. ». Ces deux contrôles sont effectués sur le serveur, aussi bien au paiement classique qu'au paiement par blocs. L'extension ne vérifie pas l'identifiant du point auprès de Packeta ; elle contrôle seulement qu'un point a été choisi et que son pays correspond.
Le point est enregistré avec la commande lors de sa création :
Écran de commande de l'administration : Packeta pickup point avec le nom, l'adresse, Pickup point ID et le pays, sous l'adresse de livraison. Si une commande Packeta n'a pas de point, l'écran indique « No pickup point was selected for this order. ».
Page de remerciement et vue de la commande : Packeta pickup point : avec le nom et l'adresse.
E-mails de commande : le nom et l'adresse du point dans les e-mails HTML et texte brut. Les e-mails destinés à l'administration incluent aussi le Pickup point ID.
En base de données, le point est enregistré dans les métadonnées de commande _vfd_pckt_point_id, _vfd_pckt_point_name (nom et adresse) et _vfd_pckt_point_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 Packeta. 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 son emplacement de domaine. Libérez-le dans votre compte vibefox.net.
Sans clé active, Packeta n'est pas affiché aux clients au paiement. Les gestionnaires de boutique connectés le voient toujours, avec la mention (unlicensed — visible to admins only), afin de pouvoir 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 concerné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
Packeta n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la API key est saisie et que le pays de destination est CZ, SK, HU ou RO. Vérifiez qu'un prix est défini pour le pays (ligne de pays, ligne * Default ou Fallback cost), les limites de poids et de sous-total, Excluded shipping classes, et que la méthode est ajoutée à la zone correspondante (ou que Ignore shipping zones est activé). La page des réglages liste en haut les problèmes de configuration. Activez Debug log pour voir la raison dans WooCommerce > Status > Logs.
Packeta a refusé la clé API : copiez à nouveau la clé API depuis client.packeta.com > Client support et enregistrez. Tant que ce n'est pas fait, le widget ne peut pas s'ouvrir au paiement.
Le widget ne s'ouvre pas : le script de Packeta est bloqué par un bloqueur de publicités ou de confidentialité, par une politique de sécurité du contenu ou par une panne de Packeta. Autorisez widget.packeta.com dans votre politique de sécurité du contenu. Les développeurs peuvent modifier l'URL du script avec le filtre vfd_pckt_widget_url.
La livraison est gratuite par erreur : vérifiez dans Country prices les lignes avec un Price de 0, surtout une ligne * Default ajoutée avec + Add country et restée vide.
Autres pays ou transporteurs : par défaut, la méthode fonctionne pour CZ, SK, HU et RO. Les développeurs peuvent ajouter des pays avec le filtre vfd_pckt_countries et transmettre des identifiants de transporteur au widget avec le filtre vfd_pckt_widget_options.
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, puis 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, avec la vérification de clé API enregistrée. Les réglages et les méthodes de zone 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 et le point relais enregistré.
Packeta est une marque de son titulaire respectif. Cette extension n'est ni affiliée à Packeta ni approuvée par Packeta.