WP_REST_Posts_Controller::sanitize_post_statuses( string|array $statuses, WP_REST_Request $request, string $parameter ): array|WP_Error

In this article

Sanitizes and validates the list of post statuses, including whether the user can query private statuses.

Parameters

$statusesstring|arrayrequired
One or more post statuses.
$requestWP_REST_Requestrequired
Full details about the request.
$parameterstringrequired
Additional parameter to pass to validation.

Return

array|WP_Error A list of valid statuses, otherwise WP_Error object.

Source

public function sanitize_post_statuses( $statuses, $request, $parameter ) {
	$statuses = wp_parse_slug_list( $statuses );

	// The default status is different in WP_REST_Attachments_Controller.
	$attributes     = $request->get_attributes();
	$default_status = $attributes['args']['status']['default'];

	foreach ( $statuses as $status ) {
		if ( $status === $default_status ) {
			continue;
		}

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

		if ( current_user_can( $post_type_obj->cap->edit_posts ) || 'private' === $status && current_user_can( $post_type_obj->cap->read_private_posts ) ) {
			$result = rest_validate_request_arg( $status, $request, $parameter );
			if ( is_wp_error( $result ) ) {
				return $result;
			}
		} else {
			return new WP_Error(
				'rest_forbidden_status',
				__( 'Status is forbidden.' ),
				array( 'status' => rest_authorization_required_code() )
			);
		}
	}

	return $statuses;
}

Changelog

VersionDescription
4.7.0Introduced.

User Contributed Notes

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