WICHTIG: Bearbeiten Sie niemals die Originaldatei, da diese bei Systemupdates immer überschrieben wird. Arbeiten Sie immer mit einer Kopie des Templates.
Unsere Templates heißen
templatemitlogo_v2 (Netto) bzw.
templatemitlogo_brutto_v2 und befinden sich jeweils in einem Unterordner der einzelnen Apps.
Für die App Rechnungen heißt der Ordner
/cmssystem/rechnungen/rechnungstemplate/templatemitlogo_v2.
In diesem Ordner befinden sich die Templatedateien im HTML-Format, ein Ordner namens
Labels, in dem Bilder gespeichert werden, sowie die Datei
class_v2.php.
Bilder/Logos
Die Bilder sind grunsätzlich als JPG oder PNG zu hinterlegen. Andere Bildformate werden nicht unterstützt.
Wenn Sie das Logo im Kopf des Dokuments ändern möchten, lesen Sie bitte den Abschnitt
Header/Footer weiter unten auf dieser Seite.
Da Bilder beim Umwandeln in die PDF-Datei nochmals komprimiert werden und die Qualität leidet, sollte die Auflösung der Bilder möglichst hoch sein.
Es empfiehlt sich eine Bildauflösung ca. 1.5-2x so groß wie das abgebildete Bild in der PDF, damit die Bildqualität nicht so stark von der zusätzlichen Komprimierung verschlechtert wird.
Vorlage erstellen/kopieren
Die Vorlagen Templates können Sie unter
System → Administration → Erweitert → PDF Templates → PDF-CopyMaster kopieren.
Setzen Sie dazu den Haken vor die zu kopierende Vorlage und geben Sie rechts ins Textfeld den Namen, den Ihr personalisiertes Template erhalten soll, ein.
Wenn Sie ein Template direkt per FTP kopieren und umbenennen wollen, müssen Sie in der Datei
class_v2.php eine Änderung vornehmen:
Der Klassename innerhalb der Datei muss gleich dem Templatenamen sein.
Beispiel: Sie haben das Template
templatemitlogo_v2 kopiert und nennen das neue Template
eigenestemplate_v2.
Der Klassename muss daher in
tri_pdfoutput_eigenestemplate_v2 geändert werden.
Der PDF CopyMaster passt den Klassennamen in der Datei
class_v2.php automatisch an.
Header und Footer sind als eigenständiges Template im Ordner
/cmssystem/standard/standardtemplates gespeichert.
Dieses Template wird für alle PDFs verwendet. Auch für Header und Footer gibt es eine
class_v2.php, in der Sie beim kopieren den Ordnernamen ändern müssen.
Zusätzlich finden Sie hier die folgenden Zeilen:
$this->marging = array(
'left' => 19, // linker Rand
'right' => 11, // rechter Rand
'top' => 50, // oberer Rand
'bottom' => 40 // unterer Rand
);
Die Angaben sind jeweils in Millimeter. Die folgende Grafik zeigt die Anordnung der Abstände auf dem PDF:
Wie auf der Grafik zu sehen, befinden sich das Logo im Header und die Daten im Footer innerhalb der in der
class_v2.php angegebenen Grenzen.
Die Templates selbst sind in normalem HTML verfasst. Zu beachten ist dabei, dass zumindest im Header und Footer für Sonderzeichen das XHTML-Format verwendet werden sollte.
Um Fehler zu vermeiden ist es jedoch ratsam, auch in den Apptemplates XHTML zu verwenden.
Beispiel: Für den Buchstaben "Ä" wäre der XHTML-Code "&
Auml;".
Eine Liste mit Sonderzeichen und deren Entsprechungen in XHTML finden Sie hier:
wiki.selfhtml.org
Logos
Logos sind wie in den Apptemplates ebenfalls im Unterordner
Labels gespeichert.
contentstart.html und contentend.html
Diese beiden Dateien stellen Anfang und Ende des Inhalts dar. Sie werden nicht auf jeder Seite ausgegeben, sondern nur vor bzw. nach dem Inhalt, auch wenn sich dieser über mehrere Seiten erstreckt.