236 lines
9.2 KiB
Plaintext
236 lines
9.2 KiB
Plaintext
[1]HTML Mail
|
|
|
|
Lets you theme your messages the same way you theme the rest of your
|
|
website.
|
|
|
|
[2]Requirement
|
|
|
|
* [3]Mail System 7.x-2.x
|
|
|
|
[4]Installation
|
|
|
|
The following additional modules, while not required, are highly
|
|
recommended:
|
|
*
|
|
|
|
[5]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.
|
|
|
|
*
|
|
|
|
[6]Emogrifier
|
|
Converts stylesheets to inline style rules, for consistent
|
|
display on mobile devices and webmail.
|
|
|
|
*
|
|
|
|
[7]Mail MIME
|
|
Provides a text/plain alternative to text/html emails, and
|
|
automatically converts image references to inline image
|
|
attachments.
|
|
|
|
*
|
|
|
|
[8]Pathologic
|
|
Converts urls from relative to absolute, so clickable
|
|
links in your email messages work as intended.
|
|
|
|
*
|
|
|
|
[9]Transliteration
|
|
Converts non-ASCII characters to their US-ASCII
|
|
equivalents, such as from Microsoft "smart-quotes" to
|
|
regular quotes.
|
|
|
|
Also available as a [10]patch.
|
|
|
|
[11]Updating from previous versions
|
|
|
|
The [12]7.x-2.x branch shares 94% of its code with the [13]6.x-2.x
|
|
branch, but only 15% of its code with the [14]7.x-1.x branch, and a
|
|
tiny 8% of its code with the [15]6.x-1.x branch.
|
|
|
|
Let your compatibility expectations be adjusted accordingly.
|
|
* Check the module dependencies, as they have changed. The latest
|
|
version of [16]HTML Mail depends on the [17]Mail System module
|
|
(7.x-2.2 or later) and will not work without it.
|
|
* Run update.php immediately after uploading new code.
|
|
* The user-interface for adding email header and footer text has been
|
|
removed. Headers and footers may be added by template files and/or
|
|
by enabling the [18]Echo module.
|
|
* Any customized filters should be carefully tested, as some of the
|
|
template variables have changed. Full documentation is provided
|
|
both on the module configuration page (Click on the Instructions
|
|
link) and as comments within the htmlmail.tpl.php file itself.
|
|
* The following options have been removed from the module settings
|
|
page. In their place, any combination of [19]over 200 filter
|
|
modules may be used to create an email-specific [20]text format for
|
|
post-template filtering.
|
|
+ [21]Line break converter
|
|
+ [22]URL Filter
|
|
+ [23]Relative Path to Absolute URLs
|
|
+ [24]Emogrifier
|
|
+ [25]Token support
|
|
* Full MIME handling, including automatic generation of a plaintext
|
|
alternative part and conversion of image references to inline image
|
|
attachments, is available simply by enabling the [26]Mail MIME
|
|
module.
|
|
|
|
[27]Configuration
|
|
|
|
Visit the [28]Mail System settings page at
|
|
admin/config/system/mailsystem to select which parts of Drupal will use
|
|
[29]HTML Mail instead of the [30]default [31]mail system.
|
|
|
|
Visit the [32]HTML Mail settings page at admin/config/system/htmlmail
|
|
to select a theme and post-filter for your messages.
|
|
|
|
[33]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 email theme directory
|
|
(selected below), 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
|
|
You may choose a theme that will hold your templates from Step 1
|
|
above. If the [34]Echo module is installed, this theme will also be
|
|
used to wrap your templated text in a webpage. You use any one of
|
|
[35]over 800 themes to style your messages, or [36]create your own
|
|
for even more power and flexibility.
|
|
3. Post-filtering
|
|
You may choose a [37]text format to be used for filtering email
|
|
messages after theming. This allows you to use any combination of
|
|
[38]over 200 filter modules to make final changes to your message
|
|
before sending.
|
|
Here is a recommended configuration:
|
|
+ [39]Emogrifier Converts stylesheets to inline style rules for
|
|
consistent display on mobile devices and webmail.
|
|
+ [40]Transliteration Converts non-ASCII text to US-ASCII
|
|
equivalents. This helps prevent Microsoft "smart-quotes" from
|
|
appearing as question-marks in Mozilla Thunderbird.
|
|
+ [41]Pathologic Converts relative URLS to absolute URLS so that
|
|
clickable links in your message will work as intended.
|
|
|
|
Troubleshooting
|
|
|
|
* Double-check the [42]Mail System module settings and and make sure
|
|
you selected HTMLMailSystem for your Site-wide default mail system.
|
|
* Try selecting the [ ] (Optional) Debug checkbox at the [43]HTML
|
|
Mail module settings page and re-sending your message.
|
|
* Clear your cache after changing any .tpl.php files.
|
|
* If you use a post-filter, make sure your filter settings page looks
|
|
like [44]this.
|
|
* Visit the [45]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
|
|
|
|
[46]Documentation
|
|
|
|
[47]filter.module
|
|
[48]api.drupal.org/api/drupal/modules--filter--filter.module
|
|
[49]api.drupal.org/api/drupal/modules--filter--filter.module/gro
|
|
up/standard_filters/7
|
|
|
|
[50]Installing contributed modules
|
|
[51]drupal.org/documentation/install/modules-themes/modules-7
|
|
|
|
[52]Theming guide
|
|
[53]drupal.org/documentation/theme
|
|
|
|
Original Author
|
|
|
|
* [54]Chris Herberte
|
|
|
|
Current Maintainer
|
|
|
|
* [55]Bob Vincent
|
|
|
|
References
|
|
|
|
1. http://drupal.org/project/htmlmail
|
|
2. http://www.dict.org/bin/Dict?Form=Dict2&Database=*&Query=requirement
|
|
3. http://drupal.org/project/mailsystem
|
|
4. http://drupal.org/documentation/install/modules-themes/modules-7
|
|
5. http://drupal.org/project/echo
|
|
6. http://drupal.org/project/emogrifier
|
|
7. http://drupal.org/project/mailmime
|
|
8. http://drupal.org/project/pathologic
|
|
9. http://drupal.org/project/filter_transliteration
|
|
10. http://drupal.org/node/1095278#comment-4219530
|
|
11. http://drupal.org/node/250790
|
|
12. http://drupal.org/node/1106064
|
|
13. http://drupal.org/node/1119548
|
|
14. http://drupal.org/node/355250
|
|
15. http://drupal.org/node/329828
|
|
16. http://drupal.org/project/htmlmail
|
|
17. http://drupal.org/project/mailsystem
|
|
18. http://drupal.org/project/echo
|
|
19. http://drupal.org/project/modules/?filters=type%3Aproject_project%20tid%3A63%20hash%3A1hbejm%20-bs_project_sandbox%3A1%20bs_project_has_releases%3A1
|
|
20. http://drupal.org/node/778976
|
|
21. http://api.drupal.org/api/drupal/modules--filter--filter.module/function/_filter_autop/7
|
|
22. http://api.drupal.org/api/drupal/modules--filter--filter.module/function/_filter_url/7
|
|
23. http://drupal.org/project/rel_to_abs
|
|
24. http://www.pelagodesign.com/sidecar/emogrifier/
|
|
25. http://drupal.org/project/token
|
|
26. http://drupal.org/project/mailmime
|
|
27. http://drupal.org/files/images/htmlmail_settings_2.thumbnail.png
|
|
28. http://drupal.org/project/mailsystem
|
|
29. http://drupal.org/project/htmlmail
|
|
30. http://api.drupal.org/api/drupal/modules--system--system.mail.inc/class/DefaultMailSystem/7
|
|
31. http://api.drupal.org/api/drupal/includes--mail.inc/function/drupal_mail_system/7
|
|
32. http://drupal.org/project/htmlmail
|
|
33. http://drupal.org/documentation/theme
|
|
34. http://drupal.org/project/echo
|
|
35. http://drupal.org/project/themes
|
|
36. http://drupal.org/documentation/theme
|
|
37. http://drupal.org/node/778976
|
|
38. http://drupal.org/project/modules/?filters=type%3Aproject_project%20tid%3A63%20hash%3A1hbejm%20-bs_project_sandbox%3A1%20bs_project_has_releases%3A1
|
|
39. http://drupal.org/project/emogrifier
|
|
40. http://drupal.org/project/filter_transliteration
|
|
41. http://drupal.org/project/pathologic
|
|
42. http://drupal.org/project/mailsystem
|
|
43. http://drupal.org/project/htmlmail
|
|
44. http://drupal.org/node/1130960
|
|
45. http://drupal.org/project/issues/htmlmail
|
|
46. http://drupal.org/project/documentation
|
|
47. http://api.drupal.org/api/drupal/modules--filter--filter.module/6
|
|
48. http://api.drupal.org/api/drupal/modules--filter--filter.module/7
|
|
49. http://api.drupal.org/api/drupal/modules--filter--filter.module/group/standard_filters/7
|
|
50. http://drupal.org/documentation/install/modules-themes/modules-7
|
|
51. http://drupal.org/documentation/install/modules-themes/modules-7
|
|
52. http://drupal.org/documentation/theme
|
|
53. http://drupal.org/documentation/theme
|
|
54. http://drupal.org/user/1171
|
|
55. http://drupal.org/user/36148
|