PDF Prestashop : quels sont les problemes et solutions ?

1. PDF de facture vide ou illisible dans PrestaShop

Il arrive que les factures PDF générées par PrestaShop soient vides ou corrompues. Cela est souvent dû à un conflit de module ou une erreur dans le fichier invoice.tpl.

Activez le mode debug dans PrestaShop pour identifier les erreurs PHP lors de la génération. Vérifiez également les surcharges dans le dossier /override/classes/pdf/. Une restauration du fichier original peut parfois suffire à corriger le problème d'affichage.

2. Erreur 500 lors de la génération de PDF dans PrestaShop

Une erreur 500 peut apparaître lors de la tentative de téléchargement d’un PDF, notamment pour les factures ou bons de livraison.

Ce problème est souvent lié à une limite de mémoire PHP trop basse. Augmentez la valeur memory_limit dans le fichier php.ini et vérifiez aussi les fichiers PDFGenerator.php. Assurez-vous que votre serveur respecte les prérequis de PrestaShop.

3. Problème d'encodage des caractères dans les PDF PrestaShop

Les accents et caractères spéciaux peuvent apparaître mal affichés ou sous forme de carrés dans les documents PDF, en particulier dans les langues non latines.

Cela est souvent lié à l’utilisation d’une police non compatible UTF-8. Remplacez la police par une compatible comme DejaVu Sans dans les fichiers de génération PDF (PDFGenerator.php), afin d’assurer un rendu correct multilingue.

4. Mauvais logo ou logo manquant sur les PDF PrestaShop

Parfois, le logo de la boutique n’apparaît pas sur les documents PDF, ou affiche une ancienne version malgré sa mise à jour dans le back-office.

Videz le cache PrestaShop et supprimez le fichier /img/tmp/logo_invoice.jpg si présent. Rechargez le logo dans Apparence > Thème & Logo pour qu’il soit repris lors de la prochaine génération des documents PDF.

5. PDF généré avec une mise en page cassée dans PrestaShop

Une mise en page désorganisée peut apparaître sur les bons de commande ou factures, en raison d’un CSS mal appliqué dans les fichiers *.tpl.

Corrigez le style dans les fichiers /pdf/invoice.tpl ou /pdf/delivery-slip.tpl, en évitant les valeurs absolues de positionnement. Utilisez des tableaux structurés pour conserver une disposition propre sur tous les formats de papier.

6. Nom de fichier PDF incohérent ou mal formaté dans PrestaShop

Les fichiers PDF générés peuvent porter un nom générique ou illisible, ce qui complique la gestion pour le client et l’administrateur.

Modifiez le nom dans les classes de génération PDF, par exemple dans PDF.php ou via un override. Utilisez des noms dynamiques contenant le numéro de commande et le nom du client pour une meilleure organisation documentaire.

7. Informations manquantes sur les factures PDF PrestaShop

Des informations obligatoires comme le numéro de TVA, l'adresse de facturation ou les frais de port peuvent être absentes des factures PDF.

Vérifiez que toutes les variables Smarty sont bien appelées dans invoice.tpl. Si besoin, utilisez le debug Smarty pour afficher toutes les données disponibles et les insérer correctement dans le modèle PDF.

8. Mauvaise langue sur les PDF PrestaShop

Il arrive que les documents PDF soient générés dans la mauvaise langue, notamment lorsque les clients utilisent une langue différente du back-office.

Assurez-vous que la langue de génération du PDF correspond à celle de la commande client. Vous pouvez forcer la langue dans PDFGenerator.php en liant la langue du contexte à celle de la commande ($order->id_lang).

9. Modules incompatibles modifiant les PDF PrestaShop

Certains modules tiers modifient les fichiers PDF de façon incorrecte, causant des erreurs d’affichage ou des blocages lors de la génération.

Désactivez les modules récents un par un pour identifier le module problématique. Privilégiez les extensions certifiées et testées pour la version de votre PrestaShop, surtout lorsqu'elles interviennent sur les documents officiels.

10. Impossible de générer plusieurs PDF à la fois dans PrestaShop

L’export groupé de plusieurs factures PDF peut échouer ou générer un seul document corrompu, surtout avec un grand nombre de commandes.

Ce blocage vient souvent d’une limite serveur (timeout ou mémoire). Augmentez les valeurs max_execution_time et memory_limit. Pour les boutiques avec volume élevé, utilisez un module d’export PDF en masse optimisé pour ce type de traitement.