web2pdf für TYPO3

Warum web2pdf für TYPO3-Websites mit Preislisten und Produktseiten unverzichtbar ist

Vertriebsteams brauchen druckbare PDFs. Kunden erwarten auf Produktseiten einen “Als PDF speichern”-Button. Und Einkäufer in der Industrie laden Preislisten herunter, um sie intern weiterzuleiten. web2pdf löst genau dieses Problem: Die Extension rendert beliebige TYPO3-Seiten als PDF - mit korrektem Layout, eingebetteten Bildern und sauberer Typografie. Statt jede Seite manuell als PDF zu erstellen und bei Änderungen zu aktualisieren, generiert web2pdf das PDF live aus dem aktuellen Seiteninhalt.

Das spart nicht nur Redaktionszeit, sondern verhindert auch veraltete PDF-Versionen. Wenn der Preis eines Produkts im CMS geändert wird, liefert web2pdf beim nächsten Download automatisch die aktuelle Version.

Typische Einsatzszenarien

Produktkataloge und Preislisten im B2B. Ein Maschinenbauunternehmen pflegt 200 Produktseiten in TYPO3. Der Außendienst braucht zu jedem Produkt ein druckbares Datenblatt. web2pdf generiert aus jeder Produktseite ein PDF mit Logo, technischen Daten und Kontaktinformationen im Corporate Design. Der Redakteur pflegt nur eine Quelle - die Webseite - und das PDF aktualisiert sich automatisch.

Artikel und Whitepaper als Download. Medienunternehmen und Fachverlage bieten Magazin-Artikel als PDF-Download an. web2pdf wandelt den Artikel inklusive Bilder und Formatierung in ein druckoptimiertes PDF um. Ein Print-CSS steuert dabei, welche Elemente im PDF erscheinen (Content) und welche nicht (Navigation, Footer, Cookie-Banner).

Angebote und Konfigurationen. Konfigurator-Ergebnisse, Angebotszusammenfassungen oder Warenkorb-Übersichten lassen sich über web2pdf als PDF exportieren. Der Nutzer klickt auf “Angebot als PDF” und erhält ein druckreifes Dokument mit allen gewählten Optionen. Ein Automobilkonfigurator, der die gewählte Ausstattung als PDF ausgibt, ein Versicherungsrechner, der das Angebot zum Download bereitstellt - die Einsatzfelder sind breit und der Nutzen für den Vertrieb unmittelbar messbar.

Technische Architektur

web2pdf funktioniert als TYPO3-Extension mit einem Frontend-Plugin, das auf jeder Seite einen PDF-Download-Button einblendet. Beim Klick ruft der Browser dieselbe Seite mit einem zusätzlichen Parameter auf; eine Middleware der Extension nimmt die fertig gerenderte Ausgabe dieses Aufrufs und übergibt das HTML an die PHP-Bibliothek mPDF.

mPDF (Composer-Paket mpdf/mpdf, Version 8) bringt klare Stärken und Grenzen mit:

• Stärken: mPDF ist reines PHP und läuft im Prozess von TYPO3, ohne externes Programm und ohne Browser auf dem Server. Kopf- und Fußzeilen kommen aus eigenen Fluid-Partials, Seitenformat und Ränder aus TypoScript.
• Grenzen: mPDF behandelt jedes HTML-Element fest als Block- oder Inline-Element. CSS Flexbox und Grid setzt es nicht um, float und position nur eingeschränkt. Große Tabellen machen die Erzeugung langsam und speicherintensiv. Wer das Layout der Website mit voller CSS-Unterstützung (Flexbox, Grid, Custom Properties) im PDF braucht, kommt um einen Headless-Browser wie Puppeteer/Chromium nicht herum.

Die Extension konfiguriert sich über TypoScript-Konstanten. Wichtige Parameter: Seitenformat (etwa A4 oder A3), Hoch- oder Querformat, Ränder, eigene Kopf- und Fußzeilen, Ausgabe als Download oder im Browser sowie Such-und-Ersetz-Regeln für das HTML vor der Umwandlung.

Ein separates Print-CSS (@media print) steuert, welche Elemente im PDF sichtbar sind. Gosign empfiehlt, Navigation, Footer, Cookie-Banner und interaktive Elemente im Print-CSS auszublenden und stattdessen Logo, Kontaktdaten und eine URL-Angabe einzufügen. Ein gut konfiguriertes Print-CSS macht den Unterschied zwischen einem professionellen Datenblatt und einem Screenshot der Webseite. Typische Anpassungen: Schriftgröße auf 11pt für Leserlichkeit im Druck, Seitenumbrüche vor H2-Überschriften, QR-Code mit der Quell-URL in der Fußzeile.

Häufige Probleme und Lösungen

Problem: PDF zeigt falsches Layout, fehlende Bilder oder Schriften. Häufigste Ursache: mPDF setzt nur einen Teil von CSS um. Websites, die Flexbox oder CSS Grid verwenden, sehen im PDF komplett anders aus als im Browser. Die Lösung: ein separates Print-CSS mit Layouts aus Blöcken und Tabellen, die mPDF versteht. Schriften bettet mPDF aus TTF-Dateien ein; web2pdf bringt dafür ein eigenes Schriftverzeichnis mit. Reicht das nicht, bleibt der Wechsel auf Puppeteer außerhalb von web2pdf.

Problem: PDF-Generierung dauert zu lange. web2pdf erzeugt jedes PDF im PHP-Prozess des Aufrufs neu, und mPDF ist bei langen Seiten mit großen Tabellen langsam und speicherhungrig. Bei gleichzeitigen Anfragen multipliziert sich die Serverlast. Die Lösung: PDF-Caching implementieren. Das generierte PDF wird für eine definierte Zeit (z.B. 60 Minuten) im Dateisystem gecacht. Erst wenn sich der Seiteninhalt ändert, wird das PDF neu generiert. Reicht der Speicher nicht, empfiehlt die mPDF-Dokumentation, das PHP-Speicherlimit anzuheben.

Problem: Exception, wenn das Plugin auf der Seite fehlt. Wer den PDF-Parameter selbst an Links hängt, statt das Plugin der Extension einzubinden, bekommt in der gecachten Ausgabe eine TYPO3-Exception, weil das TypoScript-Setup dann nicht initialisiert ist. Die Lösung laut Dokumentation: das Plugin auf jeder Seite platzieren, die als PDF ausgegeben werden soll, am einfachsten per TypoScript für alle Seiten. Seiten hinter einem Login sind dagegen kein Sonderfall: Die Middleware wandelt die Ausgabe des Aufrufs um, den der angemeldete Besucher selbst stellt.

Migration und Versions-Kompatibilität

Mittwald pflegt web2pdf weiter: Version 4 unterstützt TYPO3 v12.4 (seit August 2023), Version 5.0.1 vom März 2025 unterstützt v13.4, ältere Versionsreihen decken v10 und v11 ab. Eine Version für TYPO3 v14 gibt es im TER noch nicht (Stand September 2026).

Wo das PDF das Layout der Website mit modernem CSS zeigen soll, empfiehlt Gosign einen architekturellen Wechsel: Statt web2pdf als TYPO3-Extension zu betreiben, wird die PDF-Generierung als separater Microservice implementiert. Ein Node.js-Service mit Puppeteer nimmt URLs entgegen und liefert PDFs zurück. Das entkoppelt die PDF-Generierung vom TYPO3-Server, reduziert die Serverlast und macht die Lösung TYPO3-versionsunabhängig.

Der Migrationsaufwand von web2pdf auf eine Puppeteer-basierte Lösung beträgt typischerweise 2 bis 4 Tage. Die bestehenden Print-CSS-Dateien können 1:1 übernommen werden. Nur der Aufruf-Mechanismus (Button-Klick, URL-Handling) muss angepasst werden.

Ein häufig unterschätzter Aspekt bei der PDF-Generierung: Barrierefreiheit. PDFs, die aus HTML generiert werden, sind nicht automatisch barrierefrei. Für Unternehmen, die dem Barrierefreiheitsstärkungsgesetz (BFSG, ab Juni 2025) unterliegen, müssen die generierten PDFs Tagged PDF-Strukturen enthalten. mPDF erzeugt keine Tagged-PDF-Strukturen; die Unterstützung von PDF/UA steht im mPDF-Projekt seit 2020 als offener Wunsch. Gosign empfiehlt für diesen Anwendungsfall eine Erzeugung, die die HTML-Semantik in PDF-Tags überträgt, etwa über Puppeteer, das getaggte PDFs standardmäßig anlegt.