WP_REST_Posts_Controller::check_status( string $status, WP_REST_Request $request, string $param )

Checks whether the status is valid for the given post.


Description

Allows for sending an update request with the current status, even if that status would not be acceptable.


Parameters

$status

(Required) The provided status.

$request

(Required) The request object.

$param

(Required) The parameter name.


Return

(true|WP_Error) True if the status is valid, or WP_Error if not.


Source

File: wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

	public function check_status( $status, $request, $param ) {
		if ( $request['id'] ) {
			$post = $this->get_post( $request['id'] );

			if ( ! is_wp_error( $post ) && $post->post_status === $status ) {
				return true;
			}
		}

		$args = $request->get_attributes()['args'][ $param ];

		return rest_validate_value_from_schema( $status, $args, $param );
	}


Changelog

Changelog
Version Description
5.6.0 Introduced.