Mail Branding

Add a wrapper around bodyHTML.

Add email templates to wireMail

How it works?

Create an email template without content. On the spot where you wish to have your content place the tag {bodyHTML}. The markup you've set with $mail->bodyHTML('<p>Markup</p>'); will replace that tag.

Setting the defaults

Go to the module settings and set the path to your email template. Make sure it is an absolute URL. Optionally you could inline all CSS with Emogrifier when you add a CSS file. The CSS file needs to be placed in the same folder, have the same basename as the wrapper and should end with the .css extension.

When using the Emogrifier CSS inliner applying it on the bodyHTML only is the most efficient way. We recommend you to write the inline styles for the wrapper manually.

Overwriting the defaults

The API overwrites the settings set in the module configuration.

$mail = wireMail();
$mail->to('user@some-domain.ext')->from('you@own-domain.ext');
$mail->subject('Mail Subject');

// Overwrite the Absolute URL
$mail->template('/site/templates/template_wrapper.php');

// Overwrite the Emogrifier CSS inliner. (0, bodyHTML, wrapper)
$mail->inlineCSS('bodyHTML');

$mail->bodyHTML('<p>This paragraph will replace the {bodyHTML} tag in the mail template.</p>');
$mail->send();

The added methods

// Disable the wrapper template* (Just send the bodyHTML)
$mail->template('');

// Disable the Emogrifier inliner
$mail->inlineCSS(0);

// Apply only on bodyHTML. (optimal when using Emogrifier inliner)
$mail->inlineCSS('bodyHTML');

// Apply over the complete HTML.
$mail->inlineCSS('wrapper');

Thanks!

This module is written by Martijn Geerts and sponsored by Calago.nl.

More modules by martijn-geerts

  • Admin Custom Files

    Add custom scripts & styles to the admin with optional dependencies
  • Select File Fieldtype

    Field that stores a filename from a folder.
  • Image Interceptor

    Let editors use WYSIWYG images, but change the image size/behaviour.
  • Markup RSS Feed enhanced

    Renders an RSS feed. Given a PageArray, renders an RSS feed of them.
  • Select Fields

    Field storing field references.
  • Mail Branding

    Add a wrapper around bodyHTML.
  • Inputfield Source Code

    Display a string with the rendered output of this Page (per it's Template) in an Inputfield. The markup could be copied with a button click (flash enabled browsers) and/or copied manually from…
  • Markup Adaptive

    Javascript helper to sync your CSS media queries with javascript.
  • PLUs (Page Lister URLs)

    Link to listerpages with predefined settings.

All modules by martijn-geerts

Install and use modules at your own risk. Always have a site and database backup before installing new modules.