Downloads

Download tar.gz 18.4 KB
MD5: 4eaa48ab6b131568ef84bdd344d0b9b4
SHA-1: a0e10df504b5d57b29807611663643a5eed49280
SHA-256: 0d6c20c64a4abaa1fd360973a794bf13e43189d58c52b0926369e379c0779874
Download zip 24.9 KB
MD5: 34a2a0f676428aa5db96b3309ad36745
SHA-1: c849dafe5de0373e8bb0c534e9440533bd511f9d
SHA-256: 46ddcae89e49db78b2a5475a69dcd1d4e7f2abbae31cf03a83c3ba75065ced75

Release notes

HTML Mail

Lets you theme your outgoing messages the same way you theme the rest of your website.

Requirement

Installation

The following additional modules, while not required, are highly recommended:

  • Echo
    Wraps your messages in a drupal theme. Now you can "brand" your messages with the same logo, header, fonts, and styles as your website.
  • Emogrifier
    Converts stylesheets to inline style rules, for consistent display on mobile devices and webmail.
  • Mail MIME
    Provides a text/plain alternative to text/html emails, and automatically converts image references to inline image attachments.
  • Pathologic
    Converts urls from relative to absolute, so clickable links in your email messages work as intended.
  • Transliteration

    Converts non-ASCII characters to their US-ASCII equivalents, such as from Microsoft "smart-quotes" to regular quotes.

    Also available as a patch.

Configuration

Visit the Mail System settings page at admin/settings/mailsystem to select which parts of Drupal will use HTML Mail instead of the default mail system.

Visit the HTML Mail settings page at admin/settings/htmlmail to select a theme and post-filter for your messages.

Theming

The email message text goes through three transformations before sending:

  1. Template File

    A template file is applied to your message header, subject, and body text. The default template is the included htmlmail.tpl.php file. You may copy this file to your default theme directory and use it to customize the contents and formatting of your messages. The comments within that file contain complete documentation on its usage.

  2. Theming

    (Optional: requires Echo module.) The templated text may be wrapped in a website theme. This lets you use any one of over 800 themes to style your messages. Creating an email-specific sub-theme lets you use the full power of the drupal theme system to format your messages.

  3. Post-filtering

    You may choose a text format to be used for filtering email messages after theming. This allows you to use any combination of over 200 filter modules to make final changes to your message before sending.

    Here is a recommended configuration:

    • Emogrifier Converts stylesheets to inline style rules for consistent display on mobile devices and webmail.

    • Transliteration Converts non-ASCII text to US-ASCII equivalents. This helps prevent Microsoft "smart-quotes" from appearing as question-marks in Mozilla Thunderbird.

    • Pathologic Converts relative URLS to absolute URLS so that clickable links in your message will work as intended.

Troubleshooting

Visit the issue queue for support and feature requests.

Related Modules

Echo

http://drupal.org/project/echo

Emogrifier

http://drupal.org/project/emogrifier

HTML Purifier

http://drupal.org/project/htmlpurifier

htmLawed

http://drupal.org/project/htmlawed

Mail MIME

http://drupal.org/project/mailmime

Mail System

http://drupal.org/project/mailsystem

Pathologic

http://drupal.org/project/pathologic

Transliteration

http://drupal.org/project/transliteration

Documentation

filter.module
D6: http://api.drupal.org/api/drupal/modules--filter--filter.module/6

D7: http://api.drupal.org/api/drupal/modules--filter--filter.module/7

Installing contributed modules
D6: http://drupal.org/documentation/install/modules-themes/modules-5-6

D7: http://drupal.org/documentation/install/modules-themes/modules-7

Theming guide

http://drupal.org/documentation/theme

Original Author

Current Maintainer

Created by: pillarsdotnet
Created on: 8 Apr 2011 at 07:21 UTC
Last updated: 8 Apr 2011 at 07:22 UTC
Unsupported

Other releases