Email Template

With the Email Template you can style all your email traffic with a nice custom HTML template

Installation

Prerequisites

Make sure your system meets the minimum requirements:

ExpressionEngine 2.10+ or 3.2+
PHP 5.3

Installation Instructions**

Upload ee2/system/third_party/email_template to system/expressionengine/third_party/
Install the module in Add-Ons → Modules

License field

This module is using a license field to check if the license for the module is valid or not. On addons.reinos.nl you can check your license and add your valid domains.

Control panel overview

In the Module CP you can enter then your license Control panel overview

When you enter a wrong license, the module will not work and it shows you an warning Control panel overview

On a local environment, like *.dev *.local *.localhost *.test the license will be valid for the testing and building new sites.

The Email template module is intend to style all your emails that comes from EE. But to fully understand the way of going underground and where there could be a possible error you see below what the module do step by step

If you send email with EE, like from the Communicate tab, EE will send this email with the Email parser.
When the email is send with the EE email parser, the Email template module catch this email with a hook (http://www.ellislab.com/expressionengine/user-guide/development/extension_hooks/global/email/index.html#id1)
By stripping down the body, finding out what type of email it is and apply some settings, it creates 2 new variable. {subject} and {body}
In the settings page there is field called ”template”, this is the field where you placed you html template with the 2 vars included ({subject} and {body})
When the module gets the template, it will parse the {body} with your real body what you typed in step 1 and also the {subject} from step 1
If the Module found extra template tags, it will try to parse them also.
When the template is parsed by the module, it will send the email again, but now with the template.
Tip: for better HTML formatting, use the Premail site to compile it to one single HTML file.

Settings

On the settings page of the module you can add your html template.

Settings	Description
License Key	This is the License key, generated by Devot:ee
Report Statistics	Report anonymously data
Template	This is the actual template. Just paste your html code here and place `{body}` and `{subject}` variable here
Force HTML	Force every email to HTML
Log enable	Enable email logging
CRLF	Set the CRLF (line ending)

Variables

The Email Template module has a couple of special variables to use.

Tag Variable

Below are the Tag Variables. Those Variables can be used in the tag described above

body

This is the actual body that comes from the template

{body}

subject

This is the subject of the email

{subject}

do_not_parse

This variable will ensure that the template will not be handled by the Email Template module. This becomes handy if you use for example Firemail to send email campaigns.

{do_not_parse}

Changelog

4.0.1 (29-07-2019)

Bugfix: where in some case the update was throwing an error

4.0.0 (27-06-2019)

Refactor: License settings due the release of the EE store (*Breaking changes)
Refactor: Rename the module with a prefix of reinos_ due the release of the EE store (\Breaking changes)**

*Note: There is a change you will have to validate the license again

\Note:** Because the module has been renamed with a prefix reinos_ there is an update path by simply add the new update to your site and install it. By installing the module, you are disabling the old module that can be deleted afterward. Also note that you have to rename the module calls and hooks with a prefix reinos_

See this article about the rename https://addons.reinos.nl/news/modules-renamed

3.2.0 (19-12-2018)

Added: EE5 support
Stopped: EE3 feature development. Only bugfixes are done into the EE3 branch.

3.1.1 (08-06-2018)

Added: license support for MSM

3.1.0 (25-04-2018)

Added: new license field (*Breaking changes) [EE3, EE4]
Bugfix: PHP 7.2 issue [EE3, EE4]

*Note: you need to add your license key and license email from addons.reinos.nl in order to validate your license and add a valid domain url in your license field on addons.reinos.nl/profile/licenses or the module will not work on a live site. Also make sure you have read the license section in the documentation