2016-11-13 21:15:55 +00:00
|
|
|
<?php
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) {
|
|
|
|
exit; // Exit if accessed directly
|
|
|
|
}
|
|
|
|
|
|
|
|
if ( ! class_exists( 'WC_Log_Handler' ) ) {
|
|
|
|
include_once( dirname( dirname( __FILE__ ) ) . '/abstracts/abstract-wc-log-handler.php' );
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handles log entries by sending an email.
|
|
|
|
*
|
|
|
|
* @class WC_Log_Handler_Email
|
|
|
|
* @version 1.0.0
|
|
|
|
* @package WooCommerce/Classes
|
|
|
|
* @category Class
|
|
|
|
* @author WooThemes
|
|
|
|
*/
|
|
|
|
class WC_Log_Handler_Email extends WC_Log_Handler {
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Stores email recipients.
|
|
|
|
*
|
|
|
|
* @var array
|
|
|
|
* @access private
|
|
|
|
*/
|
2016-11-16 19:19:20 +00:00
|
|
|
private $to = array();
|
2016-11-13 21:15:55 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor for the logger.
|
|
|
|
*
|
|
|
|
* @param $args additional args. {
|
|
|
|
* Optional. @see WC_Log_Handler::__construct.
|
|
|
|
*
|
|
|
|
* @type string|arr $to Optional. Email or emails to recieve log messages. Default site admin.
|
|
|
|
* }
|
|
|
|
*/
|
2016-11-13 22:22:45 +00:00
|
|
|
public function __construct( $args = array() ) {
|
2016-11-13 21:15:55 +00:00
|
|
|
|
|
|
|
$args = wp_parse_args( $args, array(
|
|
|
|
'threshold' => 'critical',
|
|
|
|
'to' => get_option( 'admin_email' ),
|
|
|
|
) );
|
|
|
|
|
|
|
|
parent::__construct( $args );
|
|
|
|
|
|
|
|
if ( is_array( $args['to'] ) ) {
|
|
|
|
foreach ( $args['to'] as $to ) {
|
|
|
|
$this->add_email( $to );
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
$this->add_email( $args['to'] );
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handle a log entry.
|
|
|
|
*
|
|
|
|
* @param string $level emergency|alert|critical|error|warning|notice|info|debug
|
|
|
|
* @param string $message
|
|
|
|
* @param array $context {
|
2016-11-16 19:22:00 +00:00
|
|
|
* Array with additional information
|
2016-11-13 21:15:55 +00:00
|
|
|
* }
|
|
|
|
*
|
|
|
|
* @return bool log entry should bubble to further loggers.
|
|
|
|
*/
|
|
|
|
public function handle( $level, $timestamp, $message, $context ) {
|
|
|
|
|
|
|
|
if ( $this->should_handle( $level ) ) {
|
|
|
|
$subject = $this->get_subject( $level, $timestamp, $message, $context );
|
|
|
|
$body = $this->get_body( $level, $timestamp, $message, $context );
|
2016-11-16 19:19:20 +00:00
|
|
|
wp_mail( $this->to, $subject, $body );
|
2016-11-13 21:15:55 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2016-11-13 22:22:45 +00:00
|
|
|
/**
|
|
|
|
* Build subject for log email.
|
|
|
|
*
|
|
|
|
* @param string $level emergency|alert|critical|error|warning|notice|info|debug
|
|
|
|
* @param string $message
|
|
|
|
* @param array $context {
|
2016-11-16 19:22:00 +00:00
|
|
|
* Array with additional information
|
2016-11-13 22:22:45 +00:00
|
|
|
* }
|
|
|
|
*
|
|
|
|
* @return string subject
|
|
|
|
*/
|
2016-11-13 21:15:55 +00:00
|
|
|
public function get_subject( $level, $timestamp, $message, $context ) {
|
2016-11-13 22:22:45 +00:00
|
|
|
return sprintf( __( '[%s] WooCommerce log message', 'woocommerce' ), $level );
|
2016-11-13 21:15:55 +00:00
|
|
|
}
|
|
|
|
|
2016-11-13 22:22:45 +00:00
|
|
|
/**
|
|
|
|
* Build body for log email.
|
|
|
|
*
|
|
|
|
* @param string $level emergency|alert|critical|error|warning|notice|info|debug
|
|
|
|
* @param string $message
|
|
|
|
* @param array $context {
|
2016-11-16 19:22:00 +00:00
|
|
|
* Array with additional information
|
2016-11-13 22:22:45 +00:00
|
|
|
* }
|
|
|
|
*
|
|
|
|
* @return string body
|
|
|
|
*/
|
2016-11-13 21:15:55 +00:00
|
|
|
public function get_body( $level, $timestamp, $message, $context ) {
|
|
|
|
$entry = $this->format_entry( $level, $timestamp, $message, $context );
|
2016-11-19 16:33:31 +00:00
|
|
|
return __( 'You have recieved the following WooCommerce log message:', 'woocommerce' )
|
|
|
|
. PHP_EOL . PHP_EOL . $entry;
|
2016-11-13 21:15:55 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Adds an email to the list of recipients.
|
2016-11-13 22:22:45 +00:00
|
|
|
*
|
|
|
|
* @param string email Email address to add
|
2016-11-13 21:15:55 +00:00
|
|
|
*/
|
|
|
|
public function add_email( $email ) {
|
2016-11-16 19:19:20 +00:00
|
|
|
array_push( $this->to, $email );
|
2016-11-13 21:15:55 +00:00
|
|
|
}
|
|
|
|
}
|