57 lines
2.0 KiB
PHP
57 lines
2.0 KiB
PHP
|
<?php
|
||
|
|
/**
|
||
|
|
* Order Transition Functions.
|
||
|
|
*
|
||
|
|
* @package EDD
|
||
|
|
* @subpackage Orders
|
||
|
|
* @copyright Copyright (c) 2022, Easy Digital Downloads
|
||
|
|
* @license https://opensource.org/licenses/gpl-2.0.php GNU Public License
|
||
|
|
* @since 3.0
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Record order status change
|
||
|
|
*
|
||
|
|
* @since 3.0
|
||
|
|
* @param string $old_status the status of the order prior to this change.
|
||
|
|
* @param string $new_status The new order status.
|
||
|
|
* @param int $order_id the ID number of the order.
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
function edd_record_order_status_change( $old_status, $new_status, $order_id ) {
|
||
|
|
|
||
|
|
// Get the list of statuses so that status in the payment note can be translated.
|
||
|
|
$stati = edd_get_payment_statuses();
|
||
|
|
$old_status = isset( $stati[ $old_status ] ) ? $stati[ $old_status ] : $old_status;
|
||
|
|
$new_status = isset( $stati[ $new_status ] ) ? $stati[ $new_status ] : $new_status;
|
||
|
|
|
||
|
|
$status_change = sprintf(
|
||
|
|
/* translators: %1$s Old order status. %2$s New order status. */
|
||
|
|
__( 'Status changed from %1$s to %2$s', 'easy-digital-downloads' ),
|
||
|
|
$old_status,
|
||
|
|
$new_status
|
||
|
|
);
|
||
|
|
|
||
|
|
edd_insert_payment_note( $order_id, $status_change );
|
||
|
|
}
|
||
|
|
add_action( 'edd_transition_order_status', 'edd_record_order_status_change', 100, 3 );
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Triggers `edd_update_payment_status` hook when an order status changes
|
||
|
|
* for backwards compatibility.
|
||
|
|
*
|
||
|
|
* @since 3.0
|
||
|
|
* @param string $old_status the status of the order prior to this change.
|
||
|
|
* @param string $new_status The new order status.
|
||
|
|
* @param int $order_id the ID number of the order.
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
add_action( 'edd_transition_order_status', function( $old_status, $new_status, $order_id ) {
|
||
|
|
// Trigger the payment status action hook for backwards compatibility.
|
||
|
|
do_action( 'edd_update_payment_status', $order_id, $new_status, $old_status );
|
||
|
|
if ( 'complete' === $old_status ) {
|
||
|
|
// Trigger the action again to account for add-ons listening for status changes from "publish".
|
||
|
|
do_action( 'edd_update_payment_status', $order_id, $new_status, 'publish' );
|
||
|
|
}
|
||
|
|
}, 10, 3 );
|