WC_API_Customers::validate_request() │ protected │ WC 2.1

Validate the request by checking:

1) the ID is a valid integer
2) the ID returns a valid WP_User
3) the current user has the proper permissions

Метод класса: WC_API_Customers{}

Хуков нет.

Возвращает

int|WP_Error. valid user ID or WP_Error if any of the checks fails

Использование

// protected - в коде основоного (родительского) или дочернего класса
$result = $this->validate_request( $id, $type, $context );

$id(строка|int) (обязательный)

the customer ID

$type(строка) (обязательный)

the request type, unused because this method overrides the parent class

$context(строка) (обязательный)

the context of the request, either read, edit or delete

Заметки

• Смотрите: WC_API_Resource::validate_request()

Список изменений

Код WC_API_Customers::validate_request() WC API Customers::validate request ^{WC 8.3.1}

protected function validate_request( $id, $type, $context ) {

	$id = absint( $id );

	// validate ID
	if ( empty( $id ) ) {
		return new WP_Error( 'woocommerce_api_invalid_customer_id', __( 'Invalid customer ID', 'woocommerce' ), array( 'status' => 404 ) );
	}

	// non-existent IDs return a valid WP_User object with the user ID = 0
	$customer = new WP_User( $id );

	if ( 0 === $customer->ID ) {
		return new WP_Error( 'woocommerce_api_invalid_customer', __( 'Invalid customer', 'woocommerce' ), array( 'status' => 404 ) );
	}

	// validate permissions
	switch ( $context ) {

		case 'read':
			if ( ! current_user_can( 'list_users' ) ) {
				return new WP_Error( 'woocommerce_api_user_cannot_read_customer', __( 'You do not have permission to read this customer', 'woocommerce' ), array( 'status' => 401 ) );
			}
			break;

		case 'edit':
			if ( ! current_user_can( 'edit_users' ) ) {
				return new WP_Error( 'woocommerce_api_user_cannot_edit_customer', __( 'You do not have permission to edit this customer', 'woocommerce' ), array( 'status' => 401 ) );
			}
			break;

		case 'delete':
			if ( ! current_user_can( 'delete_users' ) ) {
				return new WP_Error( 'woocommerce_api_user_cannot_delete_customer', __( 'You do not have permission to delete this customer', 'woocommerce' ), array( 'status' => 401 ) );
			}
			break;
	}

	return $id;
}