From 84a81942009fe5c20dcd9dcac970a2b532a1a850 Mon Sep 17 00:00:00 2001
From: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Date: Wed, 15 Jun 2022 13:19:10 +0000
Subject: [PATCH] REST API: Some documentation and test improvements for
 `update_post_parent_caches()`:

* Make the function description more specific, for consistency with `update_post_author_caches()`.
* Add missing `@covers` tags for the unit test.

Follow-up to [53506].

See #55593.
Built from https://develop.svn.wordpress.org/trunk@53507


git-svn-id: http://core.svn.wordpress.org/trunk@53096 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/post.php                                         | 5 +++--
 .../rest-api/endpoints/class-wp-rest-posts-controller.php    | 3 ++-
 wp-includes/version.php                                      | 2 +-
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/wp-includes/post.php b/wp-includes/post.php
index 97a3fb8f77..07dd58980e 100644
--- a/wp-includes/post.php
+++ b/wp-includes/post.php
@@ -7490,16 +7490,17 @@ function update_post_author_caches( $posts ) {
 }
 
 /**
- * Prime post parent post caches.
+ * Updates parent post caches for a list of post objects.
  *
  * @since 6.1.0
  *
- * @param WP_Post[] $posts Array of Post objects.
+ * @param WP_Post[] $posts Array of post objects.
  */
 function update_post_parent_caches( $posts ) {
 	$parent_ids = wp_list_pluck( $posts, 'post_parent' );
 	$parent_ids = array_map( 'absint', $parent_ids );
 	$parent_ids = array_unique( array_filter( $parent_ids ) );
+
 	if ( ! empty( $parent_ids ) ) {
 		_prime_post_caches( $parent_ids, false );
 	}
diff --git a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php
index 87de7a2421..58be931937 100644
--- a/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php
+++ b/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php
@@ -369,8 +369,9 @@ class WP_REST_Posts_Controller extends WP_REST_Controller {
 
 		$posts = array();
 
-		update_post_parent_caches( $query_result );
 		update_post_author_caches( $query_result );
+		update_post_parent_caches( $query_result );
+
 		if ( post_type_supports( $this->post_type, 'thumbnail' ) ) {
 			update_post_thumbnail_cache( $posts_query );
 		}
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 1ef3f915b6..a47a548fff 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -16,7 +16,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '6.1-alpha-53506';
+$wp_version = '6.1-alpha-53507';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.