woocommerce_review_order_eligible_statuses │ filter-hook │ WC 10.8.0

Filter the order statuses that are eligible to receive the review-request email.

Same hook the email's trigger() consults at send time; documented on WC_Email_Customer_Review_Request::is_order_eligible_for_send().

Usage

add_filter( 'woocommerce_review_order_eligible_statuses', 'wp_kama_woocommerce_review_order_eligible_statuses_filter', 10, 2 );

/**
 * Function for `woocommerce_review_order_eligible_statuses` filter-hook.
 * 
 * @param string[]      $eligible_statuses Default: `[ 'completed' ]`.
 * @param WC_Order|null $order             Order being inspected, or null if it could not be loaded.
 *
 * @return string[]
 */
function wp_kama_woocommerce_review_order_eligible_statuses_filter( $eligible_statuses, $order ){

	// filter...
	return $eligible_statuses;
}

$eligible_statuses(string[])

Default: [ 'completed' ].

$order(WC_Order|null)

Order being inspected, or null if it could not be loaded.

Changelog

Where the hook is called

$eligible_statuses = (array) apply_filters(
	'woocommerce_review_order_eligible_statuses',
	array( OrderStatus::COMPLETED ),
	$order instanceof WC_Order ? $order : null
);

$eligible_statuses = (array) apply_filters(
	'woocommerce_review_order_eligible_statuses',
	array( OrderStatus::COMPLETED ),
	$order
);

$eligible_statuses = (array) apply_filters(
	'woocommerce_review_order_eligible_statuses',
	array( OrderStatus::COMPLETED ),
	$order
);

$eligible_statuses = (array) apply_filters(
	'woocommerce_review_order_eligible_statuses',
	array( OrderStatus::COMPLETED ),
	$this->object
);

Where the hook is used in WooCommerce