@@ -13,7 +13,7 @@
|
||||
define('MAIL_LINE_ENDINGS', isset($_SERVER['WINDIR']) || strpos($_SERVER['SERVER_SOFTWARE'], 'Win32') !== FALSE ? "\r\n" : "\n");
|
||||
|
||||
/**
|
||||
* Compose and optionally send an e-mail message.
|
||||
* Composes and optionally sends an e-mail message.
|
||||
*
|
||||
* Sending an e-mail works with defining an e-mail template (subject, text
|
||||
* and possibly e-mail headers) and the replacement values to use in the
|
||||
@@ -191,7 +191,7 @@ function drupal_mail($module, $key, $to, $language, $params = array(), $from = N
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns an object that implements the MailSystemInterface.
|
||||
* Returns an object that implements the MailSystemInterface interface.
|
||||
*
|
||||
* Allows for one or more custom mail backends to format and send mail messages
|
||||
* composed using drupal_mail().
|
||||
@@ -328,7 +328,7 @@ interface MailSystemInterface {
|
||||
}
|
||||
|
||||
/**
|
||||
* Perform format=flowed soft wrapping for mail (RFC 3676).
|
||||
* Performs format=flowed soft wrapping for mail (RFC 3676).
|
||||
*
|
||||
* We use delsp=yes wrapping, but only break non-spaced languages when
|
||||
* absolutely necessary to avoid compatibility issues.
|
||||
@@ -340,6 +340,9 @@ interface MailSystemInterface {
|
||||
* @param $indent (optional)
|
||||
* A string to indent the text with. Only '>' characters are repeated on
|
||||
* subsequent wrapped lines. Others are replaced by spaces.
|
||||
*
|
||||
* @return
|
||||
* The content of the email as a string with formatting applied.
|
||||
*/
|
||||
function drupal_wrap_mail($text, $indent = '') {
|
||||
// Convert CRLF into LF.
|
||||
@@ -371,8 +374,7 @@ function drupal_wrap_mail($text, $indent = '') {
|
||||
}
|
||||
|
||||
/**
|
||||
* Transform an HTML string into plain text, preserving the structure of the
|
||||
* markup. Useful for preparing the body of a node to be sent by e-mail.
|
||||
* Transforms an HTML string into plain text, preserving its structure.
|
||||
*
|
||||
* The output will be suitable for use as 'format=flowed; delsp=yes' text
|
||||
* (RFC 3676) and can be passed directly to drupal_mail() for sending.
|
||||
@@ -551,9 +553,9 @@ function drupal_html_to_text($string, $allowed_tags = NULL) {
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function for array_walk in drupal_wrap_mail().
|
||||
*
|
||||
* Wraps words on a single line.
|
||||
*
|
||||
* Callback for array_walk() winthin drupal_wrap_mail().
|
||||
*/
|
||||
function _drupal_wrap_mail_line(&$line, $key, $values) {
|
||||
// Use soft-breaks only for purely quoted or unindented text.
|
||||
@@ -563,9 +565,9 @@ function _drupal_wrap_mail_line(&$line, $key, $values) {
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function for drupal_html_to_text().
|
||||
*
|
||||
* Keeps track of URLs and replaces them with placeholder tokens.
|
||||
*
|
||||
* Callback for preg_replace_callback() within drupal_html_to_text().
|
||||
*/
|
||||
function _drupal_html_to_mail_urls($match = NULL, $reset = FALSE) {
|
||||
global $base_url, $base_path;
|
||||
@@ -590,18 +592,18 @@ function _drupal_html_to_mail_urls($match = NULL, $reset = FALSE) {
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function for drupal_wrap_mail() and drupal_html_to_text().
|
||||
* Replaces non-quotation markers from a given piece of indentation with spaces.
|
||||
*
|
||||
* Replace all non-quotation markers from a given piece of indentation with spaces.
|
||||
* Callback for array_map() within drupal_html_to_text().
|
||||
*/
|
||||
function _drupal_html_to_text_clean($indent) {
|
||||
return preg_replace('/[^>]/', ' ', $indent);
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function for drupal_html_to_text().
|
||||
* Pads the last line with the given character.
|
||||
*
|
||||
* Pad the last line with the given character.
|
||||
* @see drupal_html_to_text()
|
||||
*/
|
||||
function _drupal_html_to_text_pad($text, $pad, $prefix = '') {
|
||||
// Remove last line break.
|
||||
|
||||
Reference in New Issue
Block a user