HTML2PDF5 Update Anleitung

Owned by Benedikt Brütsch
Last updated: Juli 25, 2024 by Svenja Verheyen
4 min read

Die PDF-Vorlagen müssen geupdated werden, damit diese auch zukünftig problemlos verwendet werden können und es nach dem PHP8-Update nicht zu Problemen kommt.

Übersicht:

Warum müssen die Vorlagen angepasst werden?

Auf Grund des Serverupdates auf PHP8 wird es notwendig, dass die PDF-Vorlagen geupdated werden.
Für die neuen Versionen der Vorlagen haben wir neue Standardvorlagen hinzugefügt, es können aber natürlich auch weiterhin eigene Vorlagen verwendet werden.

Warum ein PHP-Update?

Das Serverupdate auf PHP8 ist leider notwendig, da der Support für PHP7 bald ausläuft.
Durch das Update sollte sich die Shop-Performance verbessern, es wird neue Sicherheitsfeatures geben und der Entwicklung neue Funktion zur Verfügung stehen, um die Shops nachhaltig zu verbessern.

Welche Vorlagen müssen angepasst werden?

Prinzipiell müssen alle Vorlagen angepasst werden, aus denen ein PDF generiert wird. Diese findest du unter Content-Management > Vorlagen > PDF-Vorlagen.

  • 2. Rechnung Warenkorb

  • Anfrage als Angebots PDF an den Kunden

  • Artikelangebot

  • Brief für Musteranforderung

  • Gutschriften PDF

  • Jobticket

  • Zusätzliches Auftragsdokument

  • Lieferschein

  • Lieferschein neutral

  • Rechnung

  • Rechnung Warenkorb

  • Rechnungskorrektur Warenkorb

  • Storno-Rechnung

Empfohlene Vorgehensweise pro Vorlage

  1. Vorlage sichern

  2. Bestehende Vorlage in das neue Eingabefeld einfügen

  3. Beispielbestellung als realen Datensatz wählen

  4. Vorlage kontrollieren und Fehler beheben

  5. Update abschließen

Vorlage sichern

Wir empfehlen als erstes die bestehende Vorlage zu sichern. Kopiere hierfür den HTML-Code der Vorlage aus dem Eingabefeld “Text” in einen HTML-Editor wie z. B. den Editor in Windows.

Bestehende Vorlage in das neue Eingabefeld einfügen

Anschließend die aktuelle Vorlage in das Eingabefeld “Vorschau HTML2PDF” einfügen und speichern.
Es kann auch die Mustervorlage für HTML2PDF genutzt werden:

image-20240319-142152.png
Neue Dropdowns für die HTML2PDF Vorlagen

Beispielbestellung als realen Datensatz wählen

Über das Dropdown unter dem Eingabefeld kann eine Beispielbestellung ausgewählt werden, um reale Beispieldaten zu verwenden. Anschließend kann über den “Vorschau” Button die Vorlage geladen und mit den Daten der Beispielbestellung befüllt werden.

Vorlage kontrollieren

Anschließend die aktuellen Vorlagen anschauen, ob es Fehler gibt oder ob die Vorlage gut aussieht.
Sollten Fehler auftreten, wird in der Vorschau eine Fehlermeldung ausgegeben z. B. “Tags are closed in a wrong order for [tr]”. Neu mit dem Release 04/2024: Gleichzeitig wird in der generierten Vorlage (HTML) die Zeile angezeigt und markiert in der sich der Fehler befindet.

image-20240404-140214.png
Ein Fehler ist aufgetreten und muss behoben werden.

 

Es müssen alle Fehler müssen behoben werden, damit die Vorlage korrekt verwendet werden kann.
Nach jeder Fehlerbehebung kann die Vorlage über den “Vorschau”-Button genutzt, bis keine Fehler mehr vorhanden sind.

Update abschließen

Wenn alle Vorlagen geupdated wurden kann abschließend das Update abgeschlossen werden.
Dies geschieht über die neue Funktion ganz unten in der Übersichtsseite:

Html2Pdf 5 Praxisbeispiele

Hintergrunddatei im neutralen Lieferschein ausblenden

Um die PDF-Hintergrundatei (aus Einstellungen > Allgemein > Rechnung > Hintergrund PDF) im neutralen Lieferschein auszublenden. Muss hier der Hintergrund der Vorlage weiß eingefärbt werden.
Dazu muss in der Vorlage ein “page” Element um die “Content” und dies braucht die Eigenschaft “backcolor”.

Beispiel:

<style> ... </style> <page backcolor="#FFFFFF"> ...Content-Html... </page>

“The html tag [pagebreak] is not known by Html2Pdf”

In einigen Dokumenten, wie z. B. der Rechnung wurde bisher der Tag “<pagebreak/>” verwendet, damit geordnete Seitenumbrüche stattfinden. Dieser wird nun leider nicht mehr unterstützt und muss daher folgendermaßen ersetzt werden

Beispiel:

Alt: <pagebreak/><p style="height:250px; width:100%; display:block"></p> Neu: <div style="page-break-before:always;height:250px; width:100%; display:block"></div>

Breitenabgaben greifen nicht

Bei der Umstellung kann es vorkommen, das bisherige Breitenangaben innerhalb von DIVs/Tabellen/Tabellenzellen nicht mehr greifen. Diese müssen nun per “style” eingefügt werden.

Beispiel:

Alt: <table width="100%" cellpadding="0" cellspacing="0"> Neu: <table style="width:100%;" cellpadding="0" cellspacing="0">

Tabellenausrichtung anpassen

Wenn Tabellen keine Breitenangabe von 100% haben, kann es vorkommen, dass diese nicht links positioniert sind. Dies liegt vermutlich an dem align-Attribut (align="center"), dass für die Ausrichtung der Tabelle verantwortlich ist. Bitte entfernen Sie es ganz oder ändern die Angabe auf “left”.

Zeilen laufen ineinander

Bei der Umstellung kann es vorkommen, das Texte übereinander laufen. Dies wird durch die “em”-Angaben im “line-height” hervorgerufen. Diese sind nicht mehr zulässig und müssen durch “%”-Angaben ersetzt oder ganz entfernt werden.

Benötigst du Hilfe?

Hilfestellung

Kostenpflichtiger Support / Onboarding

Wir helfen gerne auf Stundenbasis bei der Kontrolle und bei der Fehlerbehebung deiner Vorlagen.
Bitte eröffne hierzu ein Ticket.