options()->get( 'email_html' ) ) { $nl2br = true; } return $nl2br; } /** * Init paths for email notifications */ public function init_paths() { /** * UM hook * * @type filter * @title um_email_templates_path_by_slug * @description Extend email templates path * @input_vars * [{"var":"$paths","type":"array","desc":"Email slug -> Template Path"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ $this->path_by_slug = apply_filters( 'um_email_templates_path_by_slug', $this->path_by_slug ); } /** * Check blog ID on multisite, return '' if single site * * @return string */ public function get_blog_id() { $blog_id = ''; if ( is_multisite() ) { $blog_id = '/' . get_current_blog_id(); } return $blog_id; } /** * Locate a template and return the path for inclusion. * * @access public * @param string $template_name * @return string */ public function locate_template( $template_name ) { // check if there is template at theme folder $blog_id = $this->get_blog_id(); //get template file from current blog ID folder $template = locate_template( array( trailingslashit( 'ultimate-member/email' . $blog_id ) . $template_name . '.php', ) ); // If there isn't template at theme folder for current blog ID get template file from theme folder if ( is_multisite() && ! $template ) { $template = locate_template( array( trailingslashit( 'ultimate-member/email' ) . $template_name . '.php', ) ); } // If there isn't template at theme folder, get template file from plugin dir if ( ! $template ) { $path = ! empty( $this->path_by_slug[ $template_name ] ) ? $this->path_by_slug[ $template_name ] : um_path . 'templates/email'; $template = trailingslashit( $path ) . $template_name . '.php'; } // Return what we found. /** * UM hook * * @type filter * @title um_locate_email_template * @description Change email notification template path * @input_vars * [{"var":"$template","type":"string","desc":"Template Path"}, * {"var":"$template_name","type":"string","desc":"Template Name"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ return apply_filters( 'um_locate_email_template', $template, $template_name ); } /** * @param $slug * @param $args * @return bool|string */ public function get_email_template( $slug, $args = array() ) { $located = $this->locate_template( $slug ); /** * UM hook * * @type filter * @title um_email_template_path * @description Change email template location * @input_vars * [{"var":"$located","type":"string","desc":"Template Location"}, * {"var":"$slug","type":"string","desc":"Template Key"}, * {"var":"$args","type":"array","desc":"Template settings"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ $located = apply_filters( 'um_email_template_path', $located, $slug, $args ); if ( ! file_exists( $located ) ) { _doing_it_wrong( __FUNCTION__, sprintf( '%s does not exist.', $located ), '2.1' ); return false; } ob_start(); /** * UM hook * * @type action * @title um_before_email_template_part * @description Action before email template loading * @input_vars * [{"var":"$slug","type":"string","desc":"Email template slug"}, * {"var":"$located","type":"string","desc":"Email template location"}, * {"var":"$args","type":"array","desc":"Email template arguments"}] * @change_log * ["Since: 2.0"] * @usage add_action( 'um_before_email_template_part', 'function_name', 10, 3 ); * @example * */ do_action( 'um_before_email_template_part', $slug, $located, $args ); include( $located ); /** * UM hook * * @type action * @title um_after_email_template_part * @description Action after email template loading * @input_vars * [{"var":"$slug","type":"string","desc":"Email template slug"}, * {"var":"$located","type":"string","desc":"Email template location"}, * {"var":"$args","type":"array","desc":"Email template arguments"}] * @change_log * ["Since: 2.0"] * @usage add_action( 'um_after_email_template_part', 'function_name', 10, 3 ); * @example * */ do_action( 'um_after_email_template_part', $slug, $located, $args ); return ob_get_clean(); } /** * Prepare email template to send * * @param $slug * @param $args * @return mixed|string */ function prepare_template( $slug, $args = array() ) { ob_start(); if ( UM()->options()->get( 'email_html' ) ) { /** * UM hook * * @type filter * @title um_email_template_html_formatting * @description Change email notification template header * @input_vars * [{"var":"$header","type":"string","desc":"Email notification header. '' by default"}, * {"var":"$slug","type":"string","desc":"Template Key"}, * {"var":"$args","type":"array","desc":"Template settings"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ echo apply_filters( 'um_email_template_html_formatting', '', $slug, $args ); /** * UM hook * * @type action * @title um_before_email_template_body * @description Action before email template body display * @input_vars * [{"var":"$slug","type":"string","desc":"Email template slug"}, * {"var":"$args","type":"array","desc":"Email template arguments"}] * @change_log * ["Since: 2.0"] * @usage add_action( 'um_before_email_template_body', 'function_name', 10, 2 ); * @example * */ do_action( 'um_before_email_template_body', $slug, $args ); /** * UM hook * * @type filter * @title um_email_template_body_attrs * @description Change email notification template body additional attributes * @input_vars * [{"var":"$body_atts","type":"string","desc":"Email notification body attributes"}, * {"var":"$slug","type":"string","desc":"Template Key"}, * {"var":"$args","type":"array","desc":"Template settings"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ $body_attrs = apply_filters( 'um_email_template_body_attrs', 'style="background: #f2f2f2;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;"', $slug, $args ); ?> > get_email_template( $slug, $args ); ?> get_email_template( $slug, $args ); $plain_email_template = strip_tags( $raw_email_template ); if( $plain_email_template !== $raw_email_template ){ $plain_email_template = preg_replace( array('/ /mi', '/^\s+/mi'), array(' ', ''), $plain_email_template ); } echo $plain_email_template; } $message = ob_get_clean(); /** * UM hook * * @type filter * @title um_email_send_message_content * @description Change email notification message content * @input_vars * [{"var":"$message","type":"string","desc":"Message Content"}, * {"var":"$template","type":"string","desc":"Template Key"}, * {"var":"$args","type":"string","desc":"Notification Arguments"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ $message = apply_filters( 'um_email_send_message_content', $message, $slug, $args ); add_filter( 'um_template_tags_patterns_hook', array( &$this, 'add_placeholder' ), 10, 1 ); add_filter( 'um_template_tags_replaces_hook', array( &$this, 'add_replace_placeholder' ), 10, 1 ); // Convert tags in email template return um_convert_tags( $message, $args ); } /** * Send Email function * * @param string $email * @param null $template * @param array $args */ public function send( $email, $template, $args = array() ) { if ( ! is_email( $email ) ) { return; } if ( empty( UM()->options()->get( $template . '_on' ) ) ) { return; } /** * Filters for disabling email notifications programmatically. * * @since 2.6.1 * @hook um_disable_email_notification_sending * * @param {bool} $disabled Does an email is disabled programmatically. By default it is false. * @param {string} $email Email address for sending. * @param {string} $template Email template key. * @param {array} $args Arguments for sending email. * * @return {bool} `true` if email is disabled programmatically. */ $hook_disabled = apply_filters( 'um_disable_email_notification_sending', false, $email, $template, $args ); if ( false !== $hook_disabled ) { return; } do_action( 'um_before_email_notification_sending', $email, $template, $args ); $this->attachments = array(); $this->headers = 'From: ' . stripslashes( UM()->options()->get( 'mail_from' ) ) . ' <' . UM()->options()->get( 'mail_from_addr' ) . '>' . "\r\n"; add_filter( 'um_template_tags_patterns_hook', array( UM()->mail(), 'add_placeholder' ), 10, 1 ); add_filter( 'um_template_tags_replaces_hook', array( UM()->mail(), 'add_replace_placeholder' ), 10, 1 ); /** * UM hook * * @type filter * @title um_email_send_subject * @description Change email notification subject * @input_vars * [{"var":"$subject","type":"string","desc":"Subject"}, * {"var":"$key","type":"string","desc":"Template Key"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ $subject = apply_filters( 'um_email_send_subject', UM()->options()->get( $template . '_sub' ), $template ); $subject = wp_unslash( um_convert_tags( $subject, $args ) ); $this->subject = html_entity_decode( $subject, ENT_QUOTES, 'UTF-8' ); $this->message = $this->prepare_template( $template, $args ); if ( UM()->options()->get( 'email_html' ) ) { $this->headers .= "Content-Type: text/html\r\n"; } else { $this->headers .= "Content-Type: text/plain\r\n"; } // Send mail wp_mail( $email, $this->subject, $this->message, $this->headers, $this->attachments ); do_action( 'um_after_email_notification_sending', $email, $template, $args ); } /** * @param $template_name * * @return mixed|void */ public function get_template_filename( $template_name ) { /** * UM hook * * @type filter * @title um_change_email_template_file * @description Change email notification template path * @input_vars * [{"var":"$template_name","type":"string","desc":"Template Name"}] * @change_log * ["Since: 2.0"] * @usage * * @example * */ return apply_filters( 'um_change_email_template_file', $template_name ); } /** * Locate a template and return the path for inclusion. * * @access public * @param string $template_name * @return string */ public function template_in_theme( $template_name ) { $template_name_file = $this->get_template_filename( $template_name ); $blog_id = $this->get_blog_id(); // check if there is a template at theme blog ID folder $template = locate_template( array( trailingslashit( 'ultimate-member/email' . $blog_id ) . $template_name_file . '.php', ) ); // Return what we found. if ( get_template_directory() === get_stylesheet_directory() ) { return ! $template ? false : true; } else { return strstr( $template, get_stylesheet_directory() ); } } /** * Method returns an expected path for template * * @access public * * @param string $location * @param string $template_name * * @return string */ public function get_template_file( $location, $template_name ) { $template_path = ''; $template_name_file = $this->get_template_filename( $template_name ); switch ( $location ) { case 'theme': //save email template in blog ID folder if we use multisite $blog_id = $this->get_blog_id(); $template_path = trailingslashit( get_stylesheet_directory() . '/ultimate-member/email' . $blog_id ) . $template_name_file . '.php'; break; case 'plugin': $path = ! empty( $this->path_by_slug[ $template_name ] ) ? $this->path_by_slug[ $template_name ] : um_path . 'templates/email'; $template_path = trailingslashit( $path ) . $template_name . '.php'; break; } /** * Filters an expected path for email template in theme or plugin. * * @since 2.6.1 * @hook um_email_get_template_file_path * * @param {string} $template_path Expected template path. * @param {string} $location Where to search 'theme||plugin'. * @param {string} $template_name_file Expected filename. * * @return {string} Expected template path. */ return apply_filters( 'um_email_get_template_file_path', $template_path, $location, $template_name_file ); } /** * Copy template to the theme * * @param string $template * @return bool */ public function copy_email_template( $template ) { $in_theme = $this->template_in_theme( $template ); if ( $in_theme ) { return false; } $plugin_template_path = wp_normalize_path( $this->get_template_file( 'plugin', $template ) ); $theme_template_path = wp_normalize_path( $this->get_template_file( 'theme', $template ) ); $template_filename = $this->get_template_filename( $template ) . '.php'; $template_dir = wp_normalize_path( str_replace( $template_filename, '', $theme_template_path ) ); $result = wp_mkdir_p( $template_dir ); if ( ! $result ) { return false; } if ( file_exists( $plugin_template_path ) && copy( $plugin_template_path, $theme_template_path ) ) { return true; } else { return false; } } /** * UM Placeholders for site url, admin email, submit registration * * @param $placeholders * * @return array */ public function add_placeholder( $placeholders ) { $placeholders[] = '{user_profile_link}'; $placeholders[] = '{site_url}'; $placeholders[] = '{admin_email}'; $placeholders[] = '{submitted_registration}'; $placeholders[] = '{login_url}'; $placeholders[] = '{password}'; $placeholders[] = '{account_activation_link}'; return $placeholders; } /** * UM Replace Placeholders for site url, admin email, submit registration * * @param $replace_placeholders * * @return array */ public function add_replace_placeholder( $replace_placeholders ) { $replace_placeholders[] = um_user_profile_url(); $replace_placeholders[] = get_bloginfo( 'url' ); $replace_placeholders[] = um_admin_email(); $replace_placeholders[] = um_user_submitted_registration_formatted(); $replace_placeholders[] = um_get_core_page( 'login' ); $replace_placeholders[] = esc_html__( 'Your set password', 'ultimate-member' ); $replace_placeholders[] = um_user( 'account_activation_link' ); return $replace_placeholders; } } }