-

Note: You are currently viewing documentation for Moodle 3.10. Up-to-date documentation for the latest stable version of Moodle may be available here: Mail configuration.

Mail configuration: Difference between revisions

From MoodleDocs
m (removing new features template)
m (Fix 'AWS SES' external hyperlink)
(22 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Server settings}}
{{Server settings}}
==Outgoing mail configuration==


If incoming mail processing is enabled, users are able to reply to forum posts via email and send files to their private files as email attachments. The two relevant settings can be found in ''Site administration>Server>Incoming mail configuration.''
Settings related to mail sent by Moodle can be found in 'Outgoing mail configuration' in Site administration -> Server -> Email.


[[File:incomingmail.png|center|thumb]]
The setting 'Allowed email domains' (allowedemaildomains) allows you to enter domains allowed by your mail server so that forum post notification emails can be sent from users' real addresses. It accepts a wildcard for conveniently adding a lot of domains (*.example.com - tim@first.example.com), or a strict match (example.com - tim@example.com).  


==Mail settings==
If allowed domains are set then the user's email address will be used in the "From" and "Reply to" field only in the following situations:


===General configuration===
* The email matches the allowed domains, and the user's setting is to display their email address to everyone.
The checkbox 'Enable incoming mail processing' (''messageinbound_enabled'') MUST be ticked for this feature to work.
* The email matches the allowed domains, and the user's setting is to display their email only to course members, and the email is to be delivered to a course member.
[[File:messageinboundenabled.png|thumb|center|600px]]
 
All other situations use the no-reply address.
 
The setting 'Email via information' (emailfromvia) adds via information in the From section of outgoing email to inform the recipient where the email came from:
Name (via shortname) <noreplyaddress>
'shortname' is the short name for the site as set in the front page settings.
 
NOTE: You can also use [[Email_setup_gmail|Google gMail]] servers or AMAZON [https://docs.bitnami.com/aws/how-to/use-ses/ AWS SES] Simple Email Services to setup SMTP relay for your outbound emails.
 
===Test outgoing mail configuration===
 
A link is available to send yourself a test email to check everything is working correctly.
 
==Incoming mail configuration==
If incoming mail processing is enabled in 'Incoming mail configuration' in Site administration, then users are able to reply to forum posts via email and send files to their private files as email attachments.


===Mailbox configuration===
===Mailbox configuration===
Line 23: Line 38:


Note 3: You may also need to make sure that your host does not block outbound connections to the IMAP ports (some do by default).
Note 3: You may also need to make sure that your host does not block outbound connections to the IMAP ports (some do by default).
Note 4: If using gmail, you may find that IMAP does not work with Google's higher security setting.  If IMAP is not working with gmail, check out https://support.google.com/accounts/answer/6010255?hl=en-GB


==Message handlers==
==Message handlers==
Accessed from ''Site administration>Server>Incoming mail configuration>Message handlers'', this page allows you to turn on or off the following settings. Note that you must first have completed the fields in ''Site administration>Server>Incoming mail configuration>Mail settings.''
 
===Email to Private files===
===Email to Private files===
*If you enable this, then users will be able to send attachments via email directly to their private files. See [[Private files]] for details of how the feature works.
*If you enable this, then users will be able to send attachments via email directly to their private files. See [[Private files]] for details of how the feature works.
Line 38: Line 55:
===Reply to forum posts===
===Reply to forum posts===
*If you enable this, then users will be able to reply to forum posts directly from their email inbox. See the section on 'Reply to posts via email' in [[Using Forum]] for details of how the feature works.
*If you enable this, then users will be able to reply to forum posts directly from their email inbox. See the section on 'Reply to posts via email' in [[Using Forum]] for details of how the feature works.
*You must set ''Site administration>Plugins>Message outputs>Email'' to 'Always send email from the No reply address'; otherwise users will see the email of the forum poster instead.
*You must leave empty the ''Site administration > Server > Email > Outgoing mail configuration > Allowed email domains'' setting; otherwise users will see the email of the forum poster instead.
*Each user will be provided with  reply-to address when they click to reply to a forum post via  email. You can set the default expiry period for this address here.
*Each user will be provided with  reply-to address when they click to reply to a forum post via  email. You can set the default expiry period for this address here.


Line 44: Line 61:
* [https://moodle.org/mod/forum/discuss.php?d=277594 Need help configuring forum's "Reply to post" feature] forum discussion
* [https://moodle.org/mod/forum/discuss.php?d=277594 Need help configuring forum's "Reply to post" feature] forum discussion


[[es:Configuración del correo entrante]]
[[es:Configuración del correo]]
[[de:Einstellungen für eingehende E-Mails]]
[[de:Einstellungen für E-Mails]]


[[Category:Forum]]
[[Category:Forum]]

Revision as of 13:08, 3 January 2021

Outgoing mail configuration

Settings related to mail sent by Moodle can be found in 'Outgoing mail configuration' in Site administration -> Server -> Email.

The setting 'Allowed email domains' (allowedemaildomains) allows you to enter domains allowed by your mail server so that forum post notification emails can be sent from users' real addresses. It accepts a wildcard for conveniently adding a lot of domains (*.example.com - tim@first.example.com), or a strict match (example.com - tim@example.com).

If allowed domains are set then the user's email address will be used in the "From" and "Reply to" field only in the following situations:

  • The email matches the allowed domains, and the user's setting is to display their email address to everyone.
  • The email matches the allowed domains, and the user's setting is to display their email only to course members, and the email is to be delivered to a course member.

All other situations use the no-reply address.

The setting 'Email via information' (emailfromvia) adds via information in the From section of outgoing email to inform the recipient where the email came from:

Name (via shortname) <noreplyaddress>

'shortname' is the short name for the site as set in the front page settings.

NOTE: You can also use Google gMail servers or AMAZON AWS SES Simple Email Services to setup SMTP relay for your outbound emails. 

Test outgoing mail configuration

A link is available to send yourself a test email to check everything is working correctly.

Incoming mail configuration

If incoming mail processing is enabled in 'Incoming mail configuration' in Site administration, then users are able to reply to forum posts via email and send files to their private files as email attachments.

Mailbox configuration

It is important to have a dedicated email address here. Don't use one you normally use for your personal emails. You do not need to add the @ sign. If you have set up the email mountorangeschool @ besteveremail.com then it would be entered as in the following screenshot:

emailexampleincoming.png

Incoming mail server settings

As an example, if you are using gmail you would use IMAP.gmail.com in the Incoming mail server (messageinbound_host) field. (If using gmail you also need to make sure that you've enabled IMAP for yor gmail account - see https://support.google.com/mail/troubleshooter/1668960?hl=en )

Note1: The SMTP server hosting the mailbox you've configured above must support plus addressing i.e. any email sent to mountorangeschool+blahblahblah@besteveremail.com is still delivered to mountorangeschool@besteveremail.com.

Note2 : The username and password here must relate to the settings you entered earlier in Mailbox configuration. So if your address was mountorangeschool @ besteveremail.com and your username is mountorangeschool, then enter your username in this section along with the password you use to get into this email account.

Note 3: You may also need to make sure that your host does not block outbound connections to the IMAP ports (some do by default).

Note 4: If using gmail, you may find that IMAP does not work with Google's higher security setting. If IMAP is not working with gmail, check out https://support.google.com/accounts/answer/6010255?hl=en-GB

Message handlers

Email to Private files

  • If you enable this, then users will be able to send attachments via email directly to their private files. See Private files for details of how the feature works.
  • Each user will be provided with an address in their Private files to which they send the email and attached files. You can set the default expiry period for this address here.
  • Checking the 'Validate sender address' box will mean that if an email is sent to a user's private files from a different account from that registered with user in Moodle, then Moodle will check first before allowing the file to be stored in the user's Private files.

Invalid recipient handler

If a valid message is received but the sender cannot be authenticated, the message is stored on the email server and the user is contacted using the email address in their user profile. The user is given the chance to reply to confirm the authenticity of the original message.This handler processes those replies.

It is not possible to disable sender verification of this handler because the user may reply from an incorrect email address if their email client configuration is incorrect.

Reply to forum posts

  • If you enable this, then users will be able to reply to forum posts directly from their email inbox. See the section on 'Reply to posts via email' in Using Forum for details of how the feature works.
  • You must leave empty the Site administration > Server > Email > Outgoing mail configuration > Allowed email domains setting; otherwise users will see the email of the forum poster instead.
  • Each user will be provided with reply-to address when they click to reply to a forum post via email. You can set the default expiry period for this address here.

See also