WP_REST_Attachments_Controller::edit_media_item_permissions_check( WP_REST_Request $request ): true|WP_Error
- Since
- 5.5.0
- Source
wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php:1064
Checks if a given request has access to editing media.
Parameters
$requestWP_REST_Request- Full details about the request.
Return
true|WP_Error- True if the request has read access, WP_Error object otherwise.
Uses · 5
- 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.
- WP_Error::__construct()Initializes the error.
- WP_REST_Attachments_Controller::update_item_permissions_check()
Used by · 1
- WP_REST_Attachments_Controller::sideload_item_permissions_check()Checks if a given request has access to sideload a file.
Source
public function edit_media_item_permissions_check( $request ) { if ( ! current_user_can( 'upload_files' ) ) { return new WP_Error( 'rest_cannot_edit_image', __( 'Sorry, you are not allowed to upload media on this site.' ), array( 'status' => rest_authorization_required_code() ) ); } return $this->update_item_permissions_check( $request ); }History
Introduced in 5.5.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 7.1.0 tag, from
src/wp-includes/rest-api/endpoints/class-wp-rest-attachments-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.