{"type":"doc","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"Übersicht:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"808ac124-2378-4de8-ac8e-62cbdcd18b54"},"schemaVersion":{"value":"1"},"title":"Inhalt"}},"localId":"01560c0e-7e4c-46bb-b5dc-e490bd337b7f"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Warum müssen die Vorlagen angepasst werden?","type":"text"}]},{"type":"paragraph","content":[{"text":"Auf Grund des Serverupdates auf PHP8 wird es notwendig, dass die PDF-Vorlagen geupdated werden.","type":"text"},{"type":"hardBreak"},{"text":"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.","type":"text"}]},{"type":"panel","attrs":{"panelIconId":"atlassian-info","panelIcon":":info:","panelColor":"#E6FCFF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"Warum ein PHP-Update?","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Das Serverupdate auf PHP8 ist leider notwendig, da der Support für PHP7 bald ausläuft.","type":"text"},{"type":"hardBreak"},{"text":"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.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Welche Vorlagen müssen angepasst werden?","type":"text"}]},{"type":"paragraph","content":[{"text":"Prinzipiell müssen alle Vorlagen angepasst werden, aus denen ein PDF generiert wird. Diese findest du unter Content-Management > Vorlagen > PDF-Vorlagen.","type":"text"}]},{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"2. Rechnung Warenkorb","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anfrage als Angebots PDF an den Kunden","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Artikelangebot","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Brief für Musteranforderung","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gutschriften PDF","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Jobticket","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Zusätzliches Auftragsdokument","type":"text"}]}]}]}]},{"type":"layoutColumn","attrs":{"width":50.0},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lieferschein","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Lieferschein neutral","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rechnung","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rechnung Warenkorb","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rechnungskorrektur Warenkorb","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Storno-Rechnung","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Empfohlene Vorgehensweise pro Vorlage","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vorlage sichern","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bestehende Vorlage in das neue Eingabefeld einfügen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispielbestellung als realen Datensatz wählen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vorlage kontrollieren und Fehler beheben","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update abschließen","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Vorlage sichern","type":"text"}]},{"type":"paragraph","content":[{"text":"Wir empfehlen als ","type":"text"},{"text":"erstes die bestehende Vorlage zu sichern. ","type":"text","marks":[{"type":"strong"}]},{"text":"Kopiere hierfür den HTML-Code der Vorlage aus dem Eingabefeld “Text” in einen HTML-Editor wie z. B. den Editor in Windows.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Bestehende Vorlage in das neue Eingabefeld einfügen","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend die aktuelle Vorlage ","type":"text"},{"text":"in das Eingabefeld “Vorschau HTML2PDF” einfügen","type":"text","marks":[{"type":"strong"}]},{"text":" und speichern.","type":"text"},{"type":"hardBreak"},{"text":"Es kann auch die Mustervorlage für HTML2PDF genutzt werden: ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":454,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":884,"alt":"image-20240319-142152.png","id":"81755c1e-0c51-4629-9d07-a92e9f316053","collection":"contentId-50659335","type":"file","height":128}},{"type":"caption","content":[{"text":"Neue Dropdowns für die HTML2PDF Vorlagen","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Beispielbestellung als realen Datensatz wählen ","type":"text"}]},{"type":"paragraph","content":[{"text":"Über das Dropdown unter dem Eingabefeld kann eine Beispielbestellung ausgewählt werden, um reale Beispieldaten zu verwenden. Anschließend kann über den ","type":"text"},{"text":"“Vorschau” ","type":"text","marks":[{"type":"strong"}]},{"text":"Button die Vorlage geladen und mit den Daten der Beispielbestellung befüllt werden.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Vorlage kontrollieren","type":"text"}]},{"type":"paragraph","content":[{"text":"Anschließend die aktuellen ","type":"text"},{"text":"Vorlagen anschauen","type":"text","marks":[{"type":"strong"}]},{"text":", ob es Fehler gibt oder ob die Vorlage gut aussieht. ","type":"text"},{"type":"hardBreak"},{"text":"Sollten Fehler auftreten, wird in der Vorschau eine Fehlermeldung ausgegeben z. B. “Tags are closed in a wrong order for [tr]”. ","type":"text"},{"text":"Neu mit dem Release 04/2024:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff5630"}},{"type":"strong"}]},{"text":" Gleichzeitig wird in der generierten Vorlage (HTML) die Zeile angezeigt und markiert in der sich der Fehler befindet.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1270,"alt":"image-20240404-140214.png","id":"4124d35a-9542-49fa-a640-9e178c6edde1","collection":"contentId-50659335","type":"file","height":918}},{"type":"caption","content":[{"text":"Ein Fehler ist aufgetreten und muss behoben werden.","type":"text"}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Es müssen alle Fehler müssen behoben werden","type":"text","marks":[{"type":"textColor","attrs":{"color":"#bf2600"}},{"type":"strong"}]},{"text":", damit die Vorlage korrekt verwendet werden kann.","type":"text"},{"type":"hardBreak"},{"text":"Nach jeder Fehlerbehebung kann die Vorlage über den “Vorschau”-Button genutzt, bis keine Fehler mehr vorhanden sind.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Update abschließen","type":"text"}]},{"type":"paragraph","content":[{"text":"Wenn ","type":"text"},{"text":"alle Vorlagen geupdated","type":"text","marks":[{"type":"strong"}]},{"text":" wurden kann abschließend das ","type":"text"},{"text":"Update abgeschlossen","type":"text","marks":[{"type":"strong"}]},{"text":" werden. ","type":"text"},{"type":"hardBreak"},{"text":"Dies geschieht über die neue Funktion ganz unten in der Übersichtsseite:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":302,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":302,"alt":"image-20240319-142719.png","id":"eb6622c6-9991-455c-92cb-7104be60ccde","collection":"contentId-50659335","type":"file","height":74}},{"type":"caption","content":[{"text":"Diese Funktion darf erst genutzt werden, wenn alle Vorlagen geupdated wurden.","type":"text"},{"type":"hardBreak"},{"text":"Das heißt, es müssen alle html2pdf Voralgen in die normale Vorlage kopiert werden.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Html2Pdf 5 Praxisbeispiele","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Grundstruktur einer HTML2PDF-Vorlage","type":"text","marks":[{"type":"underline"},{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Eine HTML2PDF-Vorlage folgt einer klaren Struktur, um Inhalte auf mehreren Seiten korrekt darzustellen. Eine typische Vorlage enthält:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" als Hauptcontainer für eine Seite","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" für Kopfzeilen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" für Fußzeilen (z. B. Seitenzahlen)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"-Elemente zur besseren Platzierung und Formatierung","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Beispielcode für die Seitenstruktur:","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n \n ... \n \n \n ...\n \n ...\n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Seitenanzahl ausgeben | Seite 1/2","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Einfügen der Seitenanzahl in die Fußzeile","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Um eine Seitenanzahl in der Vorlage anzuzeigen, nutzt man die Platzhalter:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[[page_cu]]","type":"text","marks":[{"type":"code"}]},{"text":" für die aktuelle Seitenzahl","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[[page_nb]]","type":"text","marks":[{"type":"code"}]},{"text":" für die Gesamtseitenzahl","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Beispielcode für die Fußzeile:","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n \n

\n \n \n \n

\n Seite [[page_cu]]/[[page_nb]]\n

\n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Hinweise zur Umsetzung","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die Fußzeile wird in ","type":"text"},{"text":"jedem Dokument","type":"text","marks":[{"type":"strong"}]},{"text":" automatisch generiert.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Platzhalter ","type":"text"},{"text":"[[page_cu]]","type":"text","marks":[{"type":"code"}]},{"text":" zählt die aktuelle Seite hoch.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[[page_nb]]","type":"text","marks":[{"type":"code"}]},{"text":" sorgt dafür, dass die Gesamtseitenanzahl korrekt berechnet wird.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Falls das Layout nicht korrekt dargestellt wird, kann zusätzliches CSS helfen (z. B. ","type":"text"},{"text":"padding","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Hintergrunddatei im neutralen Lieferschein ausblenden","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Um die PDF-Hintergrundatei (aus Einstellungen > Allgemein > Rechnung > Hintergrund PDF) im neutralen Lieferschein auszublenden. Muss hier der Hintergrund der Vorlage weiß eingefärbt werden.","type":"text"},{"type":"hardBreak"},{"text":"Dazu muss in der Vorlage ein “page” Element um die “Content” und dies braucht die Eigenschaft “backcolor”.","type":"text"}]},{"type":"paragraph","content":[{"text":"Beispiel:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"\n\n ...Content-Html...\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"“The html tag [pagebreak] is not known by Html2Pdf”","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"In einigen Dokumenten, wie z. B. der Rechnung wurde bisher der Tag “” verwendet, damit geordnete Seitenumbrüche stattfinden. Dieser wird nun leider nicht mehr unterstützt und muss daher folgendermaßen ersetzt werden","type":"text"}]},{"type":"paragraph","content":[{"text":"Beispiel:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"Alt:

\n\nNeu:

","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Breitenabgaben greifen nicht","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"Beispiel:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"html"},"content":[{"text":"Alt: \n\nNeu:

","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Tabellenausrichtung anpassen","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Wenn Tabellen keine Breitenangabe von 100% haben, kann es vorkommen, dass diese nicht links positioniert sind. Dies liegt vermutlich an dem align-Attribut (","type":"text"},{"text":"align=\"center\"","type":"text","marks":[{"type":"code"}]},{"text":"), dass für die Ausrichtung der Tabelle verantwortlich ist. Bitte entfernen Sie es ganz oder ändern die Angabe auf “left”.","type":"text"}]},{"type":"codeBlock","content":[{"text":"

","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Zeilen laufen ineinander","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Verfügbare Schriften","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Aktuell stehen folgende Schriften zur Verfügung:","type":"text"},{"type":"hardBreak"},{"text":"aealarabiya, aefurat, cid0cs, cid0ct, cid0jp, cid0kr, code39azaleawide1, courier, courierb, courierbi, courieri, dejavusans, dejavusansb, dejavusansbi, dejavusanscondensed, dejavusanscondensedb, dejavusanscondensedbi, dejavusanscondensedi, dejavusansextralight, dejavusansi, dejavusansmono, dejavusansmonob, dejavusansmonobi, dejavusansmonoi, dejavuserif, dejavuserifb, dejavuserifbi, dejavuserifcondensed, dejavuserifcondensedb, dejavuserifcondensedbi, dejavuserifcondensedi, dejavuserifi, freemono, freemonob, freemonobi, freemonoi, freesans, freesansb, freesansbi, freesansi, freeserif, freeserifb, freeserifbi, freeserifi, helvetica, helveticab, helveticabi,","type":"text"},{"type":"hardBreak"},{"text":"helveticai, hysmyeongjostdmedium, kozgopromedium, kozminproregular, librebarcode39, msungstdlight, pdfacourier, pdfacourierb, pdfacourierbi, pdfacourieri, pdfahelvetica, pdfahelveticab, pdfahelveticabi, pdfahelveticai, pdfasymbol, pdfatimes, pdfatimesb, pdfatimesbi, pdfatimesi, pdfazapfdingbats, stsongstdlight, symbol, times, timesb, timesbi, timesi, uni2cid_ac15, uni2cid_ag15, uni2cid_aj16, uni2cid_ak12, verdana, verdanab, verdanai, verdanaz, zapfdingbats","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Hier ist zu beachten, dass verschiedene Varianten einer Schrift zusammengehören, z. B. umfasst die Schrift „Courier“ die Stile ","type":"text"},{"text":"Courier, Courier Bold (b), Courier Bold Italic (bi) und Courier Italic (i).","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Benötigst du Hilfe?","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Hilfestellung","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML-Elemente im Überblick: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://wiki.selfhtml.org/wiki/HTML"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML-Aufbau einer Tabelle: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://wiki.selfhtml.org/wiki/HTML/Tabellen/Aufbau_einer_Tabelle"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"HTML-Tutorials für Einsteiger: ","type":"text"},{"text":"HTML-Tutorial für Anfänger - CodeCrowd","type":"text","marks":[{"type":"link","attrs":{"href":"https://code-crowd.de/blog/html-tutorial-fuer-anfaenger-deutsch/"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Smarty Template Engine Dokumentation: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.smarty.net/docs/en/"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Smarty Template Engine “foreach”: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.smarty.net/docsv2/de/language.function.foreach.tpl"}},{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Kostenpflichtiger Support / Onboarding","type":"text"}]},{"type":"paragraph","content":[{"text":"Wir helfen gerne auf Stundenbasis bei der Kontrolle und bei der Fehlerbehebung deiner Vorlagen.","type":"text"},{"type":"hardBreak"},{"text":"Bitte eröffne hierzu ein Ticket","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://beprint.atlassian.net/servicedesk/customer/portal/3"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"}],"version":1}

Browser nicht unterstützt