VibeFox SmartPost for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur, avec l'extension SimpleXML (incluse dans la plupart des installations de PHP).

SmartPost : aucun compte d'API ni clé n'est nécessaire. La liste des points relais provient de la liste ouverte des lieux SmartPost. SmartPost ne propose pas d'API publique de tarifs : vous saisissez donc vos propres tarifs (contractuels). Créez les envois dans votre compte professionnel SmartPost (SmartPosti).

Pays : les points relais SmartPost existent en Estonie, en Lettonie, en Lituanie et en Finlande. Pour les autres pays de destination, le mode de livraison n'est pas affiché.

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 du plugin et cliquez sur Install Now. Vous pouvez aussi transférer le dossier vfd_smartpost dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox SmartPost, ou cliquez sur Settings sous le nom du plugin dans 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. Vérifiez le tableau des tarifs (les prix par défaut sont déjà renseignés), les tailles de boîte et l'état des points relais en haut de la page.

6. Ajoutez VibeFox SmartPost à la ou aux zones comprenant l'Estonie, la Lettonie, la Lituanie et/ou la Finlande, 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 SmartPost. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez le mode à une zone, la fenêtre de la zone ne contient qu'un seul champ :

Title (zone): le nom que voient les clients pour cette zone. Laissez-le vide pour utiliser le Method title général.

En haut de la page, des avis signalent les problèmes et l'état des points relais. Un avis rouge apparaît lorsqu'aucun prix n'est défini, car le mode n'est alors pas affiché au paiement. Le bloc Pickup points available at checkout indique, pour chaque pays, le nombre de points relais disponibles et le nombre de villes concernées. Il précise aussi lorsqu'une copie enregistrée de la liste est utilisée parce que la liste SmartPost est momentanément indisponible, lorsqu'un pays n'a pas pu être chargé du tout et lorsqu'un pays n'a pas de tarifs. Le bouton Refresh pickup point lists now télécharge à nouveau les listes et affiche les nouveaux chiffres.

Général

Enable/Disable: active ou désactive SmartPost dans toutes les zones à la fois.

Method title: le nom du mode de livraison affiché aux clients. Le Title d'un mode de zone le remplace. Par défaut : SmartPost parcel locker.

Tax status: Taxable ajoute la taxe WooCommerce aux frais de livraison, None ne l'ajoute pas.

Prix (dans la devise de votre boutique ; les décimales peuvent s'écrire 3.50 ou 3,50)

Price table: une ligne par pays (Estonie, Lettonie, Lituanie, Finlande) avec un prix pour chaque taille de boîte S, M, L et XL, et une colonne Free from. 0 signifie gratuit. Une cellule vide signifie que cette taille de boîte n'est pas proposée : le mode est masqué lorsque le colis nécessite cette boîte. Un pays dont toutes les cellules sont vides n'est pas desservi. Free from est le total du panier à partir duquel SmartPost est gratuit dans ce pays ; laissez la cellule vide s'il n'y a pas de livraison gratuite. Les prix qui ne sont pas des nombres sont signalés après l'enregistrement et laissés vides. Prix par défaut : Estonie 3.50, Lettonie 4.00, Lituanie 4.00, Finlande 5.00 pour chaque boîte.

Box sizes (cm): la taille intérieure de chaque boîte, le plus petit côté en premier (Side 1 (smallest), Side 2, Side 3 (largest)). Les côtés du produit sont triés de la même façon et comparés côte à côte, et la plus petite boîte qui convient est utilisée. Les produits sans dimensions entrent dans la boîte S. Un colis qui ne rentre dans aucune boîte masque le mode. Les dimensions des produits sont converties à partir de l'unité de dimension de la boutique. Valeurs par défaut : S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60. Les tailles qui ne sont pas des nombres positifs sont signalées après l'enregistrement et ne sont pas modifiées.

Calculation: mode de calcul du prix.

Disponibilité

Minimum weight (kg): masque le mode lorsque le panier est plus léger. Vide ou 0 signifie sans limite.

Maximum weight (kg): masque le mode lorsque le panier est plus lourd. Par défaut : 25. 0 signifie sans limite.

Minimum cart total: n'affiche le mode qu'à partir de ce total de panier. Laissez vide pour toujours l'afficher.

Excluded shipping classes: masque le mode lorsque le panier contient des produits de ces classes de livraison WooCommerce.

Ignore shipping zones: propose SmartPost pour les pays ci-dessous sans l'ajouter à une zone. Lorsqu'elle est désactivée, les pays sont définis par les zones de livraison auxquelles le mode est ajouté. Cette option est recommandée.

Countries (without zones): les pays de destination pour ce mode, parmi l'Estonie, la Lettonie, la Lituanie et la Finlande. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé. Laissez-le vide pour proposer le mode dans les quatre pays.

Points relais

Pickup point types: les points SmartPost que le client peut choisir : Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) et Posti post offices (Finland). Laissez-le vide pour proposer les consignes, les boîtes et les points de dépôt (par défaut). Les types existants dépendent du pays : par exemple, la Lettonie n'a que des boîtes à colis, et les bureaux de poste n'existent qu'en Finlande.

City order: lorsqu'elle est activée, les grandes villes apparaissent en premier (Tallinn, Riga, Vilnius, Helsinki et d'autres grandes villes), puis le reste par ordre alphabétique. Lorsqu'elle est désactivée, toutes les villes sont classées par ordre alphabétique.

Avancé

Debug log: enregistre les détails du calcul des prix et de la liste des points relais dans WooCommerce > Status > Logs (source vfd-smartpost). Les erreurs, comme une liste de points relais indisponible, sont toujours enregistrées. Aucune donnée client n'est enregistrée.

Remove data on uninstall: lorsqu'elle est activée, la suppression du plugin efface les réglages, les modes de zone et les points relais en cache. La désactivation du plugin ne supprime jamais les réglages. Le point relais enregistré dans les commandes est conservé.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif au plugin. Le plugin ne fonctionne que pour l'Estonie, la Lettonie, la Lituanie et la Finlande. Il vérifie le poids du panier, le montant minimum du panier et les classes de livraison exclues, trouve la boîte du colis et prend son prix dans la ligne du pays de livraison. Si la boîte n'a pas de prix, ou si le colis ne rentre dans aucune boîte, le mode est masqué. Si le pays n'a aucun point relais (la liste n'a pas pu être chargée et il n'existe pas de copie enregistrée), le mode est également masqué, afin que le client ne voie jamais un paiement qui ne peut pas être finalisé. Si le total du panier atteint le Free from du pays, le prix est de 0.

La liste des points relais de chaque pays est mise en cache pendant 24 heures, et une copie de la dernière liste valide est conservée. Un téléchargement échoué est retenu pendant 15 minutes, afin que le paiement n'attende pas la liste à chaque actualisation. Le délai d'expiration du téléchargement est de 15 secondes. Les différentes graphies d'une même ville (par exemple Riga et Rīga) sont affichées comme une seule ville.

Le mode fonctionne au paiement classique ainsi que dans les blocs Panier et Paiement. Il est compatible avec le stockage haute performance des commandes de WooCommerce (HPOS). Les prix sont exprimés dans la devise de votre boutique. Le plugin ne convertit pas les devises.

Le plugin ne consulte pas les tarifs SmartPost, ne crée pas d'envois, n'imprime pas d'étiquettes, n'appelle pas de coursier et ne suit pas les colis. Créez les envois dans votre compte professionnel SmartPost (SmartPosti). La livraison à domicile par coursier ne fait pas partie de ce mode, et il n'existe pas de vue carte.

Points relais

Lorsque le client sélectionne SmartPost, deux listes apparaissent sous le mode : -- Select city -- et -- Select pickup point --. Les listes correspondent toujours au pays de livraison. Au paiement classique, il s'agit du pays de l'adresse de livraison, ou de celui de l'adresse de facturation lorsque la commande n'est pas expédiée à une autre adresse ; les listes sont reconstruites lorsque le pays change. Au paiement par blocs, les listes suivent le pays de l'adresse de livraison. La ville de l'adresse de livraison est présélectionnée lorsqu'elle correspond à une ville de la liste. Chaque point est affiché avec son nom et son adresse. Le choix est conservé pendant le paiement, il n'est donc pas perdu lorsque le paiement se rafraîchit.

Un point relais est obligatoire. Au paiement classique, le client voit Please select a SmartPost pickup point in the shipping country. Au paiement par blocs, Place order est bloqué tant qu'aucun point n'est choisi. Dans les deux cas, le serveur vérifie à nouveau le point par rapport à la liste du pays de livraison ; un identifiant de point falsifié ou périmé, ou un point d'un autre pays, est donc refusé. Si la liste du pays est temporairement indisponible, le client voit un message et peut choisir un autre mode de livraison.

L'identifiant, le nom, la ville et le pays du point sont enregistrés dans la commande. Ils sont affichés sur l'écran de commande sous l'adresse de livraison (avec l'identifiant du lieu), sur la page de confirmation de commande, dans My account > Orders et dans les e-mails de commande (HTML et texte brut) sous le libellé SmartPost pickup point.

Pour changer le point d'une commande, ouvrez la commande et cliquez sur Change à côté de SmartPost pickup point. Choisissez une ville et un point du pays de livraison de la commande. Le nouveau point est enregistré immédiatement, et une note de commande consigne l'ancien et le nouveau point.

Clé de licence

Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Shipping > VibeFox SmartPost. 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 correspondant. Libérez-le dans votre compte vibefox.net.

Sans clé active, SmartPost 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 le plugin avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas touchées.

Lorsqu'une licence expire, le plugin 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

SmartPost n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le pays de livraison est l'Estonie, la Lettonie, la Lituanie ou la Finlande, et que le mode est ajouté à la zone du pays du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Ouvrez la page des réglages : un avis indique si aucun prix n'est défini, si un pays n'a pas de tarifs ou si un pays n'a pas de points relais. Vérifiez aussi les limites de poids, Minimum cart total, Excluded shipping classes et les tailles de boîte : un colis qui ne rentre dans aucune boîte, ou une boîte dont la cellule de prix est vide, masque le mode. Avec Debug log activé, WooCommerce > Status > Logs (source vfd-smartpost) indique pourquoi le mode a été masqué.

Le client voit des points d'un autre pays : les listes suivent l'adresse de livraison. Vérifiez le pays saisi dans l'adresse de livraison (ou dans l'adresse de facturation, lorsque la commande n'est pas expédiée à une autre adresse). Un point d'un autre pays est refusé lors de la validation de la commande.

Aucun point relais pour un pays : la liste SmartPost n'a pas pu être chargée et il n'existe pas de copie enregistrée. Le plugin réessaie toutes les 15 minutes. Cliquez plus tard sur Refresh pickup point lists now. Vérifiez aussi que Pickup point types inclut un type existant dans ce pays.

La liste des points relais est obsolète : cliquez sur Refresh pickup point lists now dans la page des réglages. Les listes sont aussi téléchargées à nouveau toutes les 24 heures.

Le client ne peut pas passer la commande : un point relais du pays de livraison doit être choisi. Si le client voit « The SmartPost pickup point list is temporarily unavailable », aucun point de ce pays n'est disponible pour le moment.

Dans quelle devise sont les prix : dans la devise de votre boutique. Le plugin ne convertit pas les devises.

Pour les développeurs : le filtre vfd_smpt_places_url modifie l'URL de la liste des lieux d'un pays (arguments : URL, code pays), par exemple pour utiliser un miroir qui renvoie le même XML.

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é sur le nouveau domaine. Si le serveur de licences est injoignable, le plugin continue de fonctionner avec le dernier état connu.

Désinstallation

La désactivation du plugin conserve tous les réglages. Seules les listes de points relais en cache sont effacées. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et l'état de licence de ce plugin ainsi que les caches sont toujours supprimés. Les réglages, les modes de zone et les copies enregistrées des listes de points relais ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés en vue d'une réinstallation ultérieure. Le point relais enregistré dans les commandes n'est jamais supprimé, et les commandes existantes conservent leurs lignes de livraison.

SmartPost et SmartPosti sont des marques de leur propriétaire respectif. Ce plugin n'est ni affilié à SmartPost ni approuvé par SmartPost.