Differences

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

--- en:2.0:e-mail-templates [2019/07/24 14:55] – [Wie baue ich Parameter in die Vorlage ein?] 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 ======
-===== Was sind E-Mail-Vorlagen? =====
+===== What are e-mail templates? =====
-Mit E-Mail-Vorlagen könnt ihr einen eigenen Text oder Logo vor und/oder hinter dem eigentlichen Inhalt der E-Mail setzen. Die Vorlage kann über CSS auch das Layout der E-Mail, wie z.B. Schriftgröße, Schriftfarbe oder Hintergrundfarbe ändern. Es können ebenfalls Bilder von eurer Webseite z.B. das Vereinslogo hinterlegt werden. Auch weitere Texte zur Webseite oder zum Verein können in einer Vorlage abgelegt werden. Erstellt der Benutzer nun eine E-Mail, so wird vor dem Versand dieser E-Mail der Inhalt der Vorlage zu dieser E-Mail ergänzt. Der Empfänger der E-Mail sieht dann das zusammengefügte Ergebnis aus dem erstellten Text des Anwenders, sowie den Ergänzungen aus der Vorlage.
+With e-mail templates you can put your own text or logo in front of and / or behind the actual content of the e-mail. The template can also use CSS to change the layout of the e-mail, such as font size, font color or background color. You can also deposite pictures of your website e.g. the club logo. Also other texts of the web page or to the association can be written within the template. If the user creates an e-mail, the content of the template for this e-mail will be added before sending this e-mail. The recipient of the e-mail then sees the merged result from the created text of the user, as well as the additions from the template.
-===== Wie erstelle ich E-Mail-Vorlagen? =====
+===== How do I create e-mail templates? =====
-Ab Admidio Version 3 können E-Mail-Vorlagen genutzt werden. Diese werden im Ordner **adm_my_files/mail_templates** abgelegt. Existiert dieser Ordner bei euch noch nicht, so müsst ihr diesen anlegen.
+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.
-Die E-Mail-Vorlage wird über eine HTML-Datei definiert. In Admidio Version 3 kann nur eine Datei mit dem Namen **template.html** genutzt werden. //Ab Admidio Version 4// könnt ihr mehrere Vorlagen hinterlegen und den Namen auch frei wählen. Es muss allerdings immer eine Datei mit der Endung **.html** sein. Selbst wenn ihr keine HTML-E-Mails nutzen wollt, müsst ihr eine HTML-Datei erstellen, fügt aber dort dann nur Text hinzu. //Ab Admidio Version 4// könnt ihr nun in den Einstellungen der **Nachrichten** bei **E-Mail-Vorlage** die gerade erstellte Datei auswählen.
+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 (ggf. nur die Anzahl). |
+| #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.