You are here

README.txt in HTML Mail 6

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
------------

Install as usual, see http://drupal.org/node/70151 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 seperate templates which effect the emails coming from the
particular module. For user module:
eg. 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 providers CSS and HTML in email may expose 
security hazards. Beyond this, if your still really, really must have HTML in 
your email, you may find this module useful.


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

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

File

README.txt
View source
  1. HTML Mail
  2. ---------
  3. HTML Mail empowers Drupal with the ability to send emails in HTML, providing
  4. formatting and semantic markup capabilities in e-mail that are not available
  5. with plain text.
  6. This module is very simple in operation. It changes headers in all outgoing
  7. e-mail modifying e-mail sent from Drupal to be HTML with the option of header,
  8. footer and CSS inclusion.
  9. For a full description of the module, visit the project page:
  10. http://drupal.org/project/htmlmail
  11. To submit bug reports and feature suggestions, or to track changes:
  12. http://drupal.org/project/issues/htmlmail
  13. Installation
  14. ------------
  15. Install as usual, see http://drupal.org/node/70151 for further information.
  16. Theming
  17. -------
  18. E-mails can be themed by copying htmlmail.tpl.php to you active theme's
  19. directory and editing the contents.
  20. To install the example template, copy htmlmail.tpl.php and html_images/ from the template
  21. folder to your current theme's folder.
  22. *** Remember clear cached data on performance settings page! ***
  23. admin-> settings -> performance
  24. [Clear Cached Data]
  25. Template suggestions per module allow seperate templates which effect the emails coming from the
  26. particular module. For user module:
  27. eg. htmlmail-user.tpl.php
  28. Creating the above file will override email theming template for email coming from the user module.
  29. You may place the template in your theme's directory but remember that a copy of
  30. the default htmlmail.tpl.php must reside in your theme directory as well for this to work.
  31. Again, clear cache to load the new template.
  32. For tips and resources on building HTML e-mails see:
  33. * http://www.campaignmonitor.com/css/
  34. * http://www.mailchimp.com/articles/email_marketing_guide/
  35. * http://css-tricks.com/using-css-in-html-emails-the-real-story/
  36. Important
  37. ---------
  38. Remember that many email clients will not be happy with certain code, your
  39. CSS may conflict with a web-mail providers CSS and HTML in email may expose
  40. security hazards. Beyond this, if your still really, really must have HTML in
  41. your email, you may find this module useful.
  42. Maintainers
  43. -----------
  44. Chris Herberte - http://drupal.org/user/1171