1 files changed, 248 insertions, 0 deletions
diff --git a/Postman/Postman-Mail/PostmanMailgunTransport.php b/Postman/Postman-Mail/PostmanMailgunTransport.php
new file mode 100644
index 0000000..c3565ea
--- /dev/null
+++ b/Postman/Postman-Mail/PostmanMailgunTransport.php
@@ -0,0 +1,248 @@
+<?php
+require_once 'PostmanModuleTransport.php';
+/**
+ * Postman Mailgun module
+ *
+ * @author jasonhendriks
+ */
+class PostmanMailgunTransport extends PostmanAbstractModuleTransport implements PostmanModuleTransport {
+	const SLUG = 'mailgun_api';
+	const PORT = 443;
+	const HOST = 'api.mailgun.net';
+	const PRIORITY = 8000;
+	const MAILGUN_AUTH_OPTIONS = 'postman_mailgun_auth_options';
+	const MAILGUN_AUTH_SECTION = 'postman_mailgun_auth_section';
+
+	/**
+	 *
+	 * @param unknown $rootPluginFilenameAndPath
+	 */
+	public function __construct( $rootPluginFilenameAndPath ) {
+		parent::__construct( $rootPluginFilenameAndPath );
+
+		// add a hook on the plugins_loaded event
+		add_action( 'admin_init', array(
+				$this,
+				'on_admin_init',
+		) );
+	}
+	public function getProtocol() {
+		return 'https';
+	}
+
+	// this should be standard across all transports
+	public function getSlug() {
+		return self::SLUG;
+	}
+	public function getName() {
+		return __( 'Mailgun API', Postman::TEXT_DOMAIN );
+	}
+	/**
+	 * v0.2.1
+	 *
+	 * @return string
+	 */
+	public function getHostname() {
+		return self::HOST;
+	}
+	/**
+	 * v0.2.1
+	 *
+	 * @return string
+	 */
+	public function getPort() {
+		return self::PORT;
+	}
+	/**
+	 * v1.7.0
+	 *
+	 * @return string
+	 */
+	public function getTransportType() {
+		return 'Mailgun_api';
+	}
+
+	/**
+	 * (non-PHPdoc)
+	 *
+	 * @see PostmanModuleTransport::createMailEngine()
+	 */
+	public function createMailEngine() {
+		$apiKey = $this->options->getMailgunApiKey();
+		$domainName = $this->options->getMailgunDomainName();
+
+		require_once 'PostmanMailgunMailEngine.php';
+		$engine = new PostmanMailgunMailEngine( $apiKey, $domainName );
+		return $engine;
+	}
+	public function getDeliveryDetails() {
+		/* translators: where (1) is the secure icon and (2) is the transport name */
+		return sprintf( __( 'Post SMTP will send mail via the <b>%1$s %2$s</b>.', Postman::TEXT_DOMAIN ), '🔐', $this->getName() );
+	}
+
+	/**
+	 *
+	 * @param unknown $data
+	 */
+	public function prepareOptionsForExport( $data ) {
+		$data = parent::prepareOptionsForExport( $data );
+		$data [ PostmanOptions::MAILGUN_API_KEY ] = PostmanOptions::getInstance()->getMailgunApiKey();
+		return $data;
+	}
+
+	/**
+	 * (non-PHPdoc)
+	 *
+	 * @see PostmanTransport::getMisconfigurationMessage()
+	 */
+	protected function validateTransportConfiguration() {
+		$messages = parent::validateTransportConfiguration();
+		$apiKey = $this->options->getMailgunApiKey();
+		$domainName = $this->options->getMailgunDomainName();
+
+		if ( empty( $apiKey ) ) {
+			array_push( $messages, __( 'API Key can not be empty', Postman::TEXT_DOMAIN ) . '.' );
+			$this->setNotConfiguredAndReady();
+		}
+
+		if ( empty( $domainName ) ) {
+			array_push( $messages, __( 'Domain Name can not be empty', Postman::TEXT_DOMAIN ) . '.' );
+			$this->setNotConfiguredAndReady();
+		}
+
+		if ( ! $this->isSenderConfigured() ) {
+			array_push( $messages, __( 'Message From Address can not be empty', Postman::TEXT_DOMAIN ) . '.' );
+			$this->setNotConfiguredAndReady();
+		}
+		return $messages;
+	}
+
+	/**
+	 * (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;
+	}
+
+	/**
+	 *
+	 * @param unknown $hostname
+	 * @param unknown $response
+	 */
+	public function populateConfiguration( $hostname ) {
+		$response = parent::populateConfiguration( $hostname );
+		return $response;
+	}
+
+	/**
+	 */
+	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 Kkey', Postman::TEXT_DOMAIN ),
+						'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 Mailgun Auth section
+		add_settings_section( PostmanMailgunTransport::MAILGUN_AUTH_SECTION, __( 'Authentication', Postman::TEXT_DOMAIN ), array(
+				$this,
+				'printMailgunAuthSectionInfo',
+		), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS );
+
+		add_settings_field( PostmanOptions::MAILGUN_API_KEY, __( 'API Key', Postman::TEXT_DOMAIN ), array(
+				$this,
+				'mailgun_api_key_callback',
+		), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION );
+
+		add_settings_field( PostmanOptions::MAILGUN_DOMAIN_NAME, __( 'Domain Name', Postman::TEXT_DOMAIN ), array(
+			$this,
+			'mailgun_domain_name_callback',
+		), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION );
+	}
+	public function printMailgunAuthSectionInfo() {
+		/* Translators: Where (1) is the service URL and (2) is the service name and (3) is a api key URL */
+		printf( '<p id="wizard_mailgun_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.', Postman::TEXT_DOMAIN ), 'https://mailgun.com', 'mailgun.com', 'https://app.mailgun.com/app/domains/' ) );
+	}
+
+	/**
+	 */
+	public function mailgun_api_key_callback() {
+		printf( '<input type="password" autocomplete="off" id="mailgun_api_key" name="postman_options[mailgun_api_key]" value="%s" size="60" class="required" placeholder="%s"/>', null !== $this->options->getMailgunApiKey() ? esc_attr( PostmanUtils::obfuscatePassword( $this->options->getMailgunApiKey() ) ) : '', __( 'Required', Postman::TEXT_DOMAIN ) );
+		print '<input type="button" id="toggleMailgunApiKey" value="Show Password" class="button button-secondary" style="visibility:hidden" />';
+	}
+
+	function mailgun_domain_name_callback() {
+		printf( '<input type="text" autocomplete="off" id="mailgun_domain_name" name="postman_options[mailgun_domain_name]" value="%s" size="60" class="required" placeholder="%s"/>', null !== $this->options->getMailgunDomainName() ? esc_attr( $this->options->getMailgunDomainName() ) : '', __( 'Required', Postman::TEXT_DOMAIN ) );
+	}
+
+	/**
+	 */
+	public function registerStylesAndScripts() {
+		// register the stylesheet and javascript external resources
+		$pluginData = apply_filters( 'postman_get_plugin_metadata', null );
+		wp_register_script( 'postman_mailgun_script', plugins_url( 'Postman/Postman-Mail/postman_mailgun.js', $this->rootPluginFilenameAndPath ), array(
+				PostmanViewController::JQUERY_SCRIPT,
+				'jquery_validation',
+				PostmanViewController::POSTMAN_SCRIPT,
+		), $pluginData ['version'] );
+	}
+
+	/**
+	 */
+	public function enqueueScript() {
+		wp_enqueue_script( 'postman_mailgun_script' );
+	}
+
+	/**
+	 */
+	public function printWizardAuthenticationStep() {
+		print '<section class="wizard_mailgun">';
+		$this->printMailgunAuthSectionInfo();
+		printf( '<label for="api_key">%s</label>', __( 'API Key', Postman::TEXT_DOMAIN ) );
+		print '<br />';
+		print $this->mailgun_api_key_callback();
+		printf( '<label for="domain_name">%s</label>', __( 'Domain Name', Postman::TEXT_DOMAIN ) );
+		print '<br />';
+		print $this->mailgun_domain_name_callback();
+		print '</section>';
+	}
+}