📖 Artikel in der Hilfe anzeigen

PDF- und E-Mail-Variablen | Verwendung


In den HTML2PDF- und E-Mail-Vorlagen werden Smarty-Variablen verwendet, um dynamische Inhalte wie Artikeldaten, Preise oder Optionen automatisch einzufügen. Die Variablen werden in geschweiften Klammern geschrieben, z. B.:

wide1800

1. Variablenübersicht anzeigen

  • In jeder Vorlage findest du den Button „HTML Vorschau mit Variablen“.

  • Damit öffnest du eine HTML-Vorschau und das Smarty-Debug-Fenster.

  • Im Debug-Fenster siehst du alle verfügbaren Variablen und deren Struktur.

  • Hinweis: Popups müssen im Browser erlaubt sein.

2. Variablentypen

  • Postenbezogene Variablen: z. B. für Jobtickets.

  • Bestellbezogene Variablen: z. B. für Rechnungen und Bestellmails.

  • Sonstige Variablen: z. B. für spezielle E-Mails wie „Neukunden“ oder „Passwort vergessen“ (Variablen | Übersicht).

Hinweis: Variablen sind nur innerhalb des gleichen Vorlagentyps (posten- oder bestellbezogen) vorlagenübergreifend nutzbar.

3. Arrays durchlaufen und passende Variablen einsetzen (bestellbezogene Vorlagen)

Um in der Rechnung z. B. alle Artikel einer Bestellung oder deren Optionen auszugeben, werden Arrays mit einer foreach-Schleife durchlaufen. Die passenden Variablen findest du im Debug-Fenster.

Beispiel: Alle Artikel einer Bestellung ausgeben

wide1800

Beispiel: Optionen eines Artikels ausgeben

wide1800{$item_option.bezeichnung_alone}: {$item_zusatz.wert} {/foreach} {/foreach}]]>

So gehst du vor:

  1. Öffne das Debug-Fenster, um die Datenstruktur und verfügbaren Variablen zu sehen.

  2. Durchlaufe das gewünschte Array mit foreach.

  3. Greife innerhalb der Schleife mit der Punktnotation auf die Werte zu, z. B. {$item_best.artikel.bezeichnung}.

  4. Beachte: Variablen wie item_best existieren nur innerhalb der jeweiligen Schleife.

4. passende Variablen einsetzen (postenbezogene Vorlagen)

Um z. B. im Jobticket Informationen eines Artikels auszugeben, muss zunächst kein Array durchlaufen werden.

Beispiel: Alle Artikel einer Bestellung ausgeben

wide1800

Um die Optionen des Artikels auszugeben, muss wiederrum ein Array durchlaufen werden, das folgendermaßen aussehen könnte.
Beispiel: Optionen eines Artikels ausgeben

wide1800{$item.bezeichnung_alone}: {$item.wert} {/foreach} ]]>

5. Zusätzliche Tipps

Kurzfassung:

  1. Debug-Fenster öffnen.

  2. Mit foreach Arrays durchlaufen.

  3. Werte mit Punktnotation ansprechen ({$item_best.artikel.bezeichnung}).

  4. Optional: Existenz der Variable prüfen.

Falls du spezielle Variablen für E-Mails wie „Neukunden“ oder „Passwort vergessen“ suchst, findest du diese Variablen | Übersicht.