Automattic\WooCommerce\Admin\API\Reports\Customers

DataStore::get_customer_order_data_and_format │ public static │ WC 1.0

Returns a data object and format object of the customers data coming from the order.

A plain WC_Order will be converted to an Overrides\Order internally to ensure consistent name resolution (user meta → billing → shipping fallback).

Method of the class: DataStore{}

No Hooks.

Returns

array. ($data, $format)

Usage

$result = DataStore::get_customer_order_data_and_format( $order, $customer_user );

$order(WC_Order) (required)

WC_Order where we get customer info from.

$customer_user(WC_Customer|null)

WC_Customer registered customer WP user.
Default: null

DataStore::get_customer_order_data_and_format() DataStore::get customer order data and format code ^{WC 11.0.1}

public static function get_customer_order_data_and_format( $order, $customer_user = null ) {
	if ( ! is_a( $order, 'WC_Order' ) ) {
		return array( array(), array() );
	}

	if ( ! $order instanceof OverridesOrder ) {
		if ( ! $order->get_id() ) {
			return array( array(), array() );
		}
		$order = new OverridesOrder( $order->get_id() );
	}

	$date_created = $order->get_date_created( 'edit' )
		?? $order->get_date_modified( 'edit' )
		?? $order->get_date_paid( 'edit' );

	$data   = array(
		'first_name'       => $order->get_customer_first_name(),
		'last_name'        => $order->get_customer_last_name(),
		'email'            => $order->get_billing_email( 'edit' ),
		'city'             => $order->get_billing_city( 'edit' ),
		'state'            => $order->get_billing_state( 'edit' ),
		'postcode'         => $order->get_billing_postcode( 'edit' ),
		'country'          => $order->get_billing_country( 'edit' ),
		'date_last_active' => $date_created ? gmdate( 'Y-m-d H:i:s', $date_created->getTimestamp() ) : null,
	);
	$format = array(
		'%s',
		'%s',
		'%s',
		'%s',
		'%s',
		'%s',
		'%s',
		'%s',
	);

	// Add registered customer data.
	if ( 0 !== $order->get_user_id() ) {
		$user_id = $order->get_user_id();
		if ( is_null( $customer_user ) ) {
			$customer_user = new \WC_Customer( $user_id );
		}

		// Set email as customer email instead of Order Billing Email if we have a customer.
		$data['email'] = $customer_user->get_email( 'edit' );

		// Adding other relevant customer data.
		$data['user_id']         = $user_id;
		$data['username']        = $customer_user->get_username( 'edit' );
		$data['date_registered'] = $customer_user->get_date_created( 'edit' ) ? $customer_user->get_date_created( 'edit' )->date( TimeInterval::$sql_datetime_format ) : null;
		$format[]                = '%d';
		$format[]                = '%s';
		$format[]                = '%s';
	}
	return array( $data, $format );
}