WP_REST_Post_Statuses_Controller::get_items() WordPress Method
The WP_REST_Post_Statuses_Controller::get_items() method is used to retrieve a list of post statuses. This is useful for finding out which statuses are available for posts, and for creating custom endpoints that return a specific status.
WP_REST_Post_Statuses_Controller::get_items( WP_REST_Request $request ) #
Retrieves all post statuses, depending on user context.
Parameters
- $request
(WP_REST_Request)(Required)Full details about the request.
Return
(WP_REST_Response|WP_Error) Response object on success, or WP_Error object on failure.
Source
File: wp-includes/rest-api/endpoints/class-wp-rest-post-statuses-controller.php
public function get_items( $request ) { $data = array(); $statuses = get_post_stati( array( 'internal' => false ), 'object' ); $statuses['trash'] = get_post_status_object( 'trash' ); foreach ( $statuses as $slug => $obj ) { $ret = $this->check_read_permission( $obj ); if ( ! $ret ) { continue; } $status = $this->prepare_item_for_response( $obj, $request ); $data[ $obj->name ] = $this->prepare_response_for_collection( $status ); } return rest_ensure_response( $data ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
4.7.0 | Introduced. |