Automattic\WooCommerce\Internal\OrderReviews

ItemEligibility::has_actionable_items │ public static │ WC 10.9.0

Whether an order has at least one item the customer can still review.

Walks the same eligible-items list and per-item decisions the page renders, so the answer matches what customer-review-order.php would show: items with STATUS_SKIP (reviews disabled on the product, or site-wide via woocommerce_enable_reviews) and items already reviewed on this order are excluded. Any remaining STATUS_FORM row without a matching review counts as actionable.

Callers in the email pipeline use this to short-circuit scheduling and sending when the customer would otherwise land on the empty-state page.

Method of the class: ItemEligibility{}

Returns

true|false. True when at least one item is still reviewable.

Usage

$result = ItemEligibility::has_actionable_items( $order ): bool;

$order(WC_Order) (required)

Order being inspected.

Changelog

ItemEligibility::has_actionable_items() ItemEligibility::has actionable items code ^{WC 10.9.1}

public static function has_actionable_items( WC_Order $order ): bool {
	/**
	 * Filter the eligible items considered when deciding whether the
	 * Customer Review Request email should fire for an order.
	 *
	 * Same hook the page template, submission handler, and endpoint use,
	 * so all four entry points agree on the eligible-items set.
	 *
	 * @since 10.9.0
	 *
	 * @param WC_Order_Item[] $items Order line items.
	 * @param WC_Order        $order The order being inspected.
	 */
	$items = (array) apply_filters( 'woocommerce_review_order_eligible_items', $order->get_items(), $order );
	self::preload_for_items( $items, $order );

	foreach ( $items as $item ) {
		if ( ! $item instanceof WC_Order_Item_Product ) {
			continue;
		}
		$decision = self::decide( $item, $order );
		if ( self::STATUS_SKIP === $decision['status'] ) {
			continue;
		}
		if ( ! ( $decision['comment'] instanceof WP_Comment ) ) {
			return true;
		}
	}

	return false;
}