2014-10-29 14:05:43 +00:00
< ? php
2018-03-07 17:25:19 +00:00
/**
* Class WC_Email_Cancelled_Order file .
*
* @ package WooCommerce\Emails
*/
2014-10-29 14:05:43 +00:00
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
2017-06-02 17:25:05 +00:00
/**
2018-03-07 14:15:17 +00:00
* Cancelled Order Email .
2017-06-02 17:25:05 +00:00
*
2018-03-07 14:15:17 +00:00
* An email sent to the admin when an order is cancelled .
2016-01-05 18:16:21 +00:00
*
2018-03-07 14:15:17 +00:00
* @ class WC_Email_Cancelled_Order
* @ version 2.2 . 7
* @ package WooCommerce / Classes / Emails
* @ extends WC_Email
2015-02-13 14:16:58 +00:00
*/
2018-03-07 14:15:17 +00:00
class WC_Email_Cancelled_Order extends WC_Email {
/**
* Constructor .
*/
public function __construct () {
$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 (
2018-08-23 07:38:16 +00:00
'{order_date}' => '' ,
'{order_number}' => '' ,
'{order_billing_full_name}' => '' ,
2018-03-07 14:15:17 +00:00
);
2018-03-07 17:25:19 +00:00
// Triggers for this email.
2018-03-07 14:15:17 +00:00
add_action ( 'woocommerce_order_status_processing_to_cancelled_notification' , array ( $this , 'trigger' ), 10 , 2 );
add_action ( 'woocommerce_order_status_on-hold_to_cancelled_notification' , array ( $this , 'trigger' ), 10 , 2 );
2018-03-07 17:25:19 +00:00
// Call parent constructor.
2018-03-07 14:15:17 +00:00
parent :: __construct ();
2018-03-07 17:25:19 +00:00
// Other settings.
2018-03-07 14:15:17 +00:00
$this -> recipient = $this -> get_option ( 'recipient' , get_option ( 'admin_email' ) );
2017-02-10 13:09:37 +00:00
}
2018-03-07 14:15:17 +00:00
/**
* Get email subject .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_subject () {
2019-03-13 14:40:37 +00:00
return __ ( '[{site_title}]: Order #{order_number} has been cancelled' , 'woocommerce' );
2015-02-13 14:16:58 +00:00
}
2018-03-07 14:15:17 +00:00
/**
* Get email heading .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_heading () {
2018-09-12 09:30:53 +00:00
return __ ( 'Order Cancelled: #{order_number}' , 'woocommerce' );
2015-02-13 14:16:58 +00:00
}
2018-03-07 14:15:17 +00:00
/**
* Trigger the sending of this email .
*
2018-03-07 17:25:19 +00:00
* @ param int $order_id The order ID .
* @ param WC_Order | false $order Order object .
2018-03-07 14:15:17 +00:00
*/
public function trigger ( $order_id , $order = false ) {
$this -> setup_locale ();
if ( $order_id && ! is_a ( $order , 'WC_Order' ) ) {
$order = wc_get_order ( $order_id );
}
if ( is_a ( $order , 'WC_Order' ) ) {
2018-08-23 07:38:16 +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 ();
$this -> placeholders [ '{order_billing_full_name}' ] = $this -> object -> get_formatted_billing_full_name ();
2018-03-07 14:15:17 +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 () );
}
$this -> restore_locale ();
}
2015-02-13 14:16:58 +00:00
2018-03-07 14:15:17 +00:00
/**
* Get content html .
*
* @ return string
*/
public function get_content_html () {
return wc_get_template_html (
2019-03-04 16:33:05 +00:00
$this -> template_html ,
array (
2019-03-04 16:38:18 +00:00
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'additional_content' => $this -> get_additional_content (),
'sent_to_admin' => true ,
'plain_text' => false ,
'email' => $this ,
2018-03-07 14:15:17 +00:00
)
);
}
2015-02-13 14:16:58 +00:00
2018-03-07 14:15:17 +00:00
/**
* Get content plain .
*
* @ return string
*/
public function get_content_plain () {
return wc_get_template_html (
2019-03-04 16:33:05 +00:00
$this -> template_plain ,
array (
2019-03-04 16:38:18 +00:00
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'additional_content' => $this -> get_additional_content (),
'sent_to_admin' => true ,
'plain_text' => true ,
'email' => $this ,
2018-03-07 14:15:17 +00:00
)
);
}
2015-02-13 14:16:58 +00:00
2019-03-04 16:56:40 +00:00
/**
* Default content to show below main email content .
*
2019-05-21 20:46:16 +00:00
* @ since 3.7 . 0
2019-03-04 16:56:40 +00:00
* @ return string
*/
public function get_default_additional_content () {
return __ ( 'Thanks for reading.' , 'woocommerce' );
}
2018-03-07 14:15:17 +00:00
/**
* Initialise settings form fields .
*/
public function init_form_fields () {
2019-03-04 16:33:05 +00:00
/* translators: %s: list of placeholders */
$placeholder_text = sprintf ( __ ( 'Available placeholders: %s' , 'woocommerce' ), '<code>' . esc_html ( implode ( '</code>, <code>' , array_keys ( $this -> placeholders ) ) ) . '</code>' );
2018-03-07 14:15:17 +00:00
$this -> form_fields = array (
2019-05-21 20:46:16 +00:00
'enabled' => array (
2018-03-07 14:15:17 +00:00
'title' => __ ( 'Enable/Disable' , 'woocommerce' ),
'type' => 'checkbox' ,
'label' => __ ( 'Enable this email notification' , 'woocommerce' ),
'default' => 'yes' ,
),
2019-05-21 20:46:16 +00:00
'recipient' => array (
2018-03-07 14:15:17 +00:00
'title' => __ ( 'Recipient(s)' , 'woocommerce' ),
'type' => 'text' ,
/* translators: %s: admin email */
'description' => sprintf ( __ ( 'Enter recipients (comma separated) for this email. Defaults to %s.' , 'woocommerce' ), '<code>' . esc_attr ( get_option ( 'admin_email' ) ) . '</code>' ),
'placeholder' => '' ,
'default' => '' ,
'desc_tip' => true ,
),
2019-05-21 20:46:16 +00:00
'subject' => array (
2018-03-07 14:15:17 +00:00
'title' => __ ( 'Subject' , 'woocommerce' ),
'type' => 'text' ,
'desc_tip' => true ,
2019-03-04 16:33:05 +00:00
'description' => $placeholder_text ,
2018-03-07 14:15:17 +00:00
'placeholder' => $this -> get_default_subject (),
'default' => '' ,
),
2019-05-21 20:46:16 +00:00
'heading' => array (
2018-03-07 14:15:17 +00:00
'title' => __ ( 'Email heading' , 'woocommerce' ),
'type' => 'text' ,
'desc_tip' => true ,
2019-03-04 16:33:05 +00:00
'description' => $placeholder_text ,
2018-03-07 14:15:17 +00:00
'placeholder' => $this -> get_default_heading (),
'default' => '' ,
),
2019-03-04 16:33:05 +00:00
'additional_content' => array (
'title' => __ ( 'Additional content' , 'woocommerce' ),
'description' => __ ( 'Text to appear to appear below the main email content.' , 'woocommerce' ) . ' ' . $placeholder_text ,
'css' => 'width:400px; height: 75px;' ,
'placeholder' => __ ( 'N/A' , 'woocommerce' ),
'type' => 'textarea' ,
'default' => $this -> get_default_additional_content (),
'desc_tip' => true ,
),
2019-05-21 20:46:16 +00:00
'email_type' => array (
2018-03-07 14:15:17 +00:00
'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 ,
),
);
}
2015-02-13 14:16:58 +00:00
}
2014-10-29 14:05:43 +00:00
endif ;
return new WC_Email_Cancelled_Order ();