dreipc_pdf for TYPO3

Wenn Besucher TYPO3-Seiten als PDF herunterladen wollen, braucht das Ergebnis ein eigenes Layout

Besucher klicken auf “Als PDF speichern” und erwarten ein sauberes Dokument: Corporate Design, Logo, Seitenzahlen, kein Navigation-Overhead. Was die Browser-Druckfunktion liefert, ist das Gegenteil: abgeschnittene Spalten, überflüssige Header und Footer, fehlende Bilder. dreipc_pdf löst dieses Problem mit einem eigenen Rendering-Ansatz: Die Extension erzeugt PDFs aus TYPO3-Seiteninhalten mit einem dedizierten Print-Layout, unabhängig von der Browser-Darstellung.

Im Gegensatz zu EXT:web2pdf, das die gerenderte HTML-Seite als Screenshot in ein PDF umwandelt, arbeitet dreipc_pdf datengetrieben. Es rendert die Inhaltselemente einer TYPO3-Seite über eigene Templates und erzeugt daraus ein formatiertes PDF. Das erlaubt volle Kontrolle über Seitenränder, Kopf- und Fußzeilen, Schriftgrößen und Seitenumbrüche.

Typical use cases

Produktdatenblätter aus dem CMS. Maschinenbauer, Chemieunternehmen und Medizintechnik-Hersteller pflegen Produktdaten in TYPO3. Vertriebsmitarbeiter brauchen diese Daten als druckbares PDF für Kundenbesuche. dreipc_pdf erzeugt aus der TYPO3-Produktseite ein PDF mit Corporate-Layout: Logo oben, technische Daten in Tabellen, Produktbild, Kontaktdaten unten. Bei einem Kunden mit 400 Produktseiten stehen die PDFs automatisch per Button auf jeder Seite bereit, ohne manuelle Erstellung.

Pressemitteilungen und Geschäftsberichte. Kommunikationsabteilungen veröffentlichen Pressemitteilungen auf der Website und bieten sie gleichzeitig als PDF zum Download an. dreipc_pdf generiert das PDF beim Klick auf den Download-Button, immer basierend auf dem aktuellen Content. Keine manuelle PDF-Erstellung, kein Risiko veralteter Downloadversionen.

Behördliche Informationsblätter. Öffentliche Einrichtungen stellen Formulare, Merkblätter und Informationsschreiben als PDF bereit. Die Inhalte werden in TYPO3 gepflegt und bei Änderungen automatisch als aktualisiertes PDF ausgeliefert. Die PDF-Version hat ein offizielles Layout mit Amtskopf und Aktenzeichen.

Technical architecture

dreipc_pdf nutzt eine PHP-PDF-Library (typischerweise mPDF oder TCPDF) zur Generierung. Die Extension registriert sich als Page-Type in TYPO3. Beim Aufruf einer Seite mit dem PDF-Type-Parameter (?type=123) wird statt des HTML-Outputs eine PDF-Datei generiert und zum Download angeboten.

Die Rendering-Pipeline arbeitet in drei Schritten. Erstens liest die Extension die Inhaltselemente der angeforderten TYPO3-Seite aus der Datenbank. Zweitens rendert sie jedes Element über ein dediziertes PDF-Fluid-Template (nicht das Standard-Web-Template). Drittens übergibt sie den gerenderten HTML-String an mPDF/TCPDF, die daraus das PDF mit den konfigurierten Seiteneinstellungen erzeugen.

Die PDF-Templates sind Fluid-Templates mit HTML/CSS, die mPDF versteht. mPDF unterstützt einen Subset von CSS2 und CSS3: Seitenränder (@page), Kopf-/Fußzeilen, Tabellen, Bilder, Schriftarten (einbettbare TTF-Fonts) und Seitenumbrüche (page-break-before, page-break-after). Flexbox und Grid werden nicht unterstützt, die Layout-Arbeit erfolgt über Tabellen oder Float.

Die Konfiguration umfasst: Seitenformat (A4, Letter, Custom), Seitenausrichtung (Hoch-/Querformat), Seitenränder, Standard-Schriftart, Kopf-/Fußzeilen-Templates und die Zuordnung von Content-Element-Typen zu PDF-Templates. Jedes Content-Element kann ein eigenes PDF-Template haben, das sich von der Web-Darstellung unterscheidet.

Common problems and solutions

Bilder fehlen im PDF. mPDF lädt Bilder über HTTP nach. Wenn der Server hinter einem Reverse Proxy oder in einer Docker-Umgebung läuft, kann mPDF die eigenen Bild-URLs nicht auflösen. Lösung: Bilder über den lokalen Dateipfad statt über die URL einbinden. In den PDF-Fluid-Templates den absoluten Serverpfad (/var/www/html/fileadmin/...) statt der Webadresse verwenden.

PDF-Erzeugung bei komplexen Seiten langsam. Eine Seite mit 30 Inhaltselementen und 15 Bildern kann 5-10 Sekunden für die PDF-Generierung brauchen. Bei gleichzeitigen Anfragen belastet das den Server. Lösung: generierte PDFs cachen. Beim ersten Aufruf wird das PDF erzeugt und im Dateisystem gespeichert. Folgende Aufrufe liefern die gecachte Version. Der Cache wird bei Content-Änderungen invalidiert.

Seitenumbrüche an falschen Stellen. mPDF bricht Seiten dort um, wo der Inhalt die Seitenhöhe überschreitet, auch mitten in einer Tabelle oder einem Absatz. Lösung: In den PDF-Templates explizite Seitenumbrüche setzen (<div style="page-break-before: always;">) und Tabellen mit <table style="page-break-inside: avoid;"> vor dem Umbrechen schützen.

Migration and version compatibility

dreipc_pdf ist eine Nischen-Extension mit begrenzter Community. Die letzte stabile Version unterstützt TYPO3 v10 und v11. Für v12 existiert kein offizielles Update, der Portierungsaufwand ist moderat (Extbase-Anpassungen, TCA-Updates).

Die Alternativen für TYPO3 v12/v13: EXT:web2pdf (Screenshot-basiert, einfacher, weniger Kontrolle über das Layout), EXT:pdfviewhelpers (ViewHelper-basiert, arbeitet mit TCPDF), EXT:fluid_fpdf (Fluid-Templates mit FPDF-Backend) oder eine Custom-Lösung mit mPDF als Composer-Paket. Die Custom-Lösung hat den Vorteil der vollständigen Kontrolle und Unabhängigkeit von Drittanbieter-Extensions.

Wer von dreipc_pdf auf eine Custom-Lösung migriert, kann die bestehenden PDF-Fluid-Templates übernehmen, sofern sie mPDF-kompatibles HTML/CSS verwenden. Der Rendering-Wrapper muss neu geschrieben werden, aber die Templates bleiben. Bei einem typischen Projekt mit 5 PDF-Templates liegt der Migrationsaufwand bei 2-3 Tagen. Gosign hat PDF-Generierung in TYPO3 mit verschiedenen Libraries umgesetzt und empfiehlt je nach Anforderung die passende Lösung.