1. À quoi sert le module
Le module indique à vos clients combien il leur reste à dépenser pour profiter de la livraison gratuite : « Plus que 23,50 € pour profiter de la livraison gratuite. », avec une barre de progression. Une fois le seuil atteint, le message devient « La livraison vous est offerte. ». La barre s’affiche dans le panier et dans le récapitulatif de commande, et se met à jour dès que le panier change.
Compatible avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et avec le multiboutique.
2. Installation
- Téléchargez le module depuis Mon compte → Historique des commandes sur addonspresta.com.
- Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
- Déposez le fichier
ap_freeshippingbar_v1.0.1.zipet attendez la confirmation. - Cliquez sur Configurer sur la fiche du module.
3. Fonctionnement
Le module compare le panier au seuil exactement comme PrestaShop décide de la livraison gratuite : le total des produits TTC, remises déduites, hors frais de port. Une règle panier offrant la livraison compte aussi comme seuil atteint. La barre ne s’affiche pas pour un panier composé uniquement de produits dématérialisés, en mode catalogue ou quand aucun seuil n’est défini.
Le module se contente d’informer : il ne modifie pas les frais de port. La livraison gratuite vient de vos réglages de livraison. Le module ne modifie pas les tables de PrestaShop et ne se connecte ni à addonspresta.com ni à aucun autre serveur.
4. Fonctions et réglages
Ouvrez Modules → Gestionnaire de modules → Barre de livraison gratuite → Configurer. Le cadre Aide, en haut, renvoie vers ce manuel et vers la page du module sur addonspresta.com, dans la langue de votre back-office.
Seuil
- Depuis Livraison > Préférences : reprend le montant « Livraison gratuite à partir de » de PrestaShop. Le libellé affiche la valeur actuelle. S’il n’est pas défini, la barre reste masquée.
- Mon propre montant : à utiliser quand la livraison gratuite vient des tranches de prix des transporteurs ou de règles panier. Le montant doit correspondre à ce que la boutique facture réellement, sinon la barre promet ce que le panier n’accorde pas.
Montant personnalisé
Le seuil dans la devise par défaut, TTC. Les clients qui paient dans une autre devise voient le montant converti.
Afficher dans le panier / Afficher dans le récapitulatif de commande
Emplacements de la barre : sous les produits sur la page panier et en haut du récapitulatif pendant la commande.
Afficher quand le panier est vide
Avant tout ajout, la barre affiche seulement le seuil : « Livraison gratuite dès 200,00 € d’achat. ».
Couleur de la barre
Une couleur hexadécimale, par exemple #24b9d7. Laissez vide pour reprendre la couleur principale de votre thème.
Messages
Trois textes par langue : sous le seuil, quand la livraison gratuite est atteinte et pour un panier vide. Dans les
textes, {amount} est remplacé par ce qu’il manque et {threshold} par le seuil ; les deux apparaissent en gras.
Le texte dans la langue par défaut est obligatoire ; il remplace les textes vides des autres langues.
5. Multiboutique
Les réglages sont enregistrés pour la boutique ou le groupe choisi dans l’en-tête du back-office. Choisissez Toutes les boutiques pour appliquer les mêmes valeurs partout, ou une seule boutique pour lui donner son propre seuil et ses propres messages. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer. Une licence couvre toutes les boutiques de l’installation.
6. Désinstallation
Gestionnaire de modules → Barre de livraison gratuite → Désinstaller supprime les réglages et les messages du module. Pour les conserver, choisissez plutôt Désactiver.
7. Questions fréquentes et dépannage
La barre ne s’affiche pas. Vérifiez qu’un seuil est défini (dans Livraison → Préférences ou en montant personnalisé), que le panier contient un produit physique et que le mode catalogue est désactivé. Videz ensuite le cache dans Paramètres avancés → Performances.
La barre annonce la livraison gratuite, mais le panier facture toujours les frais de port. Le seuil du module diffère de vos réglages de livraison. Choisissez Depuis Livraison > Préférences ou saisissez le montant à partir duquel vos transporteurs deviennent réellement gratuits.
Un texte reste en anglais dans ma boutique en français. Remplissez les messages de cette langue dans la configuration du module.
Puis-je modifier l’apparence de la barre ?
Oui. Copiez views/templates/hook/bar-content.tpl dans themes/<votre-thème>/modules/ap_freeshippingbar/views/templates/hook/
et modifiez la copie, ou ajoutez à votre thème des styles pour les classes .ap-freeshippingbar.
8. Mises à jour et assistance
Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos réglages sont conservés.
L’assistance est incluse pendant 12 mois à compter de la commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact d’addonspresta.com (du lundi au vendredi, de 10 h à 16 h ; réponse généralement sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.