WC_REST_Orders_V1_Controller::prepare_item_for_database │ protected │ WC 1.0

Prepare a single order for create.

Method of the class: WC_REST_Orders_V1_Controller{}

Returns

WP_Error|WC_Order. $data Object.

Usage

// protected - for code of main (parent) or child class
$result = $this->prepare_item_for_database( $request );

$request(WP_REST_Request) (required)

Request object.

WC_REST_Orders_V1_Controller::prepare_item_for_database() WC REST Orders V1 Controller::prepare item for database code ^{WC 10.3.6}

protected function prepare_item_for_database( $request ) {
	$id        = isset( $request['id'] ) ? absint( $request['id'] ) : 0;
	$order     = new WC_Order( $id );
	$schema    = $this->get_item_schema();
	$data_keys = array_keys( array_filter( $schema['properties'], array( $this, 'filter_writable_props' ) ) );

	if ( ! is_null( $request['customer_id'] ) && 0 !== $request['customer_id'] ) {
		if ( is_wp_error( Users::get_user_in_current_site( $request['customer_id'] ) ) ) {
			// phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped
			throw new WC_REST_Exception( 'woocommerce_rest_invalid_customer_id', __( 'Customer ID is invalid.', 'woocommerce' ), 400 );
		}

		// Make sure customer is part of blog.
		if ( is_multisite() && ! is_user_member_of_blog( $request['customer_id'] ) ) {
			add_user_to_blog( get_current_blog_id(), $request['customer_id'], 'customer' );
		}
	}

	// Handle all writable props
	foreach ( $data_keys as $key ) {
		$value = $request[ $key ];

		if ( ! is_null( $value ) ) {
			switch ( $key ) {
				case 'billing' :
				case 'shipping' :
					$this->update_address( $order, $value, $key );
					break;
				case 'line_items' :
				case 'shipping_lines' :
				case 'fee_lines' :
				case 'coupon_lines' :
					if ( is_array( $value ) ) {
						foreach ( $value as $item ) {
							if ( is_array( $item ) ) {
								if ( $this->item_is_null( $item ) || ( isset( $item['quantity'] ) && 0 === $item['quantity'] ) ) {
									$order->remove_item( $item['id'] );
								} else {
									$this->set_item( $order, $key, $item );
								}
							}
						}
					}
					break;
				default :
					if ( is_callable( array( $order, "set_{$key}" ) ) ) {
						$order->{"set_{$key}"}( $value );
					}
					break;
			}
		}
	}

	/**
	 * Filter the data for the insert.
	 *
	 * The dynamic portion of the hook name, $this->post_type, refers to post_type of the post being
	 * prepared for the response.
	 *
	 * @param WC_Order           $order      The order object.
	 * @param WP_REST_Request    $request    Request object.
	 */
	return apply_filters( "woocommerce_rest_pre_insert_{$this->post_type}", $order, $request );
}