ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / lab2454c / sothebankuab.com / wp-content / plugins / sendgrid-email-delivery-simplified / view

<?php ?>

 Email Delivery. Simplified.


 SendGrid's cloud-based email infrastructure relieves businesses of the cost and complexity
 of maintaining custom email systems. SendGrid provides reliable delivery, scalability and real-time
 analytics along with flexible APIs that make custom integration a breeze.


 Before to use this plugin, you'll need to create your very own SendGrid account.
 Go ahead and do so at <a href="http://sendgrid.com/partner/wordpress" target="_blank">http://sendgrid.com/partner/wordpress</a>


 To have the SendGrid plugin running after you activated it, please go to plugin's
 settings page and set the SendGrid credentials, and the way your email will be sent through SMTP or API.
 
 You can also set default values for the 'Name', 'Sending Address' and the 'Reply Address'
 in this page, so that you don\'t need to set these headers every time you want to send an email from your
 application.


 After you have done these configurations, all your emails sent from your WordPress installation will go through SendGrid.


 Now let see how simple is to send a text email:
 
 <div class="code">
 &lt;?php wp_mail('to@address.com\', 'Email Subject', 'Email Body'); ?&gt;
 </div>
 
 Where:
 
 <ul>
 <li>$to - Array or comma-separated list of email addresses to send message.</li>
 <li>$subject - Email subject</li>
 <li>$message - Message contents></li>
 <li>$headers - Array or SendGrid\Email() object. Optional.</li>
 <li>$attachments - Array or "\n"/"," separated list of files to attach. Optional.</li>
 </ul>
 The wp_mail function is sending text emails as default. If you want to send an email with HTML content you have
 to set the content type to 'text/html' running
 
 add_filter('wp_mail_content_type', 'set_html_content_type');
 
 function before to wp_mail() one.
 
 
 After wp_mail function you need to run the
 
 remove_filter('wp_mail_content_type', 'set_html_content_type');
 
 to remove the 'text/html' filter to avoid conflicts -- http://core.trac.wordpress.org/ticket/23578
 
 
 Example about how to send an HTML email using different headers:
 
 
 Using array for $headers:
 
 <div class="code">
 $subject = 'test plugin'
 
 $message = 'testing wordpress plugin'
 
 $to = array('address1@sendgrid.com', 'Address2 <address2@sendgrid.com>', 'address3@sendgrid.com');
 
 
 $headers = array()
 
 $headers[] = 'From: Me Myself <me@example.net>';
 
 $headers[] = 'Cc: address4@sendgrid.com';
 
 $headers[] = 'Bcc: address5@sendgrid.com';
 
 $headers[] = 'unique-args:customer=mycustomer;location=mylocation';
 
 $headers[] = 'categories: category1, category2';
 
 $headers[] = 'template: templateID';
 
 
 $attachments = array('/tmp/img1.jpg', '/tmp/img2.jpg');
 
 
 add_filter('wp_mail_content_type', 'set_html_content_type');
 
 $mail = wp_mail($to, $subject, $message, $headers, $attachments);
 
 remove_filter('wp_mail_content_type', 'set_html_content_type');
 </div>
 
 Using SendGrid\Email() for $headers:
 
 <div class="code">
 $subject = 'Test SendGrid plugin';
 
 $message = 'testing WordPress plugin';
 
 $to = array('address1@sendgrid.com', 'Address2 <address2@sendgrid.com>', 'address3@sendgrid.com');
 
 
 $headers = new SendGrid\Email();
 
 $headers 
 ->setFromName("Me Myself")
 
 ->setFrom("me@example.net")
 
 ->setCc("address4@sendgrid.com")
 
 ->setBcc("address5@sendgrid.com")
 
 ->setUniqueArgs(array('customer' => 'mycustomer', 'location' => 'mylocation'))
 
 ->addCategory('category1')
 
 ->addCategory('category2')
 
 ->setTemplateId('templateID');
 
 
 $attachments = array('/tmp/img1.jpg', '/tmp/img2.jpg');
 
 add_filter('wp_mail_content_type', 'set_html_content_type');
 
 $mail = wp_mail($to, $subject, $message, $headers, $attachments);
 
 remove_filter('wp_mail_content_type', 'set_html_content_type');
 </div>
 
 How to use Substitution and Sections
 
 <div class="code">
 $subject = 'Hey %name%, you work at %place%';
 
 $message = 'testing WordPress plugin';
 
 $to = array('address1@sendgrid.com');
 
 
 $headers = new SendGrid\Email();
 
 $headers
 
 ->addSmtpapiTo("john@somewhere.com")
 
 ->addSmtpapiTo("harry@somewhere.com")
 
 ->addSmtpapiTo("Bob@somewhere.com")
 
 ->addSubstitution("%name%", array("John", "Harry", "Bob"))
 
 ->addSubstitution("%place%", array("%office%", "%office%", "%home%"))
 
 ->addSection("%office%", "an office")
 
 ->addSection("%home%", "your house");
 
 
 $mail = wp_mail($to, $subject, $message, $headers);`
 </div>
 
 More examples for using SendGrid SMTPAPI header: <a href="https://github.com/sendgrid/smtpapi-php/" target="_blank">https://github.com/sendgrid/smtpapi-php/</a>
 
 
 Categories used for emails can be set:
 <ul>
 <li>globally, for all emails sent, by setting the 'Categories' field in the 'Mail settings' section</li>
 <li>per email by adding the category in the headers array: $headers[] = 'categories: category1, category2';</li>
 </ul>
 If you would like to configure categories for statistics, you can configure it by setting the 'Categories' field in the 'Statistics settings' section
 
 
 Define SendGrid settings as global variables (wp-config.php):
 
 <ol>
 <li>Set the API Key:
 <ul>
 <li>API Key: define('SENDGRID_API_KEY', 'sendgrid_api_key');</li>
 </ul>
 </li>
 <li>Set email related settings:
 <ul>
 <li>Send method ('api' or 'smtp'): define('SENDGRID_SEND_METHOD', 'api');</li>
 <li>From name: define('SENDGRID_FROM_NAME', 'Example Name');</li>
 <li>From email: define('SENDGRID_FROM_EMAIL', 'from_email@example.com');</li>
 <li>Reply to email: define('SENDGRID_REPLY_TO', 'reply_to@example.com');</li>
 <li>Categories: define('SENDGRID_CATEGORIES', 'category_1,category_2');</li>
 </ul>
 </li>
 </ol>

[-] sendgrid_settings_nlvx.php [edit]
[-] sendgrid_contextual_help.php [edit]
[+] js
[-] sendgrid_settings_test_email.php [edit]
[-] sendgrid_settings_test_contact.php [edit]
[+] ..
[-] sendgrid_settings.php [edit]
[-] sendgrid_stats.php [edit]
[+] css
[-] sendgrid_settings_nav.php [edit]
[+] partials
[-] sendgrid_settings_multisite.php [edit]
[+] images
[-] sendgrid_settings_general.php [edit]