Einleitung
Dieser Artikel beschreibt wie man die E-Mail Templates der CoreOne Suite auf die eigenen Bedürfnisse anpassen und in andere Sprachen übersetzen kann.
Konzept
Die E-Mail Templates sind im XSLT-Format abgelegt und werden zur Laufzeit mit XML Daten zu einer HTML Datei transformiert. Sämtliche zur Verfügung stehenden E-Mail Templates können durch das Erstellen der entsprechenden Dateien in folgendem Ordner überschrieben werden:
C:\ProgramData\itsense\Templates
Hinweis
Achten sie beim Erstellen von Templates immer darauf, dass gewisse E-Mail Clients wie zum Beispiel Microsoft Outlook nur ein begrenztes Subset der HTML / CSS Funktionalitäten darstellen können. Einfache DIVs werden dort bereits falsch dargestellt. Es empfiehlt sich daher ein Tabellen Layout zu verwenden und / oder die Templates gut zu testen!
Aufbau der Templates
Die Templates sind alle nach dem selben Muster aufgebaut. Für jede Benachrichtigung gibt es eine Hauptdatei welche sämtliche Template-Parts referenziert. Nachfolgend ist die Datei "EMailVerification.EN.tpl" aufgeführt:
[TemplatePart "../Parts/XslTemplateHeader"] <xsl:template match="/DictionaryOfString_String"> [TemplatePart "../Parts/HtmlHeaderBeforeTitle"]EMail verification[TemplatePart "../Parts/HtmlHeaderAfterTitle"] <tr> <td colspan="5">Please verifiy yourself by entering the following PIN:</td> </tr> <tr> <td colspan="5"> </td> </tr> <tr> <td colspan="5"> <p><b><xsl:value-of select="Items/Item[Key = 'verification_pin']/Value" /></b></p> </td> </tr> [TemplatePart "../Parts/HtmlFooter"] </xsl:template> </xsl:stylesheet>
Das Template im Detail:
| Zeile 1 | [TemplatePart "../Parts/XslTemplateHeader"] | Referenziert den Standard Template Header. Dieser enthält in einer Standardinstallation das Logo des Kunden und das generelle Design. |
| Zeile 3 | [TemplatePart "../Parts/HtmlHeaderBeforeTitle"]EMail verification[TemplatePart "../Parts/HtmlHeaderAfterTitle"] | Referenziert das Standard Template vor und nach der Überschrift sowie die eigentliche Überschrift in der aktuellen Sprache. |
| Zeile 12 | <p><b><xsl:value-of select="Items/Item[Key = 'verification_pin']/Value" /></b></p> | Ausgabe des Verification PINs |
| Zeile 15 | [TemplatePart "../Parts/HtmlFooter"] | Referenziert das Standard Template Footer. |
Mehrsprachigkeit
Die Templates können mehrsprachig aufgebaut werden. Dazu fügt man der entsprechenden Template Datei die Endung der entsprechenden Sprache hinzu. Wird keine Sprache angegeben, wird die Datei als Standard verwendet.
| Datei | Sprache |
|---|---|
| EmailVerification.tpl | Standard Template |
| EmailVerification.EN.tpl | Englisch |
| EmailVerification.FR.tpl | Französisch |
| EmailVerification.IT.tpl | Italienisch |
Die verwendete Sprache wird dabei immer über die Core Identität ermittelt. Ist dort keine Sprache definiert oder ist eine Sprache definiert die nicht übersetzt wurde, wird das Standard Template verwendet.
Verwandte Artikel