Edit File by line
/home/zeestwma/richards.../wp-conte.../plugins/wpforms-.../src/Admin/Settings
File: Email.php
<?php
[0] Fix | Delete
[1] Fix | Delete
namespace WPForms\Admin\Settings;
[2] Fix | Delete
[3] Fix | Delete
use WPForms\Emails\Helpers;
[4] Fix | Delete
use WPForms\Emails\Notifications;
[5] Fix | Delete
use WPForms\Admin\Education\Helpers as EducationHelpers;
[6] Fix | Delete
[7] Fix | Delete
/**
[8] Fix | Delete
* Email setting page.
[9] Fix | Delete
* Settings will be accessible via “WPForms” → “Settings” → “Email”.
[10] Fix | Delete
*
[11] Fix | Delete
* @since 1.8.5
[12] Fix | Delete
*/
[13] Fix | Delete
class Email {
[14] Fix | Delete
[15] Fix | Delete
/**
[16] Fix | Delete
* Content is plain text type.
[17] Fix | Delete
*
[18] Fix | Delete
* @since 1.8.5
[19] Fix | Delete
*
[20] Fix | Delete
* @var bool
[21] Fix | Delete
*/
[22] Fix | Delete
private $plain_text;
[23] Fix | Delete
[24] Fix | Delete
/**
[25] Fix | Delete
* Temporary storage for the style overrides preferences.
[26] Fix | Delete
*
[27] Fix | Delete
* @since 1.8.6
[28] Fix | Delete
*
[29] Fix | Delete
* @var array
[30] Fix | Delete
*/
[31] Fix | Delete
private $style_overrides;
[32] Fix | Delete
[33] Fix | Delete
/**
[34] Fix | Delete
* Determines if the user has the education modal.
[35] Fix | Delete
* If true, the value will be used to add the Education modal class to the setting controls.
[36] Fix | Delete
* This is only available in the free version.
[37] Fix | Delete
*
[38] Fix | Delete
* @since 1.8.6
[39] Fix | Delete
*
[40] Fix | Delete
* @var string
[41] Fix | Delete
*/
[42] Fix | Delete
private $has_education;
[43] Fix | Delete
[44] Fix | Delete
/**
[45] Fix | Delete
* Determines if the user has the legacy template.
[46] Fix | Delete
* If true, the value will be used to add the Legacy template class to the setting controls.
[47] Fix | Delete
*
[48] Fix | Delete
* @since 1.8.6
[49] Fix | Delete
*
[50] Fix | Delete
* @var string
[51] Fix | Delete
*/
[52] Fix | Delete
private $has_legacy_template;
[53] Fix | Delete
[54] Fix | Delete
/**
[55] Fix | Delete
* Initialize class.
[56] Fix | Delete
*
[57] Fix | Delete
* @since 1.8.5
[58] Fix | Delete
*/
[59] Fix | Delete
public function init() {
[60] Fix | Delete
[61] Fix | Delete
$this->hooks();
[62] Fix | Delete
}
[63] Fix | Delete
[64] Fix | Delete
/**
[65] Fix | Delete
* Hooks.
[66] Fix | Delete
*
[67] Fix | Delete
* @since 1.8.5
[68] Fix | Delete
*/
[69] Fix | Delete
private function hooks() {
[70] Fix | Delete
[71] Fix | Delete
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_assets' ] );
[72] Fix | Delete
add_filter( 'wpforms_update_settings', [ $this, 'maybe_update_settings' ] );
[73] Fix | Delete
add_filter( 'wpforms_settings_tabs', [ $this, 'register_settings_tabs' ], 5 );
[74] Fix | Delete
add_filter( 'wpforms_settings_defaults', [ $this, 'register_settings_fields' ], 5 );
[75] Fix | Delete
}
[76] Fix | Delete
[77] Fix | Delete
/**
[78] Fix | Delete
* Enqueue scripts and styles.
[79] Fix | Delete
* Static resources are enqueued only on the "Email" settings page.
[80] Fix | Delete
*
[81] Fix | Delete
* @since 1.8.5
[82] Fix | Delete
*/
[83] Fix | Delete
public function enqueue_assets() {
[84] Fix | Delete
[85] Fix | Delete
// Leave if the current page is not the "Email" settings page.
[86] Fix | Delete
if ( ! $this->is_settings_page() ) {
[87] Fix | Delete
return;
[88] Fix | Delete
}
[89] Fix | Delete
[90] Fix | Delete
$min = wpforms_get_min_suffix();
[91] Fix | Delete
[92] Fix | Delete
wp_enqueue_script(
[93] Fix | Delete
'wpforms-contrast-checker',
[94] Fix | Delete
WPFORMS_PLUGIN_URL . "assets/js/admin/share/contrast-checker{$min}.js",
[95] Fix | Delete
[],
[96] Fix | Delete
WPFORMS_VERSION,
[97] Fix | Delete
true
[98] Fix | Delete
);
[99] Fix | Delete
[100] Fix | Delete
wp_enqueue_script(
[101] Fix | Delete
'wpforms-xor',
[102] Fix | Delete
WPFORMS_PLUGIN_URL . "assets/js/admin/share/xor{$min}.js",
[103] Fix | Delete
[],
[104] Fix | Delete
WPFORMS_VERSION,
[105] Fix | Delete
true
[106] Fix | Delete
);
[107] Fix | Delete
[108] Fix | Delete
wp_enqueue_script(
[109] Fix | Delete
'wpforms-admin-email-settings',
[110] Fix | Delete
WPFORMS_PLUGIN_URL . "assets/js/admin/email/settings{$min}.js",
[111] Fix | Delete
[ 'jquery', 'wpforms-admin', 'wp-escape-html', 'wp-url', 'choicesjs', 'wpforms-contrast-checker', 'wpforms-xor' ],
[112] Fix | Delete
WPFORMS_VERSION,
[113] Fix | Delete
true
[114] Fix | Delete
);
[115] Fix | Delete
[116] Fix | Delete
wp_localize_script(
[117] Fix | Delete
'wpforms-admin-email-settings',
[118] Fix | Delete
'wpforms_admin_email_settings',
[119] Fix | Delete
[
[120] Fix | Delete
'contrast_fail' => esc_html__( 'This color combination may be hard to read. Try increasing the contrast between the body and text colors.', 'wpforms-lite' ),
[121] Fix | Delete
]
[122] Fix | Delete
);
[123] Fix | Delete
}
[124] Fix | Delete
[125] Fix | Delete
/**
[126] Fix | Delete
* Maybe update settings.
[127] Fix | Delete
*
[128] Fix | Delete
* @since 1.8.5
[129] Fix | Delete
*
[130] Fix | Delete
* @param array $settings Admin area settings list.
[131] Fix | Delete
*
[132] Fix | Delete
* @return array
[133] Fix | Delete
*/
[134] Fix | Delete
public function maybe_update_settings( $settings ) {
[135] Fix | Delete
[136] Fix | Delete
// Leave if the current page is not the "Email" settings page.
[137] Fix | Delete
if ( ! $this->is_settings_page() ) {
[138] Fix | Delete
return $settings;
[139] Fix | Delete
}
[140] Fix | Delete
[141] Fix | Delete
// Remove the appearance mode switcher from the settings array.
[142] Fix | Delete
unset( $settings['email-appearance'] );
[143] Fix | Delete
[144] Fix | Delete
// Backup the Pro version background color setting to the free version.
[145] Fix | Delete
// This is needed to keep the background color when the Pro version is deactivated.
[146] Fix | Delete
if ( wpforms()->is_pro() && ! Helpers::is_legacy_html_template() ) {
[147] Fix | Delete
$settings['email-background-color'] = sanitize_hex_color( $settings['email-color-scheme']['email_background_color'] );
[148] Fix | Delete
$settings['email-background-color-dark'] = sanitize_hex_color( $settings['email-color-scheme-dark']['email_background_color_dark'] );
[149] Fix | Delete
[150] Fix | Delete
return $settings;
[151] Fix | Delete
}
[152] Fix | Delete
[153] Fix | Delete
// Backup the free version background color setting to the Pro version.
[154] Fix | Delete
// This is needed to keep the background color when the Pro version is activated.
[155] Fix | Delete
$settings['email-color-scheme']['email_background_color'] = sanitize_hex_color( $settings['email-background-color'] );
[156] Fix | Delete
$settings['email-color-scheme-dark']['email_background_color_dark'] = sanitize_hex_color( $settings['email-background-color-dark'] );
[157] Fix | Delete
[158] Fix | Delete
return $settings;
[159] Fix | Delete
}
[160] Fix | Delete
[161] Fix | Delete
/**
[162] Fix | Delete
* Register "Email" settings tab.
[163] Fix | Delete
*
[164] Fix | Delete
* @since 1.8.5
[165] Fix | Delete
*
[166] Fix | Delete
* @param array $tabs Admin area tabs list.
[167] Fix | Delete
*
[168] Fix | Delete
* @return array
[169] Fix | Delete
*/
[170] Fix | Delete
public function register_settings_tabs( $tabs ) {
[171] Fix | Delete
[172] Fix | Delete
$payments = [
[173] Fix | Delete
'email' => [
[174] Fix | Delete
'form' => true,
[175] Fix | Delete
'name' => esc_html__( 'Email', 'wpforms-lite' ),
[176] Fix | Delete
'submit' => esc_html__( 'Save Settings', 'wpforms-lite' ),
[177] Fix | Delete
],
[178] Fix | Delete
];
[179] Fix | Delete
[180] Fix | Delete
return wpforms_array_insert( $tabs, $payments, 'general' );
[181] Fix | Delete
}
[182] Fix | Delete
[183] Fix | Delete
/**
[184] Fix | Delete
* Register "Email" settings fields.
[185] Fix | Delete
*
[186] Fix | Delete
* @since 1.8.5
[187] Fix | Delete
*
[188] Fix | Delete
* @param array $settings Admin area settings list.
[189] Fix | Delete
*
[190] Fix | Delete
* @return array
[191] Fix | Delete
*/
[192] Fix | Delete
public function register_settings_fields( $settings ) {
[193] Fix | Delete
[194] Fix | Delete
$this->plain_text = Helpers::is_plain_text_template();
[195] Fix | Delete
$this->has_education = ! wpforms()->is_pro() ? 'education-modal' : '';
[196] Fix | Delete
$this->style_overrides = Helpers::get_current_template_style_overrides();
[197] Fix | Delete
$this->has_legacy_template = Helpers::is_legacy_html_template() ? 'legacy-template' : '';
[198] Fix | Delete
$preview_link = $this->get_current_template_preview_link();
[199] Fix | Delete
[200] Fix | Delete
// Add Email settings.
[201] Fix | Delete
$settings['email'] = [
[202] Fix | Delete
'email-heading' => [
[203] Fix | Delete
'id' => 'email-heading',
[204] Fix | Delete
'content' => $this->get_heading_content(),
[205] Fix | Delete
'type' => 'content',
[206] Fix | Delete
'no_label' => true,
[207] Fix | Delete
'class' => [ 'section-heading', 'no-desc' ],
[208] Fix | Delete
],
[209] Fix | Delete
'email-template' => [
[210] Fix | Delete
'id' => 'email-template',
[211] Fix | Delete
'name' => esc_html__( 'Template', 'wpforms-lite' ),
[212] Fix | Delete
'class' => [ 'wpforms-email-template', 'wpforms-card-image-group' ],
[213] Fix | Delete
'type' => 'email_template',
[214] Fix | Delete
'default' => Notifications::DEFAULT_TEMPLATE,
[215] Fix | Delete
'options' => Helpers::get_email_template_choices(),
[216] Fix | Delete
'value' => Helpers::get_current_template_name(),
[217] Fix | Delete
],
[218] Fix | Delete
// The reason that we're using the 'content' type is to avoid saving the value in the option storage.
[219] Fix | Delete
// The value is used only for the appearance mode switcher, and merely acts as a switch between dark and light mode controls.
[220] Fix | Delete
'email-appearance' => [
[221] Fix | Delete
'id' => 'email-appearance',
[222] Fix | Delete
'name' => esc_html__( 'Appearance', 'wpforms-lite' ),
[223] Fix | Delete
'desc' => esc_html__( 'Modern email clients support viewing emails in light and dark modes. You can upload a header image and customize the style for each appearance mode independently to ensure an optimal reading experience.', 'wpforms-lite' ),
[224] Fix | Delete
'type' => 'radio',
[225] Fix | Delete
'class' => [ 'wpforms-setting-row-radio', 'hide-for-template-none', 'email-appearance-mode-toggle', $this->has_legacy_template ],
[226] Fix | Delete
'default' => 'light',
[227] Fix | Delete
'is_hidden' => $this->plain_text,
[228] Fix | Delete
'options' => [
[229] Fix | Delete
'light' => esc_html__( 'Light', 'wpforms-lite' ),
[230] Fix | Delete
'dark' => esc_html__( 'Dark', 'wpforms-lite' ),
[231] Fix | Delete
],
[232] Fix | Delete
],
[233] Fix | Delete
'email-preview' => [
[234] Fix | Delete
'id' => 'email-preview',
[235] Fix | Delete
'type' => 'content',
[236] Fix | Delete
'is_hidden' => empty( $preview_link ),
[237] Fix | Delete
'content' => $preview_link,
[238] Fix | Delete
],
[239] Fix | Delete
'sending-heading' => [
[240] Fix | Delete
'id' => 'sending-heading',
[241] Fix | Delete
'content' => '<h4>' . esc_html__( 'Sending', 'wpforms-lite' ) . '</h4>',
[242] Fix | Delete
'type' => 'content',
[243] Fix | Delete
'no_label' => true,
[244] Fix | Delete
'class' => [ 'section-heading', 'no-desc' ],
[245] Fix | Delete
],
[246] Fix | Delete
'email-async' => [
[247] Fix | Delete
'id' => 'email-async',
[248] Fix | Delete
'name' => esc_html__( 'Optimize Email Sending', 'wpforms-lite' ),
[249] Fix | Delete
'desc' => sprintf(
[250] Fix | Delete
wp_kses( /* translators: %1$s - WPForms.com Email settings documentation URL. */
[251] Fix | Delete
__( 'Send emails asynchronously, which can make processing faster but may delay email delivery by a minute or two. <a href="%1$s" target="_blank" rel="noopener noreferrer" class="wpforms-learn-more">Learn More</a>', 'wpforms-lite' ),
[252] Fix | Delete
[
[253] Fix | Delete
'a' => [
[254] Fix | Delete
'href' => [],
[255] Fix | Delete
'target' => [],
[256] Fix | Delete
'rel' => [],
[257] Fix | Delete
'class' => [],
[258] Fix | Delete
],
[259] Fix | Delete
]
[260] Fix | Delete
),
[261] Fix | Delete
esc_url( wpforms_utm_link( 'https://wpforms.com/docs/a-complete-guide-to-wpforms-settings/#email', 'Settings - Email', 'Optimize Email Sending Documentation' ) )
[262] Fix | Delete
),
[263] Fix | Delete
'type' => 'toggle',
[264] Fix | Delete
'status' => true,
[265] Fix | Delete
],
[266] Fix | Delete
'email-carbon-copy' => [
[267] Fix | Delete
'id' => 'email-carbon-copy',
[268] Fix | Delete
'name' => esc_html__( 'Carbon Copy', 'wpforms-lite' ),
[269] Fix | Delete
'desc' => esc_html__( 'Enable the ability to CC: email addresses in the form notification settings.', 'wpforms-lite' ),
[270] Fix | Delete
'type' => 'toggle',
[271] Fix | Delete
'status' => true,
[272] Fix | Delete
],
[273] Fix | Delete
];
[274] Fix | Delete
[275] Fix | Delete
// Add the style controls.
[276] Fix | Delete
$settings['email'] = $this->add_appearance_controls( $settings['email'] );
[277] Fix | Delete
[278] Fix | Delete
// Maybe add the Legacy template notice.
[279] Fix | Delete
$settings['email'] = $this->maybe_add_legacy_notice( $settings['email'] );
[280] Fix | Delete
[281] Fix | Delete
return $settings;
[282] Fix | Delete
}
[283] Fix | Delete
[284] Fix | Delete
/**
[285] Fix | Delete
* Maybe add the legacy template notice.
[286] Fix | Delete
*
[287] Fix | Delete
* @since 1.8.5
[288] Fix | Delete
*
[289] Fix | Delete
* @param array $settings Email settings.
[290] Fix | Delete
*
[291] Fix | Delete
* @return array
[292] Fix | Delete
*/
[293] Fix | Delete
private function maybe_add_legacy_notice( $settings ) {
[294] Fix | Delete
[295] Fix | Delete
if ( ! $this->is_settings_page() || ! Helpers::is_legacy_html_template() ) {
[296] Fix | Delete
return $settings;
[297] Fix | Delete
}
[298] Fix | Delete
[299] Fix | Delete
$content = '<div class="notice-info"><p>';
[300] Fix | Delete
$content .= sprintf(
[301] Fix | Delete
wp_kses( /* translators: %1$s - WPForms.com Email settings legacy template documentation URL. */
[302] Fix | Delete
__( 'Some style settings are not available when using the Legacy template. <a href="%1$s" target="_blank" rel="noopener noreferrer">Learn More</a>', 'wpforms-lite' ),
[303] Fix | Delete
[
[304] Fix | Delete
'a' => [
[305] Fix | Delete
'href' => [],
[306] Fix | Delete
'target' => [],
[307] Fix | Delete
'rel' => [],
[308] Fix | Delete
],
[309] Fix | Delete
]
[310] Fix | Delete
),
[311] Fix | Delete
esc_url( wpforms_utm_link( 'https://wpforms.com/docs/customizing-form-notification-emails/#legacy-template', 'Settings - Email', 'Legacy Template' ) )
[312] Fix | Delete
);
[313] Fix | Delete
$content .= '</p></div>';
[314] Fix | Delete
[315] Fix | Delete
// Add the background color control after the header image.
[316] Fix | Delete
return wpforms_array_insert(
[317] Fix | Delete
$settings,
[318] Fix | Delete
[
[319] Fix | Delete
'email-legacy-notice' => [
[320] Fix | Delete
'id' => 'email-legacy-notice',
[321] Fix | Delete
'content' => $content,
[322] Fix | Delete
'type' => 'content',
[323] Fix | Delete
'class' => 'wpforms-email-legacy-notice',
[324] Fix | Delete
],
[325] Fix | Delete
],
[326] Fix | Delete
'email-template'
[327] Fix | Delete
);
[328] Fix | Delete
}
[329] Fix | Delete
[330] Fix | Delete
/**
[331] Fix | Delete
* Add appearance controls.
[332] Fix | Delete
* This will include controls for both Light and Dark modes.
[333] Fix | Delete
*
[334] Fix | Delete
* @since 1.8.6
[335] Fix | Delete
*
[336] Fix | Delete
* @param array $settings Email settings.
[337] Fix | Delete
*
[338] Fix | Delete
* @return array
[339] Fix | Delete
*/
[340] Fix | Delete
private function add_appearance_controls( $settings ) {
[341] Fix | Delete
[342] Fix | Delete
// Education modal arguments.
[343] Fix | Delete
$education_args = [ 'action' => 'upgrade' ];
[344] Fix | Delete
[345] Fix | Delete
// New settings for the Light mode.
[346] Fix | Delete
$new_setting = [
[347] Fix | Delete
'email-header-image' => [
[348] Fix | Delete
'id' => 'email-header-image',
[349] Fix | Delete
'name' => esc_html__( 'Header Image', 'wpforms-lite' ),
[350] Fix | Delete
'desc' => esc_html__( 'Upload or choose a logo to be displayed at the top of email notifications.', 'wpforms-lite' ),
[351] Fix | Delete
'class' => [ 'wpforms-email-header-image', 'hide-for-template-none', 'has-preview-changes', 'email-light-mode', $this->get_external_header_image_class() ],
[352] Fix | Delete
'type' => 'image',
[353] Fix | Delete
'is_hidden' => $this->plain_text,
[354] Fix | Delete
'show_remove' => true,
[355] Fix | Delete
],
[356] Fix | Delete
'email-header-image-size' => [
[357] Fix | Delete
'id' => 'email-header-image-size',
[358] Fix | Delete
'no_label' => true,
[359] Fix | Delete
'type' => 'select',
[360] Fix | Delete
'class' => [ 'wpforms-email-header-image-size', 'has-preview-changes', 'email-light-mode' ],
[361] Fix | Delete
'is_hidden' => true,
[362] Fix | Delete
'choicesjs' => false,
[363] Fix | Delete
'default' => 'medium',
[364] Fix | Delete
'options' => [
[365] Fix | Delete
'small' => esc_html__( 'Small', 'wpforms-lite' ),
[366] Fix | Delete
'medium' => esc_html__( 'Medium', 'wpforms-lite' ),
[367] Fix | Delete
'large' => esc_html__( 'Large', 'wpforms-lite' ),
[368] Fix | Delete
],
[369] Fix | Delete
],
[370] Fix | Delete
'email-color-scheme' => [
[371] Fix | Delete
'id' => 'email-color-scheme',
[372] Fix | Delete
'name' => esc_html__( 'Color Scheme', 'wpforms-lite' ),
[373] Fix | Delete
'class' => [ 'email-color-scheme', 'hide-for-template-none', 'has-preview-changes', 'email-light-mode', $this->has_education, $this->has_legacy_template ],
[374] Fix | Delete
'type' => 'color_scheme',
[375] Fix | Delete
'is_hidden' => $this->plain_text,
[376] Fix | Delete
'education_badge' => $this->get_pro_education_badge(),
[377] Fix | Delete
'data_attributes' => $this->has_education ? array_merge( [ 'name' => esc_html__( 'Color Scheme', 'wpforms-lite' ) ], $education_args ) : [],
[378] Fix | Delete
'colors' => $this->get_color_scheme_controls(),
[379] Fix | Delete
],
[380] Fix | Delete
'email-typography' => [
[381] Fix | Delete
'id' => 'email-typography',
[382] Fix | Delete
'name' => esc_html__( 'Typography', 'wpforms-lite' ),
[383] Fix | Delete
'desc' => esc_html__( 'Choose the style that’s applied to all text in email notifications.', 'wpforms-lite' ),
[384] Fix | Delete
'class' => [ 'hide-for-template-none', 'has-preview-changes', 'email-typography', 'email-light-mode', $this->has_education, $this->has_legacy_template ],
[385] Fix | Delete
'education_badge' => $this->get_pro_education_badge(),
[386] Fix | Delete
'data_attributes' => $this->has_education ? array_merge( [ 'name' => esc_html__( 'Typography', 'wpforms-lite' ) ], $education_args ) : [],
[387] Fix | Delete
'type' => 'select',
[388] Fix | Delete
'is_hidden' => $this->plain_text,
[389] Fix | Delete
'choicesjs' => true,
[390] Fix | Delete
'default' => 'sans-serif',
[391] Fix | Delete
'options' => [
[392] Fix | Delete
'sans-serif' => esc_html__( 'Sans Serif', 'wpforms-lite' ),
[393] Fix | Delete
'serif' => esc_html__( 'Serif', 'wpforms-lite' ),
[394] Fix | Delete
],
[395] Fix | Delete
],
[396] Fix | Delete
];
[397] Fix | Delete
[398] Fix | Delete
// Add background color control if the Pro version is not active or Legacy template is selected.
[399] Fix | Delete
$new_setting = $this->maybe_add_background_color_control( $new_setting );
[400] Fix | Delete
[401] Fix | Delete
return wpforms_array_insert(
[402] Fix | Delete
$settings,
[403] Fix | Delete
$this->add_appearance_dark_mode_controls( $new_setting ),
[404] Fix | Delete
'email-appearance'
[405] Fix | Delete
);
[406] Fix | Delete
}
[407] Fix | Delete
[408] Fix | Delete
/**
[409] Fix | Delete
* Add appearance dark mode controls.
[410] Fix | Delete
*
[411] Fix | Delete
* This function will duplicate the default "Light" color
[412] Fix | Delete
* controls to create corresponding controls for dark mode.
[413] Fix | Delete
*
[414] Fix | Delete
* @since 1.8.6
[415] Fix | Delete
*
[416] Fix | Delete
* @param array $settings Email settings.
[417] Fix | Delete
*
[418] Fix | Delete
* @return array
[419] Fix | Delete
*/
[420] Fix | Delete
private function add_appearance_dark_mode_controls( $settings ) {
[421] Fix | Delete
[422] Fix | Delete
// Duplicate and modify each item for dark mode.
[423] Fix | Delete
foreach ( $settings as $key => $item ) {
[424] Fix | Delete
// Duplicate the item with '-dark' added to the key.
[425] Fix | Delete
$dark_key = "{$key}-dark";
[426] Fix | Delete
$settings[ $dark_key ] = $item;
[427] Fix | Delete
[428] Fix | Delete
// Modify the 'name' within the duplicated item.
[429] Fix | Delete
if ( isset( $settings[ $dark_key ]['id'] ) ) {
[430] Fix | Delete
$settings[ $dark_key ]['id'] .= '-dark';
[431] Fix | Delete
$classes = &$settings[ $dark_key ]['class'];
[432] Fix | Delete
$classes[] = 'email-dark-mode';
[433] Fix | Delete
$classes[] = 'wpforms-hide';
[434] Fix | Delete
[435] Fix | Delete
// Remove classes related to light mode.
[436] Fix | Delete
$classes = array_filter(
[437] Fix | Delete
$classes,
[438] Fix | Delete
static function ( $class_name ) {
[439] Fix | Delete
[440] Fix | Delete
return $class_name !== 'email-light-mode' && $class_name !== 'has-external-image-url';
[441] Fix | Delete
}
[442] Fix | Delete
);
[443] Fix | Delete
}
[444] Fix | Delete
[445] Fix | Delete
// Override the description for the header image control.
[446] Fix | Delete
if ( $key === 'email-header-image' ) {
[447] Fix | Delete
$settings[ $dark_key ]['desc'] = esc_html__( 'Upload or choose a logo to be displayed at the top of email notifications. Light mode image will be used if not set.', 'wpforms-lite' );
[448] Fix | Delete
}
[449] Fix | Delete
[450] Fix | Delete
// Override the background color control attributes.
[451] Fix | Delete
if ( $key === 'email-background-color' ) {
[452] Fix | Delete
$settings[ $dark_key ]['default'] = sanitize_hex_color( $this->style_overrides['email_background_color_dark'] );
[453] Fix | Delete
$settings[ $dark_key ]['data']['fallback-color'] = sanitize_hex_color( $this->style_overrides['email_background_color_dark'] );
[454] Fix | Delete
}
[455] Fix | Delete
[456] Fix | Delete
// Override the color scheme control attributes.
[457] Fix | Delete
if ( $key === 'email-color-scheme' ) {
[458] Fix | Delete
$settings[ $dark_key ]['colors'] = $this->get_color_scheme_controls( true );
[459] Fix | Delete
}
[460] Fix | Delete
}
[461] Fix | Delete
[462] Fix | Delete
return $settings;
[463] Fix | Delete
}
[464] Fix | Delete
[465] Fix | Delete
/**
[466] Fix | Delete
* Get Email settings heading content.
[467] Fix | Delete
*
[468] Fix | Delete
* @since 1.8.5
[469] Fix | Delete
*
[470] Fix | Delete
* @return string
[471] Fix | Delete
*/
[472] Fix | Delete
private function get_heading_content() {
[473] Fix | Delete
[474] Fix | Delete
return wpforms_render( 'admin/settings/email-heading' );
[475] Fix | Delete
}
[476] Fix | Delete
[477] Fix | Delete
/**
[478] Fix | Delete
* Get Email settings education badge.
[479] Fix | Delete
* This is only available in the free version.
[480] Fix | Delete
*
[481] Fix | Delete
* @since 1.8.6
[482] Fix | Delete
*
[483] Fix | Delete
* @return string
[484] Fix | Delete
*/
[485] Fix | Delete
private function get_pro_education_badge() {
[486] Fix | Delete
[487] Fix | Delete
// Leave early if the user has the Lite version.
[488] Fix | Delete
if ( empty( $this->has_education ) ) {
[489] Fix | Delete
return '';
[490] Fix | Delete
}
[491] Fix | Delete
[492] Fix | Delete
// Output the education badge.
[493] Fix | Delete
return EducationHelpers::get_badge( 'Pro' );
[494] Fix | Delete
}
[495] Fix | Delete
[496] Fix | Delete
/**
[497] Fix | Delete
* Generate color scheme controls for the color picker.
[498] Fix | Delete
*
[499] Fix | Delete
12
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
Function