1. À quoi sert le module
Le module ajoute un bouton Enregistrer le panier en PDF dans le panier, et en option dans le récapitulatif de la commande, dès que le panier n’est pas vide. Le client obtient un récapitulatif imprimable de son panier : les produits avec images, déclinaisons et prix, les bons de réduction, la livraison, les taxes et les totaux exactement comme le panier les affiche, puis — une fois saisis — les adresses, le transporteur et le message de commande, ainsi qu’une section paiement avec votre texte et les moyens de paiement disponibles pour ce panier. Les entreprises le joignent à une demande d’achat, d’autres clients le gardent pour finir leur achat plus tard. Vous décidez dans la configuration de ce que contient le PDF. Dans le back-office, le même PDF s’ouvre pour les derniers paniers d’un client, sur sa page.
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_cartpdf_v1.0.0.zipet attendez la confirmation. - Cliquez sur Configurer sur la fiche du module.
Dès l’installation, le bouton apparaît dans le panier avec les réglages par défaut.
3. Fonctionnement
Le PDF est créé au moment du clic, à partir du panier actuel. Les lignes et les totaux viennent du calcul du panier de PrestaShop et correspondent donc toujours au panier : prix spécifiques, règles de prix catalogue, réductions de groupe et bons de réduction compris, TTC ou HT selon l’affichage des prix du groupe du client, dans la langue et la devise du panier. La section des taxes ajoute les totaux HT et TTC.
Seul le panier du visiteur peut être imprimé : l’adresse du PDF ne contient aucun numéro de panier, le panier vient de la session du visiteur. Quand vous masquez le bouton (groupes de clients, clients connectés uniquement, montant minimal), l’adresse du PDF cesse aussi de fonctionner, et en mode catalogue il n’y a ni bouton ni PDF. Un PDF liste jusqu’à 150 produits, avec les images des 50 premiers ; pour un panier plus grand, une note apparaît sous la liste et les totaux couvrent toujours tout le panier.
Un panier n’a pas encore de moyen de paiement : le client le choisit à la dernière étape de la commande. La section paiement affiche donc votre texte (par exemple vos coordonnées bancaires) et les modules de paiement autorisés pour le pays, le groupe de clients et la devise du panier dans Paiement → Préférences. Les conditions propres d’un module de paiement, comme un plafond de montant, peuvent encore le masquer lors de la commande.
Les adresses, le transporteur et le message apparaissent dès que le client les a saisis lors de la commande ; le nom, les adresses et le message uniquement lorsque le client est connecté (ou commande en tant qu’invité). Les PDF ne sont jamais conservés sur le serveur, et le module ne se connecte ni à addonspresta.com ni à aucun autre serveur.
4. Fonctions et réglages
Ouvrez Modules → Gestionnaire de modules → Panier en PDF → 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.
Bouton dans le panier
- Activer le PDF du panier : une fois désactivé, le bouton disparaît et l’adresse du PDF ne fonctionne plus. Le panneau du back-office reste disponible.
- Position du bouton dans le panier : sous le bouton « Commander », sous la liste des produits ou au-dessus du récapitulatif du panier. L’emplacement exact dépend de votre thème.
- Bouton dans le récapitulatif de la commande : le même bouton à côté du récapitulatif pendant la commande, où le PDF peut déjà afficher les adresses, le transporteur et le message.
- Libellé du bouton : le texte du bouton dans chaque langue, jusqu’à 64 caractères. Vide, le libellé par défaut est utilisé.
- Ouverture du PDF : téléchargement du fichier ou ouverture dans un nouvel onglet du navigateur.
- Groupes de clients : seuls les clients des groupes cochés voient le bouton. Les visiteurs non connectés appartiennent au groupe « Visiteur ».
- Clients connectés uniquement : masque le bouton aux visiteurs.
- Montant minimal du panier : TTC, dans la devise par défaut de la boutique ; 0 affiche le bouton pour tout panier non vide.
Contenu du PDF
Chaque interrupteur ajoute une partie du PDF : images des produits (dans la taille choisie), référence, attributs de la déclinaison, personnalisations saisies par le client, prix unitaire, disponibilité de chaque produit, bons de réduction et remises, frais de port et transporteur, total HT, taxes et total TTC, adresses de livraison et de facturation, message du client, moyens de paiement disponibles, QR code avec l’adresse de la boutique et date de génération.
Apparence
- Format du papier : A4 ou Letter.
- Couleur d’accent : une couleur hexadécimale comme
#333333, pour les lignes, les titres et l’en-tête des tableaux. - Logo de la boutique dans l’en-tête : le logo des factures ou, à défaut, celui de la boutique.
- Coordonnées de la boutique dans l’en-tête : nom, adresse, téléphone et e-mail de Paramètres de la boutique → Contact → Magasins.
- Numéros de page dans le pied de page.
Textes
Pour chaque langue : le titre du document (par défaut « Votre panier »), le texte au-dessus des produits, les
informations de paiement (par exemple vos coordonnées bancaires), la note sous les totaux (par défaut « Prix et
disponibilité valables au {date}. Ce document n’est pas une commande. ») et le pied de page. Ce sont des textes bruts ;
{shop_name}, {shop_url}, {date} et {customer_name} sont remplacés par les valeurs de la boutique et du client.
PDF dans le back-office
Sur la page d’un client dans Clients → Clients, le panneau Paniers en PDF liste les 10 derniers paniers non vides du client, avec la date, le nombre de produits, la boutique et la commande passée depuis le panier. Le lien PDF ouvre le panier dans sa langue et sa devise, quels que soient les réglages du bouton. Seuls les employés dont le profil a le droit « Lecture » sur le module et accès à Clients voient le panneau ; le droit sur le module se donne dans Paramètres avancés → Équipe → Permissions.
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 bouton, son contenu et ses textes. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer. Un panier s’imprime toujours avec les réglages, le logo et les coordonnées de sa boutique ; le panneau du back-office ne liste que les paniers des boutiques gérées par l’employé. Une licence couvre toutes les boutiques de l’installation.
6. Désinstallation
Gestionnaire de modules → Panier en PDF → Désinstaller supprime les réglages du module et sa page cachée du back-office. Pour garder les réglages, choisissez plutôt Désactiver.
7. Questions fréquentes et dépannage
Le bouton n’apparaît pas. Vérifiez que Activer le PDF du panier est activé, que le panier n’est pas vide et atteint le montant minimal, que le groupe du visiteur est coché dans Groupes de clients et que votre thème affiche la position choisie. Essayez Sous le bouton « Commander », puis videz le cache dans Paramètres avancés → Performances.
Le PDF affiche des prix HT. Le PDF suit le panier : le groupe du client affiche les prix HT (Clients → Groupes). Activez Total HT, taxes et total TTC pour imprimer les deux totaux.
Un moyen de paiement manque dans le PDF. Vérifiez ses restrictions de pays, de groupes et de devises dans Paiement → Préférences. La liste ne connaît pas les conditions propres d’un module de paiement, comme un plafond de montant.
Il n’y a ni adresses ni transporteur dans le PDF. Ils apparaissent dès que le client les a saisis lors de la commande. Le bouton du récapitulatif de la commande les imprime.
Puis-je modifier la mise en page du PDF ?
Oui. Copiez views/templates/pdf/cart.tpl (ainsi que header.tpl et footer.tpl) dans
themes/<votre-thème>/modules/ap_cartpdf/views/templates/pdf/ et modifiez les copies. Un développeur peut aussi ajouter
des données avec le hook actionApCartpdfData décrit dans README.md.
Un texte reste en anglais dans ma boutique en français. Remplissez le libellé du bouton et les textes de cette langue dans la configuration du module. Les autres formulations se modifient dans International → Traductions → Traductions des modules installés.
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.