2014-10-29 14:05:43 +00:00
< ? php
if ( ! defined ( 'ABSPATH' ) ) {
2015-11-02 14:45:24 +00:00
exit ;
2014-10-29 14:05:43 +00:00
}
2017-02-16 11:46:01 +00:00
if ( ! class_exists ( 'WC_Email_Cancelled_Order' , false ) ) :
2014-10-29 14:05:43 +00:00
/**
2015-11-03 13:31:20 +00:00
* Cancelled Order Email .
2014-10-29 14:05:43 +00:00
*
2014-11-25 16:23:00 +00:00
* An email sent to the admin when an order is cancelled .
2014-10-29 14:05:43 +00:00
*
* @ class WC_Email_Cancelled_Order
* @ version 2.2 . 7
* @ package WooCommerce / Classes / Emails
* @ author WooThemes
* @ extends WC_Email
*/
class WC_Email_Cancelled_Order extends WC_Email {
2015-02-13 14:16:58 +00:00
/**
2015-11-03 13:31:20 +00:00
* Constructor .
2015-02-13 14:16:58 +00:00
*/
2015-11-02 14:45:24 +00:00
public function __construct () {
2017-07-19 13:25:00 +00:00
$this -> id = 'cancelled_order' ;
$this -> title = __ ( 'Cancelled order' , 'woocommerce' );
$this -> description = __ ( 'Cancelled order emails are sent to chosen recipient(s) when orders have been marked cancelled (if they were previously processing or on-hold).' , 'woocommerce' );
$this -> template_html = 'emails/admin-cancelled-order.php' ;
$this -> template_plain = 'emails/plain/admin-cancelled-order.php' ;
$this -> placeholders = array (
'{site_title}' => $this -> get_blogname (),
'{order_date}' => '' ,
'{order_number}' => '' ,
);
2015-02-13 14:16:58 +00:00
// Triggers for this email
2017-05-19 09:45:26 +00:00
add_action ( 'woocommerce_order_status_processing_to_cancelled_notification' , array ( $this , 'trigger' ), 10 , 2 );
2017-02-01 16:54:47 +00:00
add_action ( 'woocommerce_order_status_on-hold_to_cancelled_notification' , array ( $this , 'trigger' ), 10 , 2 );
2015-02-13 14:16:58 +00:00
// Call parent constructor
parent :: __construct ();
// Other settings
2015-11-02 14:45:24 +00:00
$this -> recipient = $this -> get_option ( 'recipient' , get_option ( 'admin_email' ) );
2015-02-13 14:16:58 +00:00
}
2017-06-02 17:25:05 +00:00
/**
* Get email subject .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_subject () {
return __ ( '[{site_title}] Cancelled order ({order_number})' , 'woocommerce' );
}
/**
* Get email heading .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_heading () {
return __ ( 'Cancelled order' , 'woocommerce' );
}
2015-02-13 14:16:58 +00:00
/**
2017-02-10 13:09:37 +00:00
* Trigger the sending of this email .
2016-01-05 18:16:21 +00:00
*
2017-02-10 13:09:37 +00:00
* @ param int $order_id The order ID .
* @ param WC_Order $order Order object .
2015-02-13 14:16:58 +00:00
*/
2017-02-10 13:09:37 +00:00
public function trigger ( $order_id , $order = false ) {
2017-10-24 13:06:21 +00:00
$this -> setup_locale ();
2017-02-17 18:10:15 +00:00
if ( $order_id && ! is_a ( $order , 'WC_Order' ) ) {
2017-02-10 13:09:37 +00:00
$order = wc_get_order ( $order_id );
}
if ( is_a ( $order , 'WC_Order' ) ) {
2017-07-19 13:25:00 +00:00
$this -> object = $order ;
$this -> placeholders [ '{order_date}' ] = wc_format_datetime ( $this -> object -> get_date_created () );
$this -> placeholders [ '{order_number}' ] = $this -> object -> get_order_number ();
2015-02-13 14:16:58 +00:00
}
2017-10-24 13:06:21 +00:00
if ( $this -> is_enabled () && $this -> get_recipient () ) {
$this -> send ( $this -> get_recipient (), $this -> get_subject (), $this -> get_content (), $this -> get_headers (), $this -> get_attachments () );
2015-02-13 14:16:58 +00:00
}
2017-06-02 17:25:05 +00:00
$this -> restore_locale ();
2015-02-13 14:16:58 +00:00
}
/**
2016-01-05 18:16:21 +00:00
* Get content html .
2015-02-13 14:16:58 +00:00
*
* @ access public
* @ return string
*/
2015-11-02 14:45:24 +00:00
public function get_content_html () {
2015-12-04 13:39:57 +00:00
return wc_get_template_html ( $this -> template_html , array (
2015-02-13 14:16:58 +00:00
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'sent_to_admin' => true ,
2015-11-01 04:04:59 +00:00
'plain_text' => false ,
2016-08-27 01:46:45 +00:00
'email' => $this ,
2015-02-13 14:16:58 +00:00
) );
}
/**
2015-07-16 19:55:48 +00:00
* Get content plain .
2015-02-13 14:16:58 +00:00
*
* @ return string
*/
2015-11-02 14:45:24 +00:00
public function get_content_plain () {
2015-12-04 13:39:57 +00:00
return wc_get_template_html ( $this -> template_plain , array (
2015-02-13 14:16:58 +00:00
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'sent_to_admin' => true ,
2015-11-30 15:16:23 +00:00
'plain_text' => true ,
2016-08-27 01:46:45 +00:00
'email' => $this ,
2015-02-13 14:16:58 +00:00
) );
}
/**
2015-07-16 19:55:48 +00:00
* Initialise settings form fields .
2015-02-13 14:16:58 +00:00
*/
2015-11-02 14:45:24 +00:00
public function init_form_fields () {
2015-02-13 14:16:58 +00:00
$this -> form_fields = array (
'enabled' => array (
'title' => __ ( 'Enable/Disable' , 'woocommerce' ),
'type' => 'checkbox' ,
'label' => __ ( 'Enable this email notification' , 'woocommerce' ),
2016-08-27 01:46:45 +00:00
'default' => 'yes' ,
2015-02-13 14:16:58 +00:00
),
'recipient' => array (
'title' => __ ( 'Recipient(s)' , 'woocommerce' ),
'type' => 'text' ,
2016-10-29 20:03:28 +00:00
/* translators: %s: admin email */
2016-10-24 23:56:38 +00:00
'description' => sprintf ( __ ( 'Enter recipients (comma separated) for this email. Defaults to %s.' , 'woocommerce' ), '<code>' . esc_attr ( get_option ( 'admin_email' ) ) . '</code>' ),
2015-02-13 14:16:58 +00:00
'placeholder' => '' ,
2015-11-03 14:59:48 +00:00
'default' => '' ,
2016-08-27 01:46:45 +00:00
'desc_tip' => true ,
2015-02-13 14:16:58 +00:00
),
'subject' => array (
'title' => __ ( 'Subject' , 'woocommerce' ),
'type' => 'text' ,
2017-06-14 16:50:17 +00:00
'desc_tip' => true ,
/* translators: %s: list of placeholders */
'description' => sprintf ( __ ( 'Available placeholders: %s' , 'woocommerce' ), '<code>{site_title}, {order_date}, {order_number}</code>' ),
2017-06-14 16:13:43 +00:00
'placeholder' => $this -> get_default_subject (),
2015-11-03 14:59:48 +00:00
'default' => '' ,
2015-02-13 14:16:58 +00:00
),
'heading' => array (
2016-10-12 10:16:30 +00:00
'title' => __ ( 'Email heading' , 'woocommerce' ),
2015-02-13 14:16:58 +00:00
'type' => 'text' ,
2017-06-14 16:50:17 +00:00
'desc_tip' => true ,
/* translators: %s: list of placeholders */
'description' => sprintf ( __ ( 'Available placeholders: %s' , 'woocommerce' ), '<code>{site_title}, {order_date}, {order_number}</code>' ),
2017-06-14 16:13:43 +00:00
'placeholder' => $this -> get_default_heading (),
2015-11-03 14:59:48 +00:00
'default' => '' ,
2015-02-13 14:16:58 +00:00
),
'email_type' => array (
2016-10-12 10:16:30 +00:00
'title' => __ ( 'Email type' , 'woocommerce' ),
2015-02-13 14:16:58 +00:00
'type' => 'select' ,
'description' => __ ( 'Choose which format of email to send.' , 'woocommerce' ),
'default' => 'html' ,
'class' => 'email_type wc-enhanced-select' ,
2015-11-03 14:59:48 +00:00
'options' => $this -> get_email_type_options (),
2016-08-27 01:46:45 +00:00
'desc_tip' => true ,
),
2015-02-13 14:16:58 +00:00
);
}
2014-10-29 14:05:43 +00:00
}
endif ;
return new WC_Email_Cancelled_Order ();