VibeFox LP Express for PrestaShop — Aide

Prérequis

PrestaShop : 8.0 à 9.x.

PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les versions plus anciennes de PHP.

LP Express : aucun compte API n'est nécessaire. LP Express ne propose pas d'API publique de tarifs, et le module n'utilise pas l'API Unisend : vous saisissez donc vos propres tarifs (contractuels). Créez les colis dans votre compte Unisend (« Mano siuntos »).

Liste des terminaux de colis : le module utilise la liste publique des terminaux LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). Aucune clé n'est nécessaire. Si cette liste en ligne est indisponible, le module 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 le back office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.

2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez VibeFox LP Express plus tard dans la liste des modules et cliquez sur Configure.

3. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).

4. Renseignez le tableau des tarifs (au moins une ligne) ou des frais de repli. Vérifiez la ligne d'état concernant 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. Cliquez sur Save.

À l'installation, le module crée le transporteur LP Express parcel terminal avec le texte de délai de livraison Delivery to an LP Express parcel terminal. Le transporteur est affecté à la zone Lituanie et à tous les groupes de clients. Vous pouvez ajouter des zones et modifier les groupes de clients, le délai de livraison, le logo et les limites de taille dans Shipping > Carriers. Ne définissez pas de prix à cet endroit : le prix provient toujours du module.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox LP Express > Configure. Chaque section possède son propre bouton Save, qui enregistre la page entière. Chaque enregistrement recharge aussi la liste des terminaux.

En haut de la page, des avis signalent les problèmes et l'état des terminaux. Un avertissement apparaît lorsqu'aucun prix n'est défini ou qu'aucun terminal de colis n'est disponible, car le transporteur n'est alors pas affiché au paiement ; lorsque le transporteur a été supprimé ; et lorsque l'unité de poids de la boutique n'est pas une unité connue du module (kg, g, lb, oz), car les poids des produits sont alors lus comme des kg. 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 la liste en ligne (avec sa date) ou votre propre liste.

Lors de l'enregistrement, un titre de méthode vide ou non valide comme nom de transporteur est refusé avec Enter a valid method title., et un titre de plus de 64 caractères est également refusé. Dans les deux cas, rien n'est enregistré. Un montant ou un poids qui n'est pas un nombre (ou qui est négatif) est signalé, et sa valeur précédente est conservée. Un Minimum weight (kg) supérieur à Maximum weight (kg) (30 kg lorsque le maximum est vide) est également signalé, car le transporteur ne serait jamais affiché ; les deux poids conservent leurs valeurs précédentes. Les prix du tableau qui ne sont pas des nombres sont signalés et laissés vides.

Général

Enable/Disable : active ou désactive LP Express. C'est le même interrupteur que le statut du transporteur dans Shipping > Carriers.

Method title : le nom du transporteur affiché aux clients dans le panier et au paiement. Par défaut : LP Express parcel terminal. Obligatoire.

Tax status : None signifie que les prix ci-dessous sont définitifs. Taxable avec une règle de taxe (une option par règle de taxe de votre boutique) signifie que PrestaShop ajoute cette taxe d'expédition aux prix ci-dessous. C'est la règle de taxe du transporteur.

Tarifs (dans la devise par défaut de votre boutique ; les décimales peuvent s'écrire 2.99 ou 2,99)

Price table : une ligne par pays de destination. Cliquez sur + Add country pour ajouter une ligne et sur l'icône de corbeille pour en supprimer une. Choisissez * Any other country pour chaque pays qui n'a pas sa propre ligne. Chaque ligne comporte 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 le poids d'un article avec Per item. Une colonne vide utilise le prix de base de la ligne. 0 signifie gratuit.

Fallback cost : utilisé lorsque le tableau des tarifs n'a pas de ligne pour le pays de destination. Laissez ce champ vide pour masquer le transporteur pour ces pays.

Calculation : la manière dont le prix est calculé.

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 produit est tarifé selon son propre poids et multiplié par sa quantité, puis les prix sont additionnés.

Free shipping from : le total du panier (produits à expédier, après remises, hors taxes) à partir duquel LP Express est gratuit. Laissez vide s'il n'y a pas de livraison gratuite.

Disponibilité

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

Maximum weight (kg) : masque le transporteur lorsque le panier est plus lourd. Les terminaux LP Express acceptent les colis jusqu'à 30 kg. Par défaut : 30. 0 signifie aucune limite. Vide signifie 30 kg dans les zones du transporteur, et aucune limite uniquement pour les pays de Ignore shipping zones situés en dehors de ces zones.

Minimum cart total : affiche le transporteur seulement à partir de ce total de panier (produits à expédier, après remises, hors taxes). Laissez vide pour toujours l'afficher.

Ignore shipping zones : propose LP Express pour les pays ci-dessous sans que vous ayez à définir vous-même les zones. Le transporteur est alors rattaché à toutes les zones actives (y compris aux zones créées ultérieurement). Les zones que le transporteur avait auparavant restent autorisées pour tous leurs pays. Lorsque vous désactivez à nouveau l'option, le transporteur retrouve les zones qu'il avait avant. Lorsqu'elle est désactivée, les pays sont définis par les zones du transporteur dans Shipping > Carriers. Ce mode est recommandé.

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 le transporteur dans tous les pays.

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.

Avancé

Debug log : écrit le détail du calcul des prix et de la liste des terminaux dans logs/vfd_lpex_debug.log.php, dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs, comme une liste de terminaux indisponible, sont toujours journalisées. Aucune donnée client n'est journalisée.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Remove data on uninstall : lorsqu'elle est activée, la désinstallation du module supprime les réglages, le transporteur et la liste des terminaux enregistrée. Lorsqu'elle est désactivée, la désinstallation se contente de désactiver le transporteur. Le terminal enregistré dans les commandes est toujours conservé.

Fonctionnement au paiement

À l'étape d'expédition, PrestaShop demande au module le prix LP Express. Seuls les produits physiques comptent : les produits virtuels n'ajoutent aucun poids et ne sont pas inclus dans le total du panier. Le module vérifie les pays de Ignore shipping zones, le poids du panier et le total minimum du panier. 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, ou si aucun terminal de colis n'est disponible, le transporteur est masqué, de sorte que le client ne voit jamais une étape de paiement qu'il ne peut pas achever.

Les prix et les montants sont exprimés dans la devise par défaut de votre boutique. Le prix est ensuite affiché dans la devise du panier du client, au taux de change PrestaShop.

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

Si vous modifiez le transporteur dans Shipping > Carriers alors qu'il a déjà des commandes, PrestaShop l'enregistre comme une nouvelle version du transporteur. Le module suit automatiquement la nouvelle version.

Le module 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 ce transporteur.

Points relais

Lorsque le client sélectionne LP Express, le bloc LP Express parcel terminal apparaît sous le transporteur avec deux listes : -- 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 enregistré immédiatement dans le panier, de sorte qu'il n'est pas perdu lorsque le paiement se rafraîchit. Le module fonctionne avec les thèmes Classic et Hummingbird.

Un terminal est obligatoire. Sans terminal, Continue à l'étape d'expédition et Place order affichent Please select an LP Express parcel terminal. Lorsque le client clique sur Continue, le serveur vérifie de nouveau le terminal par rapport à la liste ; un identifiant de terminal falsifié ou périmé est donc refusé avec The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.

L'identifiant, le nom et la ville du terminal sont enregistrés avec la commande. Ils sont affichés dans le bloc LP Express parcel terminal de la page de commande du back office (avec Terminal ID), sur la page de confirmation de commande et dans les détails de commande du client. Dans l'e-mail de confirmation de commande et dans l'e-mail de nouvelle commande envoyé au marchand, ils sont ajoutés au nom du transporteur sous la forme LP Express parcel terminal: suivi du terminal. Si une commande n'a pas de terminal, la page de commande du back office affiche No parcel terminal was chosen for this order.

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox LP Express est le premier bloc de Modules > Module Manager > VibeFox LP Express > Configure, au-dessus des réglages. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine), ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: presta-shipping-lp-express et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back office (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, le module continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : celui de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, le transporteur LP Express n'est pas affiché aux clients au moment du paiement, et aucun tarif n'est calculé. La vitrine PrestaShop ne sait pas que vous êtes connecté au back office : le transporteur est donc masqué aussi pour vous. Vous pouvez configurer le module avant d'acheter une clé, mais pas le tester au paiement. Un rappel apparaît dans Modules > Module Manager, sous l'onglet Alerts. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié automatiquement pendant votre travail dans le back office : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation ou la réinitialisation du module supprime toujours la clé de licence et le statut de la licence.

Dépannage

LP Express n'apparaît pas au paiement : vérifiez que la licence est active et que Enable/Disable est activé. Dans Shipping > Carriers, vérifiez que le transporteur couvre la zone du pays du client et le groupe du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Ouvrez la page du module : un avertissement indique si aucun prix n'est défini ou si aucun terminal de colis n'est disponible. Vérifiez aussi les limites de poids et le Minimum cart total. Les produits peuvent également être limités à certains transporteurs sur la fiche produit. Avec le Debug log activé, le champ Log de la page du module indique pourquoi le transporteur a été masqué.

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. Le module 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 : cliquez sur Save sur la page du module. Cela recharge la liste des terminaux. Avec votre propre liste, mettez à jour les lignes vous-même.

Le client ne peut pas poursuivre : un terminal de colis doit être choisi. Si le client voit The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., aucun terminal n'est disponible pour le moment. Ajoutez votre propre liste.

Dans quelle devise sont les prix : dans la devise par défaut de votre boutique. Les clients qui paient dans une autre devise voient le prix converti au taux de change PrestaShop.

La page indique que le transporteur LP Express est introuvable : le transporteur a été supprimé dans Shipping > Carriers. Réinitialisez le module dans Modules > Module Manager pour le recréer.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox LP Express et choisissez Uninstall. La clé de licence et le statut de la licence sont toujours supprimés. La liste des terminaux en cache est toujours vidée. Si Remove data on uninstall est activé, le transporteur est supprimé (les commandes conservent leur historique), et les réglages, le journal et la copie enregistrée de la liste des terminaux sont supprimés. S'il est désactivé, le transporteur est seulement désactivé et tous les réglages ainsi que la copie enregistrée sont conservés. Réinstaller le module rend au transporteur enregistré le statut qu'il avait. Le terminal enregistré dans les commandes n'est jamais supprimé.

LP Express est une marque de son propriétaire respectif. Ce module n'est ni affilié à LP Express ni approuvé par LP Express.