You are here

README.txt in Mime Mail 6

Same filename and directory in other branches
  1. 8 README.txt
  2. 5 README.txt
  3. 7 README.txt
INSTALLATION
  Hopefully, you know the drill by now :)
  1. Download the module and extract the files.
  2. Upload the entire mimemail folder into your Drupal sites/all/modules/
     or sites/my.site.folder/modules/ directory if you are running a multi-site
     installation of Drupal and you want this module to be specific to a
     particular site in your installation.
  3. Enable the Mime Mail module by navigating to:
     Administer > Site building > Modules
  4. Adjust settings by navigating to:
     Administer > Site configuration > Mime Mail

USAGE
  This module may be required by other modules, but is not terribly
  useful by itself. Once installed, any module can send messages by
  calling the mimemail() function:

  $sender      - a user object, text email address or an array with name, mail
  $recipient   - a user object, text email address or an array with name, mail
  $subject     - subject line
  $body        - body text in HTML format
  $plaintext   - boolean, whether to send messages in plaintext-only (default FALSE)
  $headers     - a keyed array with headers (optional)
  $text        - plaintext portion of a multipart e-mail (optional)
  $attachments - array of arrays with the file's path, MIME type (optional)
  $mailkey     - message identifier
  $send        - boolean, whether to send or only prepare the message (default TRUE)

  return       - an array containing the MIME-encoded message, including headers and body

  This module creates a user preference for receiving plaintext-only messages.
  This preference will be honored by all calls to mimemail() if the format is not
  explicitly set and the user has access to edit this preference (allowed by default).

  E-mail messages are formatted using the mimemail-message.tpl.php template.
  This includes a CSS style sheet and uses an HTML version of the text.
  The included CSS is either:
    the mail.css file found anywhere in your default theme folder or
    the combined CSS style sheets of your default theme.

  CSS style sheets with "email" media are always included.

  To create a custom mail template copy the mimemail-message.tpl.php file from
  the mimemail/theme directory into your default theme's folder. Both general and
  by-mailkey theming can be performed:
    mimemail-message.tpl.php (for all messages)
    mimemail-message--[mailkey].tpl.php (for messages with a specific mailkey)
  Note that if you are using a different administration theme than your default theme,
  you should place the same template files into that theme folder too.

  Images with absolute path will be available as remote content. To embed images
  into emails you have to use relative paths.
  For example:
    instead of http://www.mysite.com/sites/default/files/mypicture.jpg
    use /sites/default/files/mypicture.jpg

  Since some email clients (namely Outlook 2007 and GMail) is tend to only regard
  inline CSS, you can use the Compressor to convert CSS styles into inline style
  attributes. It transmogrifies the HTML source by parsing the CSS and inserting the
  CSS definitions into tags within the HTML based on the CSS selectors. To use the
  Compressor, just enable it.

  The 'send arbitrary files' permission allows you to attach or embed files located
  outside Drupal's public files directory. Note that this has security implications:
  arbitrary means even your settings.php! Give to trusted roles only!

CREDITS

  MAINTAINER: Allie Micka < allie at pajunas dot com >

  * Allie Micka
    Mime enhancements and HTML mail code

  * Gerhard Killesreiter
    Original mail and mime code

  * Robert Castelo
    HTML to Text and other functionality

File

README.txt
View source
  1. INSTALLATION
  2. Hopefully, you know the drill by now :)
  3. 1. Download the module and extract the files.
  4. 2. Upload the entire mimemail folder into your Drupal sites/all/modules/
  5. or sites/my.site.folder/modules/ directory if you are running a multi-site
  6. installation of Drupal and you want this module to be specific to a
  7. particular site in your installation.
  8. 3. Enable the Mime Mail module by navigating to:
  9. Administer > Site building > Modules
  10. 4. Adjust settings by navigating to:
  11. Administer > Site configuration > Mime Mail
  12. USAGE
  13. This module may be required by other modules, but is not terribly
  14. useful by itself. Once installed, any module can send messages by
  15. calling the mimemail() function:
  16. $sender - a user object, text email address or an array with name, mail
  17. $recipient - a user object, text email address or an array with name, mail
  18. $subject - subject line
  19. $body - body text in HTML format
  20. $plaintext - boolean, whether to send messages in plaintext-only (default FALSE)
  21. $headers - a keyed array with headers (optional)
  22. $text - plaintext portion of a multipart e-mail (optional)
  23. $attachments - array of arrays with the file's path, MIME type (optional)
  24. $mailkey - message identifier
  25. $send - boolean, whether to send or only prepare the message (default TRUE)
  26. return - an array containing the MIME-encoded message, including headers and body
  27. This module creates a user preference for receiving plaintext-only messages.
  28. This preference will be honored by all calls to mimemail() if the format is not
  29. explicitly set and the user has access to edit this preference (allowed by default).
  30. E-mail messages are formatted using the mimemail-message.tpl.php template.
  31. This includes a CSS style sheet and uses an HTML version of the text.
  32. The included CSS is either:
  33. the mail.css file found anywhere in your default theme folder or
  34. the combined CSS style sheets of your default theme.
  35. CSS style sheets with "email" media are always included.
  36. To create a custom mail template copy the mimemail-message.tpl.php file from
  37. the mimemail/theme directory into your default theme's folder. Both general and
  38. by-mailkey theming can be performed:
  39. mimemail-message.tpl.php (for all messages)
  40. mimemail-message--[mailkey].tpl.php (for messages with a specific mailkey)
  41. Note that if you are using a different administration theme than your default theme,
  42. you should place the same template files into that theme folder too.
  43. Images with absolute path will be available as remote content. To embed images
  44. into emails you have to use relative paths.
  45. For example:
  46. instead of http://www.mysite.com/sites/default/files/mypicture.jpg
  47. use /sites/default/files/mypicture.jpg
  48. Since some email clients (namely Outlook 2007 and GMail) is tend to only regard
  49. inline CSS, you can use the Compressor to convert CSS styles into inline style
  50. attributes. It transmogrifies the HTML source by parsing the CSS and inserting the
  51. CSS definitions into tags within the HTML based on the CSS selectors. To use the
  52. Compressor, just enable it.
  53. The 'send arbitrary files' permission allows you to attach or embed files located
  54. outside Drupal's public files directory. Note that this has security implications:
  55. arbitrary means even your settings.php! Give to trusted roles only!
  56. CREDITS
  57. MAINTAINER: Allie Micka < allie at pajunas dot com >
  58. * Allie Micka
  59. Mime enhancements and HTML mail code
  60. * Gerhard Killesreiter
  61. Original mail and mime code
  62. * Robert Castelo
  63. HTML to Text and other functionality