HowTo:EMail Template
Einrichten der EMail-Konfiguration
ACHTUNG: Feature noch nicht implementiert
Die Email Vorlagen liegen im tempates/_core/mail Verzeichnis
Wenn Du eines dieser Templates verändern möchtes, so kopiere es in das entsprechende Verzeichnis in Deinem Template-Ordner!
Für jede mögliche EMail gibt es zwei verschiedene Templates, ein Text-Template und ein HTML-Template. Das Text-Template kann die folgenden Kopfzeilen enthalten, Kursiv geschriebene Werte sind hierbei optional:
- SUBJECT Betreff der EMail
- FROM "Klartext-Name" <email-adresse>
- REPLY "Klartext-Name" <email-adresse>
- CC "Klartext-Name" <email-adresse>
- BCC "Klartext-Name" <email-adresse>
- ATTACHMENT Link-Name DateiName
Für die HTML-Variante gibt es lediglich eine Möglichkeit:
- IMAGE Link-Name <DateiName>
Diese Zeilen müssen am Anfang der TEXT-Version (hinter dem Kommentar /* ... */ der jeweiligen EMail) definiert werden, und zwar je Zeile ein Feld.
Der Vorteil bei den Angaben im Template ist, dass diese nun sprachgesteuert angegeben werden können. Natürlich hätte man diese Angaben auch im Admin-Backend belassen können - aber dann wäre es ja noch umfangreicher gewesen, da man alles Sprachabhängig hätte eingeben müssen.
Kopfzeilen der Text-Datei
- SUBJECT
- Die Angabe vom SUBJECT ist zwingend vorgeschrieben, alle anderen Angaben sind optional.
- FROM optional
- Angabe des Absenders den der Empfänger der EMail sieht.
- Default-Werte:
- Klartext-Name: ShopName
- mail-from: Wert vonr Konfiguration/Mein-Shop/EMail_von
- REPLY optional
- Optionale Angabe des Antwort-Empfängers (Reply-To). Die Angabe dieses Wertes ist sinnvoll wenn der Server EMails nur über einen bestimmten account verschicken kann, Kundenantworten zu diesem Thema aber in einer anderen InBox landen sollen.
- CC optional
- Angabe von EMail-Empfängern die diese EMail immer als Kopie erhalten sollen.
- BCC optional
- Angabe von Email-Empfängern die diese EMail immer als Blindkopie erhalten sollen.
- ATTACHMENT optional
- Angabe von Dateien die mit der EMail verschickt werden sollen, z.B. PDF-Dokumente o.ä.
Kopfzeilen der HTML-Datei
- IMAGE optional
- Hier können Bilddaten angegeben werden die mit der Email verschickt werden (Embedded Images), die Bild-Datei muß hierbei im GIF-Format vorliegen!
- Um zum Beispiel ein ShopLogo zu übergeben wäre folgendes nötig:
- Speichern des Logos als GIF-Datei logo.gif unter /templates/myTemplate/email/attachment
- IMAGE shop-logo logo.gif
- in der Email das Bild mit <img src="cid:shop-logo" alt="logo"> referenzieren
Verzeichnisstruktur
- templates/_core/mail
- sprachunabhängig Vorlagen
- templates/_core/mail/attachment
- sprachunabhängige Anhänge & Bilder
- templates/_core/mail/Sprache
- Emails in der jeweiligen Sprache
- templates/_core/mail/Sprache/attachment
- sprachabhängige Anhänge & Bilder
Hinweis zum Update
Die EMail-Templates befinden sich in dem folgenden Verzeichnis:
- templates/*/admin/mail/sprache/
Der Update-Prozess wird die neuen EMail-Templates im templates/_core Verzeichnis installieren und versuchen die vorhandenen EMail-Templates aus in das entsprechende Template-Verzeichnis zu verschieben.
gelöschte Konstanten
Wenn Du eigene Erweiterungen implementiert hast so prüfe daß nicht eine der folgenden Konstanten verwendet wurde:
- EMAIL_EMBED_IMAGES
- CONTACT_US_EMAIL_ADDRESS
- CONTACT_US_EMAIL_SUBJECT
- EMAIL_SUPPORT_ADDRESS
- EMAIL_SUPPORT_NAME
- EMAIL_SUPPORT_REPLY_ADDRESS
- EMAIL_SUPPORT_REPLY_ADDRESS_NAME
- EMAIL_SUPPORT_SUBJECT
- EMAIL_SUPPORT_FORWARDING_STRING
- EMAIL_BILLING_ADDRESS
- EMAIL_BILLING_NAME
- EMAIL_BILLING_REPLY_ADDRESS
- EMAIL_BILLING_REPLY_ADDRESS_NAME
- EMAIL_BILLING_SUBJECT
- EMAIL_BILLING_FORWARDING_STRING
- EMAIL_BILLING_SUBJECT_ORDER
Noch offen
- Ob eine Modifikation des Templates stattfindet steht noch nicht fest.