<?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 );

/**
 * When an order item changes status, we need to recalculate the related download's sales and earnings.
 *
 * @since 3.0
 * @param string $old_value The old value.
 * @param string $new_value The new value.
 * @param int $order_item_id The order item ID.
 */
add_action( 'edd_transition_order_item_status', function( $old_value, $new_value, $order_item_id ) {
	if ( $old_value === $new_value || 'inherit' === $new_value ) {
		return;
	}
	$order_item = edd_get_order_item( $order_item_id );
	edd_recalculate_download_sales_earnings( $order_item->product_id );
}, 10, 3 );

/**
 * When an order item adjustment changes type, we need to recalculate the related download's sales and earnings.
 *
 * @since 3.0
 * @param string $old_value The old value.
 * @param string $new_value The new value.
 * @param int $order_item_id The order item ID.
 */
add_action( 'edd_transition_order_adjustment_type', function( $old_value, $new_value, $adjustment_id ) {
	if ( 'discount' === $new_value ) {
		return;
	}
	$adjustment = edd_get_order_adjustment( $adjustment_id );
	if ( 'order_item' === $adjustment->object_type ) {
		$order_item = edd_get_order_item( $adjustment->object_id );
		edd_recalculate_download_sales_earnings( $order_item->product_id );
	}
}, 10, 3 );