1. À quoi sert le module
Le module ajoute sur la page produit un bouton Télécharger la fiche PDF. En un clic, le client obtient une fiche claire et imprimable du produit : nom, images, prix, disponibilité, caractéristiques, déclinaisons et plus encore, dans sa langue et sa devise, pour la déclinaison choisie. Vous décidez dans la configuration de ce que contient le PDF et de son apparence. Depuis la page produit du back-office, vous pouvez aussi générer la même fiche pour un client, dans la langue, la devise et le groupe de clients de votre choix.
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_productpdf_v1.0.0.zipet attendez la confirmation. - Cliquez sur Configurer sur la fiche du module.
Dès l’installation, le bouton apparaît sur les pages produit avec les réglages par défaut.
3. Fonctionnement
Le PDF est créé au moment du clic, à partir des données actuelles du produit. Les prix viennent du calcul de prix de PrestaShop pour ce client : prix spécifiques, règles de prix catalogue et réductions de groupe compris, dans la devise du visiteur et avec la taxe de son adresse. Quand le client change de déclinaison sur la page produit, le bouton suit : le PDF présente la déclinaison choisie, ses images, sa référence et son prix.
Aucun PDF n’est créé pour un produit que votre boutique ne montre pas à ce visiteur : produit désactivé, produit d’une autre boutique, produit masqué partout ou rangé dans une catégorie fermée à son groupe. Il en va de même quand vous masquez le bouton pour un groupe, une catégorie ou un produit : le lien vers le PDF cesse aussi de fonctionner.
Pour ménager le serveur, un PDF créé pour un visiteur non connecté est conservé 60 minutes (durée réglable) ; les clients connectés, qui peuvent avoir leurs propres prix, reçoivent toujours un PDF à jour. L’enregistrement des paramètres ou la modification du produit en crée aussitôt un nouveau. Le PDF est dessiné par la bibliothèque TCPDF intégrée à PrestaShop. Le module ne modifie pas les tables de PrestaShop et ne se connecte ni à addonspresta.com ni à aucun autre serveur ; les images et les liens de la description du produit ne sont pas repris dans le PDF.
Prix en mode catalogue. Le PDF affiche les prix comme réglé dans le module, y compris en mode catalogue, pour les groupes de clients qui ne voient pas les prix et pour les produits dont le prix est masqué. Si votre boutique cache volontairement ses prix (par exemple aux clients B2B avant leur connexion), activez Masquer les prix quand la boutique les masque.
4. Fonctions et réglages
Ouvrez Modules → Gestionnaire de modules → Fiche produit 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 sur la page produit
- Activer la fiche PDF : une fois désactivé, le bouton disparaît et les liens vers le PDF ne fonctionnent plus. Le panneau du back-office reste disponible.
- Position du bouton : sous le bouton « Ajouter au panier », à côté de lui ou dans le bloc de réassurance. L’emplacement exact dépend de votre thème.
- 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.
- Masquer dans les catégories : les produits d’une des catégories cochées n’ont pas de bouton.
- Masquer pour les produits : les ID des produits, séparés par des virgules, 500 au maximum.
Contenu du PDF
Chaque interrupteur ajoute une partie de la fiche : nom du produit, référence, codes EAN-13 / UPC / ISBN / MPN, marque, catégorie par défaut, résumé, description, prix, prix habituel et réduction, prix unitaire, disponibilité et délai de livraison, quantité en stock, attributs de la déclinaison choisie, tableau de toutes les déclinaisons, caractéristiques, poids et dimensions, noms des documents joints, lien vers la page produit, QR code et code-barres EAN-13.
- Images : aucune image, l’image de couverture seule, l’image de couverture avec des miniatures ou toutes les images en grille. Les images de la déclinaison choisie passent en premier. Nombre maximal d’images les limite (de 1 à 12) et Taille des images choisit l’un de vos types d’image produit : les grandes images sont plus nettes mais alourdissent le fichier.
- Prix : selon l’affichage des prix du groupe de clients (TTC ou HT), TTC, HT, les deux ou aucun prix.
- Masquer les prix quand la boutique les masque : voir « Fonctionnement ».
- Quantité en stock : imprimée uniquement si la gestion des stocks est activée dans la boutique.
- Tableau de toutes les déclinaisons : une ligne par déclinaison avec les colonnes cochées (référence, EAN-13, prix, quantité, disponibilité), jusqu’au maximum réglé (de 1 à 500).
- Code-barres EAN-13 : imprimé uniquement si le produit ou la déclinaison a un code EAN-13 valide.
- Description : les titres, listes, textes en gras et tableaux sont conservés.
Apparence
- Format du papier : A4 ou Letter.
- Couleur d’accent : une couleur hexadécimale comme
#333333, pour le trait sous le titre, les titres de section 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 et Date de génération dans le pied de page.
Textes
Trois textes par langue : au-dessus du produit (jusqu’à 300 caractères), une note sous le produit (jusqu’à 1000) et
le pied de page (jusqu’à 300). Ce sont des textes bruts ; {shop_name}, {shop_url}, {date}, {product_name} et
{reference} sont remplacés par les valeurs de la boutique et du produit. La note par défaut indique : « Prix et
disponibilité valables au {date}. Ce document ne constitue pas une offre. »
Cache
Conserver les PDF générés pendant (minutes) : de 0 à 10080 (une semaine) ; 0 crée chaque PDF à nouveau. Vider le cache des PDF supprime aussitôt les fichiers conservés, par exemple après un changement de prix par une règle de prix catalogue. Les fichiers expirés sont supprimés automatiquement. La page de configuration vous avertit quand le cache est désactivé et quand votre boutique masque les prix alors que le PDF les affiche.
PDF dans le back-office
Sur la page produit du back-office, ouvrez l’onglet Modules et choisissez Fiche produit PDF. Sélectionnez la langue, la devise, le groupe de clients dont la fiche affiche les prix et la déclinaison, puis cliquez sur Générer le PDF. La fiche s’ouvre dans un nouvel onglet ; envoyez-la à votre client comme n’importe quel fichier. Les réglages du bouton (groupes, catégories, produits, activation) ne s’appliquent pas ici. Seuls les employés dont le profil a le droit « Lecture » sur le module et accès à Catalogue → Produits 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. Le PDF de chaque boutique utilise ses propres produits, prix, stocks, images, logo et coordonnées. Dans le back-office, le PDF est créé pour la boutique choisie dans l’en-tête ou, dans le contexte Toutes les boutiques, pour la boutique par défaut du produit. Une licence couvre toutes les boutiques de l’installation.
6. Désinstallation
Gestionnaire de modules → Fiche produit PDF → Désinstaller supprime les réglages du module, sa page cachée du back-office et les PDF conservés. 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 la fiche PDF est activé, que le groupe du visiteur est coché dans Groupes de clients, que le produit et ses catégories ne sont pas masqués et que votre thème affiche la position choisie. Essayez Sous le bouton « Ajouter au panier », puis videz le cache dans Paramètres avancés → Performances.
Le PDF affiche un ancien prix. Un prix modifié par un prix spécifique daté ou une règle de prix catalogue apparaît à l’expiration du PDF conservé. Cliquez sur Vider le cache des PDF ou réduisez la durée du cache.
Il n’y a ni QR code ni code-barres dans le PDF. Le serveur a besoin de l’extension PHP GD ou Imagick ; la page de configuration vous avertit quand les deux manquent. Le code-barres nécessite aussi un code EAN-13 valide.
Une image ou une vidéo de ma description manque. C’est voulu : le PDF reprend uniquement le texte de la description, sa mise en forme et ses tableaux.
Puis-je modifier la mise en page du PDF ?
Oui. Copiez views/templates/pdf/sheet.tpl (ainsi que header.tpl et footer.tpl) dans
themes/<votre-thème>/modules/ap_productpdf/views/templates/pdf/ et modifiez les copies. Un développeur peut aussi
ajouter des données avec le hook actionApProductpdfData 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.