# top-10/4.3.4/includes/class-top-ten-core-query.php WebberZone Top 10 — Popular Posts, version 4.3.4. 955 lines. - Page: https://pluginprobe.com/plugins/top-10/4.3.4/code/includes/class-top-ten-core-query.php - Raw: https://pluginprobe.com/plugins/top-10/4.3.4/raw/includes/class-top-ten-core-query.php - Modified: 2026-07-13T20:42:44+00:00 Line numbers below start at 1. Link to a line or a range by appending a fragment to the page URL, for example `https://pluginprobe.com/plugins/top-10/4.3.4/code/includes/class-top-ten-core-query.php#L10-L20`. ```php prepare_query_args( $args ); if ( isset( $args['top_ten_query'] ) && true === $args['top_ten_query'] && ! $this->is_top_ten_query ) { $this->hooks(); } } /** * Set up hooks. * * @since 4.0.0 */ public function hooks() { Hook_Registry::add_filter( 'pre_get_posts', array( $this, 'pre_get_posts' ), 10 ); Hook_Registry::add_filter( 'posts_fields', array( $this, 'posts_fields' ), 10, 2 ); Hook_Registry::add_filter( 'posts_join', array( $this, 'posts_join' ), 10, 2 ); Hook_Registry::add_filter( 'posts_where', array( $this, 'posts_where' ), 10, 2 ); Hook_Registry::add_filter( 'posts_orderby', array( $this, 'posts_orderby' ), 9999, 2 ); Hook_Registry::add_filter( 'posts_groupby', array( $this, 'posts_groupby' ), 10, 2 ); Hook_Registry::add_filter( 'posts_clauses', array( $this, 'posts_clauses' ), 20, 2 ); Hook_Registry::add_filter( 'posts_request', array( $this, 'posts_request' ), 20, 2 ); Hook_Registry::add_filter( 'posts_pre_query', array( $this, 'posts_pre_query' ), 10, 2 ); Hook_Registry::add_filter( 'the_posts', array( $this, 'the_posts' ), 10, 2 ); Hook_Registry::add_action( 'the_post', array( $this, 'switch_to_blog_in_loop' ) ); Hook_Registry::add_action( 'loop_end', array( $this, 'loop_end' ) ); } /** * Prepare the query variables. * * @since 3.0.0 * @see \WP_Query::parse_query() * @see tptn_get_registered_settings() * * @param string|array $args { * Optional. Array or string of Query parameters. * * @type array|string $blog_id An array or comma-separated string of blog IDs. * @type bool $daily Set to true to get the daily/custom period posts. False for overall. * @type array|string $include_cat_ids An array or comma-separated string of category/custom taxonomy term_taxonomy_ids. * @type array|string $include_post_ids An array or comma-separated string of post IDs. * @type int $offset Offset the related posts returned by this number. * @type bool $strict_limit If this is set to false, then it will fetch 3x posts. * } */ public function prepare_query_args( $args = array() ) { $tptn_settings = tptn_get_settings(); $defaults = array( 'blog_id' => get_current_blog_id(), 'daily' => false, 'include_cat_ids' => 0, 'include_post_ids' => 0, 'offset' => 0, 'strict_limit' => true, ); $defaults = array_merge( $defaults, $tptn_settings ); $args = wp_parse_args( $args, $defaults ); $args = Helpers::parse_wp_query_arguments( $args ); // Set necessary variables. $args['top_ten_query'] = true; $args['suppress_filters'] = false; $args['ignore_sticky_posts'] = true; $args['no_found_rows'] = true; // Store query args before we manipulate them. $this->input_query_args = $args; $this->is_top_ten_query = isset( $this->input_query_args['is_top_ten_query'] ) ? $this->input_query_args['is_top_ten_query'] : false; $this->table_name = Database::get_table( $args['daily'] ); $this->is_daily = $args['daily']; /** * Applies filters to the query arguments before executing the query. * * This function allows developers to modify the query arguments before the query is executed. * * @since 4.0.0 * * @param array $args The query arguments. * @param \WP_Term|\WP_Post_Type|\WP_Post|\WP_User|null $queried_object The queried object. */ $args = apply_filters( 'tptn_query_args_before', $args, get_queried_object() ); // Parse the blog_id argument to get an array of IDs. $this->blog_id = wp_parse_id_list( $args['blog_id'] ); if ( is_multisite() ) { if ( count( $this->blog_id ) > 1 || ( 1 === count( $this->blog_id ) && get_current_blog_id() !== (int) $this->blog_id[0] ) ) { $this->multiple_blogs = true; } } // Set the number of posts to be retrieved with over-fetch buffer for PHP exclusions. $requested_limit = (int) $args['limit']; if ( empty( $args['posts_per_page'] ) ) { if ( $args['strict_limit'] ) { // Calculate buffer size: min(limit * 1.5, limit + 20) capped at reasonable max. $buffer_limit = min( (int) ( $requested_limit * 1.5 ), $requested_limit + 20 ); $buffer_limit = min( $buffer_limit, 100 ); // Cap at 100 to prevent over-fetching. /** * Filter the query buffer limit for PHP exclusions. * * Allows developers to adjust the buffer size when many posts might be excluded * by PHP-side filtering to ensure enough posts are returned after exclusions. * * @since 4.2.0 * * @param int $buffer_limit Buffer limit for posts_per_page. * @param int $requested_limit Original requested limit. * @param array $args Query arguments. */ $buffer_limit = apply_filters( 'tptn_query_buffer_limit', $buffer_limit, $requested_limit, $args ); $args['posts_per_page'] = $buffer_limit; } else { $args['posts_per_page'] = $requested_limit * 3; } } if ( empty( $args['post_type'] ) ) { // If post_types is empty or contains a query string then use parse_str else consider it comma-separated. if ( ! empty( $args['post_types'] ) && is_array( $args['post_types'] ) ) { $post_types = $args['post_types']; } elseif ( ! empty( $args['post_types'] ) && false === strpos( $args['post_types'], '=' ) ) { $post_types = explode( ',', $args['post_types'] ); } else { parse_str( $args['post_types'], $post_types ); // Save post types in $post_types variable. } // If post_types is empty or if we want all the post types. if ( empty( $post_types ) || 'all' === $args['post_types'] ) { $post_types = get_post_types( array( 'public' => true, ) ); } /** * Filter the post_types passed to the query. * * @since 2.2.0 * @since 3.0.0 Changed second argument from post ID to $args. * * @param array $post_types Array of post types to filter by. * @param array $args Arguments array. */ $args['post_type'] = apply_filters( 'top_ten_posts_post_types', $post_types, $args ); } // Tax Query. if ( ! empty( $args['tax_query'] ) && is_array( $args['tax_query'] ) ) { $tax_query = $args['tax_query']; } else { $tax_query = array(); } if ( ! empty( $args['include_cat_ids'] ) ) { /** * Filter to include the parent terms when including terms. * * @since 4.0.0 * * @param bool|string $include_terms_include_parents False to exclude only the categories specified, * 'parent' to include the parent categories and * 'all' to include all the ancestors. Default is false. */ $include_terms_include_parents = apply_filters( 'top_ten_query_include_terms_include_parents', false ); $include_terms_include_parents = $include_terms_include_parents ? wz_get_all_parent_ids( wp_parse_id_list( $args['include_cat_ids'] ), $include_terms_include_parents ) : wp_parse_id_list( $args['include_cat_ids'] ); $tax_query[] = array( 'field' => 'term_taxonomy_id', 'terms' => $include_terms_include_parents, 'include_children' => false, ); } if ( ! empty( $args['exclude_categories'] ) ) { /** * Filter to include the parent categories when excluding categories. * * @since 4.0.0 * * @param bool|string $exclude_terms_include_parents False to exclude only the categories specified, * 'parent' to include the parent categories and * 'all' to include all the ancestors. Default is false. */ $exclude_terms_include_parents = apply_filters( 'top_ten_query_exclude_terms_include_parents', false ); $exclude_categories = $exclude_terms_include_parents ? wz_get_all_parent_ids( wp_parse_id_list( $args['exclude_categories'] ), $exclude_terms_include_parents ) : wp_parse_id_list( $args['exclude_categories'] ); $tax_query[] = array( 'field' => 'term_taxonomy_id', 'terms' => $exclude_categories, 'operator' => 'NOT IN', 'include_children' => false, ); } /** * Filter the tax_query passed to the query. * * @since 3.0.0 * * @param array $tax_query Array of tax_query parameters. * @param array $args Arguments array. */ $tax_query = apply_filters( 'top_ten_query_tax_query', $tax_query, $args ); // Add a relation key if more than one $tax_query. if ( count( $tax_query ) > 1 && ! isset( $tax_query['relation'] ) ) { /** * Filter the tax_query relation parameter. * * @since 3.2.0 * * @param string $relation The logical relationship between each inner taxonomy array when there is more than one. Default is 'AND'. * @param array $args Arguments array. */ $tax_query['relation'] = apply_filters( 'top_ten_query_tax_query_relation', 'AND', $args ); } $args['tax_query'] = $tax_query; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_tax_query // Set date_query. if ( ! empty( $args['date_query'] ) && is_array( $args['date_query'] ) ) { // If date_query is already provided, use it as-is. $date_query = $args['date_query']; } else { // Create date_query from how_old parameter. $date_query = array( array( 'after' => $args['how_old'] ? Helpers::get_from_date( null, $args['how_old'] + 1, 0 ) : '', 'before' => current_time( 'mysql' ), 'inclusive' => true, ), ); } /** * Filter the date_query passed to \WP_Query. * * @since 3.2.0 * * @param array $date_query Array of date parameters to be passed to \WP_Query. * @param array $args Arguments array. */ $args['date_query'] = apply_filters( 'top_ten_query_date_query', $date_query, $args ); // Meta Query. if ( ! empty( $args['meta_query'] ) && is_array( $args['meta_query'] ) ) { $meta_query = $args['meta_query']; } else { $meta_query = array(); } /** * Filter the meta_query passed to \WP_Query. * * @since 3.2.0 * * @param mixed $meta_query Array of meta_query parameters. * @param array $args Arguments array. */ $meta_query = apply_filters( 'top_ten_query_meta_query', $meta_query, $args ); // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query // Validate meta_query structure. if ( ! is_array( $meta_query ) ) { $meta_query = array(); } // Add a relation key if more than one $meta_query and if 'relation' is not already set. if ( count( $meta_query ) > 1 && ! isset( $meta_query['relation'] ) ) { /** * Filter the meta_query relation parameter. * * @since 3.2.0 * * @param string $relation The logical relationship between each inner meta_query array when there is more than one. Default is 'AND'. * @param array $args Arguments array. */ $meta_query['relation'] = apply_filters( 'top_ten_query_meta_query_relation', 'AND', $args ); } $args['meta_query'] = $meta_query; // phpcs:ignore WordPress.DB.SlowDBQuery.slow_db_query_meta_query // Set post_status. $args['post_status'] = empty( $args['post_status'] ) ? array( 'publish', 'inherit' ) : $args['post_status']; // Unset what we don't need. unset( $args['title'] ); unset( $args['title_daily'] ); unset( $args['blank_output'] ); unset( $args['blank_output_text'] ); unset( $args['show_excerpt'] ); unset( $args['excerpt_length'] ); unset( $args['show_date'] ); unset( $args['show_author'] ); unset( $args['disp_list_count'] ); unset( $args['title_length'] ); unset( $args['link_new_window'] ); unset( $args['link_nofollow'] ); unset( $args['before_list'] ); unset( $args['after_list'] ); unset( $args['before_list_item'] ); unset( $args['after_list_item'] ); /** * Filters the arguments of the query. * * @since 3.0.0 * * @param array $args The arguments of the query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $this->query_args = apply_filters_ref_array( 'top_ten_query_args', array( $args, &$this ) ); if ( $this->should_cache() && ! $this->in_cache ) { // Handle exclude_current_post by adding current_post_id for cache key consistency. $cache_args = $this->query_args; if ( ! empty( $cache_args['exclude_current_post'] ) ) { $cache_args['current_post_id'] = (int) get_the_ID(); } $this->cache_name = \WebberZone\Top_Ten\Util\Cache::get_key( $cache_args ); } } /** * Modify the pre_get_posts clause. * * @since 4.0.0 * * @param \WP_Query $query The WP_Query instance. */ public function pre_get_posts( $query ) { if ( true === $query->get( 'top_ten_query' ) ) { $query_args_keys = array( 'date_query', 'tax_query', 'meta_query', 'post_type', 'post_status', 'posts_per_page', 'offset', 'author', ); foreach ( $query_args_keys as $key ) { if ( ! empty( $this->query_args[ $key ] ) ) { $query->set( $key, $this->query_args[ $key ] ); } } $query->set( 'suppress_filters', false ); $query->set( 'no_found_rows', true ); $query->set( 'ignore_sticky_posts', true ); remove_filter( 'pre_get_posts', array( $this, 'pre_get_posts' ) ); } } /** * Modify the SELECT clause - posts_fields. * * @since 3.0.0 * * @param string $fields The SELECT clause of the query. * @param \WP_Query $query The \WP_Query instance. * @return string Updated Fields */ public function posts_fields( $fields, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $fields; } $_fields[] = "{$this->table_name}.postnumber"; $_fields[] = $this->is_daily ? "SUM({$this->table_name}.cntaccess) as visits" : "{$this->table_name}.cntaccess as visits"; $_fields[] = "{$this->table_name}.blog_id"; $_fields = implode( ', ', $_fields ); $fields .= ',' . $_fields; /** * Filters the fields returned by the SELECT clause. * * @since 3.2.0 * * @param string $fields The fields returned by the SELECT clause. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $fields = apply_filters_ref_array( 'top_ten_query_posts_fields', array( $fields, &$this ) ); remove_filter( 'posts_fields', array( $this, 'posts_fields' ) ); return $fields; } /** * Modify the posts_join clause. * * @since 3.0.0 * * @param string $join The JOIN clause of the query. * @param \WP_Query $query The \WP_Query instance. * @return string Updated JOIN */ public function posts_join( $join, $query ) { global $wpdb; // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $join; } $join .= " INNER JOIN {$this->table_name} ON {$this->table_name}.postnumber={$wpdb->posts}.ID "; /** * Filters the JOIN clause of Top_Ten_Core_Query. * * @since 3.2.0 * * @param string $join The JOIN clause of the Query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $join = apply_filters_ref_array( 'top_ten_query_posts_join', array( $join, &$this ) ); remove_filter( 'posts_join', array( $this, 'posts_join' ) ); return $join; } /** * Modify the posts_where clause. * * @since 3.0.0 * * @param string $where The WHERE clause of the query. * @param \WP_Query $query The \WP_Query instance. * @return string Updated WHERE */ public function posts_where( $where, $query ) { global $wpdb; // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $where; } if ( ! $this->multiple_blogs ) { $where .= " AND {$this->table_name}.blog_id IN ('" . join( "', '", $this->blog_id ) . "') "; // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared } if ( $this->is_daily ) { if ( isset( $this->query_args['from_date'] ) ) { $from_date = Helpers::get_from_date( $this->query_args['from_date'], 0, 0 ); } else { $from_date = Helpers::get_from_date( null, $this->query_args['daily_range'], $this->query_args['hour_range'] ); } $where .= $wpdb->prepare( " AND {$this->table_name}.dp_date >= %s ", $from_date ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared if ( isset( $this->query_args['to_date'] ) ) { $to_date = Helpers::get_from_date( $this->query_args['to_date'], 0, 0 ); $where .= $wpdb->prepare( " AND {$this->table_name}.dp_date <= %s ", $to_date ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared } } /** * Filters the WHERE clause of Top_Ten_Core_Query. * * @since 3.2.0 * * @param string $where The WHERE clause of the Query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $where = apply_filters_ref_array( 'top_ten_query_posts_where', array( $where, &$this ) ); remove_filter( 'posts_where', array( $this, 'posts_where' ) ); return $where; } /** * Modify the ORDER BY clause of the query. * * @since 3.0.0 * * @param string $orderby The current ORDER BY clause. * @param \WP_Query $query The current query instance. * @return string Modified ORDER BY clause. */ public function posts_orderby( $orderby, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $orderby; } // Use WP_Query's parse_order method to get a valid order. $query_orderby = $query->get( 'orderby' ); $order = $query->parse_order( $query->get( 'order' ) ); // Preserve intentional orderby values except the plugin's visits alias. if ( is_array( $query_orderby ) && isset( $query_orderby['visits'] ) ) { $visits_order = $query->parse_order( $query_orderby['visits'] ); $orderby = empty( $orderby ) ? "visits $visits_order, {$this->table_name}.postnumber $visits_order" : "visits $visits_order, {$orderby}"; } elseif ( empty( $query_orderby ) || 'visits' === $query_orderby ) { $orderby = "visits $order, {$this->table_name}.postnumber $order"; } /** * Filters the ORDER BY clause of Top_Ten_Core_Query. * * @since 3.2.0 * * @param string $orderby The ORDER BY clause of the Query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $orderby = apply_filters_ref_array( 'top_ten_query_posts_orderby', array( $orderby, &$this ) ); remove_filter( 'posts_orderby', array( $this, 'posts_orderby' ), 9999 ); return $orderby; } /** * Modify the posts_groupby clause. * * @since 3.0.0 * * @param string $groupby The GROUP BY clause of the query. * @param \WP_Query $query The \WP_Query instance. * @return string Updated GROUP BY */ public function posts_groupby( $groupby, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $groupby; } if ( $this->is_daily ) { $groupby = " {$this->table_name}.postnumber "; } /** * Filters the GROUP BY clause of Top_Ten_Core_Query. * * @since 3.2.0 * * @param string $groupby The GROUP BY clause of the Query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $groupby = apply_filters_ref_array( 'top_ten_query_posts_groupby', array( $groupby, &$this ) ); remove_filter( 'posts_groupby', array( $this, 'posts_groupby' ) ); return $groupby; } /** * Modify posts_clauses in WP_Query to handle multiple blogs. * * @since 3.2.0 * * @param array $clauses Query clauses. * @param \WP_Query $query The \WP_Query instance. * @return array Updated Query Clauses. */ public function posts_clauses( $clauses, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $clauses; } $this->ms_select = array(); if ( $this->multiple_blogs ) { global $wpdb; $root_site_db_prefix = $wpdb->prefix; foreach ( $this->blog_id as $blog_id ) { switch_to_blog( $blog_id ); $ms_select = " SELECT {$clauses['fields']} FROM {$root_site_db_prefix}posts {$clauses['join']} WHERE 1=1 {$clauses['where']} "; $ms_select .= $wpdb->prepare( " AND {$this->table_name}.blog_id = %d", $blog_id ); // phpcs:ignore WordPress.DB.PreparedSQL.InterpolatedNotPrepared if ( $this->is_daily ) { $ms_select .= " GROUP BY {$this->table_name}.postnumber "; } $ms_select = str_replace( $root_site_db_prefix, $wpdb->prefix, $ms_select ); $ms_select = str_replace( "{$wpdb->prefix}top_ten", "{$wpdb->base_prefix}top_ten", $ms_select ); $this->ms_select[] = $ms_select; restore_current_blog(); } // Update the clauses. $clauses['fields'] = 'tables.*'; $clauses['where'] = ''; $clauses['join'] = ''; $clauses['groupby'] = ''; } /** * Filters all query clauses at once, for convenience. * * @since 3.2.0 * * @param array $clauses The GROUP BY clause of the Query. * @param Top_Ten_Core_Query $query The Top_Ten_Core_Query instance (passed by reference). */ $clauses = apply_filters_ref_array( 'top_ten_query_posts_clauses', array( $clauses, &$this ) ); return $clauses; } /** * Modify the completed SQL query before sending. * * @since 3.2.0 * * @param string $sql The complete SQL query. * @param \WP_Query $query The \WP_Query instance (passed by reference). * @return string Updated SQL. */ public function posts_request( $sql, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $sql; } if ( $this->multiple_blogs ) { global $wpdb; // Clean up remanescent WHERE request. $sql = str_replace( 'WHERE 1=1', '', $sql ); // Multisite request. $sql = str_replace( "FROM $wpdb->posts", 'FROM ( ' . implode( ' UNION ', $this->ms_select ) . ' ) tables', $sql ); } /** * Filters the completed SQL query before sending. * * @since 3.2.0 * * @param string $sql The complete SQL query. * @param Top_Ten_Core_Query $query The \WP_Query instance (passed by reference). */ $sql = apply_filters_ref_array( 'top_ten_query_posts_request', array( $sql, &$this ) ); remove_filter( 'posts_request', array( $this, 'posts_request' ) ); return $sql; } /** * Update the_post while \WP_Query loops through this. * * @since 3.2.0 * * @param \WP_Post $post The Post object (passed by reference). */ public function switch_to_blog_in_loop( $post ) { global $blog_id; if ( $this->multiple_blogs ) { if ( isset( $post->blog_id ) && (int) $blog_id !== (int) $post->blog_id ) { switch_to_blog( $post->blog_id ); } else { restore_current_blog(); } } } /** * Restore current blog on loop end. * * @since 3.2.0 */ public function loop_end() { if ( $this->multiple_blogs ) { restore_current_blog(); } } /** * Filter posts_pre_query to allow caching to work. * * @since 3.0.0 * * @param \WP_Post[] $posts Array of post objects. * @param \WP_Query $query The WP_Query instance (passed by reference). * @return \WP_Post[] Updated Array of post objects. */ public function posts_pre_query( $posts, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $posts; } // Check the cache if there are any posts saved. if ( $this->should_cache() ) { $cache_name = $this->cache_name; $post_ids = get_transient( $cache_name ); if ( ! empty( $post_ids ) ) { $posts = get_posts( array( 'post__in' => array_unique( $post_ids ), 'fields' => $query->get( 'fields' ), 'orderby' => 'post__in', 'post_type' => $query->get( 'post_type' ), 'post_status' => $query->get( 'post_status' ), 'numberposts' => $query->get( 'posts_per_page' ), ) ); $query->found_posts = count( $posts ); $query->max_num_pages = (int) ceil( $query->found_posts / $query->get( 'posts_per_page' ) ); $this->in_cache = true; } } /** * Filters the posts_pre_query of Top_Ten_Query after processing and before returning. * * @since 4.0.0 * * @param \WP_Post[] $posts Array of post data. * @param \WP_Query $query The WP_Query instance. */ $posts = apply_filters( 'top_ten_query_posts_pre_query', $posts, $query ); remove_filter( 'posts_pre_query', array( $this, 'posts_pre_query' ) ); return $posts; } /** * Modify the array of retrieved posts. * * @since 3.0.0 * * @param \WP_Post[] $posts Array of post objects. * @param \WP_Query $query The \WP_Query instance (passed by reference). * @return \WP_Post[] Updated Array of post objects. */ public function the_posts( $posts, $query ) { // Return if it is not a Top_Ten_Core_Query. if ( true !== $query->get( 'top_ten_query' ) ) { return $posts; } // Support caching to speed up retrieval. if ( $this->should_cache() && ! $this->in_cache ) { /** This filter is defined in display-posts.php */ $cache_time = apply_filters( 'tptn_cache_time', $this->query_args['cache_time'], $this->query_args ); $cache_name = $this->cache_name; $post_ids = wp_list_pluck( $query->posts, 'ID' ); set_transient( $cache_name, $post_ids, $cache_time ); } if ( ! empty( $this->query_args['include_post_ids'] ) ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison $include_post_ids = wp_parse_id_list( $this->query_args['include_post_ids'] ); } if ( ! empty( $include_post_ids ) ) { $extra_posts = get_posts( array( 'include' => $include_post_ids, 'fields' => $query->get( 'fields' ), 'orderby' => 'post__in', 'post_type' => $query->get( 'post_type' ), 'post_status' => $query->get( 'post_status' ), ) ); $posts = array_merge( $extra_posts, $posts ); } // Shuffle posts if random order is set. if ( $this->random_order ) { shuffle( $posts ); } /** * Filter array of WP_Post objects before it is returned to the Top_Ten_Core_Query instance. * * @since 3.0.0 * * @param \WP_Post[] $posts Array of post objects. * @param array $args Arguments array. */ $posts = apply_filters( 'top_ten_query_the_posts', $posts, $this->query_args ); remove_filter( 'the_posts', array( $this, 'the_posts' ) ); return $posts; } /** * Determines if caching should be enabled for the current query. * * @since 4.1.0 * * @return bool Whether caching should be enabled. */ protected function should_cache() { return ! empty( $this->query_args['cache_posts'] ) && ! ( is_preview() || is_admin() || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) ); } } ```