Skip to content

Settings ​

The settings page is the start page of the add-on: go to Add-Ons and click Email Template. Here you add your HTML template and set how all outgoing email is handled.

SettingsDescription
LoggingWhat is written to the log: only errors, everything (errors and notices) or nothing
Force HTMLSend every email as HTML. When set to No, the mail type of the original email is kept.
NL2BRConvert new lines in the email body to <br> before it is placed in the template
Log enabledLog every outgoing email, see Outgoing emails
CRLFSet the line ending: EE default, LF (\n) or CRLF (\r\n)
Reply ToOverride the Reply To of every email. Format: email:name, e.g. john@domain.com:John Doe
BCCExtra BCC addresses (comma separated) that are added to every email
TemplateThe actual template. Paste your HTML here and place the {body} and {subject} variables in it

Logs ​

Under Logs the module shows what happened while sending email, depending on the Logging setting:

  • Errors: the template is empty or has no {body} variable, parsing the template failed, or the Reply To or a BCC address is not a valid email address. When the template can't be used, the email is still sent, but without the template.
  • Notices (only with Everything): every email that is sent with the template, and every email that is sent without it because it contains {do_not_parse}.

Available from v5.0.0

  • Filters: filter the logs on severity, date (a period or your own date range) and a keyword in the message, and choose how many logs are shown per page. The filters stay active while sorting and paging.
  • Delete: delete a single log, select logs with the checkboxes and delete them with With selected, or remove everything with Delete all logs.
  • Export logs: download the logs that match the active filters as a CSV file (separated by ;).

On a multi-site (MSM) install you only see, export and delete the logs of the current site.

Outgoing emails ​

When Log enabled is set to Yes, every outgoing email is stored and listed under Outgoing emails in the module. You can view each email as it was sent, with the recipients, subject and send date. On a multi-site (MSM) install you only see the emails of the current site.

Filter the list on date (a period or your own date range) and a keyword in the subject, to, from, cc or bcc, and choose how many emails are shown per page. Available from v5.0.0

The log is never cleaned up automatically; delete old entries from the list when you no longer need them.