BP_REST_Document_Endpoint::update_item( WP_REST_Request $request )
Update a document.
Description
Parameters
- $request
-
(Required) Full details about the request.
Return
(WP_REST_Response) | WP_Error
Source
File: bp-document/classes/class-bp-rest-document-endpoint.php
public function update_item( $request ) { $id = $request['id']; $documents = $this->assemble_response_data( array( 'document_ids' => array( $id ) ) ); if ( empty( $documents['documents'] ) ) { return new WP_Error( 'bp_rest_document_invalid_id', __( 'Invalid document ID.', 'buddyboss' ), array( 'status' => 404, ) ); } $document = end( $documents['documents'] ); $args = array( 'id' => $document->id, 'privacy' => $document->privacy, 'attachment_id' => $document->attachment_id, 'group_id' => $document->group_id, 'activity_id' => $document->activity_id, 'folder_id' => $document->folder_id, 'title' => $document->title, ); if ( isset( $request['group_id'] ) && ! empty( $request['group_id'] ) ) { $args['group_id'] = $request['group_id']; $args['privacy'] = 'grouponly'; } if ( isset( $request['folder_id'] ) && ! empty( $request['folder_id'] ) ) { $args['folder_id'] = $request['folder_id']; $parent_folder = new BP_Document_Folder( $args['folder_id'] ); $args['privacy'] = $parent_folder->privacy; } /** * Filter the query arguments for the request. * * @param array $args Key value array of query var to query value. * @param WP_REST_Request $request The request sent to the API. * * @since 0.1.0 */ $args = apply_filters( 'bp_rest_document_update_items_query_args', $args, $request ); if ( ! empty( $request['title'] ) ) { $document_rename = bp_document_rename_file( $document->id, $document->attachment_id, $request['title'] ); if ( ! isset( $document_rename['document_id'] ) || $document_rename['document_id'] < 1 ) { return new WP_Error( 'bp_rest_document_rename', $document_rename, array( 'status' => 404, ) ); } } if ( empty( $document->folder_id ) && ( ! isset( $request['folder_id'] ) || empty( $request['folder_id'] ) ) && isset( $request['privacy'] ) && ! empty( $request['privacy'] ) ) { bp_document_update_privacy( $document->id, $request['privacy'], 'document' ); } $id = $this->bp_rest_create_document( $args ); $status = true; if ( is_wp_error( $id ) ) { return $id; } if ( empty( $id ) ) { $status = false; } $documents = $this->assemble_response_data( array( 'document_ids' => array( $request['id'] ) ) ); $document = current( $documents['documents'] ); $fields_update = $this->update_additional_fields_for_object( $document, $request ); if ( is_wp_error( $fields_update ) ) { return $fields_update; } $retval = $this->prepare_response_for_collection( $this->prepare_item_for_response( $document, $request ) ); $response = new WP_REST_Response(); $response->set_data( array( 'updated' => $status, 'data' => $retval, ) ); /** * Fires after an document is updated via the REST API. * * @param WP_REST_Response $response The response data. * @param WP_REST_Request $request The request sent to the API. * * @since 0.1.0 */ do_action( 'bp_rest_document_update_item', $response, $request ); return $response; }
Changelog
Version | Description |
---|---|
0.1.0 | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.