Changeset 37589 for trunk/src/wp-includes/query.php

Timestamp:

05/28/2016 03:09:09 AM (9 years ago)

Author:

boonebgorges

Message:

Allow term meta lazy-loading to be selectively disabled in WP_Query.

The process of lazy-loading can be resource intensive for object that have
terms in large numbers of taxonomies and are running a persistent object cache.
This new parameter allows the feature to be disabled in these cases.

Props DBrumbaugh10Up.
See #36953.

File:

• trunk/src/wp-includes/query.php (modified) (4 diffs)

trunk/src/wp-includes/query.php

@@ -1469 +1469 @@
      *              Introduced the `$comment_status` and `$ping_status` parameters.
      *              Introduced `RAND(x)` syntax for `$orderby`, which allows an integer seed value to random sorts.
-     * @since 4.6.0 Added 'post_name__in' support for `$orderby`.
+     * @since 4.6.0 Added 'post_name__in' support for `$orderby`. Introduced `$lazy_load_term_meta`.
      * @access public
      *
@@ -1568 +1568 @@
      *     @type bool         $update_post_meta_cache  Whether to update the post meta cache. Default true.
      *     @type bool         $update_post_term_cache  Whether to update the post term cache. Default true.
+     *     @type bool         $lazy_load_term_meta     Whether to lazy-load term meta. Setting to false will
+     *                                                 disable cache priming for term meta, so that each
+     *                                                 get_term_meta() call will hit the database.
+     *                                                 Defaults to the value of `$update_post_term_cache`.
      *     @type int          $w                       The week number of the year. Default empty. Accepts numbers 0-53.
      *     @type int          $year                    The four-digit year. Default empty. Accepts any four-digit year.
@@ -2546 +2550 @@
             $q['update_post_term_cache'] = true;
 
+        if ( ! isset( $q['lazy_load_term_meta'] ) ) {
+            $q['lazy_load_term_meta'] = $q['update_post_term_cache'];
+        }
+
         if ( !isset($q['update_post_meta_cache']) )
             $q['update_post_meta_cache'] = true;
@@ -3783 +3791 @@
         }
 
-        if ( $q['update_post_term_cache'] ) {
+        if ( $q['lazy_load_term_meta'] ) {
             wp_queue_posts_for_term_meta_lazyload( $this->posts );
         }