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 Aussendienst 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 die Extension intern die aktuelle Seite auf und übergibt den HTML-Output an ein PDF-Rendering-Backend.

Die Extension unterstützt zwei Rendering-Engines:

• wkhtmltopdf: Die klassische Lösung, basierend auf einer älteren WebKit-Version. Vorteile: Einfache Installation als einzelne Binary, geringer Ressourcenverbrauch. Nachteile: CSS Flexbox und Grid werden nicht unterstützt, Webfonts funktionieren nur eingeschränkt, das Projekt wird seit 2022 nicht mehr aktiv gepflegt.
• Puppeteer/Chromium: Die moderne Alternative. Puppeteer steuert einen headless Chromium-Browser, der die Seite wie ein normaler Browser rendert und als PDF exportiert. Volle CSS-Unterstützung (Flexbox, Grid, Custom Properties), korrekte Webfont-Einbettung, JavaScript-Ausführung. Nachteil: Höherer Ressourcenverbrauch (Chromium benötigt ca. 100-200 MB RAM pro Rendering-Prozess).

Die Extension selbst konfiguriert sich über TypoScript und Extension-Einstellungen im TYPO3 Install Tool. Wichtige Parameter: PDF-Seitengrösse (A4, Letter, Custom), Ränder, Header/Footer-Templates, Cookie-Handling für authentifizierte Inhalte.

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össe auf 11pt für Leserlichkeit im Druck, Seitenumbrüche vor H2-Überschriften, QR-Code mit der Quell-URL in der Fusszeile.

Häufige Probleme und Lösungen

Problem: PDF zeigt falsches Layout, fehlende Bilder oder Schriften. Häufigste Ursache: wkhtmltopdf kann modernes CSS nicht rendern. Websites, die Flexbox oder CSS Grid verwenden, sehen im PDF komplett anders aus als im Browser. Die Lösung: Auf Puppeteer als Rendering-Engine wechseln. Alternativ ein separates Print-CSS erstellen, das Layout-Fallbacks für ältere Rendering-Engines enthält.

Problem: PDF-Generierung dauert 10+ Sekunden. Puppeteer startet für jedes PDF einen Chromium-Prozess. 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. Auf Servern mit wenig RAM (unter 2 GB) ist wkhtmltopdf trotz CSS-Einschränkungen die pragmatischere Wahl.

Problem: Authentifizierte Seiten liefern leeres PDF. web2pdf ruft die Seite intern per HTTP auf. Wenn die Seite hinter einem Login liegt, fehlen die Session-Cookies, und der Rendering-Prozess sieht nur die Login-Seite. Die Lösung: Einen speziellen PDF-Rendering-Endpoint konfigurieren, der die Authentifizierung über einen Token statt über Session-Cookies löst.

Migration und Versions-Kompatibilität

web2pdf ist für TYPO3 v10 und v11 stabil verfügbar. Für TYPO3 v12 LTS existieren Community-Forks, die die Kompatibilität herstellen. Das ursprüngliche Paket wird nicht mehr aktiv gepflegt.

Für TYPO3 v13 und darüber hinaus 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. Weder wkhtmltopdf noch Puppeteer erzeugen standardmässig barrierefreie PDFs. Gosign empfiehlt für diesen Anwendungsfall eine nachgelagerte Verarbeitung mit einer spezialisierten PDF-Library (z.B. TCPDF oder mPDF mit Tag-Support), die die HTML-Semantik in PDF-Tags überträgt.