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
Vorlage sichern
Bestehende Vorlage in das neue Eingabefeld einfügen
Beispielbestellung als realen Datensatz wählen
Vorlage kontrollieren und Fehler beheben
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:
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.
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">
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.