| Dir : /home/trave494/v1world.us/wp-content/plugins/wp-mail-smtp/src/Admin/Pages/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : //home/trave494/v1world.us/wp-content/plugins/wp-mail-smtp/src/Admin/Pages/DebugEventsTab.php |
<?php
namespace WPMailSMTP\Admin\Pages;
use WPMailSMTP\Admin\Area;
use WPMailSMTP\Admin\DebugEvents\DebugEvents;
use WPMailSMTP\Admin\DebugEvents\Migration;
use WPMailSMTP\Admin\DebugEvents\Table;
use WPMailSMTP\Admin\PageAbstract;
use WPMailSMTP\Admin\ParentPageAbstract;
use WPMailSMTP\Options;
use WPMailSMTP\WP;
/**
* Debug Events settings page.
*
* @since 3.0.0
*/
class DebugEventsTab extends PageAbstract {
/**
* Part of the slug of a tab.
*
* @since 3.0.0
*
* @var string
*/
protected $slug = 'debug-events';
/**
* Tab priority.
*
* @since 3.0.0
*
* @var int
*/
protected $priority = 40;
/**
* Debug events list table.
*
* @since 3.0.0
*
* @var Table
*/
protected $table = null;
/**
* Plugin options.
*
* @since 3.0.0
*
* @var Options
*/
protected $options;
/**
* Constructor.
*
* @since 3.0.0
*
* @param ParentPageAbstract $parent_page Tab parent page.
*/
public function __construct( $parent_page = null ) {
$this->options = new Options();
parent::__construct( $parent_page );
// Remove unnecessary $_GET parameters and prevent url duplications in _wp_http_referer input.
$this->remove_get_parameters();
}
/**
* Link label of a tab.
*
* @since 3.0.0
*
* @return string
*/
public function get_label() {
return esc_html__( 'Debug Events', 'wp-mail-smtp' );
}
/**
* Title of a tab.
*
* @since 3.0.0
*
* @return string
*/
public function get_title() {
return $this->get_label();
}
/**
* Register hooks.
*
* @since 3.0.0
*/
public function hooks() {
add_action( 'wp_mail_smtp_admin_area_enqueue_assets', [ $this, 'enqueue_assets' ] );
}
/**
* Enqueue required JS and CSS.
*
* @since 3.0.0
*/
public function enqueue_assets() {
$min = WP::asset_min();
wp_enqueue_style(
'wp-mail-smtp-flatpickr',
wp_mail_smtp()->assets_url . '/css/vendor/flatpickr.min.css',
[],
'4.6.9'
);
wp_enqueue_script(
'wp-mail-smtp-flatpickr',
wp_mail_smtp()->assets_url . '/js/vendor/flatpickr.min.js',
[ 'jquery' ],
'4.6.9',
true
);
wp_enqueue_script(
'wp-mail-smtp-tools-debug-events',
wp_mail_smtp()->assets_url . "/js/smtp-tools-debug-events{$min}.js",
[ 'jquery', 'wp-mail-smtp-flatpickr' ],
WPMS_PLUGIN_VER,
true
);
wp_localize_script(
'wp-mail-smtp-tools-debug-events',
'wp_mail_smtp_tools_debug_events',
[
'lang_code' => sanitize_key( WP::get_language_code() ),
'plugin_url' => wp_mail_smtp()->plugin_url,
'loader' => wp_mail_smtp()->prepare_loader( 'blue' ),
'texts' => [
'delete_all_notice' => esc_html__( 'Are you sure you want to permanently delete all debug events?', 'wp-mail-smtp' ),
'cancel' => esc_html__( 'Cancel', 'wp-mail-smtp' ),
'close' => esc_html__( 'Close', 'wp-mail-smtp' ),
'yes' => esc_html__( 'Yes', 'wp-mail-smtp' ),
'ok' => esc_html__( 'OK', 'wp-mail-smtp' ),
'notice_title' => esc_html__( 'Heads up!', 'wp-mail-smtp' ),
'error_occurred' => esc_html__( 'An error occurred!', 'wp-mail-smtp' ),
],
]
);
}
/**
* Get email logs list table.
*
* @since 3.0.0
*
* @return Table
*/
public function get_table() {
if ( $this->table === null ) {
$this->table = new Table();
}
return $this->table;
}
/**
* Display scheduled actions table.
*
* @since 3.0.0
*/
public function display() {
?>
<form method="POST" action="<?php echo esc_url( $this->get_link() ); ?>">
<?php $this->wp_nonce_field(); ?>
<!-- Debug Events Section Title -->
<div class="wp-mail-smtp-setting-row wp-mail-smtp-setting-row-content wp-mail-smtp-clear section-heading" id="wp-mail-smtp-setting-row-email-heading">
<div class="wp-mail-smtp-setting-field">
<h2><?php esc_html_e( 'Debug Events', 'wp-mail-smtp' ); ?></h2>
</div>
<p>
<?php esc_html_e( 'On this page, you can view and configure different plugin debugging events. View email sending errors and enable debugging events, allowing you to detect email sending issues.', 'wp-mail-smtp' ); ?>
</p>
</div>
<!-- Debug Events -->
<div id="wp-mail-smtp-setting-row-debug_event_types" class="wp-mail-smtp-setting-row wp-mail-smtp-setting-row-checkbox wp-mail-smtp-clear">
<div class="wp-mail-smtp-setting-label">
<label for="wp-mail-smtp-setting-debug_event_types">
<?php esc_html_e( 'Event Types', 'wp-mail-smtp' ); ?>
</label>
</div>
<div class="wp-mail-smtp-setting-field">
<div>
<input name="wp-mail-smtp[debug_events][email_errors]" type="checkbox"
value="true"
checked
disabled
id="wp-mail-smtp-setting-debug_events_email_errors">
<label for="wp-mail-smtp-setting-debug_events_email_errors">
<?php esc_html_e( 'Email Sending Errors', 'wp-mail-smtp' ); ?>
</label>
<p class="desc">
<?php esc_html_e( 'This debug event is always enabled and will record any email sending errors in the table below.', 'wp-mail-smtp' ); ?>
</p>
</div>
<hr class="wp-mail-smtp-setting-mid-row-sep">
<div>
<input name="wp-mail-smtp[debug_events][email_debug]" type="checkbox"
value="true" <?php checked( true, $this->options->get( 'debug_events', 'email_debug' ) ); ?>
id="wp-mail-smtp-setting-debug_events_email_debug">
<label for="wp-mail-smtp-setting-debug_events_email_debug">
<?php esc_html_e( 'Debug Email Sending', 'wp-mail-smtp' ); ?>
</label>
<p class="desc">
<?php esc_html_e( 'Check this if you would like to debug the email sending process. Once enabled, all debug events will be logged in the table below. This setting should only be enabled for shorter debugging periods and disabled afterwards.', 'wp-mail-smtp' ); ?>
</p>
</div>
</div>
</div>
<?php $this->display_save_btn(); ?>
</form>
<?php
if ( ! DebugEvents::is_valid_db() ) {
$this->display_debug_events_not_installed();
} else {
$table = $this->get_table();
$table->prepare_items();
?>
<form action="<?php echo esc_url( $this->get_link() ); ?>" method="get">
<input type="hidden" name="page" value="<?php echo esc_attr( Area::SLUG . '-tools' ); ?>" />
<input type="hidden" name="tab" value="<?php echo esc_attr( $this->get_slug() ); ?>" />
<?php
// State of status filter for submission with other filters.
if ( $table->get_filtered_types() !== false ) {
printf( '<input type="hidden" name="type" value="%s">', esc_attr( $table->get_filtered_types() ) );
}
if ( $this->get_filters_html() ) {
?>
<div id="wp-mail-smtp-reset-filter">
<?php
$type = $table->get_filtered_types();
echo wp_kses(
sprintf( /* translators: %1$s - number of debug events found; %2$s - filtered type. */
_n(
'Found <strong>%1$s %2$s event</strong>',
'Found <strong>%1$s %2$s events</strong>',
absint( $table->get_pagination_arg( 'total_items' ) ),
'wp-mail-smtp'
),
absint( $table->get_pagination_arg( 'total_items' ) ),
$type !== false && isset( $table->get_types()[ $type ] ) ? $table->get_types()[ $type ] : ''
),
[
'strong' => [],
]
);
?>
<?php foreach ( $this->get_filters_html() as $id => $html ) : ?>
<?php
echo wp_kses(
$html,
[ 'em' => [] ]
);
?>
<i class="reset dashicons dashicons-dismiss" data-scope="<?php echo esc_attr( $id ); ?>"></i>
<?php endforeach; ?>
</div>
<?php
}
$table->search_box(
esc_html__( 'Search Events', 'wp-mail-smtp' ),
Area::SLUG . '-debug-events-search-input'
);
$table->views();
$table->display();
?>
</form>
<?php
}
}
/**
* Process tab form submission ($_POST ).
*
* @since 3.0.0
*
* @param array $data Post data specific for the plugin.
*/
public function process_post( $data ) {
$this->check_admin_referer();
// Unchecked checkboxes doesn't exist in $_POST, so we need to ensure we actually have them in data to save.
if ( empty( $data['debug_events']['email_debug'] ) ) {
$data['debug_events']['email_debug'] = false;
}
// All the sanitization is done there.
$this->options->set( $data, false, false );
WP::add_admin_notice(
esc_html__( 'Settings were successfully saved.', 'wp-mail-smtp' ),
WP::ADMIN_NOTICE_SUCCESS
);
}
/**
* Return an array with information (HTML and id) for each filter for this current view.
*
* @since 3.0.0
*
* @return array
*/
private function get_filters_html() {
$filters = [
'.search-box' => $this->get_filter_search_html(),
'.wp-mail-smtp-filter-date' => $this->get_filter_date_html(),
];
return array_filter( $filters );
}
/**
* Return HTML with information about the search filter.
*
* @since 3.0.0
*
* @return string
*/
private function get_filter_search_html() {
$table = $this->get_table();
$term = $table->get_filtered_search();
if ( $term === false ) {
return '';
}
return sprintf( /* translators: %s The searched term. */
__( 'where event contains "%s"', 'wp-mail-smtp' ),
'<em>' . esc_html( $term ) . '</em>'
);
}
/**
* Return HTML with information about the date filter.
*
* @since 3.0.0
*
* @return string
*/
private function get_filter_date_html() {
$table = $this->get_table();
$dates = $table->get_filtered_dates();
if ( $dates === false ) {
return '';
}
$dates = array_map(
function ( $date ) {
return date_i18n( 'M j, Y', strtotime( $date ) );
},
$dates
);
$html = '';
switch ( count( $dates ) ) {
case 1:
$html = sprintf( /* translators: %s - Date. */
esc_html__( 'on %s', 'wp-mail-smtp' ),
'<em>' . $dates[0] . '</em>'
);
break;
case 2:
$html = sprintf( /* translators: %1$s - Date. %2$s - Date. */
esc_html__( 'between %1$s and %2$s', 'wp-mail-smtp' ),
'<em>' . $dates[0] . '</em>',
'<em>' . $dates[1] . '</em>'
);
break;
}
return $html;
}
/**
* Display a message when debug events DB table is missing.
*
* @since 3.0.0
*/
private function display_debug_events_not_installed() {
$error_message = get_option( Migration::ERROR_OPTION_NAME );
?>
<div class="notice-inline notice-error">
<h3><?php esc_html_e( 'Debug Events are Not Installed Correctly', 'wp-mail-smtp' ); ?></h3>
<p>
<?php
if ( ! empty( $error_message ) ) {
esc_html_e( 'The database table was not installed correctly. Please contact plugin support to diagnose and fix the issue. Provide them the error message below:', 'wp-mail-smtp' );
echo '<br><br>';
echo '<code>' . esc_html( $error_message ) . '</code>';
} else {
esc_html_e( 'For some reason the database table was not installed correctly. Please contact plugin support team to diagnose and fix the issue.', 'wp-mail-smtp' );
}
?>
</p>
</div>
<?php
}
/**
* Remove unnecessary $_GET parameters for shorter URL.
*
* @since 3.0.0
*/
protected function remove_get_parameters() {
if ( isset( $_SERVER['REQUEST_URI'] ) ) {
$_SERVER['REQUEST_URI'] = remove_query_arg(
[
'_wp_http_referer',
'_wpnonce',
'wp-mail-smtp-debug-events-nonce',
],
$_SERVER['REQUEST_URI'] // phpcs:ignore WordPress.Security.ValidatedSanitizedInput
);
}
}
}