307 lines
8.6 KiB
PHP
307 lines
8.6 KiB
PHP
<?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 = 46000;
|
|
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 ();
|
|
$recommendation['logo_url'] = $this->getLogoURL();
|
|
|
|
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 ps-input ps-w-75" 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>';
|
|
}
|
|
|
|
/**
|
|
* Get Socket's logo
|
|
*
|
|
* @since 2.1
|
|
* @version 1.0
|
|
*/
|
|
public function getLogoURL() {
|
|
|
|
return POST_SMTP_ASSETS . "images/logos/mandrill.png";
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns true, to prevent from errors because it's default Module Transport.
|
|
*
|
|
* @since 2.1.8
|
|
* @version 1.0
|
|
*/
|
|
public function has_granted() {
|
|
|
|
return true;
|
|
|
|
}
|
|
}
|