'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_edit_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_edit_redirect_handlers', [$this, 'handle_page_redirect'], 10);
}
/**
* Registers the necessary scripts.
*
* @since 2.0.0
* @return void
*/
public function register_scripts(): void {
parent::register_scripts();
wp_enqueue_script('wu-email-edit-page', wu_get_asset('email-edit-page.js', 'js'), ['jquery', 'clipboard']);
}
/**
* Allow child classes to register widgets, if they need them.
*
* @since 1.8.2
* @return void
*/
public function register_widgets(): void {
parent::register_widgets();
$object = $this->get_object();
// translators: %s is replaced with the number of days.
$days_text = sprintf(__('Send %s day(s) after the event.', 'wp-multisite-waas'), '{{ days }}');
// translators: %1$s is replaced with the number of hours, %2$s is replaced with the number of minutes.
$hour_text = sprintf(__('Send %1$s hour(s) and %2$s minute(s) after the event.', 'wp-multisite-waas'), '{{ hours.split(":").shift() }}', '{{ hours.split(":").pop() }}');
$desc = sprintf(
'%s
%s',
$days_text,
$hour_text
);
$this->add_save_widget(
'save',
[
'html_attr' => [
'data-wu-app' => 'email_edit_save',
'data-state' => wu_convert_to_state(
[
'slug' => $this->edit ? $object->get_slug() : '',
'target' => $this->edit ? $object->get_target() : 'admin',
'schedule' => $this->edit ? $object->has_schedule() : false,
'schedule_type' => $this->edit ? $object->get_schedule_type() : 'days',
'days' => $this->edit ? $object->get_send_days() : 1,
'hours' => $this->edit ? $object->get_send_hours() : '12:00',
]
),
],
'fields' => [
'slug' => [
'type' => 'text',
'title' => __('Slug', 'wp-multisite-waas'),
'desc' => __('An unique identifier for this system email.', 'wp-multisite-waas'),
'value' => $this->edit ? $object->get_slug() : '',
'html_attr' => [
'required' => 'required',
'v-on:input' => 'slug = $event.target.value.toLowerCase().replace(/[^a-z0-9-_]+/g, "")',
'v-bind:value' => 'slug',
],
],
'event' => [
'type' => 'select',
'title' => __('Event', 'wp-multisite-waas'),
'desc' => __('The event that will trigger the sending of this email.', 'wp-multisite-waas'),
'placeholder' => __('Event', 'wp-multisite-waas'),
'options' => 'wu_get_event_types_as_options',
'value' => $this->edit ? $object->get_event() : 0,
'html_attr' => [
'name' => '',
],
],
'target' => [
'type' => 'select',
'title' => __('Target', 'wp-multisite-waas'),
'desc' => __('To whom this email should be sent.', 'wp-multisite-waas'),
'placeholder' => __('Network Administrators', 'wp-multisite-waas'),
'value' => $this->edit ? $object->get_target() : 'admin',
'options' => [
'admin' => __('Network Administrators', 'wp-multisite-waas'),
'customer' => __('Customer', 'wp-multisite-waas'),
],
'html_attr' => [
'v-model' => 'target',
],
],
'send_copy_to_admin' => [
'type' => 'toggle',
'title' => __('Send Copy to Admins?', 'wp-multisite-waas'),
'desc' => __('Checking this options will add the network admins as bcc every time this email is sent to a customer.', 'wp-multisite-waas'),
'value' => $this->edit ? $object->get_send_copy_to_admin() : false,
'wrapper_html_attr' => [
'v-show' => 'target == "customer"',
'v-cloak' => 1,
],
],
'schedule' => [
'type' => 'toggle',
'title' => __('Schedule?', 'wp-multisite-waas'),
'desc' => __('You can define when the email is sent after the event triggers.', 'wp-multisite-waas'),
'value' => $this->edit ? $this->get_object()->has_schedule() : 0,
'html_attr' => [
'v-model' => 'schedule',
],
],
'send_date' => [
'type' => 'group',
'title' => __('Scheduling Options', 'wp-multisite-waas'),
'tooltip' => __('When this email will be sent after the event?', 'wp-multisite-waas'),
'desc' => $desc,
'desc_id' => 'send_date_desc',
'wrapper_html_attr' => [
'v-show' => 'schedule',
'v-cloak' => 1,
],
'fields' => [
'schedule_type' => [
'type' => 'select',
'default' => 'days',
'wrapper_classes' => 'wu-w-2/3',
'value' => $this->edit ? $object->get_schedule_type() : 'days',
'options' => [
'hours' => __('Delay for hours', 'wp-multisite-waas'),
'days' => __('Delay for days', 'wp-multisite-waas'),
],
'html_attr' => [
'v-model' => 'schedule_type',
],
],
'send_days' => [
'type' => 'number',
'value' => $this->edit && $object->get_send_days() ? $object->get_send_days() : 1,
'placeholder' => 1,
'min' => 0,
'wrapper_classes' => 'wu-ml-2 wu-w-1/3',
'wrapper_html_attr' => [
'v-show' => "schedule_type == 'days'",
'v-cloak' => '1',
],
'html_attr' => [
'v-model' => 'days',
],
],
'send_hours' => [
'type' => 'text',
'date' => true,
'placeholder' => $this->edit ? $object->get_send_hours() : '12:00',
'value' => $this->edit ? $object->get_send_hours() : '',
'wrapper_classes' => 'wu-ml-2 wu-w-1/3',
'html_attr' => [
'data-no-calendar' => 'true',
'wu-datepicker' => 'true',
'data-format' => 'H:i',
'data-allow-time' => 'true',
'v-model' => 'hours',
],
'wrapper_html_attr' => [
'v-show' => "schedule_type == 'hours'",
'v-cloak' => '1',
],
],
],
],
],
]
);
add_meta_box('wp-ultimo-placeholders', __('Placeholders', 'wp-multisite-waas'), [$this, 'output_default_widget_placeholders'], get_current_screen()->id, 'normal', null, []);
$this->add_fields_widget(
'active',
[
'title' => __('Active', 'wp-multisite-waas'),
'fields' => [
'active' => [
'type' => 'toggle',
'title' => __('Active', 'wp-multisite-waas'),
'desc' => __('Use this option to manually enable or disable this email.', 'wp-multisite-waas'),
'value' => $this->get_object()->is_active(),
],
],
]
);
$this->add_tabs_widget(
'email_edit_options',
[
'title' => __('Advanced Options', 'wp-multisite-waas'),
'position' => 'normal',
'sections' => [
'general' => [
'title' => __('General', 'wp-multisite-waas'),
'icon' => 'dashicons-wu-lock',
'desc' => __('Rules and limitations to the applicability of this discount code.', 'wp-multisite-waas'),
'state' => [
'sender' => $this->edit ? $object->get_custom_sender() : 0,
],
'fields' => [
'style' => [
'type' => 'select',
'title' => __('Email Style', 'wp-multisite-waas'),
'desc' => __('Choose if email body will be sent using the HTML template or in plain text.', 'wp-multisite-waas'),
'placeholder' => __('Style', 'wp-multisite-waas'),
'options' => [
'default' => __('Use Default', 'wp-multisite-waas'),
'html' => __('HTML Emails', 'wp-multisite-waas'),
'plain' => __('Plain Emails', 'wp-multisite-waas'),
],
'value' => $this->edit ? $object->get_style() : 'html',
],
],
],
'sender' => [
'title' => __('Custom Sender', 'wp-multisite-waas'),
'icon' => 'dashicons-wu-mail',
'desc' => __('You can define an email and a name that will only be used when this email is sent.', 'wp-multisite-waas'),
'fields' => [
'custom_sender' => [
'type' => 'toggle',
'title' => __('Use a custom sender?', 'wp-multisite-waas'),
'desc' => __('You can define an email and a name that will only be used when this email is sent.', 'wp-multisite-waas'),
'value' => $this->edit ? $object->get_custom_sender() : 0,
'html_attr' => [
'v-model' => 'sender',
],
],
'custom_sender_name' => [
'type' => 'text',
'title' => __('From "Name"', 'wp-multisite-waas'),
'desc' => __('Override the global from name for this particular email.', 'wp-multisite-waas'),
'wrapper_classes' => 'wu-full',
'value' => $this->edit ? $object->get_custom_sender_name() : '',
'wrapper_html_attr' => [
'v-show' => 'sender',
'v-cloak' => 1,
],
],
'custom_sender_email' => [
'type' => 'email',
'title' => __('From "Email"', 'wp-multisite-waas'),
'desc' => __('Override the global from email for this particular email.', 'wp-multisite-waas'),
'wrapper_classes' => 'wu-full',
'value' => $this->edit ? $object->get_custom_sender_email() : '',
'wrapper_html_attr' => [
'v-show' => 'sender',
'v-cloak' => 1,
],
],
],
],
],
]
);
}
/**
* Outputs the block that shows the event payload placeholders.
*
* @since 2.0.0
*
* @param mixed $unused Not sure.
* @param array $data Arguments passed by add_meta_box.
* @return void
*/
public function output_default_widget_placeholders($unused, $data): void {
wu_get_template(
'email/widget-placeholders',
[
'title' => __('Event Payload', 'wp-multisite-waas'),
'loading_text' => __('Loading Payload', 'wp-multisite-waas'),
]
);
}
/**
* Returns the title of the page.
*
* @since 2.0.0
* @return string Title of the page.
*/
public function get_title() {
return $this->edit ? __('Edit Email', 'wp-multisite-waas') : __('Add new Email', '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 __('Edit Email', 'wp-multisite-waas');
}
/**
* Returns the action links for that page.
*
* @since 1.8.2
* @return array
*/
public function action_links() {
$url_atts = [
'id' => $this->get_object()->get_id(),
'model' => 'email',
'page' => 'edit',
];
$send_test_link = wu_get_form_url('send_new_test', $url_atts);
return [
[
'url' => wu_network_admin_url('wp-ultimo-emails'),
'label' => __('Go Back', 'wp-multisite-waas'),
'icon' => 'wu-reply',
],
[
'url' => $send_test_link,
'label' => __('Send Test Email', 'wp-multisite-waas'),
'icon' => 'wu-mail',
'classes' => 'wubox',
],
];
}
/**
* Returns the labels to be used on the admin page.
*
* @since 2.0.0
* @return array
*/
public function get_labels() {
return [
'edit_label' => __('Edit Email', 'wp-multisite-waas'),
'add_new_label' => __('Add new Email', 'wp-multisite-waas'),
'updated_message' => __('Email updated with success!', 'wp-multisite-waas'),
'title_placeholder' => __('Enter Email Subject', 'wp-multisite-waas'),
'title_description' => __('This will be used as the email subject line.', 'wp-multisite-waas'),
'save_button_label' => __('Save Email', 'wp-multisite-waas'),
'save_description' => '',
'delete_button_label' => __('Delete Email', 'wp-multisite-waas'),
'delete_description' => __('Be careful. This action is irreversible.', 'wp-multisite-waas'),
];
}
/**
* Filters the list table to return only relevant events.
*
* @since 2.0.0
*
* @param array $args Query args passed to the list table.
* @return array Modified query args.
*/
public function query_filter($args) {
$extra_args = [
'object_type' => 'system_email',
'object_id' => absint($this->get_object()->get_id()),
];
return array_merge($args, $extra_args);
}
/**
* Handles the toggles.
*
* @since 2.0.0
* @return void
*/
public function handle_save(): void {
$_POST['schedule'] = wu_request('schedule');
$_POST['send_copy_to_admin'] = wu_request('send_copy_to_admin');
$_POST['custom_sender'] = wu_request('custom_sender');
parent::handle_save();
}
/**
* 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 ('wp-ultimo-edit-email' === $page->get_id()) {
if (wu_request('test_notice')) {
$test_notice = wu_request('test_notice');
?>
get_item_by('id', $_GET['id']);
if (! $item) {
wp_safe_redirect(wu_network_admin_url('wp-ultimo-emails'));
exit;
}
return $item;
}
return new Email();
}
/**
* Emails have titles.
*
* @since 2.0.0
*/
public function has_title(): bool {
return true;
}
/**
* Wether or not this pages should have an editor field.
*
* @since 2.0.0
*/
public function has_editor(): bool {
return true;
}
/**
* Filters the list table to return only relevant events.
*
* @since 2.0.0
*
* @param array $args Query args passed to the list table.
* @return array Modified query args.
*/
public function events_query_filter($args) {
$extra_args = [
'object_type' => 'email',
'object_id' => absint($this->get_object()->get_id()),
];
return array_merge($args, $extra_args);
}
}