'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_customize_email_template', ]; /** * Overrides the init method to add additional hooks. * * @since 2.0.0 * @return void */ public function init(): void { parent::init(); add_action('wp_ajax_wu-email-template-preview', [$this, 'email_template_preview']); } /** * Return the page object * * @since 2.0.0 * * @return object $this The Current Object */ public function get_object() { return $this; } /** * Renders the preview of a given form being customized. * * @since 2.0.0 * @return void */ public function email_template_preview(): void { $object = $this; $content = wpautop( ' Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nam nulla diam, iaculis sit amet tellus sit amet, tempus hendrerit risus. Proin elementum aliquet lorem ut cursus. Ut varius pharetra magna, eu malesuada metus feugiat id. Aenean cursus purus et massa commodo pretium id ut erat. Suspendisse erat odio, auctor ac elit eget, rhoncus iaculis nulla. Aliquam turpis leo, egestas eget dui a, imperdiet ullamcorper felis. Suspendisse ut lacinia mauris. Phasellus vitae diam euismod diam tristique faucibus. Proin gravida, augue in molestie porttitor, orci justo aliquam mauris, et commodo mauris nisi vitae tortor. Mauris vulputate fringilla purus et finibus. Duis lacus turpis, tincidunt vel dui ac, fermentum aliquet dolor. Donec auctor tristique consequat. In pharetra lacus quis mi dictum, ut dapibus eros bibendum. Donec tristique nibh ac sem bibendum, at feugiat turpis molestie. Suspendisse eget eleifend nunc. Sed tempor varius nisi non tincidunt. Sed leo arcu, feugiat dapibus sollicitudin a, tincidunt eu ligula. Nam ut arcu id arcu auctor vulputate non molestie quam. Nunc non diam mauris. Praesent erat est, posuere sit amet hendrerit non, molestie eget sem. Cras ac tempor est.' ); $content .= '

Amount:	$99.00 USD
Paid with:	Credit Card
External ID:	ch_1IBe2OFmXz63vF5vkusIdsyv
ID:	342257
Processed at:	Jan 20, 2021 GMT
Invoice:	Download PDF
Type:	Initial Payment

'; /* * use arbitrary field to determine if this is the first request for the preview. */ $first_request = ! wu_request('background_color'); wu_get_template( 'broadcast/emails/base', [ 'site_name' => get_network_option(null, 'site_name'), 'site_url' => get_site_url(), 'logo_url' => wu_get_network_logo(), 'content' => $content, 'subject' => __('Sample Subject', 'wp-multisite-waas'), 'is_editor' => true, 'template_settings' => [ 'use_custom_logo' => wu_string_to_bool(wu_request('use_custom_logo', $first_request ? $object->get_setting('use_custom_logo', false) : false)), 'custom_logo' => wu_request('custom_logo', $object->get_setting('custom_logo', false)), 'background_color' => wu_request('background_color', $object->get_setting('background_color', '#f9f9f9')), 'title_color' => wu_request('title_color', $object->get_setting('title_color', '#000000')), 'title_size' => wu_request('title_size', $object->get_setting('title_size', 'h3')), 'title_align' => wu_request('title_align', $object->get_setting('title_align', 'center')), 'title_font' => wu_request('title_font', $object->get_setting('title_font', 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif')), 'content_color' => wu_request('content_color', $object->get_setting('content_color', '#000000')), 'content_align' => wu_request('content_align', $object->get_setting('content_align', 'left')), 'content_font' => wu_request('content_font', $object->get_setting('content_font', 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif')), 'footer_text' => wu_request('footer_text', $object->get_setting('footer_text', '')), 'footer_font' => wu_request('footer_font', $object->get_setting('footer_font', 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif')), 'footer_color' => wu_request('footer_color', $object->get_setting('footer_color', '#000000')), 'footer_align' => wu_request('footer_align', $object->get_setting('footer_align', 'center')), 'display_company_address' => wu_string_to_bool(wu_request('display_company_address', $first_request ? $object->get_setting('display_company_address', true) : false)), ], ] ); die; } /** * Returns the preview URL. This is then added to the iframe. * * @since 2.0.0 * @return string */ public function get_preview_url() { $url = get_admin_url(wu_get_main_site_id(), 'admin-ajax.php'); return add_query_arg( [ 'action' => 'wu-email-template-preview', 'customizer' => 1, ], $url ); } /** * Allow child classes to register widgets, if they need them. * * @since 1.8.2 * @return void */ public function register_widgets(): void { $this->add_save_widget( 'save', [ 'html_attr' => [ 'data-wu-app' => 'save', 'data-state' => wu_convert_to_state(), ], 'fields' => [ 'note' => [ 'type' => 'note', 'desc' => __('System emails and broadcasts will be sent using this template.', 'wp-multisite-waas'), ], ], ] ); $settings = $this->get_attributes(); $custom_logo = wu_get_isset($settings, 'custom_logo'); $custom_logo_args = wp_get_attachment_image_src($custom_logo, 'full'); $custom_logo_url = $custom_logo_args ? $custom_logo_args[0] : ''; $fields = [ 'tab' => [ 'type' => 'tab-select', 'wrapper_classes' => '', 'wrapper_html_attr' => [ 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'tab', ], 'options' => [ 'header' => __('Header', 'wp-multisite-waas'), 'content' => __('Content', 'wp-multisite-waas'), 'footer' => __('Footer', 'wp-multisite-waas'), ], ], 'use_custom_logo' => [ 'type' => 'toggle', 'title' => __('Use Custom Logo', 'wp-multisite-waas'), 'desc' => __('You can set a different logo to be used on the system emails.', 'wp-multisite-waas'), 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'use_custom_logo', ], ], 'custom_logo' => [ 'type' => 'image', 'stacked' => true, 'title' => __('Custom Logo', 'wp-multisite-waas'), 'desc' => __('The custom logo is used in the email header, if HTML emails are used.', 'wp-multisite-waas'), 'value' => $custom_logo, 'img' => $custom_logo_url, 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header") && require("use_custom_logo", true)', 'v-cloak' => 1, ], 'html_attr' => [ // 'v-model' => 'custom_logo', ], ], 'background_color' => [ 'type' => 'color-picker', 'title' => __('Background Color', 'wp-multisite-waas'), 'tooltip' => __('The cover background color of the email.', 'wp-multisite-waas'), 'value' => '#00a1ff', 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'background_color', ], ], 'title_color' => [ 'type' => 'color-picker', 'title' => __('Title Color', 'wp-multisite-waas'), 'value' => '#00a1ff', 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'title_color', ], ], 'title_size' => [ 'type' => 'select', 'title' => __('Title Size', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'title_size'), 'options' => [ 'h1' => __('h1', 'wp-multisite-waas'), 'h2' => __('h2', 'wp-multisite-waas'), 'h3' => __('h3', 'wp-multisite-waas'), 'h4' => __('h4', 'wp-multisite-waas'), 'h5' => __('h5', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'title_size', ], ], 'title_align' => [ 'type' => 'select', 'title' => __('Title Align', 'wp-multisite-waas'), 'tooltip' => __('Aligment of the font in the title.', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'title_align', ''), 'options' => [ 'left' => __('Left', 'wp-multisite-waas'), 'center' => __('Center', 'wp-multisite-waas'), 'right' => __('Right', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'title_align', ], ], 'title_font' => [ 'type' => 'select', 'title' => __('Title Font-Family', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'title_font', ''), 'options' => [ 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif' => __('Helvetica', 'wp-multisite-waas'), 'Arial, Helvetica, sans-serif' => __('Arial', 'wp-multisite-waas'), 'Times New Roman, Times, serif' => __('Times New Roman', 'wp-multisite-waas'), 'Lucida Console, Courier, monospace' => __('Lucida', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "header")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'title_font', ], ], 'content_color' => [ 'type' => 'color-picker', 'title' => __('Content Color', 'wp-multisite-waas'), 'value' => '#000000', 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "content")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'content_color', ], ], 'content_align' => [ 'type' => 'select', 'title' => __('Content Alignment', 'wp-multisite-waas'), 'tooltip' => __('Alignment of the font in the main email content.', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'content_align', ''), 'options' => [ 'left' => __('Left', 'wp-multisite-waas'), 'center' => __('Center', 'wp-multisite-waas'), 'right' => __('Right', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "content")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'content_align', ], ], 'content_font' => [ 'type' => 'select', 'title' => __('Content Font-Family', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'content_font', ''), 'options' => [ 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif' => __('Helvetica', 'wp-multisite-waas'), 'Arial, Helvetica, sans-serif' => __('Arial', 'wp-multisite-waas'), 'Times New Roman, Times, serif' => __('Times New Roman', 'wp-multisite-waas'), 'Lucida Console, Courier, monospace' => __('Lucida', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "content")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'content_font', ], ], 'display_company_address' => [ 'type' => 'toggle', 'title' => __('Display Company Address', 'wp-multisite-waas'), 'desc' => __('Toggle to show/hide your company address.', 'wp-multisite-waas'), 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "footer")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'display_company_address', ], ], 'footer_text' => [ 'type' => 'textarea', 'title' => __('Footer Content', 'wp-multisite-waas'), 'placeholder' => __('e.g. Extra info in the email footer.', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'footer_text', ''), 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "footer")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'footer_text', ], ], 'footer_font' => [ 'type' => 'select', 'title' => __('Footer Font-Family', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'footer_font', ''), 'options' => [ 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif' => __('Helvetica', 'wp-multisite-waas'), 'Arial, Helvetica, sans-serif' => __('Arial', 'wp-multisite-waas'), 'Times New Roman, Times, serif' => __('Times New Roman', 'wp-multisite-waas'), 'Lucida Console, Courier, monospace' => __('Lucida', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "footer")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'footer_font', ], ], 'footer_color' => [ 'type' => 'color-picker', 'title' => __('Footer Color', 'wp-multisite-waas'), 'value' => '#000000', 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "footer")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model' => 'footer_color', ], ], 'footer_align' => [ 'type' => 'select', 'title' => __('Footer Alignment', 'wp-multisite-waas'), 'tooltip' => __('Alignment of the font in the main email footer.', 'wp-multisite-waas'), 'value' => wu_get_isset($settings, 'footer_align', ''), 'options' => [ 'left' => __('Left', 'wp-multisite-waas'), 'center' => __('Center', 'wp-multisite-waas'), 'right' => __('Right', 'wp-multisite-waas'), ], 'wrapper_html_attr' => [ 'v-show' => 'require("tab", "footer")', 'v-cloak' => 1, ], 'html_attr' => [ 'v-model.lazy' => 'footer_align', ], ], ]; $state = array_merge( $settings, [ 'tab' => 'header', 'refresh' => true, ] ); $this->add_fields_widget( 'customizer', [ 'title' => __('Customizer', 'wp-multisite-waas'), 'position' => 'side', 'fields' => $fields, 'html_attr' => [ 'style' => 'margin-top: -6px;', 'data-wu-app' => 'email_template_customizer', 'data-wu-customizer-panel' => true, 'data-state' => wp_json_encode($state), ], ] ); } /** * Returns the title of the page. * * @since 2.0.0 * @return string Title of the page. */ public function get_title() { return __('Customize Email Template:', '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 __('Customize Email Template', 'wp-multisite-waas'); } /** * Returns the action links for that page. * * @since 1.8.2 * @return array */ public function action_links() { return []; } /** * Returns the labels to be used on the admin page. * * @since 2.0.0 * @return array */ public function get_labels() { return [ 'customize_label' => __('Customize Email Template', 'wp-multisite-waas'), 'add_new_label' => __('Customize Email Template', 'wp-multisite-waas'), 'edit_label' => __('Edit Email Template', 'wp-multisite-waas'), 'updated_message' => __('Email Template updated with success!', 'wp-multisite-waas'), 'title_placeholder' => __('Enter Email Template Name', 'wp-multisite-waas'), 'title_description' => __('This name is used for internal reference only.', 'wp-multisite-waas'), 'save_button_label' => __('Save Template', 'wp-multisite-waas'), 'save_description' => '', 'delete_button_label' => __('Delete Email Template', 'wp-multisite-waas'), 'delete_description' => __('Be careful. This action is irreversible.', 'wp-multisite-waas'), ]; } /** * Should implement the processes necessary to save the changes made to the object. * * @since 2.0.0 * @return void */ public function handle_save(): void { $_POST['footer_text'] = stripslashes((string) $_POST['footer_text']); $_POST['footer_text'] = sanitize_text_field($_POST['footer_text']); $_POST['use_custom_logo'] = wu_request('use_custom_logo'); $_POST['display_company_address'] = wu_request('display_company_address'); $this->save_settings($_POST); $url = add_query_arg('updated', '1'); wp_safe_redirect($url); exit; } /** * Get the value of attributes. * * @since 2.0.0 * @return mixed */ public function get_attributes() { $saved_atts = static::get_settings(); $attributes = wp_parse_args($saved_atts, static::get_default_settings()); return $attributes; } /** * Gets the default email template settings. * * @since 2.0.0 * @return array */ public static function get_default_settings() { return [ 'use_custom_logo' => false, 'custom_logo' => false, 'display_company_address' => true, 'background_color' => '#f1f1f1', 'title_color' => '#000000', 'title_size' => 'h3', 'title_align' => 'center', 'title_font' => 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif', 'content_color' => '#000000', 'content_align' => 'left', 'content_font' => 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif', 'footer_font' => 'Helvetica Neue, Helvetica, Helvetica, Arial, sans-serif', 'footer_text' => '', 'footer_color' => '#000000', 'footer_align' => 'center', ]; } /** * Returns the list of saved settings to customize the email template. * * @since 2.0.0 * * @return array */ public static function get_settings() { return wu_get_option('email_template', []); } /** * Returns a specitic email template setting. * * @since 2.0.0 * * @param string $setting The setting name. * @param string $default In case there's no option. * @return string With the requested setting. */ public function get_setting($setting, $default = false) { if ($setting) { $return = wu_get_option('email_template', []); if ($return && isset($return[ $setting ])) { $return = $return[ $setting ]; } else { $return = $default; } return $return; } } /** * Save settings. * * @since 2.0.0 * * @param array $settings_to_save List of settings to save. * @return boolean */ public function save_settings($settings_to_save) { $allowed_keys = $this->get_attributes(); foreach ($settings_to_save as $setting_to_save => $value) { if ( ! array_key_exists($setting_to_save, $allowed_keys)) { unset($settings_to_save[ $setting_to_save ]); } } return wu_save_option('email_template', $settings_to_save); } }