Changeset 61987

Timestamp:

03/12/2026 01:21:11 PM (29 hours ago)

Author:

ellatrix

Message:

REST API: Support nested _fields in revisions controller.

Use rest_is_field_included() instead of in_array() for content, title, excerpt, and guid fields in WP_REST_Revisions_Controller. This lets clients request specific sub-fields (e.g. _fields=content.raw) and skip expensive the_content rendering.

The [REST API _fields documentation](​https://developer.wordpress.org/rest-api/using-the-rest-api/global-parameters/#_fields) states that nested fields are supported using dot notation. However, the revisions controller uses in_array() which doesn't match nested keys like content.raw.

Developed in: ​https://github.com/WordPress/wordpress-develop/pull/11230.

Props ellatrix, andrewserong, mukeshpanchal27.
Fixes #64844.

File:

• trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php (modified) (1 diff)

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php

@@ -640 +640 @@
         }
 
-        if ( in_array( 'guid', $fields, true ) ) {
-            $data['guid'] = array(
-                /** This filter is documented in wp-includes/post-template.php */
-                'rendered' => apply_filters( 'get_the_guid', $post->guid, $post->ID ),
-                'raw'      => $post->guid,
-            );
-        }
-
-        if ( in_array( 'title', $fields, true ) ) {
-            $data['title'] = array(
-                'raw'      => $post->post_title,
-                'rendered' => get_the_title( $post->ID ),
-            );
-        }
-
-        if ( in_array( 'content', $fields, true ) ) {
-
-            $data['content'] = array(
-                'raw'      => $post->post_content,
-                /** This filter is documented in wp-includes/post-template.php */
-                'rendered' => apply_filters( 'the_content', $post->post_content ),
-            );
-        }
-
-        if ( in_array( 'excerpt', $fields, true ) ) {
-            $data['excerpt'] = array(
-                'raw'      => $post->post_excerpt,
-                'rendered' => $this->prepare_excerpt_response( $post->post_excerpt, $post ),
-            );
+        if ( rest_is_field_included( 'guid', $fields ) ) {
+            $data['guid'] = array();
+        }
+        if ( rest_is_field_included( 'guid.rendered', $fields ) ) {
+            /** This filter is documented in wp-includes/post-template.php */
+            $data['guid']['rendered'] = apply_filters( 'get_the_guid', $post->guid, $post->ID );
+        }
+        if ( rest_is_field_included( 'guid.raw', $fields ) ) {
+            $data['guid']['raw'] = $post->guid;
+        }
+
+        if ( rest_is_field_included( 'title', $fields ) ) {
+            $data['title'] = array();
+        }
+        if ( rest_is_field_included( 'title.raw', $fields ) ) {
+            $data['title']['raw'] = $post->post_title;
+        }
+        if ( rest_is_field_included( 'title.rendered', $fields ) ) {
+            $data['title']['rendered'] = get_the_title( $post->ID );
+        }
+
+        if ( rest_is_field_included( 'content', $fields ) ) {
+            $data['content'] = array();
+        }
+        if ( rest_is_field_included( 'content.raw', $fields ) ) {
+            $data['content']['raw'] = $post->post_content;
+        }
+        if ( rest_is_field_included( 'content.rendered', $fields ) ) {
+            /** This filter is documented in wp-includes/post-template.php */
+            $data['content']['rendered'] = apply_filters( 'the_content', $post->post_content );
+        }
+
+        if ( rest_is_field_included( 'excerpt', $fields ) ) {
+            $data['excerpt'] = array();
+        }
+        if ( rest_is_field_included( 'excerpt.raw', $fields ) ) {
+            $data['excerpt']['raw'] = $post->post_excerpt;
+        }
+        if ( rest_is_field_included( 'excerpt.rendered', $fields ) ) {
+            $data['excerpt']['rendered'] = $this->prepare_excerpt_response( $post->post_excerpt, $post );
         }