WP_REST_Posts_Controller::sanitize_post_statuses()publicWP 4.7.0

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

Метод класса: WP_REST_Posts_Controller{}

Хуков нет.

Возвращает

Массив|WP_Error. A list of valid statuses, otherwise WP_Error object.

Использование

$WP_REST_Posts_Controller = new WP_REST_Posts_Controller();
$WP_REST_Posts_Controller->sanitize_post_statuses( $statuses, $request, $parameter );
$statuses(строка|массив) (обязательный)
One or more post statuses.
$request(WP_REST_Request) (обязательный)
Full details about the request.
$parameter(строка) (обязательный)
Additional parameter to pass to validation.

Список изменений

С версии 4.7.0 Введена.

Код WP_REST_Posts_Controller::sanitize_post_statuses() WP 6.4.3

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