| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334 |
- <?php
- /**
- * WooCommerce Email Settings
- *
- * @package WooCommerce/Admin
- * @version 2.1.0
- */
- defined( 'ABSPATH' ) || exit;
- if ( class_exists( 'WC_Settings_Emails', false ) ) {
- return new WC_Settings_Emails();
- }
- /**
- * WC_Settings_Emails.
- */
- class WC_Settings_Emails extends WC_Settings_Page {
- /**
- * Constructor.
- */
- public function __construct() {
- $this->id = 'email';
- $this->label = __( 'Emails', 'woocommerce' );
- add_action( 'woocommerce_admin_field_email_notification', array( $this, 'email_notification_setting' ) );
- parent::__construct();
- }
- /**
- * Get sections.
- *
- * @return array
- */
- public function get_sections() {
- $sections = array(
- '' => __( 'Email options', 'woocommerce' ),
- );
- return apply_filters( 'woocommerce_get_sections_' . $this->id, $sections );
- }
- /**
- * Get settings array.
- *
- * @return array
- */
- public function get_settings() {
- $settings = apply_filters(
- 'woocommerce_email_settings', array(
- array(
- 'title' => __( 'Email notifications', 'woocommerce' ),
- 'desc' => __( 'Email notifications sent from WooCommerce are listed below. Click on an email to configure it.', 'woocommerce' ),
- 'type' => 'title',
- 'id' => 'email_notification_settings',
- ),
- array( 'type' => 'email_notification' ),
- array(
- 'type' => 'sectionend',
- 'id' => 'email_notification_settings',
- ),
- array(
- 'type' => 'sectionend',
- 'id' => 'email_recipient_options',
- ),
- array(
- 'title' => __( 'Email sender options', 'woocommerce' ),
- 'type' => 'title',
- 'desc' => '',
- 'id' => 'email_options',
- ),
- array(
- 'title' => __( '"From" name', 'woocommerce' ),
- 'desc' => __( 'How the sender name appears in outgoing WooCommerce emails.', 'woocommerce' ),
- 'id' => 'woocommerce_email_from_name',
- 'type' => 'text',
- 'css' => 'min-width:300px;',
- 'default' => esc_attr( get_bloginfo( 'name', 'display' ) ),
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( '"From" address', 'woocommerce' ),
- 'desc' => __( 'How the sender email appears in outgoing WooCommerce emails.', 'woocommerce' ),
- 'id' => 'woocommerce_email_from_address',
- 'type' => 'email',
- 'custom_attributes' => array(
- 'multiple' => 'multiple',
- ),
- 'css' => 'min-width:300px;',
- 'default' => get_option( 'admin_email' ),
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'type' => 'sectionend',
- 'id' => 'email_options',
- ),
- array(
- 'title' => __( 'Email template', 'woocommerce' ),
- 'type' => 'title',
- 'desc' => sprintf( __( 'This section lets you customize the WooCommerce emails. <a href="%s" target="_blank">Click here to preview your email template</a>.', 'woocommerce' ), wp_nonce_url( admin_url( '?preview_woocommerce_mail=true' ), 'preview-mail' ) ),
- 'id' => 'email_template_options',
- ),
- array(
- 'title' => __( 'Header image', 'woocommerce' ),
- 'desc' => __( 'URL to an image you want to show in the email header. Upload images using the media uploader (Admin > Media).', 'woocommerce' ),
- 'id' => 'woocommerce_email_header_image',
- 'type' => 'text',
- 'css' => 'min-width:300px;',
- 'placeholder' => __( 'N/A', 'woocommerce' ),
- 'default' => '',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( 'Footer text', 'woocommerce' ),
- 'desc' => __( 'The text to appear in the footer of WooCommerce emails.', 'woocommerce' ) . ' ' . sprintf( __( 'Available placeholders: %s', 'woocommerce' ), '{site_title}' ),
- 'id' => 'woocommerce_email_footer_text',
- 'css' => 'width:300px; height: 75px;',
- 'placeholder' => __( 'N/A', 'woocommerce' ),
- 'type' => 'textarea',
- 'default' => '{site_title}',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( 'Base color', 'woocommerce' ),
- /* translators: %s: default color */
- 'desc' => sprintf( __( 'The base color for WooCommerce email templates. Default %s.', 'woocommerce' ), '<code>#96588a</code>' ),
- 'id' => 'woocommerce_email_base_color',
- 'type' => 'color',
- 'css' => 'width:6em;',
- 'default' => '#96588a',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( 'Background color', 'woocommerce' ),
- /* translators: %s: default color */
- 'desc' => sprintf( __( 'The background color for WooCommerce email templates. Default %s.', 'woocommerce' ), '<code>#f7f7f7</code>' ),
- 'id' => 'woocommerce_email_background_color',
- 'type' => 'color',
- 'css' => 'width:6em;',
- 'default' => '#f7f7f7',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( 'Body background color', 'woocommerce' ),
- /* translators: %s: default color */
- 'desc' => sprintf( __( 'The main body background color. Default %s.', 'woocommerce' ), '<code>#ffffff</code>' ),
- 'id' => 'woocommerce_email_body_background_color',
- 'type' => 'color',
- 'css' => 'width:6em;',
- 'default' => '#ffffff',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'title' => __( 'Body text color', 'woocommerce' ),
- /* translators: %s: default color */
- 'desc' => sprintf( __( 'The main body text color. Default %s.', 'woocommerce' ), '<code>#3c3c3c</code>' ),
- 'id' => 'woocommerce_email_text_color',
- 'type' => 'color',
- 'css' => 'width:6em;',
- 'default' => '#3c3c3c',
- 'autoload' => false,
- 'desc_tip' => true,
- ),
- array(
- 'type' => 'sectionend',
- 'id' => 'email_template_options',
- ),
- )
- );
- return apply_filters( 'woocommerce_get_settings_' . $this->id, $settings );
- }
- /**
- * 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 ) {
- $email->admin_options();
- break;
- }
- }
- } else {
- $settings = $this->get_settings();
- WC_Admin_Settings::output_fields( $settings );
- }
- }
- /**
- * Save settings.
- */
- public function save() {
- global $current_section;
- if ( ! $current_section ) {
- WC_Admin_Settings::save_fields( $this->get_settings() );
- } 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 ) {
- do_action( 'woocommerce_update_options_' . $this->id . '_' . $email->id );
- }
- }
- } else {
- do_action( 'woocommerce_update_options_' . $this->id . '_' . $current_section );
- }
- }
- }
- /**
- * Output email notification settings.
- */
- public function email_notification_setting() {
- // Define emails that can be customised here.
- $mailer = WC()->mailer();
- $email_templates = $mailer->get_emails();
- ?>
- <tr valign="top">
- <td class="wc_emails_wrapper" colspan="2">
- <table class="wc_emails widefat" cellspacing="0">
- <thead>
- <tr>
- <?php
- $columns = apply_filters(
- 'woocommerce_email_setting_columns', array(
- 'status' => '',
- 'name' => __( 'Email', 'woocommerce' ),
- 'email_type' => __( 'Content type', 'woocommerce' ),
- 'recipient' => __( 'Recipient(s)', 'woocommerce' ),
- 'actions' => '',
- )
- );
- foreach ( $columns as $key => $column ) {
- echo '<th class="wc-email-settings-table-' . esc_attr( $key ) . '">' . esc_html( $column ) . '</th>';
- }
- ?>
- </tr>
- </thead>
- <tbody>
- <?php
- foreach ( $email_templates as $email_key => $email ) {
- echo '<tr>';
- foreach ( $columns as $key => $column ) {
- switch ( $key ) {
- case 'name':
- echo '<td class="wc-email-settings-table-' . esc_attr( $key ) . '">
- <a href="' . admin_url( 'admin.php?page=wc-settings&tab=email§ion=' . strtolower( $email_key ) ) . '">' . $email->get_title() . '</a>
- ' . wc_help_tip( $email->get_description() ) . '
- </td>';
- break;
- case 'recipient':
- echo '<td class="wc-email-settings-table-' . esc_attr( $key ) . '">
- ' . esc_html( $email->is_customer_email() ? __( 'Customer', 'woocommerce' ) : $email->get_recipient() ) . '
- </td>';
- break;
- case 'status':
- echo '<td class="wc-email-settings-table-' . esc_attr( $key ) . '">';
- if ( $email->is_manual() ) {
- echo '<span class="status-manual tips" data-tip="' . esc_attr__( 'Manually sent', 'woocommerce' ) . '">' . esc_html__( 'Manual', 'woocommerce' ) . '</span>';
- } elseif ( $email->is_enabled() ) {
- echo '<span class="status-enabled tips" data-tip="' . esc_attr__( 'Enabled', 'woocommerce' ) . '">' . esc_html__( 'Yes', 'woocommerce' ) . '</span>';
- } else {
- echo '<span class="status-disabled tips" data-tip="' . esc_attr__( 'Disabled', 'woocommerce' ) . '">-</span>';
- }
- echo '</td>';
- break;
- case 'email_type':
- echo '<td class="wc-email-settings-table-' . esc_attr( $key ) . '">
- ' . esc_html( $email->get_content_type() ) . '
- </td>';
- break;
- case 'actions':
- echo '<td class="wc-email-settings-table-' . esc_attr( $key ) . '">
- <a class="button alignright" href="' . admin_url( 'admin.php?page=wc-settings&tab=email§ion=' . strtolower( $email_key ) ) . '">' . esc_html__( 'Manage', 'woocommerce' ) . '</a>
- </td>';
- break;
- default:
- do_action( 'woocommerce_email_setting_column_' . $key, $email );
- break;
- }
- }
- echo '</tr>';
- }
- ?>
- </tbody>
- </table>
- </td>
- </tr>
- <?php
- }
- }
- return new WC_Settings_Emails();
|