Messages Template

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.

messages-template

Set the HTML template

This is the simplest method, introduced on version 3.6. 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.

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.

2015-11-14_141017

Create an alternative PHP template

Deprecated.

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!