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

(string) (Required) The provided status.

$request

(WP_REST_Request) (Required) The request object.

$param

(string) (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

Version Description
5.6.0 Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_rest_posts_controller/check_status