123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178 |
- <?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;
|