WP_REST_Terms_Controller::get_items_permissions_check( WP_REST_Request $request ): bool|WP_Error
- Since
- 4.7.0
- Source
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php:184
Checks if a request has access to read terms in the specified taxonomy.
Parameters
$requestWP_REST_Request- Full details about the request.
Return
bool|WP_Error- True if the request has read access, otherwise false or WP_Error object.
Uses · 8
- get_taxonomy()Retrieves the taxonomy object of $taxonomy.
- current_user_can()Returns whether the current user has the specified capability.
- __()Retrieves the translation of $text.
- rest_authorization_required_code()Returns a contextual HTTP error code for authorization failure.
- get_post()Retrieves post data given a post ID or post object.
- WP_REST_Terms_Controller::check_is_taxonomy_allowed()Checks that the taxonomy is valid.
- WP_Error::__construct()Initializes the error.
- WP_REST_Terms_Controller::check_read_terms_permission_for_post()Checks if the terms for a post can be read.
Used by · 1
- WP_REST_Menus_Controller::get_items_permissions_check()Checks if a request has access to read menus.
Source
public function get_items_permissions_check( $request ) { $tax_obj = get_taxonomy( $this->taxonomy ); if ( ! $tax_obj || ! $this->check_is_taxonomy_allowed( $this->taxonomy ) ) { return false; } if ( 'edit' === $request['context'] && ! current_user_can( $tax_obj->cap->edit_terms ) ) { return new WP_Error( 'rest_forbidden_context', __( 'Sorry, you are not allowed to edit terms in this taxonomy.' ), array( 'status' => rest_authorization_required_code() ) ); } if ( ! empty( $request['post'] ) ) { $post = get_post( $request['post'] ); if ( ! $post ) { return new WP_Error( 'rest_post_invalid_id', __( 'Invalid post ID.' ), array( 'status' => 400, ) ); } if ( ! $this->check_read_terms_permission_for_post( $post, $request ) ) { return new WP_Error( 'rest_forbidden_context', __( 'Sorry, you are not allowed to view terms for this post.' ), array( 'status' => rest_authorization_required_code(), ) ); } } return true; }History
Introduced in 4.7.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.8.8 tag, from
src/wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it. - Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.