diff options
Diffstat (limited to 'Postman/Postman-Send-Test-Email')
3 files changed, 530 insertions, 0 deletions
diff --git a/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php b/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php new file mode 100644 index 0000000..1a207c8 --- /dev/null +++ b/Postman/Postman-Send-Test-Email/PostmanSendTestEmailController.php @@ -0,0 +1,358 @@ +<?php +if ( ! defined( 'ABSPATH' ) ) { + exit; // Exit if accessed directly +} + +class PostmanSendTestEmailController { + const EMAIL_TEST_SLUG = 'postman/email_test'; + const RECIPIENT_EMAIL_FIELD_NAME = 'postman_recipient_email'; + + // logging + private $logger; + private $options; + + // Holds the values to be used in the fields callbacks + private $rootPluginFilenameAndPath; + + /** + * Constructor + * + * @param mixed $rootPluginFilenameAndPath + */ + public function __construct( $rootPluginFilenameAndPath ) { + assert( ! empty( $rootPluginFilenameAndPath ) ); + assert( PostmanUtils::isAdmin() ); + assert( is_admin() ); + + $this->logger = new PostmanLogger( get_class( $this ) ); + $this->rootPluginFilenameAndPath = $rootPluginFilenameAndPath; + $this->options = PostmanOptions::getInstance(); + + PostmanUtils::registerAdminMenu( $this, 'addEmailTestSubmenu' ); + + // hook on the init event + add_action( 'init', array( + $this, + 'on_init', + ) ); + + // initialize the scripts, stylesheets and form fields + add_action( 'admin_init', array( + $this, + 'on_admin_init', + ) ); + } + + /** + * Functions to execute on the init event + * + * "Typically used by plugins to initialize. The current user is already authenticated by this time." + * ref: http://codex.wordpress.org/Plugin_API/Action_Reference#Actions_Run_During_a_Typical_Request + */ + public function on_init() { + // register Ajax handlers + new PostmanSendTestEmailAjaxController(); + } + + /** + * Fires on the admin_init method + */ + public function on_admin_init() { + $this->registerStylesAndScripts(); + } + + /** + * Get the settings option array and print one of its values + */ + public function test_email_callback() { + printf( '<input type="text" id="%s" name="postman_test_options[test_email]" value="%s" class="required email" size="40"/>', self::RECIPIENT_EMAIL_FIELD_NAME, wp_get_current_user()->user_email ); + } + + /** + * Register and add settings + */ + private function registerStylesAndScripts() { + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'registerStylesAndScripts()' ); + } + + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + + // register the stylesheet resource + wp_register_style( 'postman_send_test_email', plugins_url( 'Postman/Postman-Send-Test-Email/postman_send_test_email.css', $this->rootPluginFilenameAndPath ), PostmanViewController::POSTMAN_STYLE, $pluginData ['version'] ); + + // register the javascript resource + wp_register_script( 'postman_test_email_wizard_script', plugins_url( 'Postman/Postman-Send-Test-Email/postman_send_test_email.js', $this->rootPluginFilenameAndPath ), array( + PostmanViewController::JQUERY_SCRIPT, + 'jquery_validation', + 'jquery_steps_script', + PostmanViewController::POSTMAN_SCRIPT, + ), $pluginData ['version'] ); + } + + /** + * Register the Email Test screen + */ + public function addEmailTestSubmenu() { + $page = add_submenu_page( null, sprintf( __( '%s Setup', 'post-smtp' ), __( 'Postman SMTP', 'post-smtp' ) ), __( 'Postman SMTP', 'post-smtp' ), Postman::MANAGE_POSTMAN_CAPABILITY_NAME, PostmanSendTestEmailController::EMAIL_TEST_SLUG, array( + $this, + 'outputTestEmailContent', + ) ); + // When the plugin options page is loaded, also load the stylesheet + add_action( 'admin_print_styles-' . $page, array( + $this, + 'enqueueEmailTestResources', + ) ); + } + + /** + */ + function enqueueEmailTestResources() { + wp_enqueue_style( 'jquery_steps_style' ); + wp_enqueue_style( PostmanViewController::POSTMAN_STYLE ); + wp_enqueue_style( 'postman_send_test_email' ); + wp_enqueue_script( 'postman_test_email_wizard_script' ); + wp_localize_script( PostmanViewController::POSTMAN_SCRIPT, 'postman_email_test', array( + 'recipient' => '#' . self::RECIPIENT_EMAIL_FIELD_NAME, + 'not_started' => _x( 'In Outbox', 'Email Test Status', 'post-smtp' ), + 'sending' => _x( 'Sending...', 'Email Test Status', 'post-smtp' ), + 'success' => _x( 'Success', 'Email Test Status', 'post-smtp' ), + 'failed' => _x( 'Failed', 'Email Test Status', 'post-smtp' ), + 'ajax_error' => __( 'Ajax Error', 'post-smtp' ), + ) ); + } + + /** + */ + public function outputTestEmailContent() { + print '<div class="wrap">'; + + PostmanViewController::outputChildPageHeader( __( 'Send a Test Email', 'post-smtp' ) ); + + printf( '<form id="postman_test_email_wizard" method="post" action="%s">', PostmanUtils::getSettingsPageUrl() ); + + wp_nonce_field('post-smtp', 'security' ); + + // Step 1 + printf( '<h5>%s</h5>', __( 'Specify the Recipient', 'post-smtp' ) ); + print '<fieldset>'; + printf( '<legend>%s</legend>', __( 'Who is this message going to?', 'post-smtp' ) ); + printf( '<p>%s', __( 'This utility allows you to send an email message for testing.', 'post-smtp' ) ); + print ' '; + /* translators: where %d is an amount of time, in seconds */ + printf( '%s</p>', sprintf( _n( 'If there is a problem, Postman will give up after %d second.', 'If there is a problem, Postman will give up after %d seconds.', $this->options->getReadTimeout(), 'post-smtp' ), $this->options->getReadTimeout() ) ); + printf( '<label for="postman_test_options[test_email]">%s</label>', _x( 'Recipient Email Address', 'Configuration Input Field', 'post-smtp' ) ); + print $this->test_email_callback(); + print '</fieldset>'; + + // Step 2 + printf( '<h5>%s</h5>', __( 'Send The Message', 'post-smtp' ) ); + print '<fieldset>'; + print '<legend>'; + print __( 'Sending the message:', 'post-smtp' ); + printf( ' <span id="postman_test_message_status">%s</span>', _x( 'In Outbox', 'Email Test Status', 'post-smtp' ) ); + print '</legend>'; + print '<section>'; + printf( '<p><label>%s</label></p>', __( 'Status', 'post-smtp' ) ); + print '<textarea id="postman_test_message_error_message" readonly="readonly" cols="65" rows="4"></textarea>'; + print '</section>'; + print '</fieldset>'; + + // Step 3 + printf( '<h5>%s</h5>', __( 'Session Transcript', 'post-smtp' ) ); + print '<fieldset>'; + printf( '<legend>%s</legend>', __( 'Examine the Session Transcript if you need to.', 'post-smtp' ) ); + printf( '<p>%s</p>', __( 'This is the conversation between Postman and the mail server. It can be useful for diagnosing problems. <b>DO NOT</b> post it on-line, it may contain your account password.', 'post-smtp' ) ); + print '<section>'; + printf( '<p><label for="postman_test_message_transcript">%s</label></p>', __( 'Session Transcript', 'post-smtp' ) ); + print '<textarea readonly="readonly" id="postman_test_message_transcript" cols="65" rows="8"></textarea>'; + print '</section>'; + print '</fieldset>'; + + print '</form>'; + print '</div>'; + } +} + +/** + * + * @author jasonhendriks + */ +class PostmanSendTestEmailAjaxController extends PostmanAbstractAjaxHandler { + + /** + * Constructor + * + * @param PostmanOptions $options + * @param PostmanOAuthToken $authorizationToken + * @param PostmanConfigTextHelper $oauthScribe + */ + function __construct() { + parent::__construct(); + PostmanUtils::registerAjaxHandler( 'postman_send_test_email', $this, 'sendTestEmailViaAjax' ); + } + + /** + * Yes, this procedure is just for testing. + * + * @return boolean + */ + function test_mode() { + return true; + } + + /** + * This Ajax sends a test email + */ + function sendTestEmailViaAjax() { + + check_admin_referer('post-smtp', 'security'); + + // get the email address of the recipient from the HTTP Request + $email = $this->getRequestParameter( 'email' ); + + // get the name of the server from the HTTP Request + $serverName = PostmanUtils::postmanGetServerName(); + + /* translators: where %s is the domain name of the site */ + $subject = sprintf( _x( 'Postman SMTP Test (%s)', 'Test Email Subject', 'post-smtp' ), $serverName ); + + // Postman API: indicate to Postman this is just for testing + add_filter( 'postman_test_email', array( + $this, + 'test_mode', + ) ); + + // this header specifies that there are many parts (one text part, one html part) + $header = 'Content-Type: multipart/alternative;'; + + // createt the message content + $message = $this->createMessageContent(); + + // send the message + $success = wp_mail( $email, $subject, $message, $header ); + + // Postman API: remove the testing indicator + remove_filter( 'postman_test_email', array( + $this, + 'test_mode', + ) ); + + // Postman API: retrieve the result of sending this message from Postman + $result = apply_filters( 'postman_wp_mail_result', null ); + + // post-handling + if ( $success ) { + $this->logger->debug( 'Test Email delivered to server' ); + // the message was sent successfully, generate an appropriate message for the user + $statusMessage = sprintf( __( 'Your message was delivered (%d ms) to the SMTP server! Congratulations :)', 'post-smtp' ), $result ['time'] ); + + $this->logger->debug( 'statusmessage: ' . $statusMessage ); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $result ['transcript'], + ); + + // log the response + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'Ajax Response:' ); + $this->logger->trace( $response ); + } + + // send the JSON response + wp_send_json_success( $response ); + } else { + $this->logger->error( 'Test Email NOT delivered to server - ' . $result ['exception']->getCode() ); + // the message was NOT sent successfully, generate an appropriate message for the user + $statusMessage = $result ['exception']->getMessage(); + + $this->logger->debug( 'statusmessage: ' . $statusMessage ); + + // compose the JSON response for the caller + $response = array( + 'message' => $statusMessage, + 'transcript' => $result ['transcript'], + ); + + // log the response + if ( $this->logger->isTrace() ) { + $this->logger->trace( 'Ajax Response:' ); + $this->logger->trace( $response ); + } + + // send the JSON response + wp_send_json_error( $response ); + } + } + + /** + * Create the multipart message content + * + * @return string + */ + private function createMessageContent() { + // Postman API: Get the plugin metadata + $pluginData = apply_filters( 'postman_get_plugin_metadata', null ); + + /* + translators: where %s is the Postman plugin version number (e.g. 1.4) */ + // English - Mandarin - French - Hindi - Spanish - Portuguese - Russian - Japanese + // http://www.pinyin.info/tools/converter/chars2uninumbers.html + $greeting = 'Hello! - 你好 - Bonjour! - नमस्ते - ¡Hola! - Olá - Привет! - 今日は'; + $sentBy = sprintf( _x( 'Sent by Postman %s', 'Test Email Tagline', 'post-smtp' ), $pluginData ['version'] ); + $imageSource = __( 'Image source', 'post-smtp' ); + $withPermission = __( 'Used with permission', 'post-smtp' ); + $messageArray = array( + 'Content-Type: text/plain; charset = "UTF-8"', + 'Content-Transfer-Encoding: 8bit', + '', + 'Hello!', + '', + sprintf( '%s - https://wordpress.org/plugins/post-smtp/', $sentBy ), + '', + 'Content-Type: text/html; charset=UTF-8', + 'Content-Transfer-Encoding: quoted-printable', + '', + '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">', + '<html xmlns="http://www.w3.org/1999/xhtml">', + '<head>', + '<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />', + '<style type="text/css" media="all">', + '.wporg-notification .im {', + ' color: #888;', + '} /* undo a GMail-inserted style */', + '</style>', + '</head>', + '<body class="wporg-notification">', + ' <div style="background: #e8f6fe; font-family: & quot; Helvetica Neue&quot; , Helvetica ,Arial,sans-serif; font-size: 14px; color: #666; text-align: center; margin: 0; padding: 0">', + ' <table border="0" cellspacing="0" cellpadding="0" bgcolor="#e8f6fe" style="background: #e8f6fe; width: 100%;">', + ' <tbody>', + ' <tr>', + ' <td>', + ' <table border="0" cellspacing="0" cellpadding="0" align="center" style="padding: 0px; width: 100%;"">', + ' <tbody>', + ' <tr>', + ' <td>', + ' <div style="max-width: 600px; height: 400px; margin: 0 auto; overflow: hidden;background-image:url(\'https://ps.w.org/postman-smtp/assets/email/poofytoo.png\');background-repeat: no-repeat;">', + sprintf( ' <div style="margin:50px 0 0 300px; width:300px; font-size:2em;">%s</div>', $greeting ), + sprintf( ' <div style="text-align:right;font-size: 1.4em; color:black;margin:150px 0 0 200px;">%s', $sentBy ), + ' <br/><span style="font-size: 0.8em"><a style="color:#3f73b9" href="https://wordpress.org/plugins/post-smtp/">https://wordpress.org/plugins/post-smtp/</a></span>', + ' </div>', + ' </div>', + ' </td>', + ' </tr>', + ' </tbody>', + ' </table>', + sprintf( ' <br><span style="font-size:0.9em;color:#94c0dc;">%s: <a style="color:#94c0dc" href="http://poofytoo.com">poofytoo.com</a> - %s</span>', $imageSource, $withPermission ), + ' </td>', + ' </tr>', + ' </tbody>', + ' </table>', + '</body>', + '</html>', + ); + return implode( PostmanMessage::EOL, $messageArray ); + } +} diff --git a/Postman/Postman-Send-Test-Email/postman_send_test_email.css b/Postman/Postman-Send-Test-Email/postman_send_test_email.css new file mode 100644 index 0000000..40d612c --- /dev/null +++ b/Postman/Postman-Send-Test-Email/postman_send_test_email.css @@ -0,0 +1,3 @@ +.wizard>.content { + min-height: 26em; +} diff --git a/Postman/Postman-Send-Test-Email/postman_send_test_email.js b/Postman/Postman-Send-Test-Email/postman_send_test_email.js new file mode 100644 index 0000000..ab69d1f --- /dev/null +++ b/Postman/Postman-Send-Test-Email/postman_send_test_email.js @@ -0,0 +1,169 @@ +transcript = false; +jQuery(document).ready( + function() { + ready = 0; + jQuery(postman_email_test.recipient).focus(); + jQuery("#postman_test_email_wizard") + .steps( + { + forceMoveForward : true, + showFinishButtonAlways : true, + bodyTag : "fieldset", + headerTag : "h5", + transitionEffect : "slideLeft", + stepsOrientation : "vertical", + autoFocus : true, + labels : { + current : steps_current_step, + pagination : steps_pagination, + finish : steps_finish, + next : steps_next, + previous : steps_previous, + loading : steps_loading + }, + onStepChanging : function(event, currentIndex, + newIndex) { + return handleStepChange(event, + currentIndex, newIndex, + jQuery(this)); + + }, + onInit : function() { + jQuery(postman_email_test.recipient) + .focus(); + jQuery('li + li').addClass('disabled'); + }, + onStepChanged : function(event, currentIndex, + priorIndex) { + return postHandleStepChange(event, + currentIndex, priorIndex, + jQuery(this)); + }, + onFinishing : function(event, currentIndex) { + return true; + }, + onFinished : function(event, currentIndex) { + if (ready == 0) { + return false; + } else { + var form = jQuery(this); + form.submit(); + } + } + }).validate({ + errorPlacement : function(error, element) { + element.before(error); + } + }); + }); +function handleStepChange(event, currentIndex, newIndex, form) { + // Always allow going backward even if + // the current step contains invalid fields! + if (currentIndex > newIndex) { + return false; + } + + // Clean up if user went backward + // before + if (currentIndex < newIndex) { + // To remove error styles + jQuery(".body:eq(" + newIndex + ") label.error", form).remove(); + jQuery(".body:eq(" + newIndex + ") .error", form).removeClass("error"); + } + + // Disable validation on fields that + // are disabled or hidden. + form.validate().settings.ignore = ":disabled,:hidden"; + + // Start validation; Prevent going + // forward if false + valid = form.valid(); + if (!valid) { + return false; + } + + if (currentIndex === 0) { + ready = 0; + // this disables the finish button during the screen slide + jQuery('li').addClass('disabled'); + jQuery('#postman_test_message_status').html( + postman_email_test.not_started); + jQuery('#postman_test_message_status').css('color', ''); + jQuery('#postman_test_message_error_message').val(''); + jQuery('#postman_test_message_transcript').val(''); + hide(jQuery('#test-success')); + hide(jQuery('#test-fail')); + } else if (currentIndex === 1) { + return transcript; + } + + return true; +} +function postHandleStepChange(event, currentIndex, priorIndex, myself) { + if (currentIndex === 0) { + } else if (currentIndex === 1) { + // this is the second place I disable the finish button but Steps + // re-enables it after the screen slides + jQuery('li').addClass('disabled'); + var data = { + 'action' : 'postman_send_test_email', + 'email' : jQuery(postman_email_test.recipient).val(), + 'security' : jQuery('#security').val() + }; + jQuery('#postman_test_message_status').html(postman_email_test.sending); + jQuery('#postman_test_message_status').css('color', 'blue'); + // http://stackoverflow.com/questions/21987318/catch-handle-502-bad-gateway-error + jQuery + .ajax( + { + statusCode : { + 502 : function() { + alert('The server returned "HTTP Error 502 Bad gateway". Contact your hosting provider to resolve the error.'); + } + }, + method : "POST", + url : ajaxurl, + data : data + }).done(function(response) { + handleResponse(response); + }).fail( + function(response) { + // handle ajax failure + jQuery('#postman_test_message_status').html( + postman_email_test.ajax_error); + jQuery('#postman_test_message_status').css('color', + 'red'); + jQuery('#postman_test_message_error_message').val( + postman_ajax_msg.bad_response + ":\n\n" + + response.responseText); + jQuery('li + li').removeClass('disabled'); + }); + + } + function handleResponse(response) { + if (postmanValidateAjaxResponse(response)) { + if (response.data.transcript + && response.data.transcript.length != 0) { + // only enable the next button if there is a transcript + transcript = true; + jQuery('li').removeClass('disabled'); + } else { + jQuery('li + li').removeClass('disabled'); + } + if (response.success) { + jQuery('#postman_test_message_status').html( + postman_email_test.success); + jQuery('#postman_test_message_status').css('color', 'green'); + } else { + jQuery('#postman_test_message_status').html( + postman_email_test.failed); + jQuery('#postman_test_message_status').css('color', 'red'); + } + jQuery('#postman_test_message_error_message').val( + response.data.message); + jQuery('#postman_test_message_transcript').val( + response.data.transcript); + } + ready = 1; + } +} |