WP_REST_Posts_Controller::update_item_permissions_check() │ public │ WP 4.7.0

Checks if a given request has access to update a post.

{} It's a method of the class: WP_REST_Posts_Controller{}

No Hooks.

Return

true|WP_Error. True if the request has access to update the item, WP_Error object otherwise.

Usage

$WP_REST_Posts_Controller = new WP_REST_Posts_Controller();
$WP_REST_Posts_Controller->update_item_permissions_check( $request );

$request(WP_REST_Request) (required)

Full details about the request.

Changelog

Code of WP_REST_Posts_Controller::update_item_permissions_check() WP REST Posts Controller::update item permissions check ^{WP 5.9.3}

public function update_item_permissions_check( $request ) {
	$post = $this->get_post( $request['id'] );
	if ( is_wp_error( $post ) ) {
		return $post;
	}

	$post_type = get_post_type_object( $this->post_type );

	if ( $post && ! $this->check_update_permission( $post ) ) {
		return new WP_Error(
			'rest_cannot_edit',
			__( 'Sorry, you are not allowed to edit this post.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	if ( ! empty( $request['author'] ) && get_current_user_id() !== $request['author'] && ! current_user_can( $post_type->cap->edit_others_posts ) ) {
		return new WP_Error(
			'rest_cannot_edit_others',
			__( 'Sorry, you are not allowed to update posts as this user.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	if ( ! empty( $request['sticky'] ) && ! current_user_can( $post_type->cap->edit_others_posts ) && ! current_user_can( $post_type->cap->publish_posts ) ) {
		return new WP_Error(
			'rest_cannot_assign_sticky',
			__( 'Sorry, you are not allowed to make posts sticky.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	if ( ! $this->check_assign_terms_permission( $request ) ) {
		return new WP_Error(
			'rest_cannot_assign_term',
			__( 'Sorry, you are not allowed to assign the provided terms.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	return true;
}