mailmime 8.x-2.8

Fixes:

#1133932: Mail MIME dependencies are unclear.

Provides a class for creating MIME messages.

• NOTE: This module does not send mail.

  If you came here looking for a mail-sending module, try HTML Mail (which can use this module for MIME-handling) or Mime Mail (which comes with its own MIME-handling library).

Mail Mime extends the PEAR class called Mail_Mime (version 1.6.1 or later) to provide a drupal-friendly library for creating and parsing MIME messages. Neither Mail Mime nor Mail_Mime send mail nor do anything useful on their own. Both are intended as code libraries to be used by other programs that send or receive mail.

Mail Mime started out as part of HTML Mail. I separated into its own module for two reasons:

1. The separation helped clarify in my own mind which parts of the mail-sending process require MIME and which do not. The resulting code is simpler and easier to maintain.

2. It is possible that another mail-sending or mail-reading module may find the Mail Mime library useful.

Requirement

The following files, available from PEAR, must be installed and available somewhere on the include_path.

*    `Mail/mime.php`
*    `Mail/mimeDecode.php`
*    `Mail/mimePart.php`
*    `PEAR.php`
*    `PEAR5.php`

One way to satisfy this requirement is to run the following command from a Unix root shell prompt:

pear install -a Mail_Mime

Another way is to install and enable the Include module before enabling the Mail MIME module.

Installation

1. Download and install as usual.

2. When enabled, Mail Mime will

   • Auto-detect whether the required files are present.

   • If any files are missing, and the Include module is available, Mail Mime will use Include to auto-download and enable the missing files.

   • If all of the above fails, Mail Mime will disable itself and print a warning to both the screen and the error log.