2012-09-17 00:53:17 +00:00
< ? php
2018-03-07 17:25:37 +00:00
/**
* Class WC_Email_Customer_Completed_Order file .
*
* @ package WooCommerce\Emails
*/
2013-02-20 17:14:46 +00:00
2014-09-20 19:30:40 +00:00
if ( ! defined ( 'ABSPATH' ) ) {
2018-03-07 17:25:37 +00:00
exit ; // Exit if accessed directly.
2014-09-20 19:30:40 +00:00
}
2013-02-20 17:14:46 +00:00
2017-02-16 11:46:01 +00:00
if ( ! class_exists ( 'WC_Email_Customer_Completed_Order' , false ) ) :
2013-08-02 10:17:56 +00:00
2012-09-17 00:53:17 +00:00
/**
2018-03-07 14:15:17 +00:00
* Customer Completed Order Email .
2016-01-05 18:14:06 +00:00
*
2018-03-07 14:15:17 +00:00
* Order complete emails are sent to the customer when the order is marked complete and usual indicates that the order has been shipped .
*
* @ class WC_Email_Customer_Completed_Order
* @ version 2.0 . 0
* @ package WooCommerce / Classes / Emails
* @ extends WC_Email
2012-09-17 00:53:17 +00:00
*/
2018-03-07 14:15:17 +00:00
class WC_Email_Customer_Completed_Order extends WC_Email {
/**
* Constructor .
*/
public function __construct () {
$this -> id = 'customer_completed_order' ;
$this -> customer_email = true ;
$this -> title = __ ( 'Completed order' , 'woocommerce' );
$this -> description = __ ( 'Order complete emails are sent to customers when their orders are marked completed and usually indicate that their orders have been shipped.' , 'woocommerce' );
$this -> template_html = 'emails/customer-completed-order.php' ;
$this -> template_plain = 'emails/plain/customer-completed-order.php' ;
$this -> placeholders = array (
'{site_title}' => $this -> get_blogname (),
'{order_date}' => '' ,
'{order_number}' => '' ,
);
2018-03-07 17:25:37 +00:00
// Triggers for this email.
2018-03-07 14:15:17 +00:00
add_action ( 'woocommerce_order_status_completed_notification' , array ( $this , 'trigger' ), 10 , 2 );
2018-03-07 17:25:37 +00:00
// Call parent constructor.
2018-03-07 14:15:17 +00:00
parent :: __construct ();
2017-02-10 13:09:37 +00:00
}
2018-03-07 14:15:17 +00:00
/**
* Trigger the sending of this email .
*
2018-03-07 17:25:37 +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' ) ) {
$this -> object = $order ;
$this -> recipient = $this -> object -> get_billing_email ();
$this -> placeholders [ '{order_date}' ] = wc_format_datetime ( $this -> object -> get_date_created () );
$this -> placeholders [ '{order_number}' ] = $this -> object -> get_order_number ();
}
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 ();
2012-09-17 00:53:17 +00:00
}
2012-11-27 16:22:47 +00:00
2018-03-07 14:15:17 +00:00
/**
* Get email subject .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_subject () {
return __ ( 'Your {site_title} order from {order_date} is complete' , 'woocommerce' );
2014-05-30 09:42:47 +00:00
}
2012-11-27 16:22:47 +00:00
2018-03-07 14:15:17 +00:00
/**
* Get email heading .
*
* @ since 3.1 . 0
* @ return string
*/
public function get_default_heading () {
return __ ( 'Your order is complete' , 'woocommerce' );
}
2012-09-17 00:53:17 +00:00
2018-03-07 14:15:17 +00:00
/**
* Get content html .
*
* @ access public
* @ return string
*/
public function get_content_html () {
return wc_get_template_html (
$this -> template_html , array (
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'sent_to_admin' => false ,
'plain_text' => false ,
'email' => $this ,
)
);
}
2012-11-27 16:22:47 +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 (
$this -> template_plain , array (
'order' => $this -> object ,
'email_heading' => $this -> get_heading (),
'sent_to_admin' => false ,
'plain_text' => true ,
'email' => $this ,
)
);
}
2012-11-27 16:22:47 +00:00
2018-03-07 14:15:17 +00:00
/**
* Initialise settings form fields .
*/
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' => __ ( 'Subject' , 'woocommerce' ),
'type' => 'text' ,
'desc_tip' => true ,
/* translators: %s: list of placeholders */
'description' => sprintf ( __ ( 'Available placeholders: %s' , 'woocommerce' ), '<code>{site_title}, {order_date}, {order_number}</code>' ),
'placeholder' => $this -> get_default_subject (),
'default' => '' ,
),
'heading' => array (
'title' => __ ( 'Email heading' , 'woocommerce' ),
'type' => 'text' ,
'desc_tip' => true ,
/* translators: %s: list of placeholders */
'description' => sprintf ( __ ( 'Available placeholders: %s' , 'woocommerce' ), '<code>{site_title}, {order_date}, {order_number}</code>' ),
'placeholder' => $this -> get_default_heading (),
'default' => '' ,
),
'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 ,
),
);
}
2015-02-13 14:16:58 +00:00
}
2013-08-02 10:17:56 +00:00
endif ;
2014-09-20 19:30:40 +00:00
return new WC_Email_Customer_Completed_Order ();