/**
* 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 testToAccessors()
{
$message = new SendGrid\Mail();
// setTo instanciates and overrides existing data
$message->setTo('bar');
$message->setTo('foo');
$this->assertEquals(1, count($message->getTos()));
$to_list = $message->getTos();
$this->assertEquals('foo', $to_list[0]);
// setTos instanciates and overrides existing data
$message->setTos(array('raz', 'ber'));
$this->assertEquals(2, count($message->getTos()));
$to_list = $message->getTos();
$this->assertEquals('raz', $to_list[0]);
$this->assertEquals('ber', $to_list[1]);
// addTo appends to existing data
$message->addTo('foo');
$message->addTo('raz');
$this->assertEquals(4, count($message->getTos()));
$to_list = $message->getTos();
$this->assertEquals('raz', $to_list[0]);
$this->assertEquals('ber', $to_list[1]);
$this->assertEquals('foo', $to_list[2]);
$this->assertEquals('raz', $to_list[3]);
// removeTo removes all occurences of data
$message->removeTo('raz');
$this->assertEquals(2, count($message->getTos()));
$to_list = $message->getTos();
$this->assertEquals('ber', $to_list[0]);
$this->assertEquals('foo', $to_list[1]);
}
/**
*
* @param $tos an array containing to addresses, is required.
* @param from : sender's email address, is required
* @param fromName : human friendly sender's name
* @param subject required
* @param text - text content of mail, is required
* @param html - html content of mail, is required
*
* @return return value of zero indicates success
* A non zero return value indicates failure.
*
*/
static function sendViaWeb($tos, $from, $fromName, $subject, $text, $html)
{
$mode = Config::getInstance()->get_value("sendgrid.mail.mode");
if (strcmp($mode, "production") != 0) {
$recipients = implode($tos, ",");
$message = sprintf("\n\n **** mail to %s **** \n %s \n\n", $recipients, $text);
Logger::getInstance()->info($message);
return;
}
$login = Config::getInstance()->get_value("sendgrid.login");
$password = Config::getInstance()->get_value("sendgrid.password");
if (empty($login) || empty($password) || empty($tos) || empty($from) || empty($text) || empty($html)) {
//bad input
return self::BAD_INPUT_ERROR;
}
// SendGrid PHP LIB path should be included before
// webgloo libraries for this to work
$sendgrid = new \SendGrid($login, $password);
$mail = new \SendGrid\Mail();
$fromName = empty($fromName) ? $from : $fromName;
$mail->setTos($tos)->setFrom($from)->setFromName($fromName)->setSubject($subject)->setText($text)->setHtml($html);
/*
* response handling.
* CURLOPT_RETURNTRANSFER option is set in SendGrid/Web#send()
* that method will return the result on success, FALSE on failure
*
* @see http://docs.sendgrid.com/documentation/api/web-api/#responseserror
* {"message":"error","errors":[]}
*
* @see http://docs.sendgrid.com/documentation/api/web-api/#responsessuccess
* {"message":"success"}
*
*/
$response = $sendgrid->web->send($mail);
if ($response === FALSE) {
//problem with curl transport
$message = " Error communicating with sendgrid mail endpoint";
Logger::getInstance()->error($message);
return self::CURL_ERROR;
}
//parse response json
$responseObj = json_decode($response);
if (!is_object($responseObj) || !property_exists($responseObj, "message")) {
//bad json from sendgrid
$message = sprintf("Sendgrid mail api response :: [[%s]] is malformed", $response);
Logger::getInstance()->error($message);
return self::MALFORMED_RESPONSE;
}
$message = $responseObj->message;
if (strcasecmp($message, "error") == 0) {
//sendgrid returned error.
//get errors array
$message = " Sendgrid mail api returned error";
Logger::getInstance()->error($message);
foreach ($responseObj->errors as $error) {
Logger::getInstance()->error($error);
}
return self::SENDGRID_ERROR;
}
if (strcasecmp($message, "success") == 0) {
//success
return 0;
}
return self::UNKNOWN_ERROR;
}
