Wissensdatenbank

1 000 FAQs, 500 Anleitungen und erläuternde Videos. Hier gibt es nur Lösungen!

Ein PDF-Fehler in PrestaShop 9.x beheben

Aktualisierung 31.08.2026

Dieser Leitfaden hilft bei der Behebung eines Problems mit dem CMS Prestashop v9.x, das die Erstellung von PDF-Rechnungen über das Admin-Panel (Back Office) betrifft, insbesondere wenn die französische Sprache verwendet wird.

 

Das Problem

Beim Versuch, eine PDF-Rechnung für eine Bestellung in französischer Sprache anzuzeigen oder herunterzuladen, gibt PrestaShop (Version 9.x) einen Fehler 500 zurück. Dieses Problem hängt mit einer Inkompatibilität zwischen der PDF-Generierungsbibliothek (TCPDF), die die Standardschriftart (helvetica) verwendet, und den Hosting-Konfigurationen zusammen.

 

Eine kompatible Schriftart definieren

Die Lösung besteht darin, die Verwendung der kompatibleren Schriftart freesans über eine benutzerdefinierte Konfigurationsdatei zu erzwingen.

Es wird dringend empfohlen, eine Datei namens defines_custom.inc.php zu erstellen. Diese Methode ist die sicherste, da sie sicherstellt, dass die Korrektur bei Updates des PrestaShop-Kernsystems nicht verloren geht.

Dazu:

  1. Greifen Sie über FTP oder den Dateimanager auf Ihre PrestaShop 9.x-Installation zu.
  2. Navigieren Sie zum Verzeichnis /config/.
  3. Erstellen Sie eine neue Datei mit dem Namen defines_custom.inc.php.
  4. Bearbeiten Sie die Datei defines_custom.inc.php und fügen Sie den folgenden Inhalt hinzu:

    <?php
    /**
     * Avoid error PDF, force font 'freesans'.
     */
    define('PDF_FONT_NAME_MAIN', 'freesans');
  5. Speichern Sie die Datei und testen Sie die Erstellung einer Rechnung in Französisch.

War diese FAQ nützlich?