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.

git-svn-id: https://develop.svn.wordpress.org/trunk@53507 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Sergey Biryukov 2022-06-15 13:17:59 +00:00
parent 9a488568a0
commit 20ccbb1437
3 changed files with 8 additions and 4 deletions

View File

@ -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 );
}

View File

@ -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 );
}

View File

@ -1516,7 +1516,7 @@ class WP_Test_REST_Posts_Controller extends WP_Test_REST_Post_Type_Controller_Te
/**
* @ticket 55592
* @covers WP_REST_Posts_Controller::get_items()
* @covers WP_REST_Posts_Controller::get_items
*/
public function test_get_items_with_featured_media() {
$file = DIR_TESTDATA . '/images/canola.jpg';
@ -1789,6 +1789,8 @@ class WP_Test_REST_Posts_Controller extends WP_Test_REST_Post_Type_Controller_Te
/**
* @ticket 55593
* @covers WP_REST_Posts_Controller::get_items
* @covers update_post_parent_caches
*/
public function test_get_items_parent_ids_primed() {
$parent_id1 = self::$post_ids[0];