Wiki source code of E-Mail

Last modified by Carina Enke on 17.01.2024
Show last authors
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 [[image:attach:kb_envelop-filled.png]] The **email **course element allows the integration of an email form into a course or group. By using this form, course participants can directly communicate with the author or recipients defined by the author. The subject and message can either be predefined or freely defined by the sender.
5 {{/layout-cell}}
6
7 {{layout-cell}}
8 {{panel borderColor="silver" borderStyle="solid" title="Content"}}
9 {{toc maxLevel="4" minLevel="2"/}}
10 {{/panel}}
11 {{/layout-cell}}
12 {{/layout-section}}
13
14 {{layout-section ac:type="single"}}
15 {{layout-cell}}
16 == Usage: Learners' View ==
17
18 {{panel title="Overview"}}
19 (% class="wrapped" %)
20 |(((
21 In the **email** course element, there is a ready-made form for **sending emails**. This means that the course author can preconfigure the recipients, subject, and message. The email author will then find this prefilled form in the course view of the course element. They can still change the subject and message, specify recipients for copies, and add attachments. However, the preconfigured recipients cannot be changed.
22 )))|(((
23 (% class="content-wrapper" %)
24 (((
25 [[image:attach:Kursrun - Leeres E-Mailformular_en.png]]
26 )))
27 )))
28 {{/panel}}
29 {{/layout-cell}}
30 {{/layout-section}}
31
32 {{layout-section ac:type="single"}}
33 {{layout-cell}}
34
35 {{/layout-cell}}
36 {{/layout-section}}
37
38 {{layout-section ac:type="single"}}
39 {{layout-cell}}
40 {{id name="Email"/}}
41
42 {{panel title="Functions for users"}}
43 As a user, you can use the following functions in an **email **course element:
44
45 ==== Send email ====
46
47 (% class="wrapped" %)
48 |(((
49 (% class="content-wrapper" %)
50 (((
51 Send an email to a preconfigured group of recipients using the form provided.
52
53 {{expand title="How to use the form?"}}
54 (% class="wrapped" %)
55 |(((
56 (% class="content-wrapper" %)
57 (((
58 1. Open the **email **course element.
59 1. (((
60 In the upper section, you can see information about the sender and preconfigured (% style="color: rgb(0,0,0);" %)**recipient**(%%)**s **of the email.
61
62 {{info}}
63 The recipients are determined by the course author and cannot be changed in the form.
64 {{/info}}
65 )))
66 )))
67 )))|(((
68 (% class="content-wrapper" %)
69 (((
70 [[image:attach:Kursrun - E-Mail Absender und Empfänger_en.png]]
71 )))
72 )))
73 |(((
74 3. Optionally enter another email address in the **Copy to **text field. To send a copy to yourself, **select** the **Copy to sender **option.
75 )))|(((
76 (% class="content-wrapper" %)
77 (((
78 [[image:attach:Kursrun - E-Mail Kopie an_en.png]]
79 )))
80 )))
81 |(((
82 4. In the **Subject **and **Message **fields, a sample text is displayed if previously configured by the course author. This text is for orientation and **can** **be changed**. Just enter the desired changes or additions in the fields.If the course author has not added any sample text here, enter a meaningful subject and your desired message in the fields.
83
84 {{info}}
85 If you wish to address users personally when communicating with several recipients, you can use so-called placeholders. For example, use $firstname and $lastname in the subject and message to address the recipient of the email directly by their name.
86 {{/info}}
87
88 5. Optionally add documents or images with the **Select Files** button in the **Attachment **area. The possible total size of the attachment and the remaining storage space are also displayed in the form.
89 )))|(((
90 (% class="content-wrapper" %)
91 (((
92 [[image:attach:Kursrun - E-Mail Betreff und Nachricht_en.png]]
93 )))
94 )))
95 |(((
96 6. At the bottom of the form, click on **Send message **to start the distribution.
97 )))|(((
98 (% class="content-wrapper" %)
99 (((
100 [[image:attach:Kursrin - E-Mail - Nachricht senden_en.png]]
101 )))
102 )))
103 {{/expand}}
104 )))
105 )))
106 {{/panel}}
107
108 == Configuration: Authors' View ==
109
110 {{panel title="In the course editor"}}
111 The following functions are available to course authors in the course editor:
112
113 (% class="wrapped" %)
114 |(((
115 ==== Add an email course element ====
116 )))|(((
117 (% class="content-wrapper" %)
118 (((
119 {{expand title="Click to open instructions on how to add a course element ..."}}
120
121
122 {{display reference="LMS._Include Library.Kursseiten.Kursbaustein hinzufügen.WebHome"/}}
123 {{/expand}}
124 )))
125 )))
126 |(((
127 ==== General configuration settings ====
128 )))|(((
129 (% class="content-wrapper" %)
130 (((
131 In the course editor, you will find the following configuration tabs:
132
133 (% class="wrapped" %)
134 |=(((
135 Title and description
136 )))|(((
137 {{expand title="Configuration options in the tab title and description ..."}}
138
139
140 {{display reference="LMS._Include Library.Kursseiten.Kurshauptknoten\: Verfügbare Tabs im Editor.Tab Titel und Beschreibung.WebHome"/}}
141 {{/expand}}
142 )))
143 |=(% scope="col" %)Visibility|If necessary, restrict the visibility of the course element here. For more information, see the [[Visibility >>doc:LMS._Include Library.Kursseiten.Kurshauptknoten\: Verfügbare Tabs im Editor.Sichtbarkeit und Zugriff.WebHome]]help page.
144 |=(% scope="col" %)Access |If necessary, restrict the visibility of the course element here. For more information, see the [[Access >>doc:LMS._Include Library.Kursseiten.Kurshauptknoten\: Verfügbare Tabs im Editor.Sichtbarkeit und Zugriff.WebHome]]help page.
145 |=(((
146 Recipient
147 )))|(((
148 In this tab, you can decide who will be added as recipients of the emails. You also have the option to create text templates. Detailed instructions are given in the following section //Special configuration settings//.
149 )))
150 |=(((
151 Multilingualism
152 )))|(((
153 In this tab, different translations can be added to individual course element areas.
154 )))
155 )))
156 )))
157 |(((
158 ==== Special configuration settings ====
159 )))|(((
160 (% class="content-wrapper" %)
161 (((
162 In the course view of the email course element, users can use a preconfigured email form. All relevant settings and specifications for this form can be defined in the **Recipient **tab:
163
164 (% class="wrapped" %)
165 |(((
166 ===== (% style="color:#333300" %)Specify a(% style="color:#333333" %) mailing list title(%%) =====
167 )))|(((
168 (% class="content-wrapper" %)
169 (((
170 (% class="TableParagraph" %)
171 With the **mailing list title**, you can specify which title or name will appear as **recipient **in the email form.
172
173 {{expand title="How to do that?"}}
174 1. Open the **course editor **of the **email **course element// //and switch to the **Recipient** tab.
175 1. Enter your desired title in the **Mailing list title **text field.
176 1. Click on **Save**.
177 1. The title will now be displayed **to the users** **as** **the recipient**.
178 {{/expand}}
179 )))
180 )))|(% colspan="1" %)(% colspan="1" %)
181 (((
182 (% class="content-wrapper" %)
183 (((
184 [[image:attach:Kurseditor - E-Mail Beispielempfänger Projektbetreuer_en.png]]
185 )))
186 )))
187 |(((
188 ===== (% style="color:#3e4444" %)Specify recipients(%%) =====
189 )))|(((
190 (% class="TableParagraph" %)
191 Select one or both options: 
192
193 * **Distribution to group members or tutors:** By activating this option, you can define a course-specific group of recipients to which the emails will be sent in the course view. When activated, you can then specify this group in more detail. 
194 * **Distribution to e-mail addresses:** Activating this option allows you to set individual users as recipients. Use this option if you wish to use email addresses that are not linked to any group member or tutor.
195 )))|(% colspan="1" %)(% colspan="1" %)
196 (((
197 (% class="content-wrapper" %)
198 (((
199 [[image:attach:Kurseditor -E-Mail Empfängeroptionen_en.png]]
200 )))
201 )))
202 |(((
203 ===== (% style="color:#333300" %)Distribution to group members or tutors(%%) =====
204 )))|(((
205 (% class="content-wrapper" %)
206 (((
207 (% class="TableParagraph" %)
208 By activating the **Distribution to group members or tutors **option, you can define a course-specific group of recipients to which the emails will be sent in the course view.
209
210 (% class="TableParagraph" %)
211 Then choose from the following options:
212
213 * To all tutors of this course
214 * To all participants of this course
215 * To selected learning groups
216 * To selected learning areas
217
218 {{expand title="How to do that?"}}
219 1. Open the course editor of the **email **course element// //and switch to the **Recipient** tab.
220 1. **Select** the checkbox next to **Distribution to group members or tutors**.
221 1. Now select the recipients from the other options.
222 1. In the case of the learning group and learning area options, you can enter the names directly separated by commas or by using the grey square button with the three dots.
223 {{/expand}}
224 )))
225 )))|(% colspan="1" %)(% colspan="1" %)
226 (((
227 (% class="content-wrapper" %)
228 (((
229 [[image:attach:Kurseditor - E-Mail erweiterte Versandoptionen_en.png]]
230 )))
231 )))
232 |(((
233 ===== (% style="color:#333300" %)Distribution to e-mail addresses(%%) =====
234 )))|(((
235 (% class="content-wrapper" %)
236 (((
237 (% class="TableParagraph" %)
238 The **Distribution** **to e-mail addresses** option allows you to define specific participants or tutors as recipients. You can also use email addresses that are not linked to any group member or tutor.
239
240 {{expand title="How to do that?"}}
241 1. Open the **course editor** of the **email **course element// //and switch to the **Recipient **tab.
242 1. **Select** the checkbox next to **Distribution to e-mail addresses**.
243 1. Now enter the desired email addresses in the text field.
244 {{/expand}}
245 )))
246 )))|(% colspan="1" %)(% colspan="1" %)
247 (((
248 (% class="content-wrapper" %)
249 (((
250 [[image:attach:Kurseditor - E-Mailversand an E-Mailadressen mit Beispiel_en.png]]
251 )))
252 )))
253 |(((
254 ===== (% style="color:#3e4444" %)Create text templates(%%) =====
255 )))|(((
256 (% class="content-wrapper" %)
257 (((
258 (% class="TableParagraph" %)
259 The **Create** **templates** function allows you to **suggest a** **subject and/or message** to the user. These suggestions are for orientation and can be changed by the user at any time.
260
261 {{expand title="How to do that?"}}
262 1. Open the **course editor** of the **email **course element and switch to the **Recipient **tab.
263 1. Enter a suggestion for the subject and/or message in the appropriate **text fields**.
264 1. Click on **Save**. The suggestions will now be displayed to the users in the respective fields.
265 {{/expand}}
266
267 {{info}}
268 If you wish to address users personally when communicating with several recipients, you can use so-called placeholders. For example, use $firstname and $lastname in the subject and message to address the recipient of the email directly by their name.
269 {{/info}}
270 )))
271 )))|(% colspan="1" %)(% colspan="1" %)
272 (((
273 (% class="content-wrapper" %)
274 (((
275 [[image:attach:Kurseditor- Beispielvorlage E-Maillinhalt_en.png]]
276 )))
277 )))
278 )))
279 )))
280 {{/panel}}
281 {{/layout-cell}}
282 {{/layout-section}}
283
284 {{layout-section ac:type="single"}}
285 {{layout-cell}}
286
287 {{/layout-cell}}
288 {{/layout-section}}
289
290 {{layout-section ac:type="single"}}
291 {{layout-cell}}
292 {{panel title="In the course view"}}
293 In the course view, you can use the email form just like the course participants. Detailed instructions can be found in the [[Functions for users>>doc:||anchor="Email"]] section.
294 {{/panel}}
295 {{/layout-cell}}
296 {{/layout-section}}
297 {{/layout}}