summaryrefslogtreecommitdiff
path: root/Postman/Postman-Mail/PostmanMandrillTransport.php
diff options
context:
space:
mode:
Diffstat (limited to 'Postman/Postman-Mail/PostmanMandrillTransport.php')
-rw-r--r--Postman/Postman-Mail/PostmanMandrillTransport.php280
1 files changed, 280 insertions, 0 deletions
diff --git a/Postman/Postman-Mail/PostmanMandrillTransport.php b/Postman/Postman-Mail/PostmanMandrillTransport.php
new file mode 100644
index 0000000..3279f2b
--- /dev/null
+++ b/Postman/Postman-Mail/PostmanMandrillTransport.php
@@ -0,0 +1,280 @@
+<?php
+if ( ! defined( 'ABSPATH' ) ) {
+ exit; // Exit if accessed directly
+}
+
+require_once 'PostmanModuleTransport.php';
+/**
+ * Postman Mandrill module
+ *
+ * @author jasonhendriks
+ *
+ */
+class PostmanMandrillTransport extends PostmanAbstractModuleTransport implements PostmanModuleTransport {
+ const SLUG = 'mandrill_api';
+ const PORT = 443;
+ const HOST = 'mandrillapp.com';
+ const PRIORITY = 9000;
+ const MANDRILL_AUTH_OPTIONS = 'postman_mandrill_auth_options';
+ const MANDRILL_AUTH_SECTION = 'postman_mandrill_auth_section';
+ public function __construct($rootPluginFilenameAndPath) {
+ parent::__construct ( $rootPluginFilenameAndPath );
+
+ // add a hook on the plugins_loaded event
+ add_action ( 'admin_init', array (
+ $this,
+ 'on_admin_init'
+ ) );
+ }
+
+ /**
+ *
+ * @param mixed $data
+ */
+ public function prepareOptionsForExport($data) {
+ $data = parent::prepareOptionsForExport ( $data );
+ $data [PostmanOptions::MANDRILL_API_KEY] = PostmanOptions::getInstance ()->getMandrillApiKey ();
+ return $data;
+ }
+ public function getProtocol() {
+ return 'https';
+ }
+
+ // this should be standard across all transports
+ public function getSlug() {
+ return self::SLUG;
+ }
+ public function getName() {
+ return __ ( 'Mandrill API', 'post-smtp' );
+ }
+ /**
+ * v0.2.1
+ *
+ * @return string
+ */
+ public function getHostname() {
+ return self::HOST;
+ }
+ /**
+ * v0.2.1
+ *
+ * @return int
+ */
+ public function getPort() {
+ return self::PORT;
+ }
+ /**
+ * v1.7.0
+ *
+ * @return string
+ */
+ public function getTransportType() {
+ return 'mandrill_api';
+ }
+ /**
+ * v0.2.1
+ *
+ * @return string
+ */
+ public function getAuthenticationType() {
+ return '';
+ }
+ /**
+ * v0.2.1
+ *
+ * @return string
+ */
+ public function getSecurityType() {
+ return self::PROTOCOL;
+ }
+ /**
+ * v0.2.1
+ *
+ * @return string
+ */
+ public function getCredentialsId() {
+ return $this->options->getClientId ();
+ }
+ /**
+ * v0.2.1
+ *
+ * @return string
+ */
+ public function getCredentialsSecret() {
+ return $this->options->getClientSecret ();
+ }
+ public function isServiceProviderGoogle($hostname) {
+ return false;
+ }
+ public function isServiceProviderMicrosoft($hostname) {
+ return false;
+ }
+ public function isServiceProviderYahoo($hostname) {
+ return false;
+ }
+ public function isOAuthUsed($authType) {
+ return false;
+ }
+
+ /**
+ * (non-PHPdoc)
+ *
+ * @see PostmanModuleTransport::createMailEngine()
+ */
+ public function createMailEngine() {
+ $apiKey = $this->options->getMandrillApiKey ();
+ require_once 'PostmanMandrillMailEngine.php';
+ $engine = new PostmanMandrillMailEngine ( $apiKey );
+ return $engine;
+ }
+
+ /**
+ * This short description of the Transport State shows on the Summary screens
+ * (non-PHPdoc)
+ *
+ * @see PostmanModuleTransport::getDeliveryDetails()
+ */
+ public function getDeliveryDetails() {
+ /* translators: where (1) is the secure icon and (2) is the transport name */
+ return sprintf ( __ ( 'Postman will send mail via the <b>%1$s %2$s</b>.', 'post-smtp' ), '🔐', $this->getName () );
+ }
+
+ /**
+ * (non-PHPdoc)
+ *
+ * @see PostmanAbstractModuleTransport::validateTransportConfiguration()
+ */
+ protected function validateTransportConfiguration() {
+ $messages = parent::validateTransportConfiguration ();
+ $apiKey = $this->options->getMandrillApiKey ();
+ if (empty ( $apiKey )) {
+ array_push ( $messages, __ ( 'API Key can not be empty', 'post-smtp' ) . '.' );
+ $this->setNotConfiguredAndReady ();
+ }
+ if (! $this->isSenderConfigured ()) {
+ array_push ( $messages, __ ( 'Message From Address can not be empty', 'post-smtp' ) . '.' );
+ $this->setNotConfiguredAndReady ();
+ }
+ return $messages;
+ }
+
+ /**
+ * Mandrill API doesn't care what the hostname or guessed SMTP Server is; it runs it's port test no matter what
+ */
+ public function getSocketsForSetupWizardToProbe($hostname, $smtpServerGuess) {
+ $hosts = array (
+ self::createSocketDefinition ( $this->getHostname (), $this->getPort () )
+ );
+ return $hosts;
+ }
+
+ /**
+ * (non-PHPdoc)
+ *
+ * @see PostmanModuleTransport::getConfigurationBid()
+ */
+ public function getConfigurationBid(PostmanWizardSocket $hostData, $userAuthOverride, $originalSmtpServer) {
+ $recommendation = array ();
+ $recommendation ['priority'] = 0;
+ $recommendation ['transport'] = self::SLUG;
+ $recommendation ['hostname'] = null; // scribe looks this
+ $recommendation ['label'] = $this->getName ();
+ if ($hostData->hostname == self::HOST && $hostData->port == self::PORT) {
+ $recommendation ['priority'] = self::PRIORITY;
+ /* translators: where variables are (1) transport name (2) host and (3) port */
+ $recommendation ['message'] = sprintf ( __ ( ('Postman recommends the %1$s to host %2$s on port %3$d.') ), $this->getName (), self::HOST, self::PORT );
+ }
+ return $recommendation;
+ }
+
+ /**
+ */
+ public function createOverrideMenu(PostmanWizardSocket $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride) {
+ $overrideItem = parent::createOverrideMenu ( $socket, $winningRecommendation, $userSocketOverride, $userAuthOverride );
+ // push the authentication options into the $overrideItem structure
+ $overrideItem ['auth_items'] = array (
+ array (
+ 'selected' => true,
+ 'name' => __ ( 'API Key', 'post-smtp' ),
+ 'value' => 'api_key'
+ )
+ );
+ return $overrideItem;
+ }
+
+ /**
+ * Functions to execute on the admin_init event
+ *
+ * "Runs at the beginning of every admin page before the page is rendered."
+ * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_an_Admin_Page_Request
+ */
+ public function on_admin_init() {
+ // only administrators should be able to trigger this
+ if (PostmanUtils::isAdmin ()) {
+ $this->addSettings ();
+ $this->registerStylesAndScripts ();
+ }
+ }
+
+ /*
+ * What follows in the code responsible for creating the Admin Settings page
+ */
+
+ /**
+ */
+ public function addSettings() {
+ // the Mandrill Auth section
+ add_settings_section ( PostmanMandrillTransport::MANDRILL_AUTH_SECTION, __ ( 'Authentication', 'post-smtp' ), array (
+ $this,
+ 'printMandrillAuthSectionInfo'
+ ), PostmanMandrillTransport::MANDRILL_AUTH_OPTIONS );
+
+ add_settings_field ( PostmanOptions::MANDRILL_API_KEY, __ ( 'API Key', 'post-smtp' ), array (
+ $this,
+ 'mandrill_api_key_callback'
+ ), PostmanMandrillTransport::MANDRILL_AUTH_OPTIONS, PostmanMandrillTransport::MANDRILL_AUTH_SECTION );
+ }
+
+ /**
+ */
+ public function printMandrillAuthSectionInfo() {
+ /* Translators: Where (1) is the service URL and (2) is the service name and (3) is a api key URL */
+ printf ( '<p id="wizard_mandrill_auth_help">%s</p>', sprintf ( __ ( 'Create an account at <a href="%1$s" target="_blank">%2$s</a> and enter <a href="%3$s" target="_blank">an API key</a> below.', 'post-smtp' ), 'https://mandrillapp.com', 'Mandrillapp.com', 'https://mandrillapp.com/settings' ) );
+ }
+
+ /**
+ */
+ public function mandrill_api_key_callback() {
+ printf ( '<input type="password" autocomplete="off" id="mandrill_api_key" name="postman_options[mandrill_api_key]" value="%s" size="60" class="required" placeholder="%s"/>', null !== $this->options->getMandrillApiKey () ? esc_attr ( PostmanUtils::obfuscatePassword ( $this->options->getMandrillApiKey () ) ) : '', __ ( 'Required', 'post-smtp' ) );
+ print ' <input type="button" id="toggleMandrillApiKey" value="Show Password" class="button button-secondary" style="visibility:hidden" />';
+ }
+
+ /**
+ */
+ public function registerStylesAndScripts() {
+ // register the stylesheet and javascript external resources
+ $pluginData = apply_filters ( 'postman_get_plugin_metadata', null );
+ wp_register_script ( 'postman_mandrill_script', plugins_url ( 'Postman/Postman-Mail/postman_mandrill.js', $this->rootPluginFilenameAndPath ), array (
+ PostmanViewController::JQUERY_SCRIPT,
+ 'jquery_validation',
+ PostmanViewController::POSTMAN_SCRIPT
+ ), $pluginData ['version'] );
+ }
+
+ /**
+ */
+ public function enqueueScript() {
+ wp_enqueue_script ( 'postman_mandrill_script' );
+ }
+
+ /**
+ */
+ public function printWizardAuthenticationStep() {
+ print '<section class="wizard_mandrill">';
+ $this->printMandrillAuthSectionInfo ();
+ printf ( '<label for="api_key">%s</label>', __ ( 'API Key', 'post-smtp' ) );
+ print '<br />';
+ print $this->mandrill_api_key_callback ();
+ print '</section>';
+ }
+}