mailsystem 7.x-1.4

Provides administrative UI and API for safely setting the mail_system variable.

A module "foo" with a MailSystemInterface implementation called "FooMailSystem" should add the following in its foo.install file:

/**
 * Implements hook_enable().
 */
function foo_enable() {
  mailsystem_set(array('foo' => 'FooMailSystem'));
}

/**
 * Implements hook_disable().
 */
function foo_disable() {
  mailsystem_clear(array('foo' => 'FooMailSystem'));
}

The above settings allow mail sent by "foo" to use "FooMailSystem". To make "FooMailSystem" the site-wide default for sending mail,

  mailsystem_set(array(mailsystem_default_id() => 'FooMailSystem'));

To restore the default mail system,

  mailsystem_set(array(mailsystem_default_id() => mailsystem_default_value()));

Or simply:

  mailsystem_set(mailsystem_defaults());

If module "foo" relies on dependency "bar" and its "BarMailSystem" class, then its code should like like this:

/**
 * Implements hook_enable().
 */
function foo_enable() {
  mailsystem_set(array('foo' => 'BarMailSystem'));
}

/**
 * Implements hook_disable().
 */
function foo_disable() {
  mailsystem_clear(array('foo' => ''));
}

If module "foo" only wants to use "BarMailSystem" when sending emails with a key of "foomail", then its code should look like this:

/**
 * Implements hook_enable().
 */
function foo_enable() {
  mailsystem_set(array('foo_foomail' => 'BarMailSystem'));
}

/**
 * Implements hook_disable().
 */
function foo_disable() {
  mailsystem_clear(array('foo_foomail' => ''));
}