' . $default_colors['base'] . '' ),
'id' => 'woocommerce_email_base_color',
'type' => 'color',
'css' => 'width:6em;',
'default' => $default_colors['base'],
'autoload' => false,
'desc_tip' => true,
),
array(
'title' => __( 'Email background', 'woocommerce' ),
/* translators: %s: default color */
'desc' => sprintf( __( 'Select a color for the background of your emails. Default %s.', 'woocommerce' ), '' . $default_colors['bg'] . '' ),
'id' => 'woocommerce_email_background_color',
'type' => 'color',
'css' => 'width:6em;',
'default' => $default_colors['bg'],
'autoload' => false,
'desc_tip' => true,
),
array(
'title' => __( 'Content background', 'woocommerce' ),
/* translators: %s: default color */
'desc' => sprintf( __( 'Choose a background color for the content area of your emails. Default %s.', 'woocommerce' ), '' . $default_colors['body_bg'] . '' ),
'id' => 'woocommerce_email_body_background_color',
'type' => 'color',
'css' => 'width:6em;',
'default' => $default_colors['body_bg'],
'autoload' => false,
'desc_tip' => true,
),
array(
'title' => __( 'Heading & text', 'woocommerce' ),
/* translators: %s: default color */
'desc' => sprintf( __( 'Set the color of your headings and text. Default %s.', 'woocommerce' ), '' . $default_colors['body_text'] . '' ),
'id' => 'woocommerce_email_text_color',
'type' => 'color',
'css' => 'width:6em;',
'default' => $default_colors['body_text'],
'autoload' => false,
'desc_tip' => true,
),
array(
'title' => __( 'Secondary text', 'woocommerce' ),
/* translators: %s: footer default color */
'desc' => sprintf( __( 'Choose a color for your secondary text, such as your footer content. Default %s.', 'woocommerce' ), '' . $default_colors['footer_text'] . '' ),
'id' => 'woocommerce_email_footer_text_color',
'type' => 'color',
'css' => 'width:6em;',
'default' => $default_colors['footer_text'],
'autoload' => false,
'desc_tip' => true,
),
array(
'title' => __( 'Auto-sync with theme', 'woocommerce' ),
'desc' => __( 'Automatically update email styles when theme styles change', 'woocommerce' ),
'id' => 'woocommerce_email_auto_sync_with_theme',
'type' => 'hidden',
'default' => 'no',
'autoload' => false,
),
array(
'type' => 'sectionend',
'id' => 'email_color_palette',
),
array(
'title' => __( 'Email improvements button', 'woocommerce' ),
'type' => 'email_improvements_button',
'id' => 'email_improvements_button',
),
array( 'type' => 'email_preview' ),
)
);
}
// Remove empty elements that depend on the email_improvements feature flag.
$settings = array_filter( $settings );
/**
* Filters the email settings array.
*
* @since 2.1.0
*
* @param array $settings Array of email settings.
*/
return apply_filters( 'woocommerce_email_settings', $settings );
}
/**
* Get custom fonts for emails.
*/
public function get_custom_fonts() {
$custom_fonts = array();
if ( wp_is_block_theme() && class_exists( 'WP_Font_Face_Resolver' ) ) {
$theme_fonts = WP_Font_Face_Resolver::get_fonts_from_theme_json();
if ( count( $theme_fonts ) > 0 ) {
foreach ( $theme_fonts as $font ) {
if ( ! empty( $font[0]['font-family'] ) ) {
$custom_fonts[ $font[0]['font-family'] ] = $font[0]['font-family'];
}
}
}
}
ksort( $custom_fonts );
return $custom_fonts;
}
/**
* Output the settings.
*/
public function output() {
global $current_section;
// Define emails that can be customised here.
$mailer = WC()->mailer();
$email_templates = $mailer->get_emails();
if ( $current_section ) {
foreach ( $email_templates as $email_key => $email ) {
if ( strtolower( $email_key ) === $current_section ) {
$this->run_email_admin_options( $email );
break;
}
}
}
parent::output();
}
/**
* Run the 'admin_options' method on a given email.
* This method exists to easy unit testing.
*
* @param object $email The email object to run the method on.
*/
protected function run_email_admin_options( $email ) {
$email->admin_options();
}
/**
* Save settings.
*/
public function save() {
global $current_section;
if ( ! $current_section ) {
$this->save_settings_for_current_section();
$this->do_update_options_action();
} else {
$wc_emails = WC_Emails::instance();
if ( in_array( $current_section, array_map( 'sanitize_title', array_keys( $wc_emails->get_emails() ) ), true ) ) {
foreach ( $wc_emails->get_emails() as $email_id => $email ) {
if ( sanitize_title( $email_id ) === $current_section ) {
$this->do_update_options_action( $email->id );
}
}
} else {
$this->save_settings_for_current_section();
$this->do_update_options_action();
}
}
}
/**
* Output email notification settings.
*/
public function email_notification_setting() {
// Define emails that can be customised here.
$mailer = WC()->mailer();
$email_templates = $mailer->get_emails();
?>
| ' . esc_html( $column ) . ' | '; } ?>||||
|---|---|---|---|---|
| ' . esc_html( $email->get_title() ) . ' ' . wc_help_tip( $email->get_description() ) . ' | '; break; case 'recipient': $to = $email->is_customer_email() ? __( 'Customer', 'woocommerce' ) : $email->get_recipient(); $cc = false; $bcc = false; if ( FeaturesUtil::feature_is_enabled( 'email_improvements' ) ) { $ccs = $email->get_cc_recipient(); $bccs = $email->get_bcc_recipient(); // Translators: %s: comma-separated email addresses to which the email is cc-ed. $cc = $ccs ? sprintf( __( 'Cc: %s', 'woocommerce' ), $ccs ) : false; // Translators: %s: comma-separated email addresses to which the email is bcc-ed. $bcc = $bccs ? sprintf( __( 'Bcc: %s', 'woocommerce' ), $bccs ) : false; if ( $cc || $bcc ) { // Translators: %s: comma-separated email addresses to which the email is sent. $to = sprintf( __( 'To: %s', 'woocommerce' ), $to ); } } $allowed_tags = array( 'b' => array() ); echo '';
echo wp_kses( $to, $allowed_tags );
if ( $cc ) {
echo ' ' . wp_kses( $cc, $allowed_tags ); } if ( $bcc ) { echo ' ' . wp_kses( $bcc, $allowed_tags ); } echo ' | ';
break;
case 'status':
echo ''; if ( $email->is_manual() ) { echo '' . esc_html__( 'Manual', 'woocommerce' ) . ''; } elseif ( $email->is_enabled() ) { echo '' . esc_html__( 'Yes', 'woocommerce' ) . ''; } else { echo '-'; } echo ' | '; break; case 'email_type': echo '' . esc_html( $email->get_content_type() ) . ' | '; break; case 'actions': echo '' . esc_html__( 'Manage', 'woocommerce' ) . ' | '; break; default: /** * Fires when rendering a custom column in the email settings table. * * @since 2.1.0 * * @param WC_Email $email The email object. */ do_action( 'woocommerce_email_setting_column_' . $key, $email ); break; } } echo '