hook_mail_alter

Definition

hook_mail_alter(&$message)
developer/hooks/core.php, line 930

Description

Alter any aspect of the emails sent by Drupal. You can use this hook to add a common site footer to all outgoing emails; add extra header fields and/or modify the mails sent out in any way. HTML-izing the outgoing mails is one possibility. See also drupal_mail().

Parameters

$message A structured array containing the message to be altered. Keys in this array include: mail_id An id to identify the mail sent. Look into the module source codes for possible mail_id values. to The mail address or addresses where the message will be send to. The formatting of this string must comply with RFC 2822. subject Subject of the e-mail to be sent. This must not contain any newline characters, or the mail may not be sent properly. body An array of lines containing the message to be sent. Drupal will format the correct line endings for you. from The From, Reply-To, Return-Path and Error-To headers in $headers are already set to this value (if given). headers Associative array containing the headers to add. This is typically used to add extra headers (From, Cc, and Bcc).

Return value

None.

Name	Description
Hooks	Allow modules to interact with the Drupal core.

Code

<?php
function hook_mail_alter(&$message) {
  if ($message['mail_id'] == 'my_message') {
    $message['body'] .= "\n\n--\nMail sent out from " . variable_get('sitename', t('Drupal'));
  }
}
?>