-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
666 lines (553 loc) · 33.7 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
=== SendGrid ===
Contributors: SendGrid
Donate link: http://sendgrid.com/
Tags: email, email reliability, email templates, sendgrid, smtp, transactional email, wp_mail,email infrastructure, email marketing, marketing email, deliverability, email deliverability, email delivery, email server, mail server, email integration, cloud email
Requires at least: 4.6
Tested up to: 4.9
Stable tag: 1.11.9
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
NO LONGER MAINTAINED. Send emails and upload contacts through SendGrid from your WordPress installation using SMTP or API integration.
== Description ==
*This plugin is no longer supported and will not work with the latest WordPress release. Feel free to fork the code from [GitHub](https://github.com/sendgrid/wordpress/) and revise the plugin to work for your needs. To learn more about Twilio SendGrid services visit SendGrid.com.*
What is the SendGrid WordPress Plugin?
SendGrid’s cloud-based email infrastructure relieves businesses of the cost and complexity of maintaining custom email systems. SendGrid provides reliable deliverability, scalability, and real-time analytics along with flexible APIs that make custom integration with your application a breeze.
SendGrid’s WordPress plugin replaces WordPress’s default wp_mail() function by using either an SMTP or API integration with SendGrid to send outgoing email from your WordPress installation. It also allows you to upload contacts directly to your SendGrid Marketing Campaigns account via a subscription widget.
By using the SendGrid plugin, you will be able to take advantage of improved deliverability and an expanded feature set, including tracking and analytics, to enhance user engagement on your WordPress installation. SendGrid also provides world class customer support, should you run into any issues.
For more details, [consult our official documentation](https://sendgrid.com/docs/Integrate/Tutorials/WordPress/index.html).
For assistance you can contact SendGrid Support from the [SendGrid Support Portal](https://support.sendgrid.com/). Click **Login & Contact Support**, and then **Contact Support** to see your support contact options. Paying SendGrid customers have the option to contact support via phone, chat, or by submitting a ticket using our web form. All SendGrid customers have the option to submit a ticket using our web form.
= The Subscription Widget =
SendGrid’s WordPress Subscription Widget makes it easy for people visiting your WordPress site to subscribe to your marketing emails, such as any newsletters, announcements, or promotional offers you may send. Upon signup, they’ll automatically receive an opt-in email allowing them to confirm their desire to begin receiving your emails. This confirmation constitutes “double opt-in,” a deliverability best practice.
For more details, consult the official documentation for the [Subscription Widget](https://sendgrid.com/docs/Integrate/Tutorials/WordPress/subscription_widget.html)
= Multisite =
If you are using the SendGrid plugin in a Multisite environment, you need to Network Activate it. You can then access the settings page on the network dashboard and the configure settings will be used for all sites.
You can enable access for SendGrid settings to each subsite in the Multisite Settings tab. If the checkbox is unchecked then that site will not see the SendGrid settings page and it will use the settings set on the network.
Warning! When you activate SendGrid management for a subsite, that site will not be able to send emails until the admin updates the SendGrid settings on that subsite.
If you already had the plugin installed in a Multisite environment and you update to versions after 1.9.0 you may need to reconfigure your plugin.
== Installation ==
Requirements:
1. PHP version >= 5.6 and <= 7.1. Installing this plugin on PHP versions 5.3 and earlier will cause your website to break.
Installation on PHP versions 5.4 and 5.5 will work but it is not recommended.
2. To send emails through SMTP you need to also install the 'Swift Mailer' plugin. ( https://wordpress.org/plugins/swift-mailer/ )
3. If wp_mail() function has been declared by another plugin that you have installed, you won't be able to use the SendGrid plugin
To upload the SendGrid Plugin .ZIP file:
1. Upload the WordPress SendGrid Plugin to the /wp-contents/plugins/ folder.
2. Activate the plugin from the "Plugins" menu in WordPress.
3. Create a SendGrid account at <a href="http://sendgrid.com/partner/wordpress" target="_blank">http://sendgrid.com/partner/wordpress</a>
4. Navigate to "Settings" -> "SendGrid Settings" and enter your SendGrid credentials
To auto install the SendGrid Plugin from the WordPress admin:
1. Navigate to "Plugins" -> "Add New"
2. Search for "SendGrid Plugin" and click "Install Now" for the "SendGrid Plugin" listing.
3. Activate the plugin from the "Plugins" menu in WordPress, or from the plugin installation screen.
4. Create a SendGrid account at <a href="http://sendgrid.com/partner/wordpress" target="_blank">http://sendgrid.com/partner/wordpress</a>
5. Navigate to "Settings" -> "SendGrid Settings" and enter your SendGrid credentials.
For Multisite:
1. Navigate to "My Sites" -> "Network Admin" -> "Plugins"
2. Click on "Add New"
3. Search for "SendGrid Plugin" and click "Install Now" for the "SendGrid Plugin" listing.
4. Network Activate the plugin from the "Plugins" menu in WordPress, or from the plugin installation screen.
5. Create a SendGrid account at <a href="http://sendgrid.com/partner/wordpress" target="_blank">http://sendgrid.com/partner/wordpress</a>
6. Navigate to "My Sites" -> "Network Admin" -> "Dashboard"
7. Click on the "SendGrid Settings" item in the menu on the left and enter your SendGrid credentials.
= Global Settings =
SendGrid settings can optionally be defined as global variables (wp-config.php):
1. Set the API key. You need to make sure you set the Mail Send permissions to FULL ACCESS, Stats to READ ACCESS and Template Engine to READ or FULL ACCESS when you created the api key on SendGrid side, so you can send emails and see statistics on wordpress):
* API key: define('SENDGRID_API_KEY', 'sendgrid_api_key');
2. Set email related settings:
* Send method ('api' or 'smtp'): define('SENDGRID_SEND_METHOD', 'api');
* From name: define('SENDGRID_FROM_NAME', 'Example Name');
* From email: define('SENDGRID_FROM_EMAIL', 'from_email@example.com');
* Reply to email: define('SENDGRID_REPLY_TO', 'reply_to@example.com');
* Categories: define('SENDGRID_CATEGORIES', 'category_1,category_2');
* Template: define('SENDGRID_TEMPLATE', 'templateID');
* Content-type: define('SENDGRID_CONTENT_TYPE', 'html');
* Unsubscribe Group: define('SENDGRID_UNSUBSCRIBE_GROUP', 'unsubscribeGroupId');
3. Set widget related settings:
* Marketing Campaigns API key: define('SENDGRID_MC_API_KEY', 'sendgrid_mc_api_key');
* Use the same authentication as for sending emails ('true' or 'false'): define('SENDGRID_MC_OPT_USE_TRANSACTIONAL', 'false');
* The contact list ID: define('SENDGRID_MC_LIST_ID', 'listID');
* Display the first and last name fields ('true' or 'false'): define('SENDGRID_MC_OPT_INCL_FNAME_LNAME', 'true');
* First and last name fields are required ('true' or 'false'): define('SENDGRID_MC_OPT_REQ_FNAME_LNAME', 'true');
* Signup confirmation email subject: define('SENDGRID_MC_SIGNUP_EMAIL_SUBJECT', 'Confirm subscription');
* Signup confirmation email content: define('SENDGRID_MC_SIGNUP_EMAIL_CONTENT', '<a href="%confirmation_link%">click here</a>');
* Signup confirmation page ID: define('SENDGRID_MC_SIGNUP_CONFIRMATION_PAGE', 'page_id');
4. Other configuration options:
* Set a custom timeout for API requests to SendGrid in seconds: define('SENDGRID_REQUEST_TIMEOUT', 10);
= Filters =
Use HTML content type for a single email:
`add_filter('wp_mail_content_type', 'set_html_content_type');
// Send the email
remove_filter('wp_mail_content_type', 'set_html_content_type');`
Change the email contents for all emails before they are sent:
`function change_content( $message, $content_type ) {
if ( 'text/plain' == $content_type ) {
$message = $message . ' will be sent as text ' ;
} else {
$message = $message . ' will be sent as text and HTML ';
}
return $message;
}
add_filter( 'sendgrid_override_template', 'change_content' );`
Changing the text content of all emails before they are sent:
`function change_sendgrid_text_email( $message ) {
return $message . ' changed by way of text filter ';
}
add_filter( 'sendgrid_mail_text', 'change_sendgrid_text_email' );`
Changing the HTML content of all emails before they are sent:
`function change_sendgrid_html_email( $message ) {
return $message . ' changed by way of html filter ';
}
add_filter( 'sendgrid_mail_html', 'change_sendgrid_html_email' );`
Note that all HTML emails sent through our plugin also contain the HTML body in the text part and that content will pass through the "sendgrid_mail_text" filter as well.
== Frequently asked questions ==
= Is there any official documentation for this plugin ? =
Yes. [You can find it here](https://sendgrid.com/docs/Integrate/Tutorials/WordPress/index.html)
= What PHP versions are supported ? =
Plugin versions 1.11.x were tested and confirmed to work on PHP 5.4, 5.5, 5.6, 7.0, 7.1. It DOES NOT work on PHP 5.3 and earlier.
Plugin versions 1.10.x were tested and confirmed to work on PHP 5.3, 5.4, 5.5 and 5.6. It DOES NOT work on PHP 7.0 and later.
= What credentials do I need to add on settings page ? =
Create a SendGrid account at <a href="http://sendgrid.com/" target="_blank">https://sendgrid.com/</a> and generate a new API key on <https://app.sendgrid.com/settings/api_keys>.
= How can I define a plugin setting to be used for all sites ? =
Add it into your wp-config.php file. Example: `define('SENDGRID_API_KEY', 'your_api_key');`.
= How to use SendGrid with WP Better Emails plugin ? =
If you have WP Better Emails plugin installed and you want to use the template defined here instead of the SendGrid template you can add the following code in your functions.php file from your theme:
`function use_wpbe_template( $message, $content_type ) {
global $wp_better_emails;
if ( 'text/plain' == $content_type ) {
$message = $wp_better_emails->process_email_text( $message );
} else {
$message = $wp_better_emails->process_email_html( $message );
}
return $message;
}
add_filter( 'sendgrid_override_template', 'use_wpbe_template', 10, 2 );`
Using the default templates from WP Better Emails will cause all emails to be sent as HTML (i.e. text/html content-type). In order to send emails as plain text (i.e. text/plain content-type) you should remove the HTML Template from WP Better Emails settings page. This is can be done by removing the '%content%' tag from the HTML template.
= Why are my emails sent as HTML instead of plain text ? =
For a detailed explanation see this page: https://sendgrid.com/docs/Classroom/Build/Format_Content/plain_text_emails_converted_to_html.html
= Will contacts from the widget be uploaded to Marketing Campaigns or Legacy Newsletter ? =
The contacts will only be uploaded to Marketing Campaigns.
= What permissions should my API keys have ? =
For the API Key used for sending emails (the General tab):
- Full Access to Mail Send.
- Read Access to Stats.
- Read Access to Supressions > Unsubscribe Groups.
- Read Access to Template Engine.
For the API Key used for contact upload (the Subscription Widget tab):
- Full Access to Marketing Campaigns.
= Can I disable the opt-in email ? =
No. SendGrid’s Email Policy requires all email addressing being sent to by SendGrid customers be confirmed opt-in addresses.
= Can I change the content of the emails before they are sent ? =
Yes. You must add a filter that does that. You need to declare a function that takes the content of the email as argument and then call add_filter() with the name "sendgrid_mail_text" or "sendgrid_mail_html", depending on what part of the email you want to change.
If you want to change the text content of all the emails before they are sent you can do it like this :
`function change_sendgrid_text_email( $message ) {
return $message . ' changed by way of text filter ';
}
add_filter( 'sendgrid_mail_text', 'change_sendgrid_text_email' );`
If you want to change HTML content of all the emails before they are sent you can do it like this :
`function change_sendgrid_html_email( $message ) {
return $message . ' changed by way of html filter ';
}
add_filter( 'sendgrid_mail_html', 'change_sendgrid_html_email' );`
Note that what is changed depends of the content-type that you have set in the settings page or overwritten by way of filter. For "text/plain" only the text part is overwritten by the filter. For "text/html" both the text and the HTML filters are called.
The code snippets above are usually added in the functions.php file of your theme.
= Can I use this plugin with BuddyPress ? =
Yes. Our plugin required special integration with BuddyPress and it's regularly tested to ensure it behaves as expected. If you have noticed issues caused by installing this plugin along with BuddyPress, you can add the following line to your wp-config.php to disable it :
`define('SENDGRID_DISABLE_BUDDYPRESS', '1');`
If you're trying to send plaintext emails using BuddyPress, keep in mind that by default the whitespace content of those emails is normalized.
That means that some newlines might be missing if you expect them to be there.
To disable this functionality, you need to add the following line in your wp-config.php file:
`define('SENDGRID_DISABLE_BP_NORMALIZE_WHITESPACE', '1');`
= Can I use shortcodes to customize the subscription confirmation page ? =
Yes. You need to create custom page and select it from the settings page. You can place any of these shortcodes in the body of that page. Here's an example :
`Hi [sendgridSubscriptionFirstName] [sendgridSubscriptionLastName],
Your email address : [sendgridSubscriptionEmail] has been successfully added.
You'll hear from us soon!`
You need to enable the use of the First Name and Last Name fields from the settings page in order to use the shortcodes for them.
= Does this plugin support Multisite? =
Yes. This plugin has basic Multisite support. You need to Network Activate this plugin.
The settings for all sites in the network can be configured only by the Network Admin in the Network Admin Dashboard.
Since 1.10.5 the Network Admin can delegate the configuration for each subsite to their respective owners. This will allow any subsite to use it's own SendGrid Plugin configuration.
= How can I further customize my emails? =
When calling the wp_mail() function you can send a SendGrid PHP email object in the headers argument.
Here is an example:
`$email = new SendGrid\Email();
$email
->setFrom('me@bar.com')
->setHtml('<strong>Hello World!</strong>')
->addCategory('customCategory')
;
wp_mail('foo@bar.com', 'Subject goes here', 'Message goes here', $email);
`
You can find more examples here: https://github.com/sendgrid/sendgrid-php/blob/v4.0.2/README.md
= My server is slow. Can I increase the timeout for API requests? =
Yes. You can define a constant in your wp-config.php file like this:
`define('SENDGRID_REQUEST_TIMEOUT', 10);`
The value is in seconds, this means that API requests will wait 10 seconds for a reponse from the SendGrid API server until timing out.
== Screenshots ==
1. Go to Admin Panel, section Plugins and activate the SendGrid plugin. If you want to send emails through SMTP you need to install also the 'Swift Mailer' plugin.
2. After activation "Settings" link will appear.
3. Go to settings page and provide your SendGrid API Key. On this page you can set also the default "Name", "Sending Address" and "Reply Address".
4. If you provide valid credentials, a form which can be used to send test emails will appear. Here you can test the plugin sending some emails.
5. Header provided in the send test email form.
6. If you click in the right corner from the top of the page on the "Help" button, a popup window with more information will appear.
7. Select the time interval for which you want to see SendGrid statistics and charts.
8. You can configure the port number when using SMTP method.
9. You can configure categories for which you would like to see your stats.
10. You can use substitutions for emails using X-SMTPAPI headers.
11. You can configure the subscription widget.
== Changelog ==
= 1.11.9 =
* Updated README to indicate that the plugin is no longer supported.
= 1.11.8 =
* Updated the plugin description to direct users to support.sendgrid.com for questions.
* Updated the "tested up to" field to confirm the latest version of the plugin wordes with the latest version of wordpress.
= 1.11.7 =
* Added a configuration parameter of API request timeout in seconds
* Fixed an issue that made the HTML subscription emails break links
= 1.11.6 =
* Added a feature flag to disable whitespace normalization in BuddyPress plaintext emails
* Fixed an issue where the from name and email subjects would incorrectly display the ampersand symbol
= 1.11.5 =
* Fixed a potential stored XSS issue on the backend settings form
* Fixed a potential CSRF issue on the backend settings form
= 1.11.4 =
* Fixed an issue where TO field recipients could not see each other in the email header
= 1.11.3 =
* Fixed an issue where the send test form was displayed when no API key was set
* Fixed an issue where the subscription test form was not displayed for the default contact list
* Fixed an issue where the virtual pages for Subscription errors was not displayed
* Fixed an issue where there was no notification for option update on the Multisite settings page
* Fixed an issue where there was no notification when an API key was not set on the General tab when there was one on the Subscription Widget tab
= 1.11.2 =
* Relaxed PHP requirement to at least version 5.4.
= 1.11.1 =
* Confirmed compatibility with PHP 7 and 7.1
* Removed some legacy code that caused warnings in PHP 7
* Fixed issue where the statistics page would show up in menu even if the API key did not have stats permissions
= 1.11.0 =
* BREAKING CHANGE: DO NOT UPGRADE IF YOU USE PHP <= 5.3. Only PHP 5.4 and later versions are supported.
* BREAKING CHANGE: Username & Password is no longer supported. Change your settings to use an API Key before updating
* API Mail Send was changed to use the V3 SendGrid API
* Emails sent with the V2 Email Object will now be translated to V3
* BREAKING CHANGE: The date parameter on the V2 object is no longer supported
* BREAKING CHANGE: When using the V2 object with SMTPAPI Tos, the BCC and CCs will only be applied to the first address
= 1.10.9 =
* Added pagination on multisite settings page
* Fixed an FAQ link
* Changed a class method to protected for extensibility (user contribution)
* Added some CSS classes for subscription widget (user contribution)
* Added warning when API Key doesn't have statistics permissions
* The statistics page will not show up in menu or dashboard when API key does not have stats permissions
= 1.10.8 =
* Fixed an XSS vulnerability in the settings forms that would allow other admins to inject scripts
= 1.10.7 =
* Add port 2525 for SMTP
* Use cache for stats widget on dashboard
= 1.10.6 =
* Fixed logos and fonts on Stats page
= 1.10.5 =
* Added settings page on multisite to give access to self manage SendGrid plugin to each subsite
= 1.10.4 =
* Set transient token for Marketing Campaign in database
= 1.10.3 =
* Add option to configure text version using setText() function from the header
* Tested up to 4.7
= 1.10.2 =
* Add options to configure subscription widget form (labels, padding)
= 1.10.1 =
* Fixed a javascript error and a PHP warning
= 1.10.0 =
* Added basic Multisite functionality
* WARNING: Multisite users need to network activate this plugin and reconfigure it.
* Fixed an issue where other users would see the SendGrid statistics widget on the dashboard.
= 1.9.5 =
* Fixed an issue with the Reply-To field
= 1.9.4 =
* Added Unsubscribe Group option
* Improved email validation
= 1.9.3 =
* Added BuddyPress integration
* MC API Key is now saved on focusout
* Added posibility of using plain text template for subscription confirmation email
* Added posibility of adding shortcodes to subscription confirmation pages
= 1.9.2 =
* Improved response time on admin dashboard
= 1.9.1 =
* Added filters that allow the change of text or HTML content of all emails before they are sent
* Fixed an issue with the widget admin notice
= 1.9.0 =
* Added the SendGrid Subscription Widget
* The settings page now has tabs to separate the configuration of general settings from the widget settings
* Fixed an issue where a 'gzinflate()' warning was displayed in Query Monitor for each plugin request
* Fixed an issue where the API Key would be deleted from the db if it was set in wp-config
= 1.8.2 =
* Update SendGrid logos
= 1.8.1 =
* Added possibility to override the email template
= 1.8.0 =
* Added SendGrid\Email() for $header
* Fix Send Test form not being displayed issue
= 1.7.6 =
* Updated validation for email addresses in the headers field of the send test email form
* Add ability to have and individual email sent to each recipient by setting x-smtpapi-to in headers
= 1.7.5 =
* Fixed an issue with the reset password email from Wordpress
* Updated validation for email addresses
* Fixed an issue where some errors were not displayed on the settings page
* Add substitutions functionality
= 1.7.4 =
* Fixed some failing requests during API Key checks
* Fixed an error that appeared on fresh installs regarding invalid port setting
= 1.7.3 =
* Add global config for content-type
* Validate send_method and port set in config file
* Be able to define categories for which you would like to see your stats
= 1.7.2 =
* Check your credentials after updating, you might need to reenter your credentials
* Fixed mcrypt library depencency issue
= 1.7.1 =
* BREAKING CHANGE: Don't make update if you don't have mcrypt php library enabled
* Fixed a timeout issue from version 1.7.0
= 1.7.0 =
* BREAKING CHANGE : wp_mail() now returns only true/false to mirror the return values of the original wp_mail(). If you have written something custom in your function.php that depends on the old behavior of the wp_mail() you should check your code to make sure it will still work right with boolean as return value instead of array
* BREAKING CHANGE: Don't make update if you don't have mcrypt php library enabled
* Added the possibility of setting the api key or username/password empty
* Added the possibility of selecting the authentication method
* Removed dependency on cURL, now all API requests are made through Wordpress
* Sending mail via SMTP now supports API keys
* Security improvements
* Refactored old code
= 1.6.9 =
* Add categories in headers, add errror message on statistics page if API key is not having permissions
= 1.6.8 =
* Update api_key validation
= 1.6.7 =
* Ability to use email templates, fix category statistics, display sender test form if we only have sending errors
= 1.6.6 =
* Remove $plugin variable to avoid conflict with other plugins
= 1.6.5 =
* Add configurable port number for SMTP method, Specify full path for sendgrid php library, Fix special characters and new lines issues
= 1.6.4 =
* Add support for toName in API method, Add required Text Domain
= 1.6.3 =
* Update Smtp class name to avoid conflicts
= 1.6.2 =
* Add Api Keys for authentication, use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v3.2.0
= 1.6.1 =
* Add unique arguments
= 1.6 =
* Fix setTo method in SMTP option, update documentation, add link to SendGrid portal
= 1.5.4 =
* Updated the plugin to use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v3.0.0
= 1.5.3 =
* Fix attachments issue
= 1.5.2 =
* Fix urlencoded username issue
= 1.5.1 =
* Fix wp_remote issue
= 1.5.0 =
* Updated the plugin to use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v2.2.0
= 1.4.6 =
* Added constants for SendGrid settings
= 1.4.5 =
* Fix changelog order in readme file
= 1.4.4 =
* Fix unicode filename for icon-128x128.png image
= 1.4.3 =
* Update plugin logo, description, screenshots on installation page
= 1.4.2 =
* Added SendGrid Statistics for the categories added in the SendGrid Settings Page
= 1.4.1 =
* Added support to set additional categories
= 1.4 =
* Fix warnings for static method, add notice for php version < 5.3.0, refactor plugin code
= 1.3.2 =
* Fix URL for loading image
= 1.3.1 =
* Fixed reply-to to accept: "name <email@example.com>"
= 1.3 =
* Added support for WordPress 3.8, fixed visual issues for WordPress 3.7
= 1.2.1 =
* Fix errors: set_html_content_type error, WP_DEBUG enabled notice, Reply-To header is overwritten by default option
= 1.2 =
* Added statistics for emails sent through WordPress plugin
= 1.1.3 =
* Fix missing argument warning message
= 1.1.2 =
* Fix display for october charts
= 1.1.1 =
* Added default category on sending
= 1.1 =
* Added SendGrid Statistics
= 1.0 =
* Fixed issue: Add error message when PHP-curl extension is not enabled.
== Upgrade notice ==
= 1.11.8 =
* Updated the plugin description to direct users to support.sendgrid.com for questions.
* Updated the "tested up to" field to confirm the latest version of the plugin wordes with the latest version of wordpress.
= 1.11.7 =
* Added a configuration parameter of API request timeout in seconds
* Fixed an issue that made the HTML subscription emails break links
= 1.11.6 =
* Added a feature flag to disable whitespace normalization in BuddyPress plaintext emails
* Fixed an issue where the from name and email subjects would incorrectly display the ampersand symbol
= 1.11.5 =
* Fixed a potential stored XSS issue on the backend settings form
* Fixed a potential CSRF issue on the backend settings form
= 1.11.4 =
* Fixed an issue where TO field recipients could not see each other in the email header
= 1.11.3 =
* Fixed an issue where the send test form was displayed when no API key was set
* Fixed an issue where the subscription test form was not displayed for the default contact list
* Fixed an issue where the virtual pages for Subscription errors was not displayed
* Fixed an issue where there was no notification for option update on the Multisite settings page
* Fixed an issue where there was no notification when an API key was not set on the General tab when there was one on the Subscription Widget tab
= 1.11.2 =
* Relaxed PHP requirement to at least version 5.4.
= 1.11.1 =
* Confirmed compatibility with PHP 7 and 7.1
* Removed some legacy code that caused warnings in PHP 7
* Fixed issue where the statistics page would show up in menu even if the API key did not have stats permissions
= 1.11.0 =
* BREAKING CHANGE: DO NOT UPGRADE IF YOU USE PHP <= 5.3. Only PHP 5.4 and later versions are supported.
* BREAKING CHANGE: Username & Password is no longer supported. Change your settings to use an API Key before updating
* API Mail Send was changed to use the V3 SendGrid API
* Emails sent with the V2 Email Object will now be translated to V3
* BREAKING CHANGE: The date parameter on the V2 object is no longer supported
* BREAKING CHANGE: When using the V2 object with SMTPAPI Tos, the BCC and CCs will only be applied to the first address
= 1.10.9 =
* Added pagination on multisite settings page
* Fixed an FAQ link
* Changed a class method to protected for extensibility (user contribution)
* Added some CSS classes for subscription widget (user contribution)
* Added warning when API Key doesn't have statistics permissions
* The statistics page will not show up in menu or dashboard when API key does not have stats permissions
= 1.10.8 =
* Fixed an XSS vulnerability in the settings forms that would allow other admins to inject scripts
= 1.10.7 =
* Add port 2525 for SMTP
* Use cache for stats widget on dashboard
= 1.10.6 =
* Fixed logos and fonts on Stats page
= 1.10.5 =
* Added settings page on multisite to give access to self manage SendGrid plugin to each subsite
= 1.10.4 =
* Set transient token for Marketing Campaign in database
= 1.10.3 =
* Add option to configure text version using setText() function from the header
* Tested up to 4.7
= 1.10.2 =
* Add options to configure subscription widget form (labels, padding)
= 1.10.1 =
* Fixed a javascript error and a PHP warning
= 1.10.0 =
* Added basic Multisite functionality
* WARNING: Multisite users need to network activate this plugin and reconfigure it.
* Fixed an issue where other users would see the SendGrid statistics widget on the dashboard.
= 1.9.5 =
* Fixed an issue with the Reply-To field
= 1.9.4 =
* Added Unsubscribe Group option
* Improved email validation
= 1.9.3 =
* Added BuddyPress integration
* MC API Key is now saved on focusout
* Added posibility of using plain text template for subscription confirmation email
* Added posibility of adding shortcodes to subscription confirmation pages
= 1.9.2 =
* Improved response time on admin dashboard
= 1.9.1 =
* Added filters that allow the change of text or HTML content of all emails before they are sent
* Fixed an issue with the widget admin notice
= 1.9.0 =
* Added the SendGrid Subscription Widget
* The settings page now has tabs to separate the configuration of general settings from the widget settings
* Fixed an issue where a 'gzinflate()' warning was displayed in Query Monitor for each plugin request
* Fixed an issue where the API Key would be deleted from the db if it was set in wp-config
= 1.8.2 =
* Update SendGrid logos
= 1.8.1 =
* Added possibility to override the email template
= 1.8.0 =
* Added SendGrid\Email() for $header
* Fix Send Test form not being displayed issue
= 1.7.6 =
* Updated validation for email addresses in the headers field of the send test email form
* Add ability to have and individual email sent to each recipient by setting x-smtpapi-to in headers
= 1.7.5 =
* Fixed an issue with the reset password email from Wordpress
* Updated validation for email addresses
* Fixed an issue where some errors were not displayed on the settings page
* Add substitutions functionality
= 1.7.4 =
* Fixed some failing requests during API Key checks
* Fixed an error that appeared on fresh installs regarding invalid port setting
= 1.7.3 =
* Add global config for content-type
* Validate send_method and port set in config file
* Be able to define categories for which you would like to see your stats
= 1.7.2 =
* Check your credentials after updating, you might need to reenter your credentials
* Fixed mcrypt library depencency issue
= 1.7.1 =
* BREAKING CHANGE: Don't make update if you don't have mcrypt php library enabled
* Fixed a timeout issue from version 1.7.0
= 1.7.0 =
* BREAKING CHANGE : wp_mail() now returns only true/false to mirror the return values of the original wp_mail(). If you have written something custom in your function.php that depends on the old behavior of the wp_mail() you should check your code to make sure it will still work right with boolean as return value instead of array
* BREAKING CHANGE: Don't make update if you don't have mcrypt php library enabled
* Added the possibility of setting the api key or username/password empty
* Added the possibility of selecting the authentication method
* Removed dependency on cURL, now all API requests are made through Wordpress
* Sending mail via SMTP now supports API keys
* Security improvements
* Refactored old code
= 1.6.9 =
* Add categories in headers, add errror message on statistics page if API key is not having permissions
= 1.6.8 =
* Update api_key validation
= 1.6.7 =
* Ability to use email templates, fix category statistics, display sender test form if we only have sending errors
= 1.6.6 =
* Remove $plugin variable to avoid conflict with other plugins
= 1.6.5 =
* Add configurable port number for SMTP method, Specify full path for sendgrid php library, Fix special characters and new lines issues
= 1.6.4 =
* Add support for toName in API method, Add required Text Domain
= 1.6.3 =
* Update Smtp class name to avoid conflicts
= 1.6.2 =
* Add Api Keys for authentication, use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v3.2.0
= 1.6.1 =
* Add unique arguments
= 1.6 =
* Fix setTo method in SMTP option, update documentation, add link to SendGrid portal
= 1.5.4 =
* Updated the plugin to use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v3.0.0
= 1.5.3 =
* Fix attachments issue
= 1.5.2 =
* Fix urlencoded username issue
= 1.5.1 =
* Fix wp_remote issue
= 1.5.0 =
* Updated the plugin to use the last version of Sendgrid library: https://github.com/sendgrid/sendgrid-php/releases/tag/v2.2.0
= 1.4.6 =
* Added constants for SendGrid settings
= 1.4.5 =
* Fix changelog order in readme file
= 1.4.4 =
* Fix unicode filename for icon-128x128.png image
= 1.4.3 =
* Update plugin logo, description, screenshots on installation page
= 1.4.2 =
* Added SendGrid Statistics for the categories added in the SendGrid Settings Page
= 1.4.1 =
* Added support to set additional categories
= 1.4 =
* Fix warnings for static method, add notice for php version < 5.3.0, refactor plugin code
= 1.3 =
* Added support for WordPress 3.8, fixed visual issues for WordPress 3.7
= 1.2 =
* Now you can switch between Sendgrid general statistics and Sendgrid WordPress statistics.
= 1.1 =
* SendGrid Statistics can be used by selecting the time interval for which you want to see your statistics.