wp-mail-smtp
Last commit date
assets
8 years ago
languages
8 years ago
src
8 years ago
vendor
8 years ago
class-wpms-am-notification.php
8 years ago
readme.txt
8 years ago
wp-mail-smtp.php
8 years ago
wp_mail_smtp.php
8 years ago
readme.txt
345 lines
| 1 | === WP Mail SMTP by WPForms === |
| 2 | Contributors: wpforms, jaredatch, smub, slaFFik |
| 3 | Tags: smtp, wp mail smtp, wordpress smtp, gmail smtp, sendgrid smtp, mailgun smtp, mail, mailer, phpmailer, wp_mail, email, mailgun, sengrid, gmail, wp smtp |
| 4 | Requires at least: 3.6 |
| 5 | Tested up to: 4.9 |
| 6 | Stable tag: trunk |
| 7 | Requires PHP: 5.3 |
| 8 | |
| 9 | The most popular WordPress SMTP and PHP Mailer plugin. Trusted by over 700k sites. |
| 10 | |
| 11 | == Description == |
| 12 | |
| 13 | = WordPress Mail SMTP Plugin = |
| 14 | |
| 15 | Having problems with your WordPress site not sending emails? You're not alone. Over 700,000 websites use WP Mail SMTP to fix their email deliverability issues. |
| 16 | |
| 17 | WP Mail SMTP fixes your email deliverability by reconfiguring the wp_mail() PHP function to use a proper SMTP provider. |
| 18 | |
| 19 | = What is SMTP? = |
| 20 | |
| 21 | SMTP (Simple Mail Transfer Protocol) is an industry standard for sending emails. SMTP helps increase email deliverability by using proper authentication. |
| 22 | |
| 23 | Popular email clients like Gmail, Yahoo, Outlook, etc are constantly improving their services to reduce email spam. One of the things their spam tools look for is whether an email is originating from the location it claims to be originating from. |
| 24 | |
| 25 | If the proper authentication isn't there, then the emails either go in your SPAM folder or worst not get delivered at all. |
| 26 | |
| 27 | This is a problem for a lot of WordPress sites because by default, WordPress uses the PHP mail function to send emails generated by WordPress or any contact form plugin like <a href="https://wpforms.com/" rel="friend">WPForms</a>. |
| 28 | |
| 29 | The issue is that most <a href"http://www.wpbeginner.com/wordpress-hosting/" rel="friend">WordPress hosting companies</a> don't have their servers properly configured for sending PHP emails. |
| 30 | |
| 31 | The combination of two causes your WordPress emails to not get delivered. |
| 32 | |
| 33 | = How does WP Mail SMTP work? = |
| 34 | |
| 35 | WP Mail SMTP plugin allows you to easily reconfigure the wp_mail() function to use a trusted SMTP provider. |
| 36 | |
| 37 | This helps you fix all WordPress not sending email issues. |
| 38 | |
| 39 | WP Mail SMTP plugin includes four different SMTP setup options: |
| 40 | |
| 41 | 1. Mailgun SMTP |
| 42 | 2. SendGrid SMTP |
| 43 | 3. Gmail SMTP |
| 44 | 4. All Other SMTP |
| 45 | |
| 46 | For all options, you can specify the "from name" and "email address" for outgoing emails. |
| 47 | |
| 48 | Instead of having users use different SMTP plugins and workflows for different SMTP providers, we decided to bring it all in one. This is what makes WP Mail SMTP, the best SMTP solution for WordPress. |
| 49 | |
| 50 | = Mailgun SMTP = |
| 51 | |
| 52 | Mailgun SMTP is a popular SMTP service provider that allows you to send large quantities of emails. They allow you to send your first 10,000 emails for free every month. |
| 53 | |
| 54 | WP Mail SMTP plugin offers a native integration with MailGun. All you have to do is connect your Mailgun account, and you will improve your email deliverability. |
| 55 | |
| 56 | Read our <a href="https://wpforms.com/how-to-send-wordpress-emails-with-mailgun/" rel="friend">Mailgun documentation</a> for more details. |
| 57 | |
| 58 | = Gmail SMTP = |
| 59 | |
| 60 | Often bloggers and small business owners don't want to use third-party SMTP services. Well you can use your Gmail or G Suite account for SMTP emails. |
| 61 | |
| 62 | This allows you to use your <a href="http://www.wpbeginner.com/beginners-guide/how-to-setup-a-professional-email-address-with-gmail-and-google-apps/" rel="friend">professional email address</a> and improve email deliverability. |
| 63 | |
| 64 | Unlike other Gmail SMTP plugins, our Gmail SMTP option uses OAuth to authenticate your Google account, keeping your login information 100% secure. |
| 65 | |
| 66 | Read our <a href="https://wpforms.com/how-to-securely-send-wordpress-emails-using-gmail-smtp/" rel="friend">Gmail documentation</a> for more details. |
| 67 | |
| 68 | = SendGrid SMTP = |
| 69 | |
| 70 | SendGrid has a free SMTP plan that you can use to send up to 100 emails per day. With our native SendGrid SMTP integration, you can easily and securely set up SendGrid SMTP on your WordPress site. |
| 71 | |
| 72 | Read our <a href="https://wpforms.com/fix-wordpress-email-notifications-with-sendgrid/" rel="friend">SendGrid documentation</a> for more details. |
| 73 | |
| 74 | = Other SMTP = |
| 75 | |
| 76 | WP Mail SMTP plugin also works with all major email services such as Gmail, Yahoo, Outlook, Microsoft Live, and any other email sending service that offers SMTP. |
| 77 | |
| 78 | You can set the following options: |
| 79 | |
| 80 | * Specify an SMTP host. |
| 81 | * Specify an SMTP port. |
| 82 | * Choose SSL / TLS encryption. |
| 83 | * Choose to use SMTP authentication or not. |
| 84 | * Specify an SMTP username and password. |
| 85 | |
| 86 | WP Mail SMTP also gives you the option to insert your password in your wp-config.php file, so it's not visible in your WordPress settings. |
| 87 | |
| 88 | To see recommended settings for the popular services as well as troubleshooting tips, check out our <a href="https://wpforms.com/docs/how-to-set-up-smtp-using-the-wp-mail-smtp-plugin/" rel="friend">SMTP documentation</a>. |
| 89 | |
| 90 | We hope that you find WP Mail SMTP plugin helpful. |
| 91 | |
| 92 | = Credits = |
| 93 | |
| 94 | WP Mail SMTP plugin was originally created by Callum Macdonald. It is now owned and maintained by the team behind <a href="https://wpforms.com/" rel="friend">WPForms</a> - the best drag & drop form builder for WordPress. |
| 95 | |
| 96 | You can try the <a href="https://wordpress.org/plugins/wpforms-lite/" rel="friend">free version of WPForms plugin</a> to see why it's the best in the market. |
| 97 | |
| 98 | = What's Next = |
| 99 | |
| 100 | If you like this plugin, then please consider checking out our other popular plugins: |
| 101 | |
| 102 | * <a href="http://optinmonster.com/" rel="friend" title="OptinMonster">OptinMonster</a> - Get More Email Subscribers |
| 103 | * <a href="https://www.monsterinsights.com/" rel="friend" title="MonsterInsights">MonsterInsights</a> - Best Google Analytics Plugin for WordPress |
| 104 | |
| 105 | Visit <a href="http://www.wpbeginner.com/" rel="friend" title="WPBeginner">WPBeginner</a> to learn from our <a href="http://www.wpbeginner.com/category/wp-tutorials/" rel="friend" title="WordPress Tutorials">WordPress Tutorials</a> and find out about other <a href="http://www.wpbeginner.com/category/plugins/" rel="friend" title="Best WordPress Plugins">best WordPress plugins</a>. |
| 106 | |
| 107 | == Installation == |
| 108 | |
| 109 | 1. Install WP Mail SMTP by WPForms either via the WordPress.org plugin repository or by uploading the files to your server. (See instructions on <a href="http://www.wpbeginner.com/beginners-guide/step-by-step-guide-to-install-a-wordpress-plugin-for-beginners/" rel="friend">how to install a WordPress plugin</a>) |
| 110 | 2. Activate WP Mail SMTP by WPForms. |
| 111 | 3. Navigate to the Settings area of WP Mail SMTP in the WordPress admin. |
| 112 | 4. Choose your SMTP option (Mailgun SMTP, SendGrid SMTP, Gmail SMTP, or Other SMTP) and follow the instructions to set it up. |
| 113 | 5. Want to support us? Consider trying <a href="https://wpforms.com/?utm_source=wprepo&utm_medium=link&utm_campaign=liteversion" rel="friend" title="WPForms">WPForms Pro</a> - the best WordPress contact form plugin! |
| 114 | |
| 115 | == Frequently Asked Questions == |
| 116 | |
| 117 | = Can I use this plugin to send email via Gmail, G Suite, Outlook.com, Office 365, Hotmail, Yahoo, or AOL SMTP? = |
| 118 | |
| 119 | Yes! We have extensive documentation that covers setting up SMTP most popular email services. |
| 120 | |
| 121 | <a href="https://wpforms.com/docs/how-to-set-up-smtp-using-the-wp-mail-smtp-plugin/" rel="friend">Read our docs</a> to see the correct SMTP settings for each service. |
| 122 | |
| 123 | = Help! I need support or have an issue. = |
| 124 | |
| 125 | Please read <a href="https://wordpress.org/support/topic/wp-mail-smtp-support-policy/">our support policy</a> for more information. |
| 126 | |
| 127 | = I found a bug, now what? = |
| 128 | |
| 129 | If you've stumbled upon a bug, the best place to report it is in the <a href="https://github.com/awesomemotive/wp-mail-smtp">WP Mail SMTP GitHub repository</a>. GitHub is where the plugin is actively developed, and posting there will get your issue quickly seen by our developers (myself and Slava). Once posted, we'll review your bug report and triage the bug. When creating an issue, the more details you can add to your report, the faster the bug can be solved. |
| 130 | |
| 131 | = Can you add feature x, y or z to the plugin? = |
| 132 | |
| 133 | Short answer: maybe. |
| 134 | |
| 135 | By all means please contact us to discuss features or options you'd like to see added to the plugin. We can't guarantee to add all of them, but we will consider all sensible requests. We can be contacted here: |
| 136 | <a href="https://wpforms.com/contact/" rel="friend">https://wpforms.com/contact/</a> |
| 137 | |
| 138 | == Screenshots == |
| 139 | |
| 140 | 1. WP Mail SMTP Settings page |
| 141 | 2. Gmail / G Suite settings |
| 142 | 3. Mailgun settings |
| 143 | 4. SendGrid settings |
| 144 | 5. SMTP settings |
| 145 | 6. Send a Test Email |
| 146 | |
| 147 | == Changelog == |
| 148 | |
| 149 | = 1.2.2 - 2017-12-27 = |
| 150 | * Fixed: Correctly handle Mailgun debug message for an incorrect api key. |
| 151 | * Fixed: Fatal error for Gmail and SMTP mailers with Nginx web-server (without Apache at all). |
| 152 | * Changed: Update X-Mailer emails header to show the real sender with a mailer and plugin version. |
| 153 | |
| 154 | = 1.2.1 - 2017-12-21 = |
| 155 | * Fixed: Failed SMTP connections generate fatal errors. |
| 156 | |
| 157 | = 1.2.0 - 2017-12-21 = |
| 158 | * Fixed: Decrease the factual minimum WordPress version from 3.9 to 3.6. |
| 159 | * Changed: Improve debug output for all mail providers. |
| 160 | |
| 161 | = 1.1.0 - 2017-12-18 = |
| 162 | * Added: New option "Auto TLS" for SMTP mailer. Default is enabled. Migration routine for all sites. |
| 163 | * Changed: Improve debug output - clear styles and context-aware content. |
| 164 | * Changed: Better exceptions handling for Google authentication process. |
| 165 | * Changed: Do not sanitize passwords, api keys etc - as they may contain special characters in certain order and sanitization will break those values. |
| 166 | * Changed: Improve wording of some helpful texts inside plugin admin area. |
| 167 | * Fixed: Do not include certain files in dependency libraries that are not used by Google mailer. This should stop flagging plugin by Wordfence and VaultPress. |
| 168 | * Fixed: Constants usage is working now, to define the SMTP password, for example. |
| 169 | * Fixed: Notice for default mailer. |
| 170 | |
| 171 | = 1.0.2 - 2017-12-12 = |
| 172 | * Fixed: PHPMailer using incorrect SMTPSecure value. |
| 173 | |
| 174 | = 1.0.1 - 2017-12-12 = |
| 175 | * Fixed: Global POST processing conflict. |
| 176 | |
| 177 | = 1.0.0 - 2017-12-12 = |
| 178 | * Added: Automatic migration tool to move options from older storage format to a new one. |
| 179 | * Added: Added Gmail & G Suite email provider integration - without your email and password. |
| 180 | * Added: Added SendGrid email provider integration - using the API key only. |
| 181 | * Added: Added Mailgun email provider integration - using the API key and configured domain only. |
| 182 | * Added: New compatibility mode - for PHP 5.2 old plugin will be loaded, for PHP 5.3 and higher - new version of admin area and new functionality. |
| 183 | * Changed: The new look of the admin area. |
| 184 | * Changed: SMTP password field now has "password" type. |
| 185 | * Changed: SMTP password field does not display real password at all when using constants in `wp-config.php` to define it. |
| 186 | * Changed: Escape properly all translations. |
| 187 | * Changed: More helpful test email content (with a mailer name). |
| 188 | |
| 189 | = 0.11.2 - 2017-11-28 = |
| 190 | * Added: Setting to hide announcement feed. |
| 191 | * Changed: Announcement feed data. |
| 192 | |
| 193 | = 0.11.1 - 2017-10-30 = |
| 194 | * Fixed: Older PHP compatibility fix. |
| 195 | |
| 196 | = 0.11 - 2017-10-30 = |
| 197 | * Added: Helper description to Return Path option. |
| 198 | * Added: Filter `wp_mail_smtp_admin_test_email_smtp_debug` to increase the debug message verbosity. |
| 199 | * Added: PHP 5.2 notice. |
| 200 | * Added: Announcement feed. |
| 201 | * Changed: Localization fixes, proper locale name. |
| 202 | * Changed: Code style improvements and optimizations for both HTML and PHP. |
| 203 | * Changed: Inputs for emails now have a proper type `email`, instead of a generic `text`. |
| 204 | * Changed: Turn off `$phpmailer->SMTPAutoTLS` when `No encryption` option is set to prevent error while sending emails. |
| 205 | * Changed: Hide Pepipost for those who are not using it. |
| 206 | * Changed: WP CLI support improved. |
| 207 | |
| 208 | = 0.10.1 = |
| 209 | * Addition of Pepipost and cleanup of admin page. |
| 210 | |
| 211 | = 0.10.0 = |
| 212 | * Addition of Pepipost and cleanup of admin page. |
| 213 | |
| 214 | = 0.9.6 = |
| 215 | * Minor security fix, sanitize test email address. |
| 216 | |
| 217 | = 0.9.5 = |
| 218 | * Minor security fix, hat tip JD Grimes. |
| 219 | |
| 220 | = 0.9.4 = |
| 221 | * Improvement to the test email function, very low priority update. |
| 222 | |
| 223 | = 0.9.3 = |
| 224 | * Fixing reported issue with passing by reference. props Adam Conway |
| 225 | |
| 226 | = 0.9.2 = |
| 227 | * Removing the deprecation notice. |
| 228 | |
| 229 | = 0.9.1 = |
| 230 | * $phpmailer->language became protected in WP 3.2, no longer unset on debug output. |
| 231 | |
| 232 | = 0.9.0 = |
| 233 | * Typo in the From email description. |
| 234 | * Removed changelog from plugin file, no need to duplicate it. |
| 235 | * Optionally set $phpmailer->Sender from from email, helps with sendmail / mail(). |
| 236 | |
| 237 | = 0.8.7 = |
| 238 | * Fix for a long standing bug that caused an error during plugin activation. |
| 239 | |
| 240 | = 0.8.6 = |
| 241 | * The Settings link really does work this time, promise. Apologies for the unnecessary updates. |
| 242 | |
| 243 | = 0.8.5 = |
| 244 | * Bugfix, the settings link on the Plugin page was broken by 0.8.4. |
| 245 | |
| 246 | = 0.8.4 = |
| 247 | * Minor bugfix, remove use of esc_html() to improve backwards compatibility. |
| 248 | * Removed second options page menu props ovidiu. |
| 249 | |
| 250 | = 0.8.3 = |
| 251 | * Bugfix, return WPMS_MAIL_FROM_NAME, props nacin. |
| 252 | * Add Settings link, props Mike Challis http://profiles.wordpress.org/MikeChallis/ |
| 253 | |
| 254 | = 0.8.2 = |
| 255 | * Bugfix, call phpmailer_init_smtp() correctly, props Sinklar. |
| 256 | |
| 257 | = 0.8.1 = |
| 258 | * Internationalisation improvements. |
| 259 | |
| 260 | = 0.8 = |
| 261 | * Added port, SSL/TLS, option whitelisting, validate_email(), and constant options. |
| 262 | |
| 263 | = 0.7 = |
| 264 | * Added checks to only override the default from name / email |
| 265 | |
| 266 | = 0.6 = |
| 267 | * Added additional SMTP debugging output |
| 268 | |
| 269 | = 0.5.2 = |
| 270 | * Fixed a pre 2.3 bug to do with mail from |
| 271 | |
| 272 | = 0.5.1 = |
| 273 | * Added a check to display a warning on versions prior to 2.3 |
| 274 | |
| 275 | = 0.5.0 = |
| 276 | * Upgraded to match 2.3 filters which add a second filter for from name |
| 277 | |
| 278 | = 0.4.2 = |
| 279 | * Fixed a bug in 0.4.1 and added more debugging output |
| 280 | |
| 281 | = 0.4.1 = |
| 282 | * Added $phpmailer->ErroInfo to the test mail output |
| 283 | |
| 284 | = 0.4 = |
| 285 | * Added the test email feature and cleaned up some other bits and pieces |
| 286 | |
| 287 | = 0.3.2 = |
| 288 | * Changed to use register_activation_hook for greater compatability |
| 289 | |
| 290 | = 0.3.1 = |
| 291 | * Added readme for WP-Plugins.org compatability |
| 292 | |
| 293 | = 0.3 = |
| 294 | * Various bugfixes and added From options |
| 295 | |
| 296 | = 0.2 = |
| 297 | * Reworked approach as suggested by westi, added options page |
| 298 | |
| 299 | = 0.1 = |
| 300 | * Initial approach, copying the wp_mail function and replacing it |
| 301 | |
| 302 | == Upgrade Notice == |
| 303 | |
| 304 | = 0.10.1 = |
| 305 | Addition of Pepipost and cleanup of admin page. |
| 306 | |
| 307 | = 0.10.0 = |
| 308 | Addition of Pepipost and cleanup of admin page. |
| 309 | |
| 310 | = 0.9.6 = |
| 311 | Minor security fix, sanitize test email address. |
| 312 | |
| 313 | = 0.9.5 = |
| 314 | Minor security fix, hat tip JD Grimes. |
| 315 | |
| 316 | = 0.9.4 = |
| 317 | Improvement to the test email function, very low priority update. |
| 318 | |
| 319 | = 0.9.3 = |
| 320 | Fixing reported issue with passing by reference. |
| 321 | |
| 322 | = 0.9.2 = |
| 323 | Removing the deprecation notice. |
| 324 | |
| 325 | = 0.9.1 = |
| 326 | Test mail functionality was broken on upgrade to 3.2, now restored. |
| 327 | |
| 328 | = 0.9.0 = |
| 329 | Low priority upgrade. Improves the appearance of the options page. |
| 330 | |
| 331 | = 0.8.7 = |
| 332 | Very low priority update. Fixes a bug that causes a spurious error during activation. |
| 333 | |
| 334 | = 0.8.6 = |
| 335 | Low priority update. The Settings link was still broken in 0.8.5. |
| 336 | |
| 337 | = 0.8.5 = |
| 338 | Minor bugfix correcting the Settings link bug introduced in 0.8.4. Very low priority update. |
| 339 | |
| 340 | = 0.8.4 = |
| 341 | Minor bugfix for users using constants. Another very low priority upgrade. Apologies for the version creep. |
| 342 | |
| 343 | = 0.8.3 = |
| 344 | Minor bugfix for users using constants. Very low priority upgrade. |
| 345 |