', // Greater-than '<', // Less-than '&', // Ampersand '&', // Ampersand '&', // Ampersand '(c)', // Copyright '(tm)', // Trademark '(R)', // Registered '--', // mdash '-', // ndash '*', // Bullet '£', // Pound sign 'EUR', // Euro sign. € ? '$', // Dollar sign '', // Unknown/unhandled entities ' ' // Runs of spaces, post-handling ); /** * Constructor. */ public function __construct() { // Init settings $this->init_form_fields(); $this->init_settings(); // Save settings hook add_action( 'woocommerce_update_options_email_' . $this->id, array( $this, 'process_admin_options' ) ); // Default template base if not declared in child constructor if ( is_null( $this->template_base ) ) { $this->template_base = WC()->plugin_path() . '/templates/'; } // Settings $this->heading = $this->get_option( 'heading', $this->heading ); $this->subject = $this->get_option( 'subject', $this->subject ); $this->email_type = $this->get_option( 'email_type' ); $this->enabled = $this->get_option( 'enabled' ); // Find/replace $this->find['blogname'] = '{blogname}'; $this->find['site-title'] = '{site_title}'; $this->replace['blogname'] = $this->get_blogname(); $this->replace['site-title'] = $this->get_blogname(); // For multipart messages add_filter( 'phpmailer_init', array( $this, 'handle_multipart' ) ); } /** * handle_multipart function. * * @param PHPMailer $mailer * @return PHPMailer */ public function handle_multipart( $mailer ) { if ( $this->sending && 'multipart' === $this->get_email_type() ) { $mailer->AltBody = wordwrap( preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ) ); $this->sending = false; } return $mailer; } /** * format_string function. * * @param mixed $string * @return string */ public function format_string( $string ) { return str_replace( apply_filters( 'woocommerce_email_format_string_find', $this->find, $this ), apply_filters( 'woocommerce_email_format_string_replace', $this->replace, $this ), $string ); } /** * get_subject function. * * @return string */ public function get_subject() { return apply_filters( 'woocommerce_email_subject_' . $this->id, $this->format_string( $this->subject ), $this->object ); } /** * get_heading function. * * @return string */ public function get_heading() { return apply_filters( 'woocommerce_email_heading_' . $this->id, $this->format_string( $this->heading ), $this->object ); } /** * Get valid recipients. * @return string */ public function get_recipient() { $recipient = apply_filters( 'woocommerce_email_recipient_' . $this->id, $this->recipient, $this->object ); $recipients = array_map( 'trim', explode( ',', $recipient ) ); $recipients = array_filter( $recipients, 'is_email' ); return implode( ', ', $recipients ); } /** * get_headers function. * * @return string */ public function get_headers() { return apply_filters( 'woocommerce_email_headers', "Content-Type: " . $this->get_content_type() . "\r\n", $this->id, $this->object ); } /** * get_attachments function. * * @return string|array */ public function get_attachments() { return apply_filters( 'woocommerce_email_attachments', array(), $this->id, $this->object ); } /** * get_type function. * * @return string */ public function get_email_type() { return $this->email_type && class_exists( 'DOMDocument' ) ? $this->email_type : 'plain'; } /** * get_content_type function. * * @return string */ public function get_content_type() { switch ( $this->get_email_type() ) { case 'html' : return 'text/html'; case 'multipart' : return 'multipart/alternative'; default : return 'text/plain'; } } /** * Return the email's title * @return string */ public function get_title() { return apply_filters( 'woocommerce_email_title', $this->title, $this ); } /** * Return the email's description * @return string */ public function get_description() { return apply_filters( 'woocommerce_email_description', $this->description, $this ); } /** * Proxy to parent's get_option and attempt to localize the result using gettext. * * @param string $key * @param mixed $empty_value * @return string */ public function get_option( $key, $empty_value = null ) { $value = parent::get_option( $key, $empty_value ); return apply_filters( 'woocommerce_email_get_option', __( $value ), $this, $value, $key, $empty_value ); } /** * Checks if this email is enabled and will be sent. * @return bool */ public function is_enabled() { return apply_filters( 'woocommerce_email_enabled_' . $this->id, 'yes' === $this->enabled, $this->object ); } /** * Checks if this email is manually sent * @return bool */ public function is_manual() { return $this->manual; } /** * Checks if this email is customer focussed. * @return bool */ public function is_customer_email() { return $this->customer_email; } /** * get_blogname function. * * @return string */ public function get_blogname() { return wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES ); } /** * get_content function. * * @return string */ public function get_content() { $this->sending = true; if ( 'plain' === $this->get_email_type() ) { $email_content = preg_replace( $this->plain_search, $this->plain_replace, strip_tags( $this->get_content_plain() ) ); } else { $email_content = $this->get_content_html(); } return wordwrap( $email_content, 70 ); } /** * Apply inline styles to dynamic content. * * @param string|null $content * @return string */ public function style_inline( $content ) { // make sure we only inline CSS for html emails if ( in_array( $this->get_content_type(), array( 'text/html', 'multipart/alternative' ) ) && class_exists( 'DOMDocument' ) ) { ob_start(); wc_get_template( 'emails/email-styles.php' ); $css = apply_filters( 'woocommerce_email_styles', ob_get_clean() ); // apply CSS styles inline for picky email clients try { $emogrifier = new Emogrifier( $content, $css ); $content = $emogrifier->emogrify(); } catch ( Exception $e ) { $logger = new WC_Logger(); $logger->add( 'emogrifier', $e->getMessage() ); } } return $content; } /** * Get the email content in plain text format. * @return string */ public function get_content_plain() { return ''; } /** * Get the email content in HTML format. * @return string */ public function get_content_html() { return ''; } /** * Get the from name for outgoing emails. * @return string */ public function get_from_name() { return wp_specialchars_decode( esc_html( get_option( 'woocommerce_email_from_name' ) ), ENT_QUOTES ); } /** * Get the from address for outgoing emails. * @return string */ public function get_from_address() { return sanitize_email( get_option( 'woocommerce_email_from_address' ) ); } /** * Send an email. * @param string $to * @param string $subject * @param string $message * @param string $headers * @param string $attachments * @return bool success */ public function send( $to, $subject, $message, $headers, $attachments ) { add_filter( 'wp_mail_from', array( $this, 'get_from_address' ) ); add_filter( 'wp_mail_from_name', array( $this, 'get_from_name' ) ); add_filter( 'wp_mail_content_type', array( $this, 'get_content_type' ) ); $message = apply_filters( 'woocommerce_mail_content', $this->style_inline( $message ) ); $return = wp_mail( $to, $subject, $message, $headers, $attachments ); remove_filter( 'wp_mail_from', array( $this, 'get_from_address' ) ); remove_filter( 'wp_mail_from_name', array( $this, 'get_from_name' ) ); remove_filter( 'wp_mail_content_type', array( $this, 'get_content_type' ) ); return $return; } /** * Initialise Settings Form Fields - these are generic email options most will use. */ public function init_form_fields() { $this->form_fields = array( 'enabled' => array( 'title' => __( 'Enable/Disable', 'woocommerce' ), 'type' => 'checkbox', 'label' => __( 'Enable this email notification', 'woocommerce' ), 'default' => 'yes' ), 'subject' => array( 'title' => __( 'Email Subject', 'woocommerce' ), 'type' => 'text', 'description' => sprintf( __( 'Defaults to %s', 'woocommerce' ), $this->subject ), 'placeholder' => '', 'default' => '', 'desc_tip' => true ), 'heading' => array( 'title' => __( 'Email Heading', 'woocommerce' ), 'type' => 'text', 'description' => sprintf( __( 'Defaults to %s', 'woocommerce' ), $this->heading ), 'placeholder' => '', 'default' => '', 'desc_tip' => true ), 'email_type' => array( 'title' => __( 'Email type', 'woocommerce' ), 'type' => 'select', 'description' => __( 'Choose which format of email to send.', 'woocommerce' ), 'default' => 'html', 'class' => 'email_type wc-enhanced-select', 'options' => $this->get_email_type_options(), 'desc_tip' => true ) ); } /** * Email type options. * @return array */ public function get_email_type_options() { $types = array( 'plain' => __( 'Plain text', 'woocommerce' ) ); if ( class_exists( 'DOMDocument' ) ) { $types['html'] = __( 'HTML', 'woocommerce' ); $types['multipart'] = __( 'Multipart', 'woocommerce' ); } return $types; } /** * Admin Panel Options Processing. */ public function process_admin_options() { // Save regular options parent::process_admin_options(); // Save templates if ( isset( $_POST['template_html_code'] ) ) { $this->save_template( $_POST['template_html_code'], $this->template_html ); } if ( isset( $_POST['template_plain_code'] ) ) { $this->save_template( $_POST['template_plain_code'], $this->template_plain ); } } /** * Get template. * * @param string $type * @return string */ public function get_template( $type ) { $type = basename( $type ); if ( 'template_html' === $type ) { return $this->template_html; } elseif ( 'template_plain' === $type ) { return $this->template_plain; } return ''; } /** * Save the email templates. * * @since 2.4.0 * @param string $template_code * @param string $template_path */ protected function save_template( $template_code, $template_path ) { if ( current_user_can( 'edit_themes' ) && ! empty( $template_code ) && ! empty( $template_path ) ) { $saved = false; $file = get_stylesheet_directory() . '/woocommerce/' . $template_path; $code = stripslashes( $template_code ); if ( is_writeable( $file ) ) { $f = fopen( $file, 'w+' ); if ( $f !== false ) { fwrite( $f, $code ); fclose( $f ); $saved = true; } } if ( ! $saved ) { $redirect = add_query_arg( 'wc_error', urlencode( __( 'Could not write to template file.', 'woocommerce' ) ) ); wp_safe_redirect( $redirect ); exit; } } } /** * Get the template file in the current theme. * * @param string $template * * @return string */ public function get_theme_template_file( $template ) { return get_stylesheet_directory() . '/' . apply_filters( 'woocommerce_template_directory', 'woocommerce', $template ) . '/' . $template; } /** * Move template action. * * @param string $template_type */ protected function move_template_action( $template_type ) { if ( $template = $this->get_template( $template_type ) ) { if ( ! empty( $template ) ) { $theme_file = $this->get_theme_template_file( $template ); if ( wp_mkdir_p( dirname( $theme_file ) ) && ! file_exists( $theme_file ) ) { // Locate template file $core_file = $this->template_base . $template; $template_file = apply_filters( 'woocommerce_locate_core_template', $core_file, $template, $this->template_base ); // Copy template file copy( $template_file, $theme_file ); /** * woocommerce_copy_email_template action hook. * * @param string $template_type The copied template type * @param string $email The email object */ do_action( 'woocommerce_copy_email_template', $template_type, $this ); echo '

' . __( 'Template file copied to theme.', 'woocommerce' ) . '

'; } } } } /** * Delete template action. * * @param string $template_type */ protected function delete_template_action( $template_type ) { if ( $template = $this->get_template( $template_type ) ) { if ( ! empty( $template ) ) { $theme_file = $this->get_theme_template_file( $template ); if ( file_exists( $theme_file ) ) { unlink( $theme_file ); /** * woocommerce_delete_email_template action hook. * * @param string $template The deleted template type * @param string $email The email object */ do_action( 'woocommerce_delete_email_template', $template_type, $this ); echo '

' . __( 'Template file deleted from theme.', 'woocommerce' ) . '

'; } } } } /** * Admin actions. */ protected function admin_actions() { // Handle any actions if ( ( ! empty( $this->template_html ) || ! empty( $this->template_plain ) ) && ( ! empty( $_GET['move_template'] ) || ! empty( $_GET['delete_template'] ) ) && 'GET' === $_SERVER['REQUEST_METHOD'] ) { if ( empty( $_GET['_wc_email_nonce'] ) || ! wp_verify_nonce( $_GET['_wc_email_nonce'], 'woocommerce_email_template_nonce' ) ) { wp_die( __( 'Action failed. Please refresh the page and retry.', 'woocommerce' ) ); } if ( ! current_user_can( 'edit_themes' ) ) { wp_die( __( 'Cheatin’ huh?', 'woocommerce' ) ); } if ( ! empty( $_GET['move_template'] ) ) { $this->move_template_action( $_GET['move_template'] ); } if ( ! empty( $_GET['delete_template'] ) ) { $this->delete_template_action( $_GET['delete_template'] ); } } } /** * Admin Options. * * Setup the email settings screen. * Override this in your email. * * @since 1.0.0 */ public function admin_options() { // Do admin actions. $this->admin_actions(); ?>

get_title() ); ?>

get_description() ) ); ?> generate_settings_html(); ?>
template_html ) || ! empty( $this->template_plain ) ) ) { ?>
__( 'HTML template', 'woocommerce' ), 'template_plain' => __( 'Plain text template', 'woocommerce' ) ); foreach ( $templates as $template_type => $title ) : $template = $this->get_template( $template_type ); if ( empty( $template ) ) { continue; } $local_file = $this->get_theme_template_file( $template ); $core_file = $this->template_base . $template; $template_file = apply_filters( 'woocommerce_locate_core_template', $core_file, $template, $this->template_base ); $template_dir = apply_filters( 'woocommerce_template_directory', 'woocommerce', $template ); ?>

%s.', 'woocommerce' ), trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template ); ?>

%s to your theme folder: %s.', 'woocommerce' ), plugin_basename( $template_file ) , trailingslashit( basename( get_stylesheet_directory() ) ) . $template_dir . '/' . $template ); ?>