'capability_here'
* To add a page to the network admin (wp-admin/network), use: 'network_admin_menu' => 'capability_here'
* To add a page to the user (wp-admin/user) admin, use: 'user_admin_menu' => 'capability_here'
*
* @since 2.0.0
* @var array
*/
protected $supported_panels = [
'network_admin_menu' => 'wu_read_emails',
];
/**
* Initializes the class
*
* @since 1.8.2
* @return void
*/
public function init(): void {
/**
* Runs the parent init functions
*/
parent::init();
add_action('wu_page_list_redirect_handlers', [$this, 'handle_page_redirect'], 10);
}
/**
* Allow child classes to register widgets, if they need them.
*
* @since 1.8.2
* @return void
*/
public function register_widgets() {}
/**
* Returns the title of the page.
*
* @since 2.0.0
* @return string Title of the page.
*/
public function get_title() {
return __('System Emails', 'wp-multisite-waas');
}
/**
* Returns the title of menu for this page.
*
* @since 2.0.0
* @return string Menu label of the page.
*/
public function get_menu_title() {
return __('System Emails', 'wp-multisite-waas');
}
/**
* Allows admins to rename the sub-menu (first item) for a top-level page.
*
* @since 2.0.0
* @return string False to use the title menu or string with sub-menu title.
*/
public function get_submenu_title() {
return __('System Emails', 'wp-multisite-waas');
}
/**
* Register ajax form that we use for system emails.
*
* @since 2.0.0
* @return void
*/
public function register_forms(): void {
/*
* Send a email test
*/
wu_register_form(
'send_new_test',
[
'render' => [$this, 'render_send_new_test_modal'],
'handler' => [$this, 'handle_send_new_test_modal'],
'capability' => 'wu_add_broadcast',
]
);
/*
* Reset or Import modal.
*/
wu_register_form(
'reset_import',
[
'render' => [$this, 'render_reset_import_modal'],
'handler' => [$this, 'handle_reset_import_modal'],
'capability' => 'wu_add_broadcasts',
]
);
/*
* Reset Confirmation modal.
*/
wu_register_form(
'reset_confirmation',
[
'render' => [$this, 'render_reset_confirmation_modal'],
'handler' => [$this, 'handle_reset_confirmation_modal'],
'capability' => 'wu_add_broadcasts',
]
);
}
/**
* Renders the modal to send tests with system emails.
*
* @since 2.0.0
* @return void
*/
public function render_send_new_test_modal(): void {
$fields = [
'send_to' => [
'type' => 'email',
'title' => __('Send To', 'wp-multisite-waas'),
'placeholder' => __('E.g. network@email.com', 'wp-multisite-waas'),
'desc' => __('The test email will be sent to the above email address.', 'wp-multisite-waas'),
'value' => get_network_option(null, 'admin_email'),
'html_attr' => [
'required' => 'required',
],
],
'email_id' => [
'type' => 'hidden',
'value' => wu_request('id'),
],
'page' => [
'type' => 'hidden',
'value' => wu_request('page'),
],
'submit_button' => [
'type' => 'submit',
'title' => __('Send Test Email', 'wp-multisite-waas'),
'value' => 'save',
'classes' => 'button button-primary wu-w-full',
'wrapper_classes' => 'wu-items-end wu-text-right',
],
];
$form = new \WP_Ultimo\UI\Form(
'send_new_test',
$fields,
[
'views' => 'admin-pages/fields',
'classes' => 'wu-modal-form wu-widget-list wu-striped wu-m-0 wu-mt-0',
'field_wrapper_classes' => 'wu-w-full wu-box-border wu-items-center wu-flex wu-justify-between wu-p-4 wu-m-0 wu-border-t wu-border-l-0 wu-border-r-0 wu-border-b-0 wu-border-gray-300 wu-border-solid',
'html_attr' => [
'data-wu-app' => 'send_new_test',
],
]
);
$form->render();
}
/**
* Handles the modal to send tests with system emails.
*
* @since 2.0.0
* @return void
*/
public function handle_send_new_test_modal() {
$email_id = wu_request('email_id');
$send_to = wu_request('send_to');
if ( ! $email_id || ! $send_to) {
$error = new \WP_Error('error', __('Something wrong happened.', 'wp-multisite-waas'));
wp_send_json_error($error);
}
$from = [
'name' => wu_get_setting('from_name'),
'email' => wu_get_setting('from_email'),
];
$to = [
[
'name' => wu_get_setting('from_name'),
'email' => $send_to,
],
];
$email = wu_get_email($email_id);
$event_slug = $email->get_event();
$event_type = wu_get_event_type($event_slug);
$payload = [];
if ($event_type) {
$payload = wu_maybe_lazy_load_payload($event_type['payload']);
}
$args = [
'style' => $email->get_style(),
'content' => $email->get_content(),
'subject' => get_network_option(null, 'site_name') . ' - ' . $email->get_title(),
'payload' => $payload,
];
$send_mail = wu_send_mail($from, $to, $args);
if ( ! $send_mail) {
$error = new \WP_Error('error', __('Something wrong happened with your test.', 'wp-multisite-waas'));
wp_send_json_error($error);
}
$page = wu_request('page', 'list');
if ('edit' === $page) {
wp_send_json_success(
[
'redirect_url' => wu_network_admin_url(
'wp-ultimo-edit-email',
[
'id' => $email_id,
'test_notice' => __('Test sent successfully', 'wp-multisite-waas'),
]
),
]
);
die();
}
wp_send_json_success(
[
'redirect_url' => wu_network_admin_url(
'wp-ultimo-emails',
[
'notice' => __('Test sent successfully', 'wp-multisite-waas'),
]
),
]
);
}
/**
* Renders the modal to reset or import system emails.
*
* @since 2.0.0
*
* @return void
*/
public function render_reset_import_modal(): void {
$default_system_emails = wu_get_default_system_emails();
$created_emails = wu_get_all_system_emails();
$fields = [
'reset_emails' => [
'type' => 'toggle',
'title' => __('Reset System Emails ', 'wp-multisite-waas'),
'desc' => __('Restore the system emails to their original content.', 'wp-multisite-waas'),
'tooltip' => '',
'value' => 0,
'html_attr' => [
'v-model' => 'reset_emails',
],
],
];
$fields['reset_note'] = [
'type' => 'note',
'title' => '',
'desc' => __('No emails to reset.', 'wp-multisite-waas'),
'tooltip' => '',
'value' => 0,
'wrapper_html_attr' => [
'v-show' => 'reset_emails',
'v-cloak' => 1,
],
];
foreach ($created_emails as $system_email_key => $system_email_value) {
$system_email_slug = $system_email_value->get_slug();
if (isset($default_system_emails[ $system_email_slug ])) {
$field_name = 'reset_' . $system_email_value->get_slug();
$system_email_target = $system_email_value->get_target();
$field_title = '
' . $system_email_value->get_title() . '
';
$fields[ $field_name ] = [
'type' => 'toggle',
'title' => $field_title,
'desc' => $system_email_value->get_event() . ' ' . $system_email_target . '',
'tooltip' => '',
'value' => 0,
'wrapper_classes' => 'wu-bg-gray-100',
'wrapper_html_attr' => [
'v-show' => 'reset_emails',
'v-cloak' => 1,
],
];
if (isset($fields['reset_note'])) {
unset($fields['reset_note']);
}
}
}
$fields['import_emails'] = [
'type' => 'toggle',
'title' => __('Import System Emails', 'wp-multisite-waas'),
'desc' => __('Add new system emails based on WP Multisite WaaS presets.', 'wp-multisite-waas'),
'tooltip' => '',
'value' => 0,
'html_attr' => [
'v-model' => 'import_emails',
],
];
$fields['import_note'] = [
'type' => 'note',
'title' => '',
'desc' => __('All emails are already present.', 'wp-multisite-waas'),
'tooltip' => '',
'value' => 0,
'wrapper_html_attr' => [
'v-show' => 'import_emails',
'v-cloak' => 1,
],
];
foreach ($default_system_emails as $default_email_key => $default_email_value) {
$maybe_is_created = wu_get_email_by('slug', $default_email_key);
if ( ! $maybe_is_created) {
$field_name = 'import_' . $default_email_key;
$field_title = '' . $default_email_value['title'] . '
';
$fields[ $field_name ] = [
'type' => 'toggle',
'title' => $field_title,
'desc' => $default_email_value['event'] . ' ' . $default_email_value['target'] . '',
'tooltip' => '',
'value' => 0,
'wrapper_classes' => 'wu-bg-gray-100',
'wrapper_html_attr' => [
'v-show' => 'import_emails',
'v-cloak' => 1,
],
];
if (isset($fields['import_note'])) {
unset($fields['import_note']);
}
}
}
$fields['submit_button'] = [
'type' => 'submit',
'title' => __('Reset and/or Import', 'wp-multisite-waas'),
'value' => 'save',
'classes' => 'button button-primary wu-w-full',
'wrapper_classes' => 'wu-items-end wu-text-right',
];
$form = new \WP_Ultimo\UI\Form(
'reset_import',
$fields,
[
'views' => 'admin-pages/fields',
'classes' => 'wu-modal-form wu-widget-list wu-striped wu-m-0 wu-mt-0',
'field_wrapper_classes' => 'wu-w-full wu-box-border wu-items-center wu-flex wu-justify-between wu-p-4 wu-m-0 wu-border-t wu-border-l-0 wu-border-r-0 wu-border-b-0 wu-border-gray-300 wu-border-solid',
'html_attr' => [
'data-wu-app' => 'reset_import',
'data-state' => wp_json_encode(
[
'reset_emails' => false,
'import_emails' => false,
]
),
],
]
);
$form->render();
}
/**
* Handles the modal to reset or import system emails.
*
* @since 2.0.0
*
* @return mixed
*/
public function handle_reset_import_modal(): void {
$reset = wu_request('reset_emails');
$import = wu_request('import_emails');
$default_system_emails = wu_get_default_system_emails();
$created_emails = wu_get_all_system_emails();
if ($reset) {
foreach ($created_emails as $created_email) {
$slug = $created_email->get_slug();
$maybe_reset = wu_request('reset_' . $slug, '');
if ($maybe_reset) {
$created_email->delete();
wu_create_default_system_email($slug);
}
}
}
if ($import) {
foreach ($default_system_emails as $default_system_emails_key => $default_system_emails_value) {
$slug = $default_system_emails_value['slug'];
$maybe_import = wu_request('import_' . $slug, '');
if ($maybe_import) {
wu_create_default_system_email($slug);
}
}
}
wp_send_json_success(
[
'redirect_url' => wu_network_admin_url('wp-ultimo-emails'),
]
);
}
/**
* Handles the redirect notice from sent new test modal.
*
* @param Base_Admin_Page $page The page object.
* @return void
*/
public function handle_page_redirect($page): void {
if ($page->get_id() === 'wp-ultimo-emails') {
if (wu_request('notice')) {
$notice = wu_request('notice');
?>
[
'type' => 'toggle',
'title' => __('Confirm Reset', 'wp-multisite-waas'),
'desc' => __('This action can not be undone.', 'wp-multisite-waas'),
'default' => 0,
'html_attr' => [
'required' => 'required',
],
],
'email_id' => [
'type' => 'hidden',
'value' => wu_request('id'),
],
'submit_button' => [
'type' => 'submit',
'title' => __('Reset Email', 'wp-multisite-waas'),
'value' => 'reset',
'classes' => 'button button-primary wu-w-full',
'wrapper_classes' => 'wu-items-end wu-text-right',
],
];
$form = new \WP_Ultimo\UI\Form(
'reset_confirmation',
$fields,
[
'views' => 'admin-pages/fields',
'classes' => 'wu-modal-form wu-widget-list wu-striped wu-m-0 wu-mt-0',
'field_wrapper_classes' => 'wu-w-full wu-box-border wu-items-center wu-flex wu-justify-between wu-p-4 wu-m-0 wu-border-t wu-border-l-0 wu-border-r-0 wu-border-b-0 wu-border-gray-300 wu-border-solid',
'html_attr' => [
'data-wu-app' => 'reset_confirmation',
],
]
);
$form->render();
}
/**
* Handles the reset confirmation modal.
*
* @since 2.0.0
*
* @return void
*/
public function handle_reset_confirmation_modal() {
$single_reset = wu_request('single_reset');
$email_id = wu_request('email_id');
if ( ! $single_reset || ! $email_id) {
$error = new \WP_Error('error', __('Something wrong happened.', 'wp-multisite-waas'));
wp_send_json_error($error);
}
$email = wu_get_email($email_id);
$slug = $email->get_slug();
$default_system_emails = wu_get_default_system_emails();
if (isset($default_system_emails[ $slug ])) {
$email->delete();
wu_create_default_system_email($slug);
$new_email = wu_get_email_by('slug', $slug);
if ( ! $new_email) {
$error = new \WP_Error('error', __('Something wrong happened.', 'wp-multisite-waas'));
wp_send_json_error($error);
}
wp_send_json_success(
[
'redirect_url' => wu_network_admin_url(
'wp-ultimo-edit-email',
[
'id' => $new_email->get_id(),
]
),
]
);
}
}
/**
* Returns the action links for that page.
*
* @since 1.8.2
* @return array
*/
public function action_links() {
$email_template_default = get_network_option(null, 'wu_default_email_template');
return [
[
'url' => wu_network_admin_url('wp-ultimo-edit-email'),
'label' => __('Add System Email', 'wp-multisite-waas'),
'icon' => 'wu-circle-with-plus',
],
[
'url' => wu_network_admin_url('wp-ultimo-customize-email-template&id=' . $email_template_default),
'label' => __('Email Template', 'wp-multisite-waas'),
'icon' => 'wu-mail',
],
[
'url' => wu_get_form_url('reset_import'),
'classes' => 'wubox',
'label' => __('Reset or Import', 'wp-multisite-waas'),
'icon' => 'wu-cycle',
],
];
}
/**
* Loads the list table for this particular page.
*
* @since 2.0.0
* @return \WP_Ultimo\List_Tables\Base_List_Table
*/
public function table() {
return new \WP_Ultimo\List_Tables\Email_List_Table();
}
}