Messages Template

In this page you’ll learn how to change the layout of the confirmation and welcome messages to adapt them to your brand.

The subscription, confirmation and cancellation processes generate a few emails which body and subject can be customized inside the subscription/unsubscription configuration panel.

Usually those messages are:

  1. the confirmation request message with inside the confirmation link to verify the email address
  2. the welcome message to confirm the definitive subscription where one can even put the links to reserved content
  3. the cancellation message (goodbye message) sent when the subscription is definitively disabled

You can customized the template used to give a “frame” to those messages in two ways.


Set the HTML template

You can directly edit the HTML available on messages template configuration panel under the list building sections. The HTML rendered can be previewed directly in the configuration panel without send a test email in its desktop and mobile version.

If you mess up the HTML code don’t worry, there is a nice “reset” button which will reload the default template.

The template HTML must contain the tag {message} which will be replace with the actual message (activation, welcome, good bye and so on). With the “test” button, the message is sent to the test subscriber addresses so it can be verified on different email clients.

Since the relevant content of confirmation, welcome and goodbye message is configures in their related panel, your template should only be a beautifier of that emails. You can eventually add a signature, change the font size or background colors. A designer should be able to provide a more complex design to copy and paste into the template editing area.

Here a screenshot of the template configuration panel and remember to activate it if you want Newsletter to use your template in place of the default template.

Create an alternative PHP template

Deprecated and will be removed shortly.

Originally Newsletter executes the “newsletter/subscription/email.php” to generate the final message (of course only if the HTML template is not active). This is a core file that must not be changed.

Follow those steps to create an alternative PHP template:

  1. copy the file “newsletter/subscription/email-alternative.php”  to the folder “wp-content/extensions/newsletter/subscription/email.php” file. Create this folder is missing.
  2. rename the just copied “email-alternative.php” to “email.php”

Never copy the original “email.php” to that folder: it will result in a fatal error every time a subscriber tries to subscribe!

The new file must contain at least the “echo $message” PHP code which render the actual message to be sent. Of course, being a PHP file, modify it with care!