options->getMailgunRegion() ) ? self::EU_REGION : self::HOST;
}
/**
* v0.2.1
*
* @return int
*/
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 %1$s %2$s.', 'post-smtp' ), '🔐', $this->getName() );
}
/**
*
* @param mixed $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', 'post-smtp' ) . '.' );
$this->setNotConfiguredAndReady();
}
if ( empty( $domainName ) ) {
array_push( $messages, __( 'Domain Name 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;
}
/**
* (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 == $this->getHostname() && $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(), $this->getHostname(), self::PORT );
}
return $recommendation;
}
/**
*
* @param mixed $hostname
* @param mixed $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 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 Mailgun Auth section
add_settings_section( PostmanMailgunTransport::MAILGUN_AUTH_SECTION, __( 'Authentication', 'post-smtp' ), array(
$this,
'printMailgunAuthSectionInfo',
), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS );
add_settings_field( PostmanOptions::MAILGUN_API_KEY, __( 'API Key', 'post-smtp' ), array(
$this,
'mailgun_api_key_callback',
), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION );
add_settings_field( PostmanOptions::MAILGUN_DOMAIN_NAME, __( 'Domain Name', 'post-smtp' ), array(
$this,
'mailgun_domain_name_callback',
), PostmanMailgunTransport::MAILGUN_AUTH_OPTIONS, PostmanMailgunTransport::MAILGUN_AUTH_SECTION );
add_settings_field( PostmanOptions::MAILGUN_REGION, __( 'Mailgun Europe Region?', 'post-smtp' ), array(
$this,
'mailgun_region_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( '%s
', sprintf( __( 'Create an account at %2$s and enter an API key below.', 'post-smtp' ), 'https://mailgun.com', 'mailgun.com', 'https://app.mailgun.com/app/domains/' ) );
}
/**
*/
public function mailgun_api_key_callback() {
printf( '', null !== $this->options->getMailgunApiKey() ? esc_attr( PostmanUtils::obfuscatePassword( $this->options->getMailgunApiKey() ) ) : '', __( 'Required', 'post-smtp' ) );
print '';
}
function mailgun_domain_name_callback() {
printf( '', null !== $this->options->getMailgunDomainName() ? esc_attr( $this->options->getMailgunDomainName() ) : '', __( 'Required', 'post-smtp' ) );
}
function mailgun_region_callback() {
$value = $this->options->getMailgunRegion();
printf( '', null !== $value ? ' checked' : '' );
}
/**
*/
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 '';
$this->printMailgunAuthSectionInfo();
printf( '', __( 'API Key', 'post-smtp' ) );
print '
';
print $this->mailgun_api_key_callback();
printf( '', __( 'Domain Name', 'post-smtp' ) );
print '
';
print $this->mailgun_domain_name_callback();
print '
';
printf( '', __( 'Mailgun Europe Region?', 'post-smtp' ) );
print '
';
print $this->mailgun_region_callback();
print '';
}
}