Description
* Please read before downloading *
This plugin is deprecated as of May 3rd, 2015. The functionality previously provided has been merged into the Postman SMTP plugin, v1.6. That single package is all you need to send your Gmail from web hosts that block your access to remote SMTP servers. If you previously installed this plugin, you may remove it. See this post for more information.
Can’t send Gmail because ports 465 and 587 are blocked on your host? No problem! The Postman Gmail API Extension works in combination with Postman SMTP to send your mail out on the HTTPS port, port 443. Even if you host your site on GoDaddy or Bluehost, your Gmail will be delivered!
The Postman Gmail API Extension includes the Google APIs Client Library for PHP. The Google API does not support password-based authentication and Postman will guide you in creating a (free) Google OAuth 2.0 Client ID.
Features
- Send Gmail from your WordPress site over HTTPS
- Available translations: English, French, Italian
If you are willing to help translate Postman into your language, please let me know!
Requirements
- Postman SMTP v1.5 (or later)
- A Gmail, Google or Google Apps account; a Google OAuth 2.0 Client ID
Installation
You must have Postman SMTP installed and activated to use this plugin.
Easy install and setup! (Recommended for all users)
- Install and activate the plugin through the ‘Plugins’ menu in WordPress.
- In the WordPress ‘Settings’ menu select ‘Postman SMTP’.
- Choose ‘Start the Wizard’ and follow the instructions.
To manually configure the Gmail API Transport
- Choose configure manually
- In ‘Transport’ choose ‘Gmail API’
- In ‘Sender Name’ enter a name.
- In ‘Sender Email Address’ enter your Gmail email address. This MUST be the same address you login to Google with.
- Go to Google Developer’s Console and create a Client ID for your WordPress site.. instructions for this are detailed in the FAQ
- Copy your generated ‘Client ID’ and ‘Client Secret’ into the plugin’s Settings.
- Choose the Save Changes button.
- Choose the ‘Request Permission from Google’ link and follow the instructions.
- Send yourself a test email.
Postman is developed on OS X with PHP 5.5.14 and Apache 2.4.9. Postman is tested in a Red Hat OpenShift environment with PHP 5.3.3 and Apache 2.2.15 with Gmail, Hotmail and Yahoo Mail (US). Postman is tested with mailtrap.io.
FAQ
- What is Postman?
-
The first and only WordPress plugin to allow sending mail with OAuth 2.0; Google, Hotmail and Yahoo Mail’s preferred authentication mechanism. Email delivery problems are now a thing of the past.
- What URI do I enter to whitelist the plugin?
-
If your WordPress site is configured with WP_HTTP_BLOCK_EXTERNAL to prevent outbound connections, you may exempt the Gmail APIs with this definition:
define(‘WP_ACCESSIBLE_HOSTS’, ‘www.googleapis.com’);
- What is a Client ID?
-
To use OAuth, your website needs it’s own Client ID. The Client ID is used to control authentication and authorization and is tied to the specific URL of your website. If you manage several website, you will need a different Client ID for each one.
- How do I get a Google Client ID?
-
- Go to Google Developer’s Console and choose ‘Create Project’, or use an existing project if you have one.
- If you have previously created a project, select it from the Projects page and you will arrive at the Project Dashboard. If you have just created a project, you are brought to the Project Dashboard automatically.
- If you have not filled out the consent screen for this project, do it now. In the left-hand hand navigation menu, select ‘Consent Screen’ from under ‘APIs & auth’. Into ’email address’ put your Gmail address and in ‘product name’ put ‘Postman SMTP’. Choose ‘Save’.
- Select ‘API’s’ from under ‘APIs & auth’. Set ‘Gmail API’ to ‘ON’.
- Select ‘Credentials’ from under ‘APIs & auth’. Choose ‘Create a new Client ID’.
- For the ‘Application Type’ use ‘Web application’.
- In ‘Authorized Javascript origins’ enter the ‘Javascript Origins’ shown on Postman’s Settings page.
- In ‘Authorized Redirect URIs’ enter the ‘Redirect URI’ shown on Postman’s Settings page.
- Choose ‘Create Client ID’.
- Enter the Client ID and Client Secret displayed here into Postman’s settings page.
- How can I revoke Postman’s access to Gmail?
-
- From the Google Developer’s Console use the Delete button under the Client ID
Reviews
Tried many, only one that WORKED.
Since the default PHP mailer doesn’t work on my WP host I needed something that would work with SMTP. I tried many ‘simple and easy’ SMTP plugins, but Postman was the only one with the extensive documentation and examples that actually worked with Google SMTP. I can now send mail and recover passwords with my WP install thanks to Postman.
Contributors & Developers
“Postman Gmail API Extension” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Postman Gmail API Extension” into your language.
Interested in development?
Browse the code or subscribe to the development log by RSS.
Changelog
1.0.4 – 2015-06-14
- Uses a filter to check for the existence of Postman, much cleaner
1.0.3 – 2015-06-08
- In case of multisite, display the plugin administration notices on the network admin pages instead of the admin pages
1.0.2 – 2015-05-06
- Deprecated. See https://wordpress.org/support/topic/postman-gmail-api-extension-is-deprecated?replies=1
1.0.1 – 2015-04-05
- [Ticket] Hide PHP warnings from
stream_set_timeout()in case the host has disabled this function. - Fix for Fatal error: Cannot redeclare class PEAR_Common in C:\PHP5\PEAR\PEAR\Common.php – similar to this error in WP Minify
1.0.0 – 2015-03-15
- Stable release
- [Ticket] Renamed Google API classes to prevent errors with other plugins using the Google API
- [Ticket] Renamed Zend framework classes to prevent errors with other plugins using the Zend framework
0.2.2 – 2015-03-06
- [Ticket] Quick fix for collisions with other plugins that use the Google API
- [Ticket] Fixed an error on activation, and fatal error on switching languages, when using a non-supported language (not US English, not French)
- [Ticket] Stopped writing to error log if a language file can’t be found
0.2.1 – 2015-03-01
- A bug in the Plugin causes it to crash when deactivating if the parent Postman SMTP plugin is not installed and active. Fixed.
- This plugin removes its configuration when deactivated, which was a terrible design decision as this requires the user to re-enable the Gmail API on upgrades. Sorry. Fixed.
- Added a warning message if this plugin is installed without Postman, in case a user thinks this is a stand-alone solution.
- Fixed French-language specific issues
0.2 – 2015-02-23
- Published to WordPress.org
0.1 – 2015-02-20
- Postman is one month old! To celebrate we’ve integrated the Gmail API for all our users who are prevented from sending email on the standard mail ports by their WordPress hosts!
