Files
woocommerce-subscriptions/includes/core/emails/class-wcs-email-new-switch-order.php
2025-05-21 10:18:23 +00:00

156 lines
4.7 KiB
PHP

<?php
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
/**
* Subscription Switched Email
*
* An email sent to the admin when a customer switches their subscription.
*
* @class WCS_Email_New_Switch_Order
* @version 1.0.0 - Migrated from WooCommerce Subscriptions v1.5
* @extends WC_Email_New_Order
*/
class WCS_Email_New_Switch_Order extends WC_Email_New_Order {
/**
* @var array Subscriptions linked to the switch order.
*/
public $subscriptions;
/**
* Constructor
*/
function __construct() {
$this->id = 'new_switch_order';
$this->title = __( 'Subscription Switched', 'woocommerce-subscriptions' );
$this->description = __( 'Subscription switched emails are sent when a customer switches a subscription.', 'woocommerce-subscriptions' );
$this->heading = __( 'Subscription Switched', 'woocommerce-subscriptions' );
$this->subject = __( '[{site_title}] Subscription Switched ({order_number}) - {order_date}', 'woocommerce-subscriptions' );
$this->template_html = 'emails/admin-new-switch-order.php';
$this->template_plain = 'emails/plain/admin-new-switch-order.php';
$this->template_base = WC_Subscriptions_Plugin::instance()->get_plugin_directory( 'templates/' );
// Triggers for this email
add_action( 'woocommerce_subscriptions_switch_completed_switch_notification', array( $this, 'trigger' ) );
// We want all the parent's methods, with none of its properties, so call its parent's constructor, rather than my parent constructor
WC_Email::__construct();
// Other settings
$this->recipient = $this->get_option( 'recipient' );
if ( ! $this->recipient ) {
$this->recipient = get_option( 'admin_email' );
}
}
/**
* Get the default e-mail subject.
*
* @since 1.0.0 - Migrated from WooCommerce Subscriptions v2.5.3
* @return string
*/
public function get_default_subject() {
return $this->subject;
}
/**
* Get the default e-mail heading.
*
* @since 1.0.0 - Migrated from WooCommerce Subscriptions v2.5.3
* @return string
*/
public function get_default_heading() {
return $this->heading;
}
/**
* trigger function.
*
* We need to override WC_Email_New_Order's trigger method because it expects to be run only once
* per request.
*
* @access public
* @return void
*/
function trigger( $order_id, $order = null ) {
if ( $order_id ) {
$this->object = wc_get_order( $order_id );
$order_date_index = array_search( '{order_date}', $this->find );
if ( false === $order_date_index ) {
$this->find['order_date'] = '{order_date}';
$this->replace['order_date'] = wcs_format_datetime( wcs_get_objects_property( $this->object, 'date_created' ) );
} else {
$this->replace[ $order_date_index ] = wcs_format_datetime( wcs_get_objects_property( $this->object, 'date_created' ) );
}
$order_number_index = array_search( '{order_number}', $this->find );
if ( false === $order_number_index ) {
$this->find['order_number'] = '{order_number}';
$this->replace['order_number'] = $this->object->get_order_number();
} else {
$this->replace[ $order_number_index ] = $this->object->get_order_number();
}
$this->subscriptions = wcs_get_subscriptions_for_switch_order( $this->object );
}
if ( ! $this->is_enabled() || ! $this->get_recipient() ) {
return;
}
$this->send( $this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments() );
}
/**
* get_content_html function.
*
* @access public
* @return string
*/
function get_content_html() {
return wc_get_template_html(
$this->template_html,
array(
'order' => $this->object,
'subscriptions' => $this->subscriptions,
'email_heading' => $this->get_heading(),
'additional_content' => is_callable( array( $this, 'get_additional_content' ) ) ? $this->get_additional_content() : '', // WC 3.7 introduced an additional content field for all emails.
'sent_to_admin' => true,
'plain_text' => false,
'email' => $this,
),
'',
$this->template_base
);
}
/**
* get_content_plain function.
*
* @access public
* @return string
*/
function get_content_plain() {
return wc_get_template_html(
$this->template_plain,
array(
'order' => $this->object,
'subscriptions' => $this->subscriptions,
'email_heading' => $this->get_heading(),
'additional_content' => is_callable( array( $this, 'get_additional_content' ) ) ? $this->get_additional_content() : '', // WC 3.7 introduced an additional content field for all emails.
'sent_to_admin' => true,
'plain_text' => true,
'email' => $this,
),
'',
$this->template_base
);
}
}