Changeset 53483 for trunk/src/wp-includes/post.php

Timestamp:

06/10/2022 03:15:07 PM (3 years ago)

Author:

SergeyBiryukov

Message:

Query: Some documentation and test improvements for update_post_author_caches():

• Make the descriptions for update_post_author_caches() and update_post_caches() more specific.
• Move the unit test into its own file, for consistency with update_post_cache() tests. This also allows for using shared fixtures in case more tests are added in the future.

Follow-up to [53482].

See #55716.

File:

• trunk/src/wp-includes/post.php (modified) (3 diffs)

trunk/src/wp-includes/post.php

@@ -7425 +7425 @@
 
 /**
- * Calls major cache updating functions for list of Post objects.
+ * Updates post, term, and metadata caches for a list of post objects.
  *
  * @since 1.5.0
  *
- * @param WP_Post[] $posts             Array of Post objects
+ * @param WP_Post[] $posts             Array of post objects (passed by reference).
  * @param string    $post_type         Optional. Post type. Default 'post'.
  * @param bool      $update_term_cache Optional. Whether to update the term cache. Default true.
@@ -7476 +7476 @@
 
 /**
- * Prime post author user caches.
+ * Updates post author user 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_author_caches( $posts ) {
@@ -7486 +7486 @@
     $author_ids = array_map( 'absint', $author_ids );
     $author_ids = array_unique( array_filter( $author_ids ) );
+
     cache_users( $author_ids );
 }
 
 /**
- * Updates metadata cache for list of post IDs.
+ * Updates metadata cache for a list of post IDs.
  *
  * Performs SQL query to retrieve the metadata for the post IDs and updates the