WP_REST_Posts_Controller::update_item_permissions_check( WP_REST_Request $request ): true|WP_Error

In this article

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

Parameters

$requestWP_REST_Requestrequired
Full details about the request.

Return

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

Source

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;
}

Changelog

VersionDescription
4.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.