Differences

This shows you the differences between two versions of the page.

--- en:2.0:e-mail-templates [2019/07/24 20:12] – fasse
+++ en:2.0:e-mail-templates [2021/12/13 11:04] (current) – fasse
@@ Line 1: / Line 1: @@
-FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//
 ====== Set up E-mail templates ======
 ===== What are e-mail templates? =====
@@ Line 8: / Line 6: @@
 Starting with Admidio Version 3, e-mail templates can be used. These are stored in the folder **adm_my_files/mail_templates**. If this folder does not exist, then you should create it.
-The e-mail template is defined via an HTML file. In Admidio Version 3, only one file named **template.html** can be used. //From Admidio Version 4// you can deposit several templates and choose the name freely. It always has to be a file with the extension **.html**. Even if you do not want to use HTML emails, you need to create an HTML file, but then just add text there. //From Admidio Version 4// you can now select in the settings of **messages** at **e-mail template** the file you just created.
+The e-mail template is defined via an HTML file. In Admidio Version 3, only one file named **template.html** can be used. //From Admidio Version 4// you can create several templates and choose the name freely. It always has to be a file with the extension **.html**. Even if you do not want to use HTML emails, you need to create an HTML file, but then just add text there. //From Admidio Version 4// you can now select in the settings of **messages** at **e-mail template** the file you just created.
-{{:de:2.0:messages:settings_email_template.png?400|Einstellungen > Nachrichten}}
+{{:en:2.0:messages:settings_email_template_en.png?400|Preferences > Messages}}
-Innerhalb der Html-Datei könnt ihr mit [[de:2.0:e-mail-templates#wie_baue_ich_parameter_in_die_vorlage_ein|vordefinierten Parameter]] weitere Inhalte hinzufügen. Zwingend erforderlich ist der Parameter **#message#**, welcher den eigentlich Inhalt der E-Mail hinzufügt. Diesen könnt ihr dann aber beliebig in eurer Vorlage platzieren.
+Within the html-file you can add further content with [[de:2.0:e-mail-templates#wie_baue_ich_parameter_in_die_vorlage_ein | predefined parameters]]. Mandatory is the parameter **#message#**, which adds the actual content of the e-mail. You can then place this parameter in your template as you like.
-Beispiel für eine E-Mail-Vorlage <code html><html>
+Example of an e-mail template:<code html><html>
 <head>
 <style type="text/css">
@@ Line 21: / Line 19: @@
 </head>
 <body>
-Dies ist ein Beispieltext, der vor dem eigentlichen Inhalt der E-Mail steht.
+This is a sample text that precedes the actual content of the e-mail.
-<i>Nun folgt der eigentliche Inhalt:</i>
+<i>Now follows the actual content:</i>
 #message#
-Am Ende der E-Mail steht dann noch dieser Text.
+At the end of the e-mail is this text.
 </body>
 </html></code>
-===== Wie baue ich Parameter in die Vorlage ein? =====
+===== How do I implement parameters in the template? =====
-Innerhalb der Html-Vorlage könnt ihr verschiedene Parameter nutzen, welche dann beim E-Mail-Versand durch den entsprechenden Inhalt ersetzt werden. Hinterlegt die Parameter an einer beliebigen Stelle in eurer Vorlage.
+Within the html template you can use different parameters, which will then be replaced by the corresponding content when sending the e-mail. Put the parameters anywhere in your template.
-Beispiel für eine Vorlage mit verschiedenen Parametern:<code html><html>
+Example of a template with different parameters:<code html><html>
 <body>#sender# sent to #recipients# from #organization_website# this message:
 <hr />
@@ Line 40: / Line 38: @@
 </html></code>
-Folgende Parameter stehen zur Verfügung:
+The following parameters are available:
-^ Parameter      ^ Mindestversion ^ Beschreibung          ^
+^ Parameter      ^ Minimum version ^ Description          ^
-| #message#                | 3.0 | Der Inhalt der E-Mail. **Dieser Parameter muss in jeder Vorlage hinterlegt werden!**  |
+| #message#                | 3.0 | The content of the e-mail. :!: **This parameter must be used in each template**.   |
-| #sender#                 | 3.0 | Bitte nur in Version 3.x nutzen. Vorname und Nachname des Absenders |
+| #sender#                 | 3.0 | Please only use in version 3.x. First name and surname of the sender. |
-| #sender_name#            | 4.0 | Vorname und Nachname des Absenders |
+| #sender_name#            | 4.0 | First name and surname of the sender. |
-| #sender_email#           | 4.0 | E-Mail Adresse des Absenders |
+| #sender_email#           | 4.0 | E-mail address of the sender. |
-| #receiver#               | 3.0 | Bitte nur in Version 3.x nutzen. Empfänger der E-Mail. Rollen und einzelne Benutzer. |
+| #sender_uuid#           | 4.1 | The unique UUID of the sender. |
-| #recipients#             | 4.0 | Empfänger der E-Mail. Rollen und einzelne Benutzer (bei BCC-Versand nur die Anzahl der einzelnen Benutzer)\\ Beispiel: //Mitglieder, Vorstand und 3 einzelne Benutzer//. |
+| #receiver#               | 3.0 | Please only use in version 3.x. Recipients of the e-mail. Roles and individual users. |
-| #organization_name#      | 4.0 | Name der Organisation. |
+| #recipients#             | 4.0 | Recipients of the e-mail. Roles and individual users (for sending as BCC only the number of individual users)\\ Example: //Members, Administrators and 3 individual users//. |
-| #organization_shortname# | 4.0 | Abkürzung der Organisation. |
+| #organization_name#      | 4.0 | Name of the organization. |
-| #organization_website#   | 4.0 | Webseite der Organisation. |
+| #organization_shortname# | 4.0 | Abbreviation of the organization. |
+| #organization_website#   | 4.0 | Website of the organization. |
-===== Wie nutze ich Vorlagen bei mehreren Organisationen? =====
+===== How do I use templates with multiple organizations? =====
-Habt ihr in Admidio mehrere Organisationen hinterlegt und wollt nun in der E-Mail-Vorlage Bezug auf die jeweilige Organisation nehmen unter der der Anwender die E-Mail erstellt hat, so habt ihr //ab Admidio Version 4// zwei unterschiedliche Möglichkeiten.
+If you have deposited several organizations in Admidio and now want to refer to the respective organization in the e-mail template under which the user has created the e-mail, then you have //as of Admidio Version 4// two different possibilities.
-Möchtet ihr nur den Namen oder die Webseite der Organisation in der Vorlage hinterlegen, so könnt ihr [[de:2.0:e-mail-templates#wie_baue_ich_parameter_in_die_vorlage_ein|die Parameter]] **#organization_name#**, **#organization_shortname#** oder **#organization_website#** nutzen. Baut diese an einer beliebigen Stelle in der Vorlage ein. Sobald die E-Mail dann erstellt wird, werden diese durch die jeweilige Organisationsdaten ersetzt.
+If you just want to put the organization's name or website in the template, you can use [[de:2.0:e-mail-templates#wie_baue_ich_parameter_in_die_vorlage_ein | the parameters]] **#organization_name#**, **#organization_shortname#** or **#organization_website#**. Deposite it anywhere in the template. As soon as the e-mail is created, it will be replaced by the respective organizational data.
-Möchtet ihr neben dem Namen vielleicht auch ein Logo, einen Schriftzug oder ein Farbschema der jeweiligen Organisation in der Vorlage hinterlegen, so müsst ihr separate HTML-Vorlagen erstellen. Dort könnt ihr dann jeweils über CSS oder dem einbinden von Bildern die Vorlage an eure Vorstellung anpassen und unter einem eigenen Namen z.B. **vorlage-organisation-1.html** im Ordner **adm_my_files/mail_templates** abspeichern. Geht nun in die Einstellungen der jeweiligen Organisation und wählt dort unter den Einstellungen der **Nachrichten** bei **E-Mail-Vorlage** nun die jeweilige Vorlage der Organisation aus.
+If you also want to place a logo, lettering or a color scheme of the organization in the template next to the name, you will need to create separate HTML templates. There you can then adapt via CSS or the integration of images, the template to your imagination and save it under a separate name, for example **template-organization-1.html** in the folder **adm_my_files/mail_templates**. Now go into the settings of the respective organization and select now under the settings of the **messages** at **email template** the template of that organization.