179 lines
5.9 KiB
PHP
179 lines
5.9 KiB
PHP
<?php
|
|
|
|
/**
|
|
* @file
|
|
* Default template for HTML Mail
|
|
*
|
|
* DO NOT EDIT THIS FILE. Copy it to your theme directory, and edit the copy.
|
|
*
|
|
* ========================================================= Begin instructions.
|
|
*
|
|
* When formatting an email message with a given $module and $key, [1]HTML
|
|
* Mail will use the first template file it finds from the following list:
|
|
* 1. htmlmail--$module--$key.tpl.php
|
|
* 2. htmlmail--$module.tpl.php
|
|
* 3. htmlmail.tpl.php
|
|
*
|
|
* For each filename, [2]HTML Mail looks first in the chosen Email theme
|
|
* directory, then in its own module directory, before proceeding to the
|
|
* next filename.
|
|
*
|
|
* For example, if example_module sends mail with:
|
|
* drupal_mail("example_module", "outgoing_message" ...)
|
|
*
|
|
*
|
|
* the possible template file names would be:
|
|
* 1. htmlmail--example_module--outgoing_message.tpl.php
|
|
* 2. htmlmail--example_module.tpl.php
|
|
* 3. htmlmail.tpl.php
|
|
*
|
|
* Template files are cached, so remember to clear the cache by visiting
|
|
* admin/config/development/performance after changing any .tpl.php files.
|
|
*
|
|
* The following variables available in this template:
|
|
*
|
|
* $body
|
|
* The message body text.
|
|
*
|
|
* $module
|
|
* The first argument to [3]drupal_mail(), which is, by convention,
|
|
* the machine-readable name of the sending module.
|
|
*
|
|
* $key
|
|
* The second argument to [4]drupal_mail(), which should give some
|
|
* indication of why this email is being sent.
|
|
*
|
|
* $message_id
|
|
* The email message id, which should be equal to
|
|
* "{$module}_{$key}".
|
|
*
|
|
* $headers
|
|
* An array of email (name => value) pairs.
|
|
*
|
|
* $from
|
|
* The configured sender address.
|
|
*
|
|
* $to
|
|
* The recipient email address.
|
|
*
|
|
* $subject
|
|
* The message subject line.
|
|
*
|
|
* $body
|
|
* The formatted message body.
|
|
*
|
|
* $language
|
|
* The language object for this message.
|
|
*
|
|
* $params
|
|
* Any module-specific parameters.
|
|
*
|
|
* $template_name
|
|
* The basename of the active template.
|
|
*
|
|
* $template_path
|
|
* The relative path to the template directory.
|
|
*
|
|
* $template_url
|
|
* The absolute URL to the template directory.
|
|
*
|
|
* $theme
|
|
* The name of the Email theme used to hold template files. If the
|
|
* [5]Echo module is enabled this theme will also be used to
|
|
* transform the message body into a fully-themed webpage.
|
|
*
|
|
* $theme_path
|
|
* The relative path to the selected Email theme directory.
|
|
*
|
|
* $theme_url
|
|
* The absolute URL to the selected Email theme directory.
|
|
*
|
|
* $debug
|
|
* TRUE to add some useful debugging info to the bottom of the
|
|
* message.
|
|
*
|
|
* Other modules may also add or modify theme variables by implementing a
|
|
* MODULENAME_preprocess_htmlmail(&$variables) [6]hook function.
|
|
*
|
|
* References
|
|
*
|
|
* 1. http://drupal.org/project/htmlmail
|
|
* 2. http://drupal.org/project/htmlmail
|
|
* 3. http://api.drupal.org/api/drupal/includes--mail.inc/function/drupal_mail/7
|
|
* 4. http://api.drupal.org/api/drupal/includes--mail.inc/function/drupal_mail/7
|
|
* 5. http://drupal.org/project/echo
|
|
* 6. http://api.drupal.org/api/drupal/modules--system--theme.api.php/function/hook_preprocess_HOOK/7
|
|
*
|
|
* =========================================================== End instructions.
|
|
*/
|
|
$template_name = basename(__FILE__);
|
|
$current_path = realpath(NULL);
|
|
$current_len = strlen($current_path);
|
|
$template_path = realpath(dirname(__FILE__));
|
|
if (!strncmp($template_path, $current_path, $current_len)) {
|
|
$template_path = substr($template_path, $current_len + 1);
|
|
}
|
|
$template_url = url($template_path, array('absolute' => TRUE));
|
|
?>
|
|
<div class="htmlmail-body">
|
|
<?php echo $body; ?>
|
|
</div>
|
|
<?php if ($debug):
|
|
$module_template = "htmlmail--$module.tpl.php";
|
|
$message_template = "htmlmail--$module--$key.tpl.php";
|
|
?>
|
|
<hr />
|
|
<div class="htmlmail-debug">
|
|
<dl><dt><p>
|
|
To customize this message:
|
|
</p></dt><dd><ol><li><p><?php if (empty($theme)): ?>
|
|
Visit <u>admin/config/system/htmlmail</u>
|
|
and select a theme to hold your custom email template files.
|
|
</p></li><li><p><?php elseif (empty($theme_path)): ?>
|
|
Visit <u>admin/appearance</u>
|
|
to enable your selected
|
|
<u><?php echo drupal_ucfirst($theme); ?></u> theme.
|
|
</p></li><li><?php endif;
|
|
if ("$template_path/$template_name" == "$theme_path/$message_template"): ?><p>
|
|
Edit your<br />
|
|
<code><?php echo "$template_path/$template_name"; ?></code>
|
|
<br />file.
|
|
</p></li><li><?php
|
|
else:
|
|
if (!file_exists("$theme_path/htmlmail.tpl.php")): ?><p>
|
|
Copy<br />
|
|
<code><?php echo "$module_path/htmlmail.tpl.php"; ?></code>
|
|
<br />to<br />
|
|
<code><?php echo "$theme_path/htmlmail.tpl.php"; ?></code>
|
|
</p></li><li><?php
|
|
endif;
|
|
if (!file_exists("$theme_path/$module_template")): ?><p>
|
|
For module-specific customization, copy<br />
|
|
<code><?php echo "$module_path/htmlmail.tpl.php"; ?></code>
|
|
<br />to<br />
|
|
<code><?php echo "$theme_path/$module_template"; ?></code>
|
|
</p></li><li><?php
|
|
endif;
|
|
if (!file_exists("$theme_path/$message_template")): ?><p>
|
|
For message-specific customization, copy<br />
|
|
<code><?php echo "$module_path/htmlmail.tpl.php"; ?></code>
|
|
<br />to<br />
|
|
<code><?php echo "$theme_path/$message_template"; ?></code>
|
|
</p></li><li><?php endif; ?><p>
|
|
Edit the copied file.
|
|
</p></li><li><?php
|
|
endif; ?><p>
|
|
Send a test message to make sure your customizations worked.
|
|
</p></li><li><p>
|
|
If you think your customizations would be of use to others,
|
|
please contribute your file as a feature request in the
|
|
<a href="http://drupal.org/node/add/project-issue/htmlmail">issue queue</a>.
|
|
</p></li></ol></dd><?php if (!empty($params)): ?><dt><p>
|
|
The <?php echo $module; ?> module sets the <u><code>$params</code></u>
|
|
variable. For this message,
|
|
</p></dt><dd><p><code><pre>
|
|
$params = <?php echo check_plain(print_r($params, 1)); ?>
|
|
</pre></code></p></dd><?php endif; ?></dl>
|
|
</div>
|
|
<?php endif;
|