From 435ab04c458f2965258700f5473dadc8e941ede7 Mon Sep 17 00:00:00 2001 From: Christoph Daum Date: Sun, 8 Mar 2026 11:08:43 +0100 Subject: [PATCH] Docs: add PHPDoc for rest_revision_query filter Replace the incorrect "documented in posts-controller" cross-reference with a proper @since 4.7.0 PHPDoc block. Add @see WP_REST_Posts_Controller::get_items() to the method docblock to surface the parallel relationship. Related to https://core.trac.wordpress.org/ticket/64224 --- .../class-wp-rest-revisions-controller.php | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php b/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php index 99282e6d3e986..6d1de0fa5a2e2 100644 --- a/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php +++ b/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php @@ -226,6 +226,8 @@ protected function get_revision( $id ) { * * @since 4.7.0 * + * @see WP_REST_Posts_Controller::get_items() + * * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure. */ @@ -297,7 +299,17 @@ public function get_items( $request ) { $args['update_post_meta_cache'] = false; } - /** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php */ + /** + * Filters WP_Query arguments when querying revisions via the REST API. + * + * Serves the same purpose as the {@see 'rest_{$this->post_type}_query'} filter in + * WP_REST_Posts_Controller, but for the standalone WP_REST_Revisions_Controller. + * + * @since 4.7.0 + * + * @param array $args Array of arguments for WP_Query. + * @param WP_REST_Request $request The REST API request. + */ $args = apply_filters( 'rest_revision_query', $args, $request ); if ( ! is_array( $args ) ) { $args = array();