PDF Datei aus TYPO3 erzeugen mit webkitpdf

Mit verschiedenen Extensions kann man dem Besucher den Download einer Webseite als PDF Datei anbieten. Die einfachste Lösung bietet die Extension webkithtml. 

Das Programm wkhtmltopdf für die Erzeugung von PDF Dateien ist auf unseren Hostingpaketen bereits vorinstalliert, damit entfällt die Verwendung der bei der Extension mitgelieferten Version. 

Die folgende Anleitung zeigt die Konfiguration Schritt für Schritt.

Extension installieren

Zunächst wird die aktuelle Version der webkitpdf Extension installiert. Bei der Installation wird eine Datenbanktabelle und ein Verzeichnis hinzugefügt:

Statisches Template Modul einbinden

Das mit der Extension mitgelieferte TypoScript Template wird auf der Root-Seite dem Haupttemplate hinzugefügt:

Seite mit Plugin erstellen

Jetzt erstellt man eine neue Seite mit der Eigenschaft "nicht im Menü" und fügt auf dieser ein Inhaltselement vom Typ 'Allgemeines Plugin' ein. Als Plugin wird Webkitpdf ausgewählt. Eine besondere Konfiguration des Plugins ist nicht erforderlich.

TypoScript Konstanten anpassen

Im Konstanten-Editor wird die Seiten-ID eingetragen, auf der sich das eben erstellte Plugin befindet. Auch der gewünschte Link-Text für die PDF Version kann hier angegeben werden:

Link in Webseite einbauen, Pfad für wkhtmltopdf anpassen

Im HTML Template der Webseite wird ein Platzhalter für den Link eingetragen. Im Beispiel heißt der Platzhalter pdflink.

Mit folgendem TypoScript Code wird dem Platzhalter der Link zum Erzeugen der PDF Datei zugewiesen:

page.10.subparts.pdflink < plugin.tx_webkitpdf_pi1.pdfLink

Das Programm zum Rendern der PDF Datei befindet sich bei uns im Verzeichnis bin. Der Pfad muss noch mit diesem TypoScript Code angepasst werden:

plugin.tx_webkitpdf_pi1.customScriptPath = /bin/

Auf jeder Webseite wird nun ein Link zum Erzeugen der PDF Datei angezeigt. Im Handbuch der Extension werden noch weitere Möglichkeiten zur Konfiguration der PDF Generierung beschrieben: