Seitenvergleich

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.

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.

Empfohlene Vorgehensweise pro Vorlage

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 Removed

Image Added

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 [td]”

Image Removed

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 Added

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 und du von uns die Bestätigung erhalten hast, dass die Vorlagen umgestellt werden dürfen, kann abschließend das Update abgeschlossen werden.
Dies geschieht über die neue Funktion ganz unten in der Übersichtsseite:

Image Modified

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”.

 <table cellspacing="0" cellpadding="5" border="0" align="center" >

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

• HTML-Elemente im Überblick: https://wiki.selfhtml.org/wiki/HTML

• HTML-Aufbau einer Tabelle: https://wiki.selfhtml.org/wiki/HTML/Tabellen/Aufbau_einer_Tabelle

• HTML-Tutorials für Einsteiger: HTML-Tutorial für Anfänger - CodeCrowd

• Smarty Template Engine Dokumentation: https://www.smarty.net/docs/en/

• Smarty Template Engine “foreach”: https://www.smarty.net/docsv2/de/language.function.foreach.tpl

Kostenpflichtiger Support / Onboarding

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