Looking for up-to-date Help documentation? Documentation for the latest releases of Totara is now available at totara.help!

Visit the new Help site

Search

It is possible to configure the settings for outgoing (sent) and incoming (received) messages from Totara Learn. 

Outgoing mail configuration

You can edit the outgoing mail configuration to your preferences by going to Site administration > Server > Email > Outgoing mail configuration.

Setting

Description

Notes

SMTP hosts

Give the full name of one or more local SMTP servers that Totara Learn should use to send mail (e.g. 'mail.a.com' or 'mail.a.com;mail.b.com'). To specify a non-default port (i.e other than port 25), you can use the [server]:[port] syntax (e.g. 'mail.a.com:587').

For secure connections

  • Port 465 is usually used with SSL

  • Port 587 is usually used with TLS

Specify security protocol below if required. If you leave this field blank, Totara Learn will use the PHP default method of sending mail.

-

SMTP security

If SMTP server requires secure connection, specify the correct protocol type.

-

SMTP Auth Type

This sets the authentication type to use on SMTP server:

  • LOGIN
  • PLAIN
  • NTLM
  • CRAM-MD5
  • XOAUTH2

-

SMTP username

If you have specified an SMTP server above, and the server requires authentication, then enter the username here.

-

SMTP password

If you have specified an SMTP server above, and the server requires authentication, then enter the password here.

-

SMTP session limit

Set the maximum number of messages sent per SMTP session. Grouping messages may speed up the sending of emails. Values lower than 2 force creation of new SMTP session for each email.

-

No-reply address

Enter the email address to be included in the From field of all outgoing emails. This email address should usually match the user account for SMTP authentication. If this setting is empty or incorrect then outgoing emails are likely to get marked as spam or are not delivered at all.

-

Character set

This setting specifies the default charset for all emails sent from the site.

-

Allow user to select character set

If enabled, users can choose an email charset in their messaging preferences.

-

Allow attachments

If ticked then it will enable emails sent from the site to have attachments, such as badges.

-

Newline characters in mail

Newline characters used in mail messages. CRLF is required according to RFC 822bis, some mail servers do automatic conversion from LF to CRLF, other mail servers do incorrect conversion from CRLF to CRCRLF, yet others reject mails with bare LF (qmail for example). Try changing this setting if you are having problems with undelivered emails or double newlines.

-

Email via information

Tick the box to add via information in the From section of outgoing email. This informs the recipient where the email came from and also helps combat recipients accidentally replying to no-reply email addresses.

-

OAuth2 ServiceThis setting provides a list of configured OAuth2 services.-

Incoming mail configuration

The settings for incoming mail can be adjusted by going to Site administration > Server > Email > Incoming mail configuration.

SettingDescriptionNotes
Enable incoming mail processing

Inbound message processing allows you to receive and process email within Totara Learn. This has applications such as sending email replies to forum posts or adding files to a user's private files.

Incoming mail processing must be enabled in order for messages to be sent with the appropriate information.

-
Mailbox nameWhen messages are sent out, they fit into the format [email protected]. To reliably generate addresses from Totara Learn, please specify the address that you would normally use before the @ sign. For example, the Mailbox name in the example would be "address". You should use a dedicated e-mail account for this purpose.-
Email domain

When messages are sent out, they fit into the format [email protected]. To reliably generate addresses from Totara Learn, please specify the domain after the @ sign. For example, the E-mail domain from the example would be "example.com". You should use a dedicated e-mail account for this purpose.

-
Incoming Mail Server

The address of the server that Totara Learn should check mail against. To specify a non-default port, you can use the [server]:[port], for example mail.example.com:587 format. If you leave this field blank, Totara Learn will use the default port for the type of mail server you specify.

-
Use SSL

Some mail servers support an additional level of security by encrypting communication between Totara Learn and your server. We recommend using this SSL encryption if your server supports it.

-
Username

This is the username your service provider will have provided to log in to your email account with.

-
Password

This is the password your service provider will have provided to log in to your email account with.

-

Message handler

You can adjust these settings to your preferences by going to Site administration > Server > Email > Message handler.

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.

Email to Private files

Store attachments to an e-mail in the user's private files storage space.

Reply to forum posts

By enabling this setting you can allow users to reply to forum posts from their associated email accounts.

On this page

Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?


  • No labels