
HTML Mail
---------

HTML Mail empowers Drupal with the ability to send emails in HTML, providing
formatting and semantic markup capabilities in e-mail that are not available
with plain text.

This module is very simple in operation. It changes headers in all outgoing
e-mail modifying e-mail sent from Drupal to be HTML with the option of header,
footer and CSS inclusion.

For a full description of the module, visit the project page:
  http://drupal.org/project/htmlmail

To submit bug reports and feature suggestions, or to track changes:
  http://drupal.org/project/issues/htmlmail

  
Installation
------------

To include inline styles so that your site theme is applied to your html emails,
download Emogrifier from http://www.pelagodesign.com/sidecar/emogrifier/
and move the emogrifier.php file to:
  DRUPAL_ROOT/sites/all/libraries/emogrifier/emogrifier.php
If available, the libraries module will be used to locate the emogrifier.php
file.  See http://drupal.org/project/libraries for further information.

Install as usual; see http://drupal.org/node/895232 for further information.


Theming
-------
E-mails can be themed by copying htmlmail.tpl.php to you active theme's 
directory and editing the contents.

To install the example template, copy htmlmail.tpl.php and html_images/ from the template
folder to your current theme's folder. 

*** Remember clear cached data on performance settings page! ***
admin-> settings -> performance
[Clear Cached Data]

Template suggestions per module allow separate templates which affect the emails coming from the
particular module. For user module:
(e.g.) htmlmail-user.tpl.php

Creating the above file will override email theming template for email coming from the user module.
You may place the template in your theme's directory but remember that a copy of
the default htmlmail.tpl.php must reside in your theme directory as well for this to work.

Again, clear cache to load the new template.

For tips and resources on building HTML e-mails see:
* http://www.campaignmonitor.com/css/
* http://www.mailchimp.com/articles/email_marketing_guide/
* http://css-tricks.com/using-css-in-html-emails-the-real-story/

Important
---------

Remember that many email clients will not be happy with certain code.  Your 
CSS may conflict with a web-mail provider's CSS, and HTML in email may expose 
security hazards. Beyond this, if you still really, really must have HTML in 
your email, you may find this module useful.


Maintainers
-----------

Chris Herberte - http://drupal.org/user/1171
