Variablen für E-Mail-Vorlagen verwenden
Ihre Aufgabe/Ausgangslage
Allgemeine Informationen
In den E-Mail-Vorlagen können Variablen, die vom Onlineshopsystem bereitgestellt wurden, in der Smarty-Syntax abgefragt werden. Je nach E-Mail-Vorlage und Verwendungszweck weichen die Variablen voneinander ab.
In der Regel stehen in einer E-Mail-Vorlage bestimmte Objekte (z. B. {$Kunde}) mit Eigenschaften (z. B. {$Kunde->cName}) zur Verfügung.
Sie können sich für einen Test alle in einer E-Mail-Vorlage verfügbaren Objekte und deren Eigenschaften in einer entsprechenden Test-E-Mail ausgeben lassen.
Installieren Sie hierfür das JTL-Debug-Plugin. Detailinformationen zum Plugin finden Sie hier.
Dieses Plugin bietet die Option Alle verfügbaren Smarty-Variablen an Body von Mails anhängen. Die Option ermöglicht es Ihnen, die Objekte und ihre Eigenschaften in dieser Test-E-Mail auszugeben.
Verfügbarkeit von Variablen in E-Mail-Vorlagen
Nicht jede Variable steht in jeder E-Mail-Vorlage zur Verfügung. Die Variablen Firma, Kunde, Kundengruppe, ShopURL, ShopLogoURL, Einstellungen und IP stehen in jeder E-Mail-Vorlage zur Verfügung. Die Variablen Bestellung, Artikel, Gutschein und Wunschliste stehen dagegen nur in E-Mail-Vorlagen zur Verfügung, die inhaltlich dazu passen:
Verfügbarkeit bei Plugins: Die E-Mail-Vorlage Rechnungskauf – Zahlungsinformationen aus dem Plugin PayPal Checkout bezieht sich inhaltlich auf eine Bestellung. Trotzdem bleibt #bestellung.bestellnr# im Betreff dieser Vorlage unverändert stehen, weil E-Mails aus Plugins keine eigenen Bestelldaten erhalten. Verwenden Sie hier stattdessen die reguläre Smarty-Syntax: {$oPluginMail->tbestellung->cBestellNr} statt #bestellung.bestellnr#. Bei anderen Plugins können die Feldnamen abweichen. Prüfen Sie das in der Dokumentation des jeweiligen Plugins.
Auch außerhalb von Plugin-Mails können Sie statt der Kurzschreibweise die reguläre Smarty-Syntax verwenden, zum Beispiel {$Bestellung->cBestellNr} statt #bestellung.bestellnr#. Diese Schreibweise unterstützt auch tiefere Verschachtelungen wie {$Bestellung->Zahlungsart->cName}.
Beispiele für Variablen im Text von E-Mail-Vorlagen
Beispiel anhand der Vorlage Kunde erhält Guthaben:
{includeMailTemplate template=header type=html}
Sehr {if $Kunde->cAnrede == "w"}geehrte{else}geehrter{/if} {$Kunde->cAnredeLocalized} {$Kunde->cNachname},<br>
<br>
wir freuen uns, Ihnen mitteilen zu dürfen, dass auf Ihrem Kundenkonto ein Gutschein für Sie hinterlegt wurde.<br>
<br>
<strong>Gutscheinwert:</strong> {$Gutschein->cLocalizedWert}<br>
<br>
Grund für die Ausstellung des Gutscheins: {$Gutschein->cGrund}<br>
<br>
Diesen Gutschein können Sie einfach bei Ihrer nächsten Bestellung einlösen. Der Betrag wird dann von Ihrem Einkaufswert abgezogen.<br>
<br>
Viel Spaß bei Ihrem nächsten Einkauf in unserem Shop.<br>
<br> Mit freundlichem Gruß<br> Ihr Team von {$Firma->cName}
{includeMailTemplate template=footer type=html}
Nehmen wir an, die Werte der Variablen wären wie folgt:
[Kunde] => stdClass Object
(
[cAnrede] => w
[cAnredeLocalized] => Frau
[cNachname] => Musterfrau
)
[Gutschein] => stdClass Object
(
[cLocalizedWert] => 5,00 Euro
[cGrund] => Geburtstag
)
[Firma] => stdClass Object
(
[cName] => Mustershop
)
Daraus ergibt sich mit der Vorlage folgende Guthaben-E-Mail:
Sehr geehrte Frau Musterfrau,<br>
<br>
wir freuen uns, Ihnen mitteilen zu dürfen, dass auf Ihrem Kundenkonto ein Gutschein für Sie hinterlegt wurde.<br>
<br>
<strong>Gutscheinwert:</strong> 5,00 Euro<br>
<br>
Grund für die Ausstellung des Gutscheins: Geburtstag<br>
<br>
Diesen Gutschein können Sie einfach bei Ihrer nächsten Bestellung einlösen. Der Betrag wird dann von Ihrem Einkaufswert abgezogen.<br>
<br>
Viel Spaß bei Ihrem nächsten Einkauf in unserem Shop.<br>
<br> Mit freundlichem Gruß<br> Ihr Team von MustershopVariablen für die Betreffzeile
Im Betreff können Sie Variablen in der Kurzschreibweise #objekt.feld# verwenden, zum Beispiel #bestellung.bestellnr# oder #firma.name#. Diese Schreibweise unterstützt nur eine Ebene. Tiefere Verschachtelungen wie #bestellung.zahlungsart.name# werden nicht ersetzt, sie bleiben unverändert im Text stehen.
Alternativ können Sie auch im Betreff die reguläre Smarty-Syntax verwenden, zum Beispiel {$Bestellung->cBestellNr} statt #bestellung.bestellnr#. Diese Schreibweise unterstützt auch tiefere Verschachtelungen wie {$Bestellung->Zahlungsart->cName}.
Für die Betreffzeile können Sie folgende Variablen verwenden:
#kunde.rabatt#
#kunde.guthaben#
#kunde.anrede#
#kunde.anredelocalized#
#kunde.titel#
#kunde.vorname#
#kunde.nachname#
#kunde.firma#
#kunde.strasse#
#kunde.hausnummer#
#kunde.plz#
#kunde.ort#
#kunde.land#
#kunde.tel#
#kunde.fax#
#kunde.mail#
#kunde.ustid#
#kunde.bundesland#
#kunde.adresszusatz#
#kunde.mobil#
#kunde.geburtstag#
#kunde.www#
#kunde.passwortklartext#
---
#bestellung.guthaben#
#bestellung.gesamtsumme#
#bestellung.bestellnr#
#bestellung.versandinfo#
#bestellung.tracking#
#bestellung.kommentar#
#bestellung.versandartname#
#bestellung.zahlungsartname#
#bestellung.status#
#bestellung.versanddatum#
#bestellung.erstellt#
#bestellung.bezahltdatum#
#bestellung.logistiker#
#bestellung.trackingurl#
#bestellung.versanddatum_de#
#bestellung.bezahldatum_de#
#bestellung.erstelldatum_de#
#bestellung.versanddatum_en#
#bestellung.bezahldatum_en#
#bestellung.erstelldatum_en#
#bestellung.bestellwertlocalized#
#bestellung.warensumme#
#bestellung.versand#
#bestellung.zahlungstyp#
#bestellung.estimateddelivery#
#bestellung.waehrungsfaktor#
#bestellung.estimateddeliveryex#
---
#firma.name#
#firma.unternehmer#
#firma.strasse#
#firma.hausnummer#
#firma.plz#
#firma.ort#
#firma.land#
#firma.tel#
#firma.fax#
#firma.email#
#firma.www#
#firma.kontoinhaber#
#firma.blz#
#firma.kontonr#
#firma.bank#
#firma.ustid#
#firma.steuernr#
#firma.iban#
#firma.bic#
---
#kundengruppe.name#
#kundengruppe.rabatt#
#kundengruppe.standard#
#kundengruppe.shoplogin#
#kundengruppe.nettopreise#Variablen in E-Mail-Vorlagen verwenden
Wie Sie die Variablen in Ihren E-Mail-Vorlagen verwenden können, lesen Sie hier: E-Mail-Vorlagen anpassen.