/**
* Send mail, similar to PHP's mail
*
* A true return value does not automatically mean that the user received the
* email successfully. It just only means that the method used was able to
* process the request without any errors.
*
* Using the two 'wp_mail_from' and 'wp_mail_from_name' hooks allow from
* creating a from address like 'Name <*****@*****.**>' when both are set. If
* just 'wp_mail_from' is set, then just the email address will be used with no
* name.
*
* The default content type is 'text/plain' which does not allow using HTML.
* However, you can set the content type of the email by using the
* 'wp_mail_content_type' filter.
*
* The default charset is based on the charset used on the blog. The charset can
* be set using the 'wp_mail_charset' filter.
*
* @since 1.2.1
* @uses apply_filters() Calls 'wp_mail' hook on an array of all of the parameters.
* @uses apply_filters() Calls 'wp_mail_from' hook to get the from email address.
* @uses apply_filters() Calls 'wp_mail_from_name' hook to get the from address name.
* @uses apply_filters() Calls 'wp_mail_content_type' hook to get the email content type.
* @uses apply_filters() Calls 'wp_mail_charset' hook to get the email charset
*
* @param string|array $to Array or comma-separated list of email addresses to send message.
* @param string $subject Email subject
* @param string $message Message contents
* @param string|array $headers Optional. Additional headers.
* @param string|array $attachments Optional. Files to attach.
* @return bool Whether the email contents were sent successfully.
*/
function wp_mail($to, $subject, $message, $headers = '', $attachments = array())
{
$sendgrid = new SendGrid(get_option('sendgrid_user'), get_option('sendgrid_pwd'));
$mail = new SendGrid\Mail();
$method = get_option('sendgrid_api');
// Compact the input, apply the filters, and extract them back out
extract(apply_filters('wp_mail', compact('to', 'subject', 'message', 'headers', 'attachments')));
// prepare attachments
$attached_files = array();
if (!empty($attachments)) {
if (!is_array($attachments)) {
$pos = strpos(',', $attachments);
if (false !== $pos) {
$attachments = preg_split('/,\\s*/', $attachments);
} else {
$attachments = explode("\n", str_replace("\r\n", "\n", $attachments));
}
}
if (is_array($attachments)) {
foreach ($attachments as $attachment) {
if (file_exists($attachment)) {
$attached_files[] = $attachment;
}
}
}
}
// Headers
$cc = array();
$bcc = array();
if (empty($headers)) {
$headers = array();
} else {
if (!is_array($headers)) {
// Explode the headers out, so this function can take both
// string headers and an array of headers.
$tempheaders = explode("\n", str_replace("\r\n", "\n", $headers));
} else {
$tempheaders = $headers;
}
$headers = array();
// If it's actually got contents
if (!empty($tempheaders)) {
// Iterate through the raw headers
foreach ((array) $tempheaders as $header) {
if (false === strpos($header, ':')) {
if (false !== stripos($header, 'boundary=')) {
$parts = preg_split('/boundary=/i', trim($header));
$boundary = trim(str_replace(array("'", '"'), '', $parts[1]));
}
continue;
}
// Explode them out
list($name, $content) = explode(':', trim($header), 2);
// Cleanup crew
$name = trim($name);
$content = trim($content);
switch (strtolower($name)) {
// Mainly for legacy -- process a From: header if it's there
case 'from':
if (false !== strpos($content, '<')) {
// So... making my life hard again?
$from_name = substr($content, 0, strpos($content, '<') - 1);
$from_name = str_replace('"', '', $from_name);
$from_name = trim($from_name);
$from_email = substr($content, strpos($content, '<') + 1);
$from_email = str_replace('>', '', $from_email);
$from_email = trim($from_email);
} else {
$from_email = trim($content);
}
break;
case 'content-type':
if (false !== strpos($content, ';')) {
list($type, $charset) = explode(';', $content);
$content_type = trim($type);
if (false !== stripos($charset, 'charset=')) {
$charset = trim(str_replace(array('charset=', '"'), '', $charset));
} elseif (false !== stripos($charset, 'boundary=')) {
$boundary = trim(str_replace(array('BOUNDARY=', 'boundary=', '"'), '', $charset));
$charset = '';
}
} else {
$content_type = trim($content);
}
break;
case 'cc':
$cc = array_merge((array) $cc, explode(',', $content));
foreach ($cc as $key => $recipient) {
$cc[$key] = trim($recipient);
}
break;
case 'bcc':
$bcc = array_merge((array) $bcc, explode(',', $content));
foreach ($bcc as $key => $recipient) {
$bcc[$key] = trim($recipient);
}
break;
case 'reply-to':
$replyto = $content;
break;
default:
// Add it to our grand headers array
$headers[trim($name)] = trim($content);
break;
}
}
}
}
// From email and name
// If we don't have a name from the input headers
if (!isset($from_name)) {
$from_name = get_option('sendgrid_from_name');
}
/* If we don't have an email from the input headers default to wordpress@$sitename
* Some hosts will block outgoing mail from this address if it doesn't exist but
* there's no easy alternative. Defaulting to admin_email might appear to be another
* option but some hosts may refuse to relay mail from an unknown domain. See
* http://trac.wordpress.org/ticket/5007.
*/
if (!isset($from_email)) {
$from_email = trim(get_option('sendgrid_from_email'));
if (!$from_email) {
// Get the site domain and get rid of www.
$sitename = strtolower($_SERVER['SERVER_NAME']);
if ('www.' == substr($sitename, 0, 4)) {
$sitename = substr($sitename, 4);
}
$from_email = "wordpress@{$sitename}";
}
}
// Plugin authors can override the potentially troublesome default
$from_email = apply_filters('wp_mail_from', $from_email);
$from_name = apply_filters('wp_mail_from_name', $from_name);
// Set destination addresses
if (!is_array($to)) {
$to = explode(',', $to);
}
// Add any CC and BCC recipients
if (!empty($cc)) {
foreach ((array) $cc as $key => $recipient) {
// Break $recipient into name and address parts if in the format "Foo <*****@*****.**>"
if (preg_match('/(.*)<(.+)>/', $recipient, $matches)) {
if (count($matches) == 3) {
$cc[$key] = trim($matches[2]);
}
}
}
}
if (!empty($bcc)) {
foreach ((array) $bcc as $key => $recipient) {
// Break $recipient into name and address parts if in the format "Foo <*****@*****.**>"
if (preg_match('/(.*)<(.+)>/', $recipient, $matches)) {
if (3 == count($matches)) {
$bcc[$key] = trim($matches[2]);
}
}
}
}
if ('api' == $method and (count($cc) or count($bcc))) {
foreach ((array) $to as $key => $recipient) {
// Break $recipient into name and address parts if in the format "Foo <*****@*****.**>"
if (preg_match('/(.*)<(.+)>/', $recipient, $matches)) {
if (3 == count($matches)) {
$to[$key] = trim($matches[2]);
}
}
}
}
// Set Content-Type and charset
// If we don't have a content-type from the input headers
if (!isset($content_type)) {
$content_type = 'text/plain';
}
$content_type = apply_filters('wp_mail_content_type', $content_type);
$mail->setTos($to)->setSubject($subject)->setText($message)->setCategory(SENDGRID_CATEGORY)->setFrom($from_email);
$categories = explode(',', get_option('sendgrid_categories'));
foreach ($categories as $category) {
$mail->addCategory($category);
}
// send HTML content
if ('text/plain' !== $content_type) {
$mail->setHtml($message);
}
// set from name
if ($from_email) {
$mail->setFromName($from_name);
}
// set from cc
if (count($cc)) {
$mail->setCcs($cc);
}
// set from bcc
if (count($bcc)) {
$mail->setBccs($bcc);
}
if (!isset($replyto)) {
$replyto = trim(get_option('sendgrid_reply_to'));
}
$reply_to_found = preg_match('/.*<(.*)>.*/i', $replyto, $result);
if ($reply_to_found) {
$replyto = $result[1];
}
$mail->setReplyTo($replyto);
// add attachemnts
if (count($attached_files)) {
$mail->setAttachments($attached_files);
}
// Send!
try {
if ('api' == $method) {
return $sendgrid->web->send($mail);
} elseif ('smtp' == $method) {
if (class_exists('Swift')) {
return $sendgrid->smtp->send($mail);
} else {
return 'Error: Swift Class not loaded. Please activate Swift plugin or use API.';
}
}
} catch (Exception $e) {
return $e->getMessage();
}
return false;
}
public function testCategoryAccessors()
{
$message = new SendGrid\Mail();
$message->setCategory('category_0');
$this->assertEquals("{\"category\":[\"category_0\"]}", $message->getHeadersJson());
$categories = array("category_1", "category_2", "category_3", "category_4");
$message->setCategories($categories);
$header = $message->getHeaders();
// ensure that the array is the same
$this->assertEquals($categories, $header['category']);
// uses valid json
$this->assertEquals("{\"category\":[\"category_1\",\"category_2\",\"category_3\",\"category_4\"]}", $message->getHeadersJson());
// ensure that addCategory appends to the list of categories
$category = "category_5";
$message->addCategory($category);
$header = $message->getHeaders();
$this->assertEquals(5, count($header['category']));
$categories[] = $category;
$this->assertEquals($categories, $header['category']);
// removeCategory removes all occurrences of a category
$message->removeCategory("category_3");
$header = $message->getHeaders();
unset($categories[2]);
$categories = array_values($categories);
$this->assertEquals(4, count($header['category']));
$this->assertEquals($categories, $header['category']);
}
