VibeFox LP Express 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.

LP Express : aucun compte API n'est nécessaire. LP Express ne propose pas d'API publique de tarifs. L'API Unisend n'est accessible qu'aux clients sous contrat et n'est pas utilisée par cette extension : vous saisissez donc vos propres tarifs (contractuels). Créez les colis dans votre compte Unisend (« Mano siuntos »).

Liste des terminaux de colis : l'extension utilise la liste publique des terminaux LP Express, la même que celle qu'utilisaient les anciennes extensions LP Express. À la sortie de la version 1.1.0, cette liste en ligne était indisponible. Tant qu'elle ne l'est pas, l'extension utilise la dernière copie téléchargée si elle existe, sinon votre propre liste. Préparez-vous à saisir votre propre liste (voir Configuration).

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_lp_express dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox LP Express, 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. Remplissez le tableau des tarifs (au moins une ligne) ou les frais de repli. Vérifiez la ligne d'état sur les terminaux de colis en haut de la page, et ajoutez votre propre liste de terminaux si la liste en ligne n'est pas disponible.

6. Ajoutez VibeFox LP Express à votre zone Lituanie dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones et choisissez des pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox LP Express. Ils s'appliquent à toutes les zones d'expédition. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un champ :

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

En haut de la page, des avis signalent les problèmes et l'état des terminaux. Un avis rouge apparaît lorsqu'aucun prix n'est défini ou qu'aucun terminal de colis n'est disponible, car la méthode n'est alors pas affichée au paiement. Une ligne d'information indique combien de terminaux de colis, dans combien de villes, sont disponibles et d'où ils proviennent : la liste en ligne, une copie enregistrée de cette liste (avec sa date) ou votre propre liste.

Général

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

Method title: le nom de la méthode d'expédition affiché aux clients. Le titre d'une méthode de zone le remplace. Par défaut : LP Express parcel terminal.

Tax status: Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.

Tarifs (dans la devise de votre boutique ; les décimales peuvent être saisies sous la forme 2.99 ou 2,99)

Price table: une ligne par pays de destination. Cliquez sur + Add country pour ajouter une ligne et sur la croix (×) pour en supprimer une. Choisissez * Any other country pour tout pays sans ligne propre. Chaque ligne contient un Base price et des colonnes de poids : XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) et XL (>5 kg). Le poids est celui du panier, ou celui d'un article avec Per item. Une colonne vide utilise le prix de base de la ligne. 0 signifie gratuit. Les prix qui ne sont pas des nombres sont signalés après l'enregistrement et laissés vides.

Fallback cost: utilisé lorsque le tableau des tarifs n'a pas de ligne pour le pays de destination. Laissez-le vide pour masquer la méthode dans ces pays.

Calculation: le mode de calcul du prix.

Per order (tier by total cart weight): un prix pour le panier, avec la colonne de poids choisie selon le poids total du panier. C'est la valeur par défaut.

Per item (each item priced by its own weight x quantity): chaque article est tarifé selon son propre poids multiplié par sa quantité, et les prix sont additionnés.

Free shipping from: le montant du panier (après remises, tel qu'affiché dans le panier) à partir duquel LP Express est gratuit. Laissez vide pour ne pas proposer de livraison gratuite.

Disponibilité

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

Maximum weight (kg): masque la méthode lorsque le panier est plus lourd. Les terminaux LP Express acceptent les colis jusqu'à 30 kg. Par défaut : 30. 0 signifie sans limite.

Minimum cart total: affiche la méthode seulement à partir de ce montant de panier. Laissez vide pour toujours l'afficher.

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

Ignore shipping zones: propose LP Express pour les pays indiqués ci-dessous sans l'ajouter à une zone. Lorsque cette option est désactivée, les pays sont définis par les zones d'expédition auxquelles la méthode a été ajoutée. C'est l'option recommandée.

Countries (without zones): les pays de destination pour ce mode. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé. Laissez-le vide pour proposer la méthode à toutes les destinations.

Terminaux de colis

Terminal list: l'origine des terminaux.

LP Express online list: la liste en ligne est téléchargée une fois par jour. Si elle ne peut pas être chargée, la dernière copie téléchargée est utilisée, puis votre propre liste ci-dessous. C'est la valeur par défaut.

Only my own list: seuls les terminaux que vous saisissez ci-dessous sont proposés.

L'enregistrement des réglages recharge la liste des terminaux.

Avancé

Debug log: consigne le calcul des prix et les détails de la liste des terminaux dans WooCommerce > Status > Logs (source vfd-lp-express). Les erreurs, comme une liste de terminaux indisponible, sont toujours consignées. Aucune donnée client n'est consignée.

Remove data on uninstall: lorsque cette option est activée, la suppression de l'extension efface les réglages, les méthodes de zone et les terminaux en cache. La désactivation de l'extension n'efface jamais les réglages. Le terminal enregistré dans les commandes est conservé.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie le poids du panier, le montant minimum du panier et les classes d'expédition exclues. Si aucun terminal de colis n'est disponible, la méthode est masquée, afin que le client ne voie jamais un paiement impossible à finaliser. Si la livraison gratuite s'applique, le prix est de 0. Sinon, le prix provient de la ligne du pays (ou de la ligne *) : la colonne de poids, sinon le prix de base, sinon les frais de repli. S'il n'existe aucun prix, la méthode est masquée.

La liste en ligne des terminaux est mise en cache pendant 24 heures. Un échec de téléchargement est mémorisé 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 10 secondes. Seuls les terminaux actifs de la liste sont proposés.

La méthode fonctionne au paiement classique et dans les blocs Panier et Paiement. Elle est compatible avec WooCommerce High-Performance Order Storage (HPOS). Les prix sont exprimés dans la devise de votre boutique. L'extension ne convertit pas les devises.

L'extension ne demande aucun tarif à LP Express ou à Unisend, ne crée pas d'envois, n'imprime pas d'étiquettes, ne fait pas appel à un coursier et ne suit pas les colis. Créez les colis dans votre compte Unisend (« Mano siuntos »). La livraison à domicile par coursier (porte à porte) ne fait pas partie de cette méthode.

Points relais

Lorsque le client sélectionne LP Express, deux listes apparaissent sous la méthode : -- Select city -- et -- Select parcel terminal --. La ville de l'adresse de livraison est présélectionnée lorsqu'elle correspond à une ville de la liste. Chaque terminal est affiché avec son nom, son adresse et son code postal. Le choix est mémorisé pendant le paiement, il n'est donc pas perdu lorsque la page du paiement se rafraîchit.

Un terminal est obligatoire. Au paiement classique, le client voit Please select an LP Express parcel terminal. Dans le bloc de paiement, Place order reste bloqué tant qu'aucun terminal n'est choisi. Dans les deux types de paiement, le serveur vérifie de nouveau le terminal dans la liste, donc un identifiant de terminal falsifié ou périmé est refusé.

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

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 LP Express. 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, et votre domaine. Utilisez Check now pour vérifier de 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 son domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, LP Express n'est pas affiché aux clients au paiement. Les gestionnaires de la boutique connectés le voient toujours, avec la mention (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 l'assistance nécessitent un renouvellement. L'état est vérifié de nouveau automatiquement en arrière-plan.

Dépannage

LP Express 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é). Ouvrez la page des réglages : un avis rouge indique si aucun prix n'est défini ou si aucun terminal de colis n'est disponible. Vérifiez aussi les limites de poids, le Minimum cart total et les Excluded shipping classes. Avec Debug log activé, WooCommerce > Status > Logs (source vfd-lp-express) indique pourquoi la méthode a été masquée.

Aucun terminal de colis : la liste en ligne n'a pas pu être chargée, et il n'existe ni copie enregistrée ni liste personnelle. L'extension réessaie toutes les 15 minutes. Saisissez votre propre liste dans Own terminal list, ou choisissez Only my own list.

La liste des terminaux est obsolète : enregistrez la page des réglages. Cela recharge la liste des terminaux. Avec votre propre liste, mettez vous-même les lignes à jour.

Le client ne peut pas passer commande : un terminal de colis doit être choisi. Si le client voit « The LP Express parcel terminal list is temporarily unavailable », aucun terminal n'est disponible pour le moment. Ajoutez votre propre liste.

Devise des tarifs : celle de votre boutique. L'extension ne convertit pas les devises.

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 état connu.

Désinstallation

La désactivation de l'extension conserve tous les réglages. Seule la liste des terminaux en cache est effacée. Pour la supprimer, désactivez-la puis supprimez-la sur la page Extensions. La clé de licence et l'état de licence de cette extension ainsi que les caches sont toujours supprimés. Les réglages, les méthodes de zone et la copie enregistrée de la liste des terminaux ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Le terminal enregistré dans les commandes n'est jamais supprimé, et les commandes existantes conservent leurs lignes d'expédition.

LP Express est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à LP Express ni approuvée par LP Express.