2016-08-25 13:20:38 -04:00
< ? php
/**
* Query API : WP_Query class
*
* @ package WordPress
* @ subpackage Query
* @ since 4.7 . 0
*/
/**
* The WordPress Query class .
*
2019-07-25 18:45:57 -04:00
* @ link https :// developer . wordpress . org / reference / classes / wp_query /
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ since 4.5 . 0 Removed the `$comments_popup` property .
*/
class WP_Query {
/**
* Query vars set by the user
*
* @ since 1.5 . 0
* @ var array
*/
public $query ;
/**
* Query vars , after parsing
*
* @ since 1.5 . 0
* @ var array
*/
public $query_vars = array ();
/**
* Taxonomy query , as passed to get_tax_sql ()
*
* @ since 3.1 . 0
2020-07-23 03:39:02 -04:00
* @ var WP_Tax_Query A taxonomy query instance .
2016-08-25 13:20:38 -04:00
*/
public $tax_query ;
/**
* Metadata query container
*
* @ since 3.2 . 0
2020-07-23 03:39:02 -04:00
* @ var WP_Meta_Query A meta query instance .
2016-08-25 13:20:38 -04:00
*/
public $meta_query = false ;
/**
* Date query container
*
* @ since 3.7 . 0
2020-07-23 03:39:02 -04:00
* @ var WP_Date_Query A date query instance .
2016-08-25 13:20:38 -04:00
*/
public $date_query = false ;
/**
* Holds the data for a single object that is queried .
*
* Holds the contents of a post , page , category , attachment .
*
* @ since 1.5 . 0
2020-10-10 15:14:04 -04:00
* @ var WP_Term | WP_Post_Type | WP_Post | WP_User | null
2016-08-25 13:20:38 -04:00
*/
public $queried_object ;
/**
* The ID of the queried object .
*
* @ since 1.5 . 0
* @ var int
*/
public $queried_object_id ;
/**
* Get post database query .
*
* @ since 2.0 . 1
* @ var string
*/
public $request ;
/**
* List of posts .
*
* @ since 1.5 . 0
* @ var array
*/
public $posts ;
/**
* The amount of posts for the current query .
*
* @ since 1.5 . 0
* @ var int
*/
public $post_count = 0 ;
/**
* Index of the current item in the loop .
*
* @ since 1.5 . 0
* @ var int
*/
public $current_post = - 1 ;
/**
* Whether the loop has started and the caller is in the loop .
*
* @ since 2.0 . 0
* @ var bool
*/
public $in_the_loop = false ;
/**
* The current post .
*
* @ since 1.5 . 0
* @ var WP_Post
*/
public $post ;
/**
* The list of comments for current post .
*
* @ since 2.2 . 0
* @ var array
*/
public $comments ;
/**
* The amount of comments for the posts .
*
* @ since 2.2 . 0
* @ var int
*/
public $comment_count = 0 ;
/**
* The index of the comment in the comment loop .
*
* @ since 2.2 . 0
* @ var int
*/
public $current_comment = - 1 ;
/**
* Current comment ID .
*
* @ since 2.2 . 0
* @ var int
*/
public $comment ;
/**
* The amount of found posts for the current query .
*
* If limit clause was not used , equals $post_count .
*
* @ since 2.1 . 0
* @ var int
*/
public $found_posts = 0 ;
/**
* The amount of pages .
*
* @ since 2.1 . 0
* @ var int
*/
public $max_num_pages = 0 ;
/**
* The amount of comment pages .
*
* @ since 2.7 . 0
* @ var int
*/
public $max_num_comment_pages = 0 ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a single post .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_single = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a preview .
2016-08-25 13:20:38 -04:00
*
* @ since 2.0 . 0
* @ var bool
*/
public $is_preview = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a page .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_page = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_archive = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a date archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_date = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a year archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_year = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a month archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_month = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a day archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_day = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a specific time .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_time = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an author archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_author = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a category archive .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_category = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a tag archive .
2016-08-25 13:20:38 -04:00
*
* @ since 2.3 . 0
* @ var bool
*/
public $is_tag = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a taxonomy archive .
2016-08-25 13:20:38 -04:00
*
* @ since 2.5 . 0
* @ var bool
*/
public $is_tax = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a search .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_search = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a feed .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_feed = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a comment feed .
2016-08-25 13:20:38 -04:00
*
* @ since 2.2 . 0
* @ var bool
*/
public $is_comment_feed = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for trackback endpoint call .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_trackback = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for the site homepage .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_home = false ;
2019-03-21 15:48:50 -04:00
/**
* Signifies whether the current query is for the Privacy Policy page .
*
* @ since 5.2 . 0
* @ var bool
*/
public $is_privacy_policy = false ;
2016-08-25 13:20:38 -04:00
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query couldn ' t find anything .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_404 = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an embed .
2016-08-25 13:20:38 -04:00
*
* @ since 4.4 . 0
* @ var bool
*/
public $is_embed = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a paged result and not for the first page .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_paged = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an administrative interface page .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ var bool
*/
public $is_admin = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an attachment page .
2016-08-25 13:20:38 -04:00
*
* @ since 2.0 . 0
* @ var bool
*/
public $is_attachment = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for an existing single post of any post type
* ( post , attachment , page , custom post types ) .
2016-08-25 13:20:38 -04:00
*
* @ since 2.1 . 0
* @ var bool
*/
public $is_singular = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for the robots . txt file .
2016-08-25 13:20:38 -04:00
*
* @ since 2.1 . 0
* @ var bool
*/
public $is_robots = false ;
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
/**
* Signifies whether the current query is for the favicon . ico file .
*
* @ since 5.4 . 0
* @ var bool
*/
public $is_favicon = false ;
2016-08-25 13:20:38 -04:00
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for the page_for_posts page .
2016-08-25 13:20:38 -04:00
*
* Basically , the homepage if the option isn ' t set for the static homepage .
*
* @ since 2.1 . 0
* @ var bool
*/
public $is_posts_page = false ;
/**
2017-06-29 23:44:46 -04:00
* Signifies whether the current query is for a post type archive .
2016-08-25 13:20:38 -04:00
*
* @ since 3.1 . 0
* @ var bool
*/
public $is_post_type_archive = false ;
/**
* Stores the -> query_vars state like md5 ( serialize ( $this -> query_vars ) ) so we know
* whether we have to re - parse because something has changed
*
* @ since 3.1 . 0
* @ var bool | string
*/
private $query_vars_hash = false ;
/**
* Whether query vars have changed since the initial parse_query () call . Used to catch modifications to query vars made
* via pre_get_posts hooks .
*
* @ since 3.1 . 1
*/
private $query_vars_changed = true ;
/**
* Set if post thumbnails are cached
*
* @ since 3.2 . 0
* @ var bool
*/
2017-11-26 18:57:55 -05:00
public $thumbnails_cached = false ;
2016-08-25 13:20:38 -04:00
/**
* Cached list of search stopwords .
*
* @ since 3.7 . 0
* @ var array
*/
private $stopwords ;
private $compat_fields = array ( 'query_vars_hash' , 'query_vars_changed' );
private $compat_methods = array ( 'init_query_flags' , 'parse_tax_query' );
/**
* Resets query flags to false .
*
* The query flags are what page info WordPress was able to figure out .
*
* @ since 2.0 . 0
*/
private function init_query_flags () {
2017-11-30 18:11:00 -05:00
$this -> is_single = false ;
$this -> is_preview = false ;
$this -> is_page = false ;
$this -> is_archive = false ;
$this -> is_date = false ;
$this -> is_year = false ;
$this -> is_month = false ;
$this -> is_day = false ;
$this -> is_time = false ;
$this -> is_author = false ;
$this -> is_category = false ;
$this -> is_tag = false ;
$this -> is_tax = false ;
$this -> is_search = false ;
$this -> is_feed = false ;
$this -> is_comment_feed = false ;
$this -> is_trackback = false ;
$this -> is_home = false ;
2019-03-21 15:48:50 -04:00
$this -> is_privacy_policy = false ;
2017-11-30 18:11:00 -05:00
$this -> is_404 = false ;
$this -> is_paged = false ;
$this -> is_admin = false ;
$this -> is_attachment = false ;
$this -> is_singular = false ;
$this -> is_robots = false ;
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
$this -> is_favicon = false ;
2017-11-30 18:11:00 -05:00
$this -> is_posts_page = false ;
2016-08-25 13:20:38 -04:00
$this -> is_post_type_archive = false ;
}
/**
* Initiates object properties and sets default values .
*
* @ since 1.5 . 0
*/
public function init () {
2017-11-30 18:11:00 -05:00
unset ( $this -> posts );
unset ( $this -> query );
2016-08-25 13:20:38 -04:00
$this -> query_vars = array ();
2017-11-30 18:11:00 -05:00
unset ( $this -> queried_object );
unset ( $this -> queried_object_id );
$this -> post_count = 0 ;
2016-08-25 13:20:38 -04:00
$this -> current_post = - 1 ;
2017-11-30 18:11:00 -05:00
$this -> in_the_loop = false ;
2016-08-25 13:20:38 -04:00
unset ( $this -> request );
unset ( $this -> post );
unset ( $this -> comments );
unset ( $this -> comment );
2017-11-30 18:11:00 -05:00
$this -> comment_count = 0 ;
$this -> current_comment = - 1 ;
$this -> found_posts = 0 ;
$this -> max_num_pages = 0 ;
2016-08-25 13:20:38 -04:00
$this -> max_num_comment_pages = 0 ;
$this -> init_query_flags ();
}
/**
* Reparse the query vars .
*
* @ since 1.5 . 0
*/
public function parse_query_vars () {
$this -> parse_query ();
}
/**
* Fills in the query variables , which do not exist within the parameter .
*
* @ since 2.1 . 0
2019-09-20 13:44:59 -04:00
* @ since 4.5 . 0 Removed the `comments_popup` public query variable .
2016-08-25 13:20:38 -04:00
*
* @ param array $array Defined query variables .
* @ return array Complete query variables with undefined ones filled in empty .
*/
2017-11-30 18:11:00 -05:00
public function fill_query_vars ( $array ) {
2016-08-25 13:20:38 -04:00
$keys = array (
2017-11-30 18:11:00 -05:00
'error' ,
'm' ,
'p' ,
'post_parent' ,
'subpost' ,
'subpost_id' ,
'attachment' ,
'attachment_id' ,
'name' ,
'pagename' ,
'page_id' ,
'second' ,
'minute' ,
'hour' ,
'day' ,
'monthnum' ,
'year' ,
'w' ,
'category_name' ,
'tag' ,
'cat' ,
'tag_id' ,
'author' ,
'author_name' ,
'feed' ,
'tb' ,
'paged' ,
'meta_key' ,
'meta_value' ,
'preview' ,
's' ,
'sentence' ,
'title' ,
'fields' ,
'menu_order' ,
'embed' ,
2016-08-25 13:20:38 -04:00
);
foreach ( $keys as $key ) {
2017-11-30 18:11:00 -05:00
if ( ! isset ( $array [ $key ] ) ) {
$array [ $key ] = '' ;
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$array_keys = array (
'category__in' ,
'category__not_in' ,
'category__and' ,
'post__in' ,
'post__not_in' ,
'post_name__in' ,
'tag__in' ,
'tag__not_in' ,
'tag__and' ,
'tag_slug__in' ,
'tag_slug__and' ,
'post_parent__in' ,
'post_parent__not_in' ,
'author__in' ,
'author__not_in' ,
);
2016-08-25 13:20:38 -04:00
foreach ( $array_keys as $key ) {
2017-11-30 18:11:00 -05:00
if ( ! isset ( $array [ $key ] ) ) {
$array [ $key ] = array ();
}
2016-08-25 13:20:38 -04:00
}
return $array ;
}
/**
* Parse a query string and set query type booleans .
*
* @ since 1.5 . 0
* @ since 4.2 . 0 Introduced the ability to order by specific clauses of a `$meta_query` , by passing the clause ' s
* array key to `$orderby` .
* @ since 4.4 . 0 Introduced `$post_name__in` and `$title` parameters . `$s` was updated to support excluded
* search terms , by prepending a hyphen .
* @ since 4.5 . 0 Removed the `$comments_popup` parameter .
* 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` . Introduced the `$lazy_load_term_meta` argument .
2017-07-01 07:25:44 -04:00
* @ since 4.9 . 0 Introduced the `$comment_count` parameter .
2019-01-09 09:55:49 -05:00
* @ since 5.1 . 0 Introduced the `$meta_compare_key` parameter .
Query: Expand the list of operators available to `compare_key` in `WP_Meta_Query`.
`compare_key`, introduced in #42409, previously supported only `=` and `LIKE`
operators. This changeset introduces a number of other operators: `!=`, `IN`,
`NOT IN`, `NOT LIKE`, `RLIKE`, `REGEXP`, `NOT REGEXP`, `EXISTS`, and `NOT EXISTS`
(the latter two aliased to `=` and `!=`, respectively). To support case-sensitive
regular expression key comparisons, the new `type_key` parameter will force
a MySQL `CAST` when 'BINARY' is passed.
Props soulseekah.
Fixes #43346.
Built from https://develop.svn.wordpress.org/trunk@46188
git-svn-id: http://core.svn.wordpress.org/trunk@46000 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-19 11:03:56 -04:00
* @ since 5.3 . 0 Introduced the `$meta_type_key` parameter .
2016-08-25 13:20:38 -04:00
*
* @ param string | array $query {
* Optional . Array or string of Query parameters .
*
* @ type int $attachment_id Attachment post ID . Used for 'attachment' post_type .
* @ type int | string $author Author ID , or comma - separated list of IDs .
* @ type string $author_name User 'user_nicename' .
* @ type array $author__in An array of author IDs to query from .
* @ type array $author__not_in An array of author IDs not to query from .
* @ type bool $cache_results Whether to cache post information . Default true .
* @ type int | string $cat Category ID or comma - separated list of IDs ( this or any children ) .
* @ type array $category__and An array of category IDs ( AND in ) .
* @ type array $category__in An array of category IDs ( OR in , no children ) .
* @ type array $category__not_in An array of category IDs ( NOT in ) .
* @ type string $category_name Use category slug ( not name , this or any children ) .
2017-07-01 07:25:44 -04:00
* @ type array | int $comment_count Filter results by comment count . Provide an integer to match
* comment count exactly . Provide an array with integer 'value'
* and 'compare' operator ( '=' , '!=' , '>' , '>=' , '<' , '<=' ) to
* compare against comment_count in a specific way .
2016-08-25 13:20:38 -04:00
* @ type string $comment_status Comment status .
* @ type int $comments_per_page The number of comments to return per page .
* Default 'comments_per_page' option .
* @ type array $date_query An associative array of WP_Date_Query arguments .
* See WP_Date_Query :: __construct () .
* @ type int $day Day of the month . Default empty . Accepts numbers 1 - 31.
* @ type bool $exact Whether to search by exact keyword . Default false .
2020-07-22 07:37:02 -04:00
* @ type string $fields Post fields to query for . Accepts :
* - '' Returns an array of complete post objects ( `WP_Post[]` ) .
* - 'ids' Returns an array of post IDs ( `int[]` ) .
* - 'id=>parent' Returns an associative array of parent post IDs ,
* keyed by post ID ( `int[]` ) .
* Default '' .
2016-08-25 13:20:38 -04:00
* @ type int $hour Hour of the day . Default empty . Accepts numbers 0 - 23.
* @ type int | bool $ignore_sticky_posts Whether to ignore sticky posts or not . Setting this to false
* excludes stickies from 'post__in' . Accepts 1 | true , 0 | false .
2020-07-13 18:10:07 -04:00
* Default false .
2016-08-25 13:20:38 -04:00
* @ type int $m Combination YearMonth . Accepts any four - digit year and month
* numbers 1 - 12. Default empty .
* @ type string $meta_compare Comparison operator to test the 'meta_value' .
2018-02-28 23:03:33 -05:00
* @ type string $meta_compare_key Comparison operator to test the 'meta_key' .
2016-08-25 13:20:38 -04:00
* @ type string $meta_key Custom field key .
* @ type array $meta_query An associative array of WP_Meta_Query arguments . See WP_Meta_Query .
* @ type string $meta_value Custom field value .
* @ type int $meta_value_num Custom field value number .
Query: Expand the list of operators available to `compare_key` in `WP_Meta_Query`.
`compare_key`, introduced in #42409, previously supported only `=` and `LIKE`
operators. This changeset introduces a number of other operators: `!=`, `IN`,
`NOT IN`, `NOT LIKE`, `RLIKE`, `REGEXP`, `NOT REGEXP`, `EXISTS`, and `NOT EXISTS`
(the latter two aliased to `=` and `!=`, respectively). To support case-sensitive
regular expression key comparisons, the new `type_key` parameter will force
a MySQL `CAST` when 'BINARY' is passed.
Props soulseekah.
Fixes #43346.
Built from https://develop.svn.wordpress.org/trunk@46188
git-svn-id: http://core.svn.wordpress.org/trunk@46000 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-19 11:03:56 -04:00
* @ type string $meta_type_key Cast for 'meta_key' . See WP_Meta_Query :: construct () .
2016-08-25 13:20:38 -04:00
* @ type int $menu_order The menu order of the posts .
* @ type int $monthnum The two - digit month . Default empty . Accepts numbers 1 - 12.
* @ type string $name Post slug .
* @ type bool $nopaging Show all posts ( true ) or paginate ( false ) . Default false .
* @ type bool $no_found_rows Whether to skip counting the total rows found . Enabling can improve
* performance . Default false .
* @ type int $offset The number of posts to offset before retrieval .
* @ type string $order Designates ascending or descending order of posts . Default 'DESC' .
* Accepts 'ASC' , 'DESC' .
* @ type string | array $orderby Sort retrieved posts by parameter . One or more options may be
* passed . To use 'meta_value' , or 'meta_value_num' ,
* 'meta_key=keyname' must be also be defined . To sort by a
* specific `$meta_query` clause , use that clause ' s array key .
2016-12-22 21:31:41 -05:00
* Accepts 'none' , 'name' , 'author' , 'date' , 'title' ,
* 'modified' , 'menu_order' , 'parent' , 'ID' , 'rand' ,
* 'relevance' , 'RAND(x)' ( where 'x' is an integer seed value ),
2016-08-25 13:20:38 -04:00
* 'comment_count' , 'meta_value' , 'meta_value_num' , 'post__in' ,
* 'post_name__in' , 'post_parent__in' , and the array keys
2016-12-22 21:31:41 -05:00
* of `$meta_query` . Default is 'date' , except when a search
* is being performed , when the default is 'relevance' .
2016-08-25 13:20:38 -04:00
* @ type int $p Post ID .
* @ type int $page Show the number of posts that would show up on page X of a
* static front page .
* @ type int $paged The number of the current page .
* @ type int $page_id Page ID .
* @ type string $pagename Page slug .
* @ type string $perm Show posts if user has the appropriate capability .
* @ type string $ping_status Ping status .
2020-01-08 07:10:04 -05:00
* @ type array $post__in An array of post IDs to retrieve , sticky posts will be included .
2016-08-25 13:20:38 -04:00
* @ type array $post__not_in An array of post IDs not to retrieve . Note : a string of comma -
* separated IDs will NOT work .
2020-01-08 07:10:04 -05:00
* @ type string $post_mime_type The mime type of the post . Used for 'attachment' post_type .
* @ type array $post_name__in An array of post slugs that results must match .
2016-08-25 13:20:38 -04:00
* @ type int $post_parent Page ID to retrieve child pages for . Use 0 to only retrieve
* top - level pages .
* @ type array $post_parent__in An array containing parent page IDs to query child pages from .
* @ type array $post_parent__not_in An array containing parent page IDs not to query child pages from .
* @ type string | array $post_type A post type slug ( string ) or array of post type slugs .
* Default 'any' if using 'tax_query' .
* @ type string | array $post_status A post status ( string ) or array of post statuses .
* @ type int $posts_per_page The number of posts to query for . Use - 1 to request all posts .
* @ type int $posts_per_archive_page The number of posts to query for by archive page . Overrides
* 'posts_per_page' when is_archive (), or is_search () are true .
* @ type string $s Search keyword ( s ) . Prepending a term with a hyphen will
* exclude posts matching that term . Eg , 'pillow -sofa' will
2016-10-20 14:42:29 -04:00
* return posts containing 'pillow' but not 'sofa' . The
* character used for exclusion can be modified using the
* the 'wp_query_search_exclusion_prefix' filter .
2016-08-25 13:20:38 -04:00
* @ type int $second Second of the minute . Default empty . Accepts numbers 0 - 60.
* @ type bool $sentence Whether to search by phrase . Default false .
* @ type bool $suppress_filters Whether to suppress filters . Default false .
* @ type string $tag Tag slug . Comma - separated ( either ), Plus - separated ( all ) .
2020-06-20 08:02:12 -04:00
* @ type array $tag__and An array of tag IDs ( AND in ) .
* @ type array $tag__in An array of tag IDs ( OR in ) .
* @ type array $tag__not_in An array of tag IDs ( NOT in ) .
2016-08-25 13:20:38 -04:00
* @ type int $tag_id Tag id or comma - separated list of IDs .
* @ type array $tag_slug__and An array of tag slugs ( AND in ) .
* @ type array $tag_slug__in An array of tag slugs ( OR in ) . unless 'ignore_sticky_posts' is
* true . Note : a string of comma - separated IDs will NOT work .
* @ type array $tax_query An associative array of WP_Tax_Query arguments .
* See WP_Tax_Query -> queries .
* @ type string $title Post title .
* @ 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 .
* }
*/
2017-11-30 18:11:00 -05:00
public function parse_query ( $query = '' ) {
2016-08-25 13:20:38 -04:00
if ( ! empty ( $query ) ) {
$this -> init ();
2019-07-02 19:42:58 -04:00
$this -> query = wp_parse_args ( $query );
$this -> query_vars = $this -> query ;
2016-08-25 13:20:38 -04:00
} elseif ( ! isset ( $this -> query ) ) {
$this -> query = $this -> query_vars ;
}
2017-11-30 18:11:00 -05:00
$this -> query_vars = $this -> fill_query_vars ( $this -> query_vars );
$qv = & $this -> query_vars ;
2016-08-25 13:20:38 -04:00
$this -> query_vars_changed = true ;
2017-11-30 18:11:00 -05:00
if ( ! empty ( $qv [ 'robots' ] ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_robots = true ;
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
} elseif ( ! empty ( $qv [ 'favicon' ] ) ) {
$this -> is_favicon = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-09-08 22:35:06 -04:00
if ( ! is_scalar ( $qv [ 'p' ] ) || ( int ) $qv [ 'p' ] < 0 ) {
2017-11-30 18:11:00 -05:00
$qv [ 'p' ] = 0 ;
2016-08-25 13:20:38 -04:00
$qv [ 'error' ] = '404' ;
} else {
2020-10-08 17:15:13 -04:00
$qv [ 'p' ] = ( int ) $qv [ 'p' ];
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$qv [ 'page_id' ] = absint ( $qv [ 'page_id' ] );
$qv [ 'year' ] = absint ( $qv [ 'year' ] );
$qv [ 'monthnum' ] = absint ( $qv [ 'monthnum' ] );
$qv [ 'day' ] = absint ( $qv [ 'day' ] );
$qv [ 'w' ] = absint ( $qv [ 'w' ] );
$qv [ 'm' ] = is_scalar ( $qv [ 'm' ] ) ? preg_replace ( '|[^0-9]|' , '' , $qv [ 'm' ] ) : '' ;
$qv [ 'paged' ] = absint ( $qv [ 'paged' ] );
2020-01-28 19:45:18 -05:00
$qv [ 'cat' ] = preg_replace ( '|[^0-9,-]|' , '' , $qv [ 'cat' ] ); // Comma-separated list of positive or negative integers.
$qv [ 'author' ] = preg_replace ( '|[^0-9,-]|' , '' , $qv [ 'author' ] ); // Comma-separated list of positive or negative integers.
2016-08-25 13:20:38 -04:00
$qv [ 'pagename' ] = trim ( $qv [ 'pagename' ] );
2017-11-30 18:11:00 -05:00
$qv [ 'name' ] = trim ( $qv [ 'name' ] );
$qv [ 'title' ] = trim ( $qv [ 'title' ] );
if ( '' !== $qv [ 'hour' ] ) {
$qv [ 'hour' ] = absint ( $qv [ 'hour' ] );
}
if ( '' !== $qv [ 'minute' ] ) {
$qv [ 'minute' ] = absint ( $qv [ 'minute' ] );
}
if ( '' !== $qv [ 'second' ] ) {
$qv [ 'second' ] = absint ( $qv [ 'second' ] );
}
if ( '' !== $qv [ 'menu_order' ] ) {
$qv [ 'menu_order' ] = absint ( $qv [ 'menu_order' ] );
}
2016-08-25 13:20:38 -04:00
// Fairly insane upper bound for search string lengths.
if ( ! is_scalar ( $qv [ 's' ] ) || ( ! empty ( $qv [ 's' ] ) && strlen ( $qv [ 's' ] ) > 1600 ) ) {
$qv [ 's' ] = '' ;
}
// Compat. Map subpost to attachment.
2017-11-30 18:11:00 -05:00
if ( '' != $qv [ 'subpost' ] ) {
2016-08-25 13:20:38 -04:00
$qv [ 'attachment' ] = $qv [ 'subpost' ];
2017-11-30 18:11:00 -05:00
}
if ( '' != $qv [ 'subpost_id' ] ) {
2016-08-25 13:20:38 -04:00
$qv [ 'attachment_id' ] = $qv [ 'subpost_id' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$qv [ 'attachment_id' ] = absint ( $qv [ 'attachment_id' ] );
2016-08-25 13:20:38 -04:00
2020-05-16 14:42:12 -04:00
if ( ( '' !== $qv [ 'attachment' ] ) || ! empty ( $qv [ 'attachment_id' ] ) ) {
2017-11-30 18:11:00 -05:00
$this -> is_single = true ;
2016-08-25 13:20:38 -04:00
$this -> is_attachment = true ;
2020-05-16 14:42:12 -04:00
} elseif ( '' !== $qv [ 'name' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_single = true ;
} elseif ( $qv [ 'p' ] ) {
$this -> is_single = true ;
2020-05-16 14:42:12 -04:00
} elseif ( '' !== $qv [ 'pagename' ] || ! empty ( $qv [ 'page_id' ] ) ) {
2017-11-30 18:11:00 -05:00
$this -> is_page = true ;
2016-08-25 13:20:38 -04:00
$this -> is_single = false ;
} else {
// Look for archive queries. Dates, categories, authors, search, post type archives.
if ( isset ( $this -> query [ 's' ] ) ) {
$this -> is_search = true ;
}
if ( '' !== $qv [ 'second' ] ) {
$this -> is_time = true ;
$this -> is_date = true ;
}
if ( '' !== $qv [ 'minute' ] ) {
$this -> is_time = true ;
$this -> is_date = true ;
}
if ( '' !== $qv [ 'hour' ] ) {
$this -> is_time = true ;
$this -> is_date = true ;
}
if ( $qv [ 'day' ] ) {
if ( ! $this -> is_date ) {
$date = sprintf ( '%04d-%02d-%02d' , $qv [ 'year' ], $qv [ 'monthnum' ], $qv [ 'day' ] );
if ( $qv [ 'monthnum' ] && $qv [ 'year' ] && ! wp_checkdate ( $qv [ 'monthnum' ], $qv [ 'day' ], $qv [ 'year' ], $date ) ) {
$qv [ 'error' ] = '404' ;
} else {
2017-11-30 18:11:00 -05:00
$this -> is_day = true ;
2016-08-25 13:20:38 -04:00
$this -> is_date = true ;
}
}
}
if ( $qv [ 'monthnum' ] ) {
if ( ! $this -> is_date ) {
if ( 12 < $qv [ 'monthnum' ] ) {
$qv [ 'error' ] = '404' ;
} else {
$this -> is_month = true ;
2017-11-30 18:11:00 -05:00
$this -> is_date = true ;
2016-08-25 13:20:38 -04:00
}
}
}
if ( $qv [ 'year' ] ) {
if ( ! $this -> is_date ) {
$this -> is_year = true ;
$this -> is_date = true ;
}
}
if ( $qv [ 'm' ] ) {
$this -> is_date = true ;
2017-11-30 18:11:00 -05:00
if ( strlen ( $qv [ 'm' ] ) > 9 ) {
2016-08-25 13:20:38 -04:00
$this -> is_time = true ;
} elseif ( strlen ( $qv [ 'm' ] ) > 7 ) {
$this -> is_day = true ;
} elseif ( strlen ( $qv [ 'm' ] ) > 5 ) {
$this -> is_month = true ;
} else {
$this -> is_year = true ;
}
}
2020-05-16 14:42:12 -04:00
if ( $qv [ 'w' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_date = true ;
}
$this -> query_vars_hash = false ;
$this -> parse_tax_query ( $qv );
foreach ( $this -> tax_query -> queries as $tax_query ) {
if ( ! is_array ( $tax_query ) ) {
continue ;
}
2020-05-16 14:42:12 -04:00
if ( isset ( $tax_query [ 'operator' ] ) && 'NOT IN' !== $tax_query [ 'operator' ] ) {
2016-08-25 13:20:38 -04:00
switch ( $tax_query [ 'taxonomy' ] ) {
case 'category' :
$this -> is_category = true ;
break ;
case 'post_tag' :
$this -> is_tag = true ;
break ;
default :
$this -> is_tax = true ;
}
}
}
unset ( $tax_query );
2020-02-09 11:55:09 -05:00
if ( empty ( $qv [ 'author' ] ) || ( '0' == $qv [ 'author' ] ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_author = false ;
} else {
$this -> is_author = true ;
}
2020-05-16 14:42:12 -04:00
if ( '' !== $qv [ 'author_name' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_author = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! empty ( $qv [ 'post_type' ] ) && ! is_array ( $qv [ 'post_type' ] ) ) {
2016-08-25 13:20:38 -04:00
$post_type_obj = get_post_type_object ( $qv [ 'post_type' ] );
2017-11-30 18:11:00 -05:00
if ( ! empty ( $post_type_obj -> has_archive ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_post_type_archive = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( $this -> is_post_type_archive || $this -> is_date || $this -> is_author || $this -> is_category || $this -> is_tag || $this -> is_tax ) {
2016-08-25 13:20:38 -04:00
$this -> is_archive = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( '' != $qv [ 'feed' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_feed = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( '' != $qv [ 'embed' ] ) {
$this -> is_embed = true ;
}
2017-11-30 18:11:00 -05:00
if ( '' != $qv [ 'tb' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_trackback = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-10-08 17:15:13 -04:00
if ( '' != $qv [ 'paged' ] && ( ( int ) $qv [ 'paged' ] > 1 ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_paged = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// If we're previewing inside the write screen.
2017-11-30 18:11:00 -05:00
if ( '' != $qv [ 'preview' ] ) {
2016-08-25 13:20:38 -04:00
$this -> is_preview = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( is_admin () ) {
2016-08-25 13:20:38 -04:00
$this -> is_admin = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( false !== strpos ( $qv [ 'feed' ], 'comments-' ) ) {
$qv [ 'feed' ] = str_replace ( 'comments-' , '' , $qv [ 'feed' ] );
2016-08-25 13:20:38 -04:00
$qv [ 'withcomments' ] = 1 ;
}
$this -> is_singular = $this -> is_single || $this -> is_page || $this -> is_attachment ;
2017-11-30 18:11:00 -05:00
if ( $this -> is_feed && ( ! empty ( $qv [ 'withcomments' ] ) || ( empty ( $qv [ 'withoutcomments' ] ) && $this -> is_singular ) ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_comment_feed = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
if ( ! ( $this -> is_singular || $this -> is_archive || $this -> is_search || $this -> is_feed
2020-06-16 02:04:12 -04:00
|| ( defined ( 'REST_REQUEST' ) && REST_REQUEST && $this -> is_main_query () )
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
|| $this -> is_trackback || $this -> is_404 || $this -> is_admin || $this -> is_robots || $this -> is_favicon ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_home = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// Correct `is_*` for 'page_on_front' and 'page_for_posts'.
2020-05-16 14:42:12 -04:00
if ( $this -> is_home && 'page' === get_option ( 'show_on_front' ) && get_option ( 'page_on_front' ) ) {
2017-11-30 18:11:00 -05:00
$_query = wp_parse_args ( $this -> query );
2020-01-28 19:45:18 -05:00
// 'pagename' can be set and empty depending on matched rewrite rules. Ignore an empty 'pagename'.
2020-05-16 14:42:12 -04:00
if ( isset ( $_query [ 'pagename' ] ) && '' === $_query [ 'pagename' ] ) {
2017-11-30 18:11:00 -05:00
unset ( $_query [ 'pagename' ] );
}
2016-08-25 13:20:38 -04:00
unset ( $_query [ 'embed' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $_query ) || ! array_diff ( array_keys ( $_query ), array ( 'preview' , 'page' , 'paged' , 'cpage' ) ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_page = true ;
$this -> is_home = false ;
2017-11-30 18:11:00 -05:00
$qv [ 'page_id' ] = get_option ( 'page_on_front' );
2020-01-28 19:45:18 -05:00
// Correct <!--nextpage--> for 'page_on_front'.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $qv [ 'paged' ] ) ) {
2016-08-25 13:20:38 -04:00
$qv [ 'page' ] = $qv [ 'paged' ];
2017-11-30 18:11:00 -05:00
unset ( $qv [ 'paged' ] );
2016-08-25 13:20:38 -04:00
}
}
}
2020-05-16 14:42:12 -04:00
if ( '' !== $qv [ 'pagename' ] ) {
2016-08-25 13:20:38 -04:00
$this -> queried_object = get_page_by_path ( $qv [ 'pagename' ] );
2020-05-16 14:42:12 -04:00
if ( $this -> queried_object && 'attachment' === $this -> queried_object -> post_type ) {
2017-11-30 18:11:00 -05:00
if ( preg_match ( '/^[^%]*%(?:postname)%/' , get_option ( 'permalink_structure' ) ) ) {
2020-01-28 19:45:18 -05:00
// See if we also have a post with the same slug.
2016-08-25 13:20:38 -04:00
$post = get_page_by_path ( $qv [ 'pagename' ], OBJECT , 'post' );
if ( $post ) {
$this -> queried_object = $post ;
2017-11-30 18:11:00 -05:00
$this -> is_page = false ;
$this -> is_single = true ;
2016-08-25 13:20:38 -04:00
}
}
}
if ( ! empty ( $this -> queried_object ) ) {
$this -> queried_object_id = ( int ) $this -> queried_object -> ID ;
} else {
unset ( $this -> queried_object );
}
2020-02-09 11:55:09 -05:00
if ( 'page' === get_option ( 'show_on_front' ) && isset ( $this -> queried_object_id ) && get_option ( 'page_for_posts' ) == $this -> queried_object_id ) {
2017-11-30 18:11:00 -05:00
$this -> is_page = false ;
$this -> is_home = true ;
2016-08-25 13:20:38 -04:00
$this -> is_posts_page = true ;
}
2019-03-21 15:48:50 -04:00
2020-02-09 11:55:09 -05:00
if ( isset ( $this -> queried_object_id ) && get_option ( 'wp_page_for_privacy_policy' ) == $this -> queried_object_id ) {
2019-03-21 15:48:50 -04:00
$this -> is_privacy_policy = true ;
}
2016-08-25 13:20:38 -04:00
}
if ( $qv [ 'page_id' ] ) {
2020-02-09 11:55:09 -05:00
if ( 'page' === get_option ( 'show_on_front' ) && get_option ( 'page_for_posts' ) == $qv [ 'page_id' ] ) {
2017-11-30 18:11:00 -05:00
$this -> is_page = false ;
$this -> is_home = true ;
2016-08-25 13:20:38 -04:00
$this -> is_posts_page = true ;
}
2019-03-21 15:48:50 -04:00
2020-02-09 11:55:09 -05:00
if ( get_option ( 'wp_page_for_privacy_policy' ) == $qv [ 'page_id' ] ) {
2019-03-21 15:48:50 -04:00
$this -> is_privacy_policy = true ;
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $qv [ 'post_type' ] ) ) {
if ( is_array ( $qv [ 'post_type' ] ) ) {
$qv [ 'post_type' ] = array_map ( 'sanitize_key' , $qv [ 'post_type' ] );
} else {
$qv [ 'post_type' ] = sanitize_key ( $qv [ 'post_type' ] );
}
2016-08-25 13:20:38 -04:00
}
if ( ! empty ( $qv [ 'post_status' ] ) ) {
2017-11-30 18:11:00 -05:00
if ( is_array ( $qv [ 'post_status' ] ) ) {
$qv [ 'post_status' ] = array_map ( 'sanitize_key' , $qv [ 'post_status' ] );
} else {
$qv [ 'post_status' ] = preg_replace ( '|[^a-z0-9_,-]|' , '' , $qv [ 'post_status' ] );
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( $this -> is_posts_page && ( ! isset ( $qv [ 'withcomments' ] ) || ! $qv [ 'withcomments' ] ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_comment_feed = false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$this -> is_singular = $this -> is_single || $this -> is_page || $this -> is_attachment ;
2020-01-28 19:45:18 -05:00
// Done correcting `is_*` for 'page_on_front' and 'page_for_posts'.
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( '404' == $qv [ 'error' ] ) {
2016-08-25 13:20:38 -04:00
$this -> set_404 ();
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$this -> is_embed = $this -> is_embed && ( $this -> is_singular || $this -> is_404 );
2017-11-30 18:11:00 -05:00
$this -> query_vars_hash = md5 ( serialize ( $this -> query_vars ) );
2016-08-25 13:20:38 -04:00
$this -> query_vars_changed = false ;
/**
* Fires after the main query vars have been parsed .
*
* @ since 1.5 . 0
*
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
do_action_ref_array ( 'parse_query' , array ( & $this ) );
}
/**
* Parses various taxonomy related query vars .
*
* For BC , this method is not marked as protected . See [ 28987 ] .
*
* @ since 3.1 . 0
*
* @ param array $q The query variables . Passed by reference .
*/
public function parse_tax_query ( & $q ) {
if ( ! empty ( $q [ 'tax_query' ] ) && is_array ( $q [ 'tax_query' ] ) ) {
$tax_query = $q [ 'tax_query' ];
} else {
$tax_query = array ();
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'taxonomy' ] ) && ! empty ( $q [ 'term' ] ) ) {
2016-08-25 13:20:38 -04:00
$tax_query [] = array (
'taxonomy' => $q [ 'taxonomy' ],
2017-11-30 18:11:00 -05:00
'terms' => array ( $q [ 'term' ] ),
'field' => 'slug' ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
foreach ( get_taxonomies ( array (), 'objects' ) as $taxonomy => $t ) {
2020-05-16 14:42:12 -04:00
if ( 'post_tag' === $taxonomy ) {
2020-01-28 19:45:18 -05:00
continue ; // Handled further down in the $q['tag'] block.
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( $t -> query_var && ! empty ( $q [ $t -> query_var ] ) ) {
2016-08-25 13:20:38 -04:00
$tax_query_defaults = array (
'taxonomy' => $taxonomy ,
2017-11-30 18:11:00 -05:00
'field' => 'slug' ,
2016-08-25 13:20:38 -04:00
);
2017-11-30 18:11:00 -05:00
if ( isset ( $t -> rewrite [ 'hierarchical' ] ) && $t -> rewrite [ 'hierarchical' ] ) {
$q [ $t -> query_var ] = wp_basename ( $q [ $t -> query_var ] );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$term = $q [ $t -> query_var ];
2016-08-25 13:20:38 -04:00
if ( is_array ( $term ) ) {
$term = implode ( ',' , $term );
}
2017-11-30 18:11:00 -05:00
if ( strpos ( $term , '+' ) !== false ) {
2016-08-25 13:20:38 -04:00
$terms = preg_split ( '/[+]+/' , $term );
foreach ( $terms as $term ) {
2017-11-30 18:11:00 -05:00
$tax_query [] = array_merge (
2018-08-16 21:51:36 -04:00
$tax_query_defaults ,
array (
2017-11-30 18:11:00 -05:00
'terms' => array ( $term ),
)
);
2016-08-25 13:20:38 -04:00
}
} else {
2017-11-30 18:11:00 -05:00
$tax_query [] = array_merge (
2018-08-16 21:51:36 -04:00
$tax_query_defaults ,
array (
2017-11-30 18:11:00 -05:00
'terms' => preg_split ( '/[,]+/' , $term ),
)
);
2016-08-25 13:20:38 -04:00
}
}
}
2020-01-28 19:45:18 -05:00
// If query string 'cat' is an array, implode it.
2016-08-25 13:20:38 -04:00
if ( is_array ( $q [ 'cat' ] ) ) {
$q [ 'cat' ] = implode ( ',' , $q [ 'cat' ] );
}
2020-01-28 19:45:18 -05:00
// Category stuff.
2016-08-25 13:20:38 -04:00
if ( ! empty ( $q [ 'cat' ] ) && ! $this -> is_singular ) {
2019-07-02 19:42:58 -04:00
$cat_in = array ();
$cat_not_in = array ();
2016-08-25 13:20:38 -04:00
$cat_array = preg_split ( '/[,\s]+/' , urldecode ( $q [ 'cat' ] ) );
$cat_array = array_map ( 'intval' , $cat_array );
2017-11-30 18:11:00 -05:00
$q [ 'cat' ] = implode ( ',' , $cat_array );
2016-08-25 13:20:38 -04:00
foreach ( $cat_array as $cat ) {
2017-11-30 18:11:00 -05:00
if ( $cat > 0 ) {
2016-08-25 13:20:38 -04:00
$cat_in [] = $cat ;
2017-11-30 18:11:00 -05:00
} elseif ( $cat < 0 ) {
2016-08-25 13:20:38 -04:00
$cat_not_in [] = abs ( $cat );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
if ( ! empty ( $cat_in ) ) {
$tax_query [] = array (
2017-11-30 18:11:00 -05:00
'taxonomy' => 'category' ,
'terms' => $cat_in ,
'field' => 'term_id' ,
'include_children' => true ,
2016-08-25 13:20:38 -04:00
);
}
if ( ! empty ( $cat_not_in ) ) {
$tax_query [] = array (
2017-11-30 18:11:00 -05:00
'taxonomy' => 'category' ,
'terms' => $cat_not_in ,
'field' => 'term_id' ,
'operator' => 'NOT IN' ,
'include_children' => true ,
2016-08-25 13:20:38 -04:00
);
}
unset ( $cat_array , $cat_in , $cat_not_in );
}
if ( ! empty ( $q [ 'category__and' ] ) && 1 === count ( ( array ) $q [ 'category__and' ] ) ) {
$q [ 'category__and' ] = ( array ) $q [ 'category__and' ];
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'category__in' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'category__in' ] = array ();
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$q [ 'category__in' ][] = absint ( reset ( $q [ 'category__and' ] ) );
unset ( $q [ 'category__and' ] );
}
if ( ! empty ( $q [ 'category__in' ] ) ) {
$q [ 'category__in' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'category__in' ] ) );
2017-11-30 18:11:00 -05:00
$tax_query [] = array (
'taxonomy' => 'category' ,
'terms' => $q [ 'category__in' ],
'field' => 'term_id' ,
'include_children' => false ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'category__not_in' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'category__not_in' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'category__not_in' ] ) );
2017-11-30 18:11:00 -05:00
$tax_query [] = array (
'taxonomy' => 'category' ,
'terms' => $q [ 'category__not_in' ],
'operator' => 'NOT IN' ,
'include_children' => false ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'category__and' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'category__and' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'category__and' ] ) );
2017-11-30 18:11:00 -05:00
$tax_query [] = array (
'taxonomy' => 'category' ,
'terms' => $q [ 'category__and' ],
'field' => 'term_id' ,
'operator' => 'AND' ,
'include_children' => false ,
2016-08-25 13:20:38 -04:00
);
}
2020-01-28 19:45:18 -05:00
// If query string 'tag' is array, implode it.
2016-08-25 13:20:38 -04:00
if ( is_array ( $q [ 'tag' ] ) ) {
$q [ 'tag' ] = implode ( ',' , $q [ 'tag' ] );
}
2020-01-28 19:45:18 -05:00
// Tag stuff.
2020-05-16 14:42:12 -04:00
if ( '' !== $q [ 'tag' ] && ! $this -> is_singular && $this -> query_vars_changed ) {
2017-11-30 18:11:00 -05:00
if ( strpos ( $q [ 'tag' ], ',' ) !== false ) {
$tags = preg_split ( '/[,\r\n\t ]+/' , $q [ 'tag' ] );
2016-08-25 13:20:38 -04:00
foreach ( ( array ) $tags as $tag ) {
2017-11-30 18:11:00 -05:00
$tag = sanitize_term_field ( 'slug' , $tag , 0 , 'post_tag' , 'db' );
2016-08-25 13:20:38 -04:00
$q [ 'tag_slug__in' ][] = $tag ;
}
2017-11-30 18:11:00 -05:00
} elseif ( preg_match ( '/[+\r\n\t ]+/' , $q [ 'tag' ] ) || ! empty ( $q [ 'cat' ] ) ) {
$tags = preg_split ( '/[+\r\n\t ]+/' , $q [ 'tag' ] );
2016-08-25 13:20:38 -04:00
foreach ( ( array ) $tags as $tag ) {
2017-11-30 18:11:00 -05:00
$tag = sanitize_term_field ( 'slug' , $tag , 0 , 'post_tag' , 'db' );
2016-08-25 13:20:38 -04:00
$q [ 'tag_slug__and' ][] = $tag ;
}
} else {
2017-11-30 18:11:00 -05:00
$q [ 'tag' ] = sanitize_term_field ( 'slug' , $q [ 'tag' ], 0 , 'post_tag' , 'db' );
2016-08-25 13:20:38 -04:00
$q [ 'tag_slug__in' ][] = $q [ 'tag' ];
}
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag_id' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'tag_id' ] = absint ( $q [ 'tag_id' ] );
$tax_query [] = array (
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag_id' ],
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag__in' ] ) ) {
$q [ 'tag__in' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'tag__in' ] ) );
$tax_query [] = array (
2016-08-25 13:20:38 -04:00
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag__in' ],
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag__not_in' ] ) ) {
$q [ 'tag__not_in' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'tag__not_in' ] ) );
$tax_query [] = array (
2016-08-25 13:20:38 -04:00
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag__not_in' ],
'operator' => 'NOT IN' ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag__and' ] ) ) {
$q [ 'tag__and' ] = array_map ( 'absint' , array_unique ( ( array ) $q [ 'tag__and' ] ) );
$tax_query [] = array (
2016-08-25 13:20:38 -04:00
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag__and' ],
'operator' => 'AND' ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag_slug__in' ] ) ) {
$q [ 'tag_slug__in' ] = array_map ( 'sanitize_title_for_query' , array_unique ( ( array ) $q [ 'tag_slug__in' ] ) );
$tax_query [] = array (
2016-08-25 13:20:38 -04:00
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag_slug__in' ],
'field' => 'slug' ,
2016-08-25 13:20:38 -04:00
);
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'tag_slug__and' ] ) ) {
$q [ 'tag_slug__and' ] = array_map ( 'sanitize_title_for_query' , array_unique ( ( array ) $q [ 'tag_slug__and' ] ) );
$tax_query [] = array (
2016-08-25 13:20:38 -04:00
'taxonomy' => 'post_tag' ,
2017-11-30 18:11:00 -05:00
'terms' => $q [ 'tag_slug__and' ],
'field' => 'slug' ,
'operator' => 'AND' ,
2016-08-25 13:20:38 -04:00
);
}
$this -> tax_query = new WP_Tax_Query ( $tax_query );
/**
* Fires after taxonomy - related query vars have been parsed .
*
* @ since 3.7 . 0
*
* @ param WP_Query $this The WP_Query instance .
*/
do_action ( 'parse_tax_query' , $this );
}
/**
2017-07-13 11:42:44 -04:00
* Generates SQL for the WHERE clause based on passed search terms .
2016-08-25 13:20:38 -04:00
*
* @ since 3.7 . 0
2017-07-13 11:42:44 -04:00
*
* @ global wpdb $wpdb WordPress database abstraction object .
2016-08-25 13:20:38 -04:00
*
* @ param array $q Query variables .
* @ return string WHERE clause .
*/
protected function parse_search ( & $q ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2016-08-25 13:20:38 -04:00
$search = '' ;
2020-01-28 19:45:18 -05:00
// Added slashes screw with quote grouping when done early, so done later.
2016-08-25 13:20:38 -04:00
$q [ 's' ] = stripslashes ( $q [ 's' ] );
2017-11-30 18:11:00 -05:00
if ( empty ( $_GET [ 's' ] ) && $this -> is_main_query () ) {
2016-08-25 13:20:38 -04:00
$q [ 's' ] = urldecode ( $q [ 's' ] );
2017-11-30 18:11:00 -05:00
}
2020-01-28 19:45:18 -05:00
// There are no line breaks in <input /> fields.
2017-11-30 18:11:00 -05:00
$q [ 's' ] = str_replace ( array ( " \r " , " \n " ), '' , $q [ 's' ] );
2016-08-25 13:20:38 -04:00
$q [ 'search_terms_count' ] = 1 ;
if ( ! empty ( $q [ 'sentence' ] ) ) {
$q [ 'search_terms' ] = array ( $q [ 's' ] );
} else {
if ( preg_match_all ( '/".*?("|$)|((?<=[\t ",+])|^)[^\t ",+]+/' , $q [ 's' ], $matches ) ) {
$q [ 'search_terms_count' ] = count ( $matches [ 0 ] );
2017-11-30 18:11:00 -05:00
$q [ 'search_terms' ] = $this -> parse_search_terms ( $matches [ 0 ] );
2020-01-28 19:45:18 -05:00
// If the search string has only short terms or stopwords, or is 10+ terms long, match it as sentence.
2017-11-30 18:11:00 -05:00
if ( empty ( $q [ 'search_terms' ] ) || count ( $q [ 'search_terms' ] ) > 9 ) {
2016-08-25 13:20:38 -04:00
$q [ 'search_terms' ] = array ( $q [ 's' ] );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
} else {
$q [ 'search_terms' ] = array ( $q [ 's' ] );
}
}
2017-11-30 18:11:00 -05:00
$n = ! empty ( $q [ 'exact' ] ) ? '' : '%' ;
$searchand = '' ;
2016-08-25 13:20:38 -04:00
$q [ 'search_orderby_title' ] = array ();
2016-10-14 16:06:28 -04:00
/**
2016-10-20 14:42:29 -04:00
* Filters the prefix that indicates that a search term should be excluded from results .
2016-10-14 16:06:28 -04:00
*
* @ since 4.7 . 0
*
2016-10-20 14:42:29 -04:00
* @ param string $exclusion_prefix The prefix . Default '-' . Returning
* an empty value disables exclusions .
2016-10-14 16:06:28 -04:00
*/
2016-10-20 14:42:29 -04:00
$exclusion_prefix = apply_filters ( 'wp_query_search_exclusion_prefix' , '-' );
2016-10-14 16:06:28 -04:00
2016-08-25 13:20:38 -04:00
foreach ( $q [ 'search_terms' ] as $term ) {
2016-10-20 14:42:29 -04:00
// If there is an $exclusion_prefix, terms prefixed with it should be excluded.
2020-02-09 11:55:09 -05:00
$exclude = $exclusion_prefix && ( substr ( $term , 0 , 1 ) === $exclusion_prefix );
2016-10-20 14:42:29 -04:00
if ( $exclude ) {
2016-08-25 13:20:38 -04:00
$like_op = 'NOT LIKE' ;
$andor_op = 'AND' ;
$term = substr ( $term , 1 );
2016-10-20 14:42:29 -04:00
} else {
$like_op = 'LIKE' ;
$andor_op = 'OR' ;
2016-08-25 13:20:38 -04:00
}
2016-10-20 14:42:29 -04:00
if ( $n && ! $exclude ) {
2017-11-30 18:11:00 -05:00
$like = '%' . $wpdb -> esc_like ( $term ) . '%' ;
2016-10-10 02:38:31 -04:00
$q [ 'search_orderby_title' ][] = $wpdb -> prepare ( " { $wpdb -> posts } .post_title LIKE %s " , $like );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$like = $n . $wpdb -> esc_like ( $term ) . $n ;
$search .= $wpdb -> prepare ( " { $searchand } (( { $wpdb -> posts } .post_title $like_op %s) $andor_op ( { $wpdb -> posts } .post_excerpt $like_op %s) $andor_op ( { $wpdb -> posts } .post_content $like_op %s)) " , $like , $like , $like );
2016-08-25 13:20:38 -04:00
$searchand = ' AND ' ;
}
if ( ! empty ( $search ) ) {
$search = " AND ( { $search } ) " ;
if ( ! is_user_logged_in () ) {
2016-10-10 02:38:31 -04:00
$search .= " AND ( { $wpdb -> posts } .post_password = '') " ;
2016-08-25 13:20:38 -04:00
}
}
return $search ;
}
/**
* Check if the terms are suitable for searching .
*
* Uses an array of stopwords ( terms ) that are excluded from the separate
* term matching when searching for posts . The list of English stopwords is
* the approximate search engines list , and is translatable .
*
* @ since 3.7 . 0
*
2018-03-25 15:33:31 -04:00
* @ param string [] $terms Array of terms to check .
2019-11-05 16:27:02 -05:00
* @ return string [] Terms that are not stopwords .
2016-08-25 13:20:38 -04:00
*/
protected function parse_search_terms ( $terms ) {
$strtolower = function_exists ( 'mb_strtolower' ) ? 'mb_strtolower' : 'strtolower' ;
2017-11-30 18:11:00 -05:00
$checked = array ();
2016-08-25 13:20:38 -04:00
$stopwords = $this -> get_search_stopwords ();
foreach ( $terms as $term ) {
2020-01-28 19:45:18 -05:00
// Keep before/after spaces when term is for exact match.
2017-11-30 18:11:00 -05:00
if ( preg_match ( '/^".+"$/' , $term ) ) {
2016-08-25 13:20:38 -04:00
$term = trim ( $term , " \" ' " );
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
$term = trim ( $term , " \" ' " );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
// Avoid single A-Z and single dashes.
2017-11-30 18:11:00 -05:00
if ( ! $term || ( 1 === strlen ( $term ) && preg_match ( '/^[a-z\-]$/i' , $term ) ) ) {
2016-08-25 13:20:38 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( in_array ( call_user_func ( $strtolower , $term ), $stopwords , true ) ) {
2016-08-25 13:20:38 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$checked [] = $term ;
}
return $checked ;
}
/**
* Retrieve stopwords used when parsing search terms .
*
* @ since 3.7 . 0
*
2019-11-05 16:27:02 -05:00
* @ return string [] Stopwords .
2016-08-25 13:20:38 -04:00
*/
protected function get_search_stopwords () {
2017-11-30 18:11:00 -05:00
if ( isset ( $this -> stopwords ) ) {
2016-08-25 13:20:38 -04:00
return $this -> stopwords ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2019-09-02 20:41:05 -04:00
/*
* translators : This is a comma - separated list of very common words that should be excluded from a search ,
2016-08-25 13:20:38 -04:00
* like a , an , and the . These are usually called " stopwords " . You should not simply translate these individual
* words into your language . Instead , look for and provide commonly accepted stopwords in your language .
*/
2017-11-30 18:11:00 -05:00
$words = explode (
2018-08-16 21:51:36 -04:00
',' ,
_x (
2017-11-30 18:11:00 -05:00
'about,an,are,as,at,be,by,com,for,from,how,in,is,it,of,on,or,that,the,this,to,was,what,when,where,who,will,with,www' ,
'Comma-separated list of search stopwords in your language'
)
);
2016-08-25 13:20:38 -04:00
$stopwords = array ();
foreach ( $words as $word ) {
$word = trim ( $word , " \r \n \t " );
2017-11-30 18:11:00 -05:00
if ( $word ) {
2016-08-25 13:20:38 -04:00
$stopwords [] = $word ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
/**
* Filters stopwords used when parsing search terms .
*
* @ since 3.7 . 0
*
2018-03-25 15:33:31 -04:00
* @ param string [] $stopwords Array of stopwords .
2016-08-25 13:20:38 -04:00
*/
$this -> stopwords = apply_filters ( 'wp_search_stopwords' , $stopwords );
return $this -> stopwords ;
}
/**
2017-06-30 12:08:44 -04:00
* Generates SQL for the ORDER BY condition based on passed search terms .
*
* @ since 3.7 . 0
*
* @ global wpdb $wpdb WordPress database abstraction object .
2016-08-25 13:20:38 -04:00
*
* @ param array $q Query variables .
* @ return string ORDER BY clause .
*/
protected function parse_search_order ( & $q ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2016-08-25 13:20:38 -04:00
if ( $q [ 'search_terms_count' ] > 1 ) {
$num_terms = count ( $q [ 'search_orderby_title' ] );
// If the search terms contain negative queries, don't bother ordering by sentence matches.
$like = '' ;
if ( ! preg_match ( '/(?:\s|^)\-/' , $q [ 's' ] ) ) {
2016-10-10 02:38:31 -04:00
$like = '%' . $wpdb -> esc_like ( $q [ 's' ] ) . '%' ;
2016-08-25 13:20:38 -04:00
}
$search_orderby = '' ;
2020-01-28 19:45:18 -05:00
// Sentence match in 'post_title'.
2016-08-25 13:20:38 -04:00
if ( $like ) {
2016-10-10 02:38:31 -04:00
$search_orderby .= $wpdb -> prepare ( " WHEN { $wpdb -> posts } .post_title LIKE %s THEN 1 " , $like );
2016-08-25 13:20:38 -04:00
}
2020-01-28 19:45:18 -05:00
// Sanity limit, sort as sentence when more than 6 terms
// (few searches are longer than 6 terms and most titles are not).
2016-08-25 13:20:38 -04:00
if ( $num_terms < 7 ) {
2020-01-28 19:45:18 -05:00
// All words in title.
2016-08-25 13:20:38 -04:00
$search_orderby .= 'WHEN ' . implode ( ' AND ' , $q [ 'search_orderby_title' ] ) . ' THEN 2 ' ;
2020-01-28 19:45:18 -05:00
// Any word in title, not needed when $num_terms == 1.
2017-11-30 18:11:00 -05:00
if ( $num_terms > 1 ) {
2016-08-25 13:20:38 -04:00
$search_orderby .= 'WHEN ' . implode ( ' OR ' , $q [ 'search_orderby_title' ] ) . ' THEN 3 ' ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
// Sentence match in 'post_content' and 'post_excerpt'.
if ( $like ) {
2016-10-10 02:38:31 -04:00
$search_orderby .= $wpdb -> prepare ( " WHEN { $wpdb -> posts } .post_excerpt LIKE %s THEN 4 " , $like );
$search_orderby .= $wpdb -> prepare ( " WHEN { $wpdb -> posts } .post_content LIKE %s THEN 5 " , $like );
2016-08-25 13:20:38 -04:00
}
if ( $search_orderby ) {
$search_orderby = '(CASE ' . $search_orderby . 'ELSE 6 END)' ;
}
} else {
2020-01-28 19:45:18 -05:00
// Single word or sentence search.
2016-08-25 13:20:38 -04:00
$search_orderby = reset ( $q [ 'search_orderby_title' ] ) . ' DESC' ;
}
return $search_orderby ;
}
/**
2017-07-13 11:44:41 -04:00
* Converts the given orderby alias ( if allowed ) to a properly - prefixed value .
2016-08-25 13:20:38 -04:00
*
* @ since 4.0 . 0
*
2017-07-13 11:42:44 -04:00
* @ global wpdb $wpdb WordPress database abstraction object .
*
2016-08-25 13:20:38 -04:00
* @ param string $orderby Alias for the field to order by .
* @ return string | false Table - prefixed value to used in the ORDER clause . False otherwise .
*/
protected function parse_orderby ( $orderby ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2016-08-25 13:20:38 -04:00
// Used to filter values.
$allowed_keys = array (
2017-11-30 18:11:00 -05:00
'post_name' ,
'post_author' ,
'post_date' ,
'post_title' ,
'post_modified' ,
'post_parent' ,
'post_type' ,
'name' ,
'author' ,
'date' ,
'title' ,
'modified' ,
'parent' ,
'type' ,
'ID' ,
'menu_order' ,
'comment_count' ,
'rand' ,
2019-01-07 22:33:49 -05:00
'post__in' ,
'post_parent__in' ,
'post_name__in' ,
2016-08-25 13:20:38 -04:00
);
2017-11-30 18:11:00 -05:00
$primary_meta_key = '' ;
2016-08-25 13:20:38 -04:00
$primary_meta_query = false ;
2017-11-30 18:11:00 -05:00
$meta_clauses = $this -> meta_query -> get_clauses ();
2016-08-25 13:20:38 -04:00
if ( ! empty ( $meta_clauses ) ) {
$primary_meta_query = reset ( $meta_clauses );
if ( ! empty ( $primary_meta_query [ 'key' ] ) ) {
$primary_meta_key = $primary_meta_query [ 'key' ];
2017-11-30 18:11:00 -05:00
$allowed_keys [] = $primary_meta_key ;
2016-08-25 13:20:38 -04:00
}
$allowed_keys [] = 'meta_value' ;
$allowed_keys [] = 'meta_value_num' ;
$allowed_keys = array_merge ( $allowed_keys , array_keys ( $meta_clauses ) );
}
// If RAND() contains a seed value, sanitize and add to allowed keys.
$rand_with_seed = false ;
if ( preg_match ( '/RAND\(([0-9]+)\)/i' , $orderby , $matches ) ) {
2020-10-08 17:15:13 -04:00
$orderby = sprintf ( 'RAND(%s)' , ( int ) $matches [ 1 ] );
2016-08-25 13:20:38 -04:00
$allowed_keys [] = $orderby ;
$rand_with_seed = true ;
}
if ( ! in_array ( $orderby , $allowed_keys , true ) ) {
return false ;
}
2019-01-07 22:33:49 -05:00
$orderby_clause = '' ;
2016-08-25 13:20:38 -04:00
switch ( $orderby ) {
case 'post_name' :
case 'post_author' :
case 'post_date' :
case 'post_title' :
case 'post_modified' :
case 'post_parent' :
case 'post_type' :
case 'ID' :
case 'menu_order' :
case 'comment_count' :
2016-10-10 02:38:31 -04:00
$orderby_clause = " { $wpdb -> posts } . { $orderby } " ;
2016-08-25 13:20:38 -04:00
break ;
case 'rand' :
$orderby_clause = 'RAND()' ;
break ;
case $primary_meta_key :
case 'meta_value' :
if ( ! empty ( $primary_meta_query [ 'type' ] ) ) {
$orderby_clause = " CAST( { $primary_meta_query [ 'alias' ] } .meta_value AS { $primary_meta_query [ 'cast' ] } ) " ;
} else {
$orderby_clause = " { $primary_meta_query [ 'alias' ] } .meta_value " ;
}
break ;
case 'meta_value_num' :
$orderby_clause = " { $primary_meta_query [ 'alias' ] } .meta_value+0 " ;
break ;
2019-01-07 22:33:49 -05:00
case 'post__in' :
if ( ! empty ( $this -> query_vars [ 'post__in' ] ) ) {
$orderby_clause = " FIELD( { $wpdb -> posts } .ID, " . implode ( ',' , array_map ( 'absint' , $this -> query_vars [ 'post__in' ] ) ) . ')' ;
}
break ;
case 'post_parent__in' :
if ( ! empty ( $this -> query_vars [ 'post_parent__in' ] ) ) {
$orderby_clause = " FIELD( { $wpdb -> posts } .post_parent, " . implode ( ', ' , array_map ( 'absint' , $this -> query_vars [ 'post_parent__in' ] ) ) . ' )' ;
}
break ;
case 'post_name__in' :
if ( ! empty ( $this -> query_vars [ 'post_name__in' ] ) ) {
2019-01-07 23:32:50 -05:00
$post_name__in = array_map ( 'sanitize_title_for_query' , $this -> query_vars [ 'post_name__in' ] );
2019-01-07 22:33:49 -05:00
$post_name__in_string = " ' " . implode ( " ',' " , $post_name__in ) . " ' " ;
2019-01-07 23:32:50 -05:00
$orderby_clause = " FIELD( { $wpdb -> posts } .post_name, " . $post_name__in_string . ' )' ;
2019-01-07 22:33:49 -05:00
}
break ;
2016-08-25 13:20:38 -04:00
default :
if ( array_key_exists ( $orderby , $meta_clauses ) ) {
// $orderby corresponds to a meta_query clause.
2017-11-30 18:11:00 -05:00
$meta_clause = $meta_clauses [ $orderby ];
2016-08-25 13:20:38 -04:00
$orderby_clause = " CAST( { $meta_clause [ 'alias' ] } .meta_value AS { $meta_clause [ 'cast' ] } ) " ;
} elseif ( $rand_with_seed ) {
$orderby_clause = $orderby ;
} else {
// Default: order by post field.
2016-10-10 02:38:31 -04:00
$orderby_clause = " { $wpdb -> posts } .post_ " . sanitize_key ( $orderby );
2016-08-25 13:20:38 -04:00
}
break ;
}
return $orderby_clause ;
}
/**
* Parse an 'order' query variable and cast it to ASC or DESC as necessary .
*
* @ since 4.0 . 0
*
* @ param string $order The 'order' query variable .
* @ return string The sanitized 'order' query variable .
*/
protected function parse_order ( $order ) {
if ( ! is_string ( $order ) || empty ( $order ) ) {
return 'DESC' ;
}
if ( 'ASC' === strtoupper ( $order ) ) {
return 'ASC' ;
} else {
return 'DESC' ;
}
}
/**
* Sets the 404 property and saves whether query is feed .
*
* @ since 2.0 . 0
*/
public function set_404 () {
$is_feed = $this -> is_feed ;
$this -> init_query_flags ();
$this -> is_404 = true ;
$this -> is_feed = $is_feed ;
2020-03-26 13:43:07 -04:00
/**
* Fires after a 404 is triggered .
*
* @ since 5.5 . 0
*
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
*/
do_action_ref_array ( 'set_404' , array ( $this ) );
2016-08-25 13:20:38 -04:00
}
/**
2020-10-06 04:59:04 -04:00
* Retrieves the value of a query variable .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
* @ since 3.9 . 0 The `$default` argument was introduced .
*
* @ param string $query_var Query variable key .
* @ param mixed $default Optional . Value to return if the query variable is not set . Default empty .
* @ return mixed Contents of the query variable .
*/
public function get ( $query_var , $default = '' ) {
if ( isset ( $this -> query_vars [ $query_var ] ) ) {
return $this -> query_vars [ $query_var ];
}
return $default ;
}
/**
2020-10-06 04:59:04 -04:00
* Sets the value of a query variable .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
*
* @ param string $query_var Query variable key .
* @ param mixed $value Query variable value .
*/
2017-11-30 18:11:00 -05:00
public function set ( $query_var , $value ) {
$this -> query_vars [ $query_var ] = $value ;
2016-08-25 13:20:38 -04:00
}
/**
2018-08-27 10:28:26 -04:00
* Retrieves an array of posts based on query variables .
2016-08-25 13:20:38 -04:00
*
* There are a few filters and actions that can be used to modify the post
* database query .
*
* @ since 1.5 . 0
*
2018-08-27 10:28:26 -04:00
* @ return WP_Post [] | int [] Array of post objects or post IDs .
2016-08-25 13:20:38 -04:00
*/
public function get_posts () {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2016-08-25 13:20:38 -04:00
$this -> parse_query ();
/**
* Fires after the query variable object is created , but before the actual query is run .
*
* Note : If using conditional tags , use the method versions within the passed instance
* ( e . g . $this -> is_main_query () instead of is_main_query ()) . This is because the functions
* like is_main_query () test against the global $wp_query instance , not the passed one .
*
* @ since 2.0 . 0
*
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
do_action_ref_array ( 'pre_get_posts' , array ( & $this ) );
// Shorthand.
$q = & $this -> query_vars ;
2020-01-28 19:45:18 -05:00
// Fill again in case 'pre_get_posts' unset some vars.
2017-11-30 18:11:00 -05:00
$q = $this -> fill_query_vars ( $q );
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// Parse meta query.
2016-08-25 13:20:38 -04:00
$this -> meta_query = new WP_Meta_Query ();
$this -> meta_query -> parse_query_vars ( $q );
2020-01-28 19:45:18 -05:00
// Set a flag if a 'pre_get_posts' hook changed the query vars.
2016-08-25 13:20:38 -04:00
$hash = md5 ( serialize ( $this -> query_vars ) );
if ( $hash != $this -> query_vars_hash ) {
$this -> query_vars_changed = true ;
2017-11-30 18:11:00 -05:00
$this -> query_vars_hash = $hash ;
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
unset ( $hash );
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// First let's clear some variables.
2017-11-30 18:11:00 -05:00
$distinct = '' ;
$whichauthor = '' ;
$whichmimetype = '' ;
$where = '' ;
$limits = '' ;
$join = '' ;
$search = '' ;
$groupby = '' ;
2016-08-25 13:20:38 -04:00
$post_status_join = false ;
2017-11-30 18:11:00 -05:00
$page = 1 ;
2016-08-25 13:20:38 -04:00
if ( isset ( $q [ 'caller_get_posts' ] ) ) {
2017-11-30 18:11:00 -05:00
_deprecated_argument (
2018-08-16 21:51:36 -04:00
'WP_Query' ,
'3.1.0' ,
2017-11-30 18:11:00 -05:00
sprintf (
I18N: Improve translator comments.
* Add missing translator comments.
* Fix placement of some translator comments. Translator comments should be on the line directly above the line containing the translation function call for optimal compatibility with various `.pot` file generation tools. The CS auto-fixing, which changed some inconsistent function calls to multi-line function calls, is part of the reason why this was no longer the case for a select group of translator comments.
Includes minor code layout fixes.
Polyglots, rejoice! All WordPress core files now have translator comments for all strings with placeholders!
Props jrf, subrataemfluence, GaryJ, webdados, Dency, swissspidy, alvarogois, marcomartins, mihaiiceyro, vladwtz, niq1982, flipkeijzer, michielatyoast, chandrapatel, thrijith, joshuanoyce, FesoVik, tessak22, bhaktirajdev, cleancoded, dhavalkasvala, garrett-eclipse, bibliofille, socalchristina, priyankkpatel, 5hel2l2y, adamsilverstein, JeffPaul, pierlo, SergeyBiryukov.
Fixes #44360.
Built from https://develop.svn.wordpress.org/trunk@45926
git-svn-id: http://core.svn.wordpress.org/trunk@45737 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-09-01 13:13:59 -04:00
/* translators: 1: caller_get_posts, 2: ignore_sticky_posts */
2017-11-30 18:11:00 -05:00
__ ( '%1$s is deprecated. Use %2$s instead.' ),
2017-01-29 06:50:41 -05:00
'<code>caller_get_posts</code>' ,
'<code>ignore_sticky_posts</code>'
)
);
if ( ! isset ( $q [ 'ignore_sticky_posts' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'ignore_sticky_posts' ] = $q [ 'caller_get_posts' ];
2017-01-29 06:50:41 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'ignore_sticky_posts' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'ignore_sticky_posts' ] = false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'suppress_filters' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'suppress_filters' ] = false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'cache_results' ] ) ) {
if ( wp_using_ext_object_cache () ) {
2016-08-25 13:20:38 -04:00
$q [ 'cache_results' ] = false ;
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
$q [ 'cache_results' ] = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'update_post_term_cache' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'update_post_term_cache' ] = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( ! isset ( $q [ 'lazy_load_term_meta' ] ) ) {
$q [ 'lazy_load_term_meta' ] = $q [ 'update_post_term_cache' ];
}
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'update_post_meta_cache' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'update_post_meta_cache' ] = true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! isset ( $q [ 'post_type' ] ) ) {
if ( $this -> is_search ) {
2016-08-25 13:20:38 -04:00
$q [ 'post_type' ] = 'any' ;
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
$q [ 'post_type' ] = '' ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
$post_type = $q [ 'post_type' ];
if ( empty ( $q [ 'posts_per_page' ] ) ) {
$q [ 'posts_per_page' ] = get_option ( 'posts_per_page' );
}
2017-11-30 18:11:00 -05:00
if ( isset ( $q [ 'showposts' ] ) && $q [ 'showposts' ] ) {
$q [ 'showposts' ] = ( int ) $q [ 'showposts' ];
2016-08-25 13:20:38 -04:00
$q [ 'posts_per_page' ] = $q [ 'showposts' ];
}
2020-02-09 11:55:09 -05:00
if ( ( isset ( $q [ 'posts_per_archive_page' ] ) && 0 != $q [ 'posts_per_archive_page' ] ) && ( $this -> is_archive || $this -> is_search ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'posts_per_page' ] = $q [ 'posts_per_archive_page' ];
2017-11-30 18:11:00 -05:00
}
if ( ! isset ( $q [ 'nopaging' ] ) ) {
2020-02-09 11:55:09 -05:00
if ( - 1 == $q [ 'posts_per_page' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'nopaging' ] = true ;
} else {
$q [ 'nopaging' ] = false ;
}
}
if ( $this -> is_feed ) {
2020-01-28 19:45:18 -05:00
// This overrides 'posts_per_page'.
2016-08-25 13:20:38 -04:00
if ( ! empty ( $q [ 'posts_per_rss' ] ) ) {
$q [ 'posts_per_page' ] = $q [ 'posts_per_rss' ];
} else {
$q [ 'posts_per_page' ] = get_option ( 'posts_per_rss' );
}
$q [ 'nopaging' ] = false ;
}
$q [ 'posts_per_page' ] = ( int ) $q [ 'posts_per_page' ];
2017-11-30 18:11:00 -05:00
if ( $q [ 'posts_per_page' ] < - 1 ) {
$q [ 'posts_per_page' ] = abs ( $q [ 'posts_per_page' ] );
2020-02-09 11:55:09 -05:00
} elseif ( 0 == $q [ 'posts_per_page' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'posts_per_page' ] = 1 ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-02-09 11:55:09 -05:00
if ( ! isset ( $q [ 'comments_per_page' ] ) || 0 == $q [ 'comments_per_page' ] ) {
2017-11-30 18:11:00 -05:00
$q [ 'comments_per_page' ] = get_option ( 'comments_per_page' );
}
2016-08-25 13:20:38 -04:00
2020-02-09 11:55:09 -05:00
if ( $this -> is_home && ( empty ( $this -> query ) || 'true' === $q [ 'preview' ] ) && ( 'page' === get_option ( 'show_on_front' ) ) && get_option ( 'page_on_front' ) ) {
2016-08-25 13:20:38 -04:00
$this -> is_page = true ;
$this -> is_home = false ;
2017-11-30 18:11:00 -05:00
$q [ 'page_id' ] = get_option ( 'page_on_front' );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( isset ( $q [ 'page' ] ) ) {
$q [ 'page' ] = trim ( $q [ 'page' ], '/' );
$q [ 'page' ] = absint ( $q [ 'page' ] );
2016-08-25 13:20:38 -04:00
}
// If true, forcibly turns off SQL_CALC_FOUND_ROWS even when limits are present.
2017-11-30 18:11:00 -05:00
if ( isset ( $q [ 'no_found_rows' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'no_found_rows' ] = ( bool ) $q [ 'no_found_rows' ];
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
$q [ 'no_found_rows' ] = false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
switch ( $q [ 'fields' ] ) {
case 'ids' :
2016-10-10 02:38:31 -04:00
$fields = " { $wpdb -> posts } .ID " ;
2016-08-25 13:20:38 -04:00
break ;
case 'id=>parent' :
2016-10-10 02:38:31 -04:00
$fields = " { $wpdb -> posts } .ID, { $wpdb -> posts } .post_parent " ;
2016-08-25 13:20:38 -04:00
break ;
default :
2016-10-10 02:38:31 -04:00
$fields = " { $wpdb -> posts } .* " ;
2016-08-25 13:20:38 -04:00
}
if ( '' !== $q [ 'menu_order' ] ) {
2016-10-10 02:38:31 -04:00
$where .= " AND { $wpdb -> posts } .menu_order = " . $q [ 'menu_order' ];
2016-08-25 13:20:38 -04:00
}
2020-01-28 19:45:18 -05:00
// The "m" parameter is meant for months but accepts datetimes of varying specificity.
2016-08-25 13:20:38 -04:00
if ( $q [ 'm' ] ) {
2017-11-30 18:11:00 -05:00
$where .= " AND YEAR( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 0 , 4 );
if ( strlen ( $q [ 'm' ] ) > 5 ) {
$where .= " AND MONTH( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 4 , 2 );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( strlen ( $q [ 'm' ] ) > 7 ) {
$where .= " AND DAYOFMONTH( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 6 , 2 );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( strlen ( $q [ 'm' ] ) > 9 ) {
$where .= " AND HOUR( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 8 , 2 );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( strlen ( $q [ 'm' ] ) > 11 ) {
$where .= " AND MINUTE( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 10 , 2 );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( strlen ( $q [ 'm' ] ) > 13 ) {
$where .= " AND SECOND( { $wpdb -> posts } .post_date)= " . substr ( $q [ 'm' ], 12 , 2 );
2016-08-25 13:20:38 -04:00
}
}
2020-01-28 19:45:18 -05:00
// Handle the other individual date parameters.
2016-08-25 13:20:38 -04:00
$date_parameters = array ();
2017-11-30 18:11:00 -05:00
if ( '' !== $q [ 'hour' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'hour' ] = $q [ 'hour' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( '' !== $q [ 'minute' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'minute' ] = $q [ 'minute' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( '' !== $q [ 'second' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'second' ] = $q [ 'second' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( $q [ 'year' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'year' ] = $q [ 'year' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( $q [ 'monthnum' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'monthnum' ] = $q [ 'monthnum' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( $q [ 'w' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'week' ] = $q [ 'w' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( $q [ 'day' ] ) {
2016-08-25 13:20:38 -04:00
$date_parameters [ 'day' ] = $q [ 'day' ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( $date_parameters ) {
$date_query = new WP_Date_Query ( array ( $date_parameters ) );
2017-11-30 18:11:00 -05:00
$where .= $date_query -> get_sql ();
2016-08-25 13:20:38 -04:00
}
unset ( $date_parameters , $date_query );
2020-01-28 19:45:18 -05:00
// Handle complex date queries.
2016-08-25 13:20:38 -04:00
if ( ! empty ( $q [ 'date_query' ] ) ) {
$this -> date_query = new WP_Date_Query ( $q [ 'date_query' ] );
2017-11-30 18:11:00 -05:00
$where .= $this -> date_query -> get_sql ();
2016-08-25 13:20:38 -04:00
}
// If we've got a post_type AND it's not "any" post_type.
2020-05-16 14:42:12 -04:00
if ( ! empty ( $q [ 'post_type' ] ) && 'any' !== $q [ 'post_type' ] ) {
2017-11-30 18:11:00 -05:00
foreach ( ( array ) $q [ 'post_type' ] as $_post_type ) {
$ptype_obj = get_post_type_object ( $_post_type );
if ( ! $ptype_obj || ! $ptype_obj -> query_var || empty ( $q [ $ptype_obj -> query_var ] ) ) {
2016-08-25 13:20:38 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( ! $ptype_obj -> hierarchical ) {
// Non-hierarchical post types can directly use 'name'.
$q [ 'name' ] = $q [ $ptype_obj -> query_var ];
} else {
// Hierarchical post types will operate through 'pagename'.
$q [ 'pagename' ] = $q [ $ptype_obj -> query_var ];
2017-11-30 18:11:00 -05:00
$q [ 'name' ] = '' ;
2016-08-25 13:20:38 -04:00
}
// Only one request for a slug is possible, this is why name & pagename are overwritten above.
break ;
2020-01-28 19:45:18 -05:00
} // End foreach.
2017-11-30 18:11:00 -05:00
unset ( $ptype_obj );
2016-08-25 13:20:38 -04:00
}
if ( '' !== $q [ 'title' ] ) {
2016-10-10 02:38:31 -04:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .post_title = %s " , stripslashes ( $q [ 'title' ] ) );
2016-08-25 13:20:38 -04:00
}
// Parameters related to 'post_name'.
2020-05-16 14:42:12 -04:00
if ( '' !== $q [ 'name' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'name' ] = sanitize_title_for_query ( $q [ 'name' ] );
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_name = ' " . $q [ 'name' ] . " ' " ;
2020-05-16 14:42:12 -04:00
} elseif ( '' !== $q [ 'pagename' ] ) {
2017-11-30 18:11:00 -05:00
if ( isset ( $this -> queried_object_id ) ) {
2016-08-25 13:20:38 -04:00
$reqpage = $this -> queried_object_id ;
} else {
2020-05-16 14:42:12 -04:00
if ( 'page' !== $q [ 'post_type' ] ) {
2017-11-30 18:11:00 -05:00
foreach ( ( array ) $q [ 'post_type' ] as $_post_type ) {
$ptype_obj = get_post_type_object ( $_post_type );
if ( ! $ptype_obj || ! $ptype_obj -> hierarchical ) {
2016-08-25 13:20:38 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$reqpage = get_page_by_path ( $q [ 'pagename' ], OBJECT , $_post_type );
if ( $reqpage ) {
2016-08-25 13:20:38 -04:00
break ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
unset ( $ptype_obj );
2016-08-25 13:20:38 -04:00
} else {
2017-11-30 18:11:00 -05:00
$reqpage = get_page_by_path ( $q [ 'pagename' ] );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $reqpage ) ) {
2016-08-25 13:20:38 -04:00
$reqpage = $reqpage -> ID ;
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
$reqpage = 0 ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$page_for_posts = get_option ( 'page_for_posts' );
2020-05-16 14:42:12 -04:00
if ( ( 'page' !== get_option ( 'show_on_front' ) ) || empty ( $page_for_posts ) || ( $reqpage != $page_for_posts ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'pagename' ] = sanitize_title_for_query ( wp_basename ( $q [ 'pagename' ] ) );
2017-11-30 18:11:00 -05:00
$q [ 'name' ] = $q [ 'pagename' ];
$where .= " AND ( { $wpdb -> posts } .ID = ' $reqpage ') " ;
$reqpage_obj = get_post ( $reqpage );
2020-05-16 14:42:12 -04:00
if ( is_object ( $reqpage_obj ) && 'attachment' === $reqpage_obj -> post_type ) {
2016-08-25 13:20:38 -04:00
$this -> is_attachment = true ;
2019-07-02 19:42:58 -04:00
$post_type = 'attachment' ;
$q [ 'post_type' ] = 'attachment' ;
2017-11-30 18:11:00 -05:00
$this -> is_page = true ;
$q [ 'attachment_id' ] = $reqpage ;
2016-08-25 13:20:38 -04:00
}
}
2020-05-16 14:42:12 -04:00
} elseif ( '' !== $q [ 'attachment' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'attachment' ] = sanitize_title_for_query ( wp_basename ( $q [ 'attachment' ] ) );
2017-11-30 18:11:00 -05:00
$q [ 'name' ] = $q [ 'attachment' ];
$where .= " AND { $wpdb -> posts } .post_name = ' " . $q [ 'attachment' ] . " ' " ;
2016-08-25 13:20:38 -04:00
} elseif ( is_array ( $q [ 'post_name__in' ] ) && ! empty ( $q [ 'post_name__in' ] ) ) {
$q [ 'post_name__in' ] = array_map ( 'sanitize_title_for_query' , $q [ 'post_name__in' ] );
2017-11-30 18:11:00 -05:00
$post_name__in = " ' " . implode ( " ',' " , $q [ 'post_name__in' ] ) . " ' " ;
$where .= " AND { $wpdb -> posts } .post_name IN ( $post_name__in ) " ;
2016-08-25 13:20:38 -04:00
}
// If an attachment is requested by number, let it supersede any post number.
2017-11-30 18:11:00 -05:00
if ( $q [ 'attachment_id' ] ) {
$q [ 'p' ] = absint ( $q [ 'attachment_id' ] );
}
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// If a post number is specified, load that post.
2016-08-25 13:20:38 -04:00
if ( $q [ 'p' ] ) {
2016-10-10 02:38:31 -04:00
$where .= " AND { $wpdb -> posts } .ID = " . $q [ 'p' ];
2016-08-25 13:20:38 -04:00
} elseif ( $q [ 'post__in' ] ) {
2017-11-30 18:11:00 -05:00
$post__in = implode ( ',' , array_map ( 'absint' , $q [ 'post__in' ] ) );
$where .= " AND { $wpdb -> posts } .ID IN ( $post__in ) " ;
2016-08-25 13:20:38 -04:00
} elseif ( $q [ 'post__not_in' ] ) {
2017-11-30 18:11:00 -05:00
$post__not_in = implode ( ',' , array_map ( 'absint' , $q [ 'post__not_in' ] ) );
$where .= " AND { $wpdb -> posts } .ID NOT IN ( $post__not_in ) " ;
2016-08-25 13:20:38 -04:00
}
if ( is_numeric ( $q [ 'post_parent' ] ) ) {
2016-10-10 02:38:31 -04:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .post_parent = %d " , $q [ 'post_parent' ] );
2016-08-25 13:20:38 -04:00
} elseif ( $q [ 'post_parent__in' ] ) {
$post_parent__in = implode ( ',' , array_map ( 'absint' , $q [ 'post_parent__in' ] ) );
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_parent IN ( $post_parent__in ) " ;
2016-08-25 13:20:38 -04:00
} elseif ( $q [ 'post_parent__not_in' ] ) {
2017-11-30 18:11:00 -05:00
$post_parent__not_in = implode ( ',' , array_map ( 'absint' , $q [ 'post_parent__not_in' ] ) );
$where .= " AND { $wpdb -> posts } .post_parent NOT IN ( $post_parent__not_in ) " ;
2016-08-25 13:20:38 -04:00
}
if ( $q [ 'page_id' ] ) {
2020-02-09 11:55:09 -05:00
if ( ( 'page' !== get_option ( 'show_on_front' ) ) || ( get_option ( 'page_for_posts' ) != $q [ 'page_id' ] ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'p' ] = $q [ 'page_id' ];
2017-11-30 18:11:00 -05:00
$where = " AND { $wpdb -> posts } .ID = " . $q [ 'page_id' ];
2016-08-25 13:20:38 -04:00
}
}
// If a search pattern is specified, load the posts that match.
if ( strlen ( $q [ 's' ] ) ) {
$search = $this -> parse_search ( $q );
}
if ( ! $q [ 'suppress_filters' ] ) {
/**
* Filters the search SQL that is used in the WHERE clause of WP_Query .
*
* @ since 3.0 . 0
*
* @ param string $search Search SQL for WHERE clause .
* @ param WP_Query $this The current WP_Query object .
*/
$search = apply_filters_ref_array ( 'posts_search' , array ( $search , & $this ) );
}
2020-01-28 19:45:18 -05:00
// Taxonomies.
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_singular ) {
2016-08-25 13:20:38 -04:00
$this -> parse_tax_query ( $q );
2016-10-10 02:38:31 -04:00
$clauses = $this -> tax_query -> get_sql ( $wpdb -> posts , 'ID' );
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$join .= $clauses [ 'join' ];
2016-08-25 13:20:38 -04:00
$where .= $clauses [ 'where' ];
}
if ( $this -> is_tax ) {
2017-11-30 18:11:00 -05:00
if ( empty ( $post_type ) ) {
2020-01-28 19:45:18 -05:00
// Do a fully inclusive search for currently registered post types of queried taxonomies.
2017-11-30 18:11:00 -05:00
$post_type = array ();
2016-08-25 13:20:38 -04:00
$taxonomies = array_keys ( $this -> tax_query -> queried_terms );
foreach ( get_post_types ( array ( 'exclude_from_search' => false ) ) as $pt ) {
2020-02-09 11:55:09 -05:00
$object_taxonomies = 'attachment' === $pt ? get_taxonomies_for_attachments () : get_object_taxonomies ( $pt );
2017-11-30 18:11:00 -05:00
if ( array_intersect ( $taxonomies , $object_taxonomies ) ) {
2016-08-25 13:20:38 -04:00
$post_type [] = $pt ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! $post_type ) {
2016-08-25 13:20:38 -04:00
$post_type = 'any' ;
2017-11-30 18:11:00 -05:00
} elseif ( count ( $post_type ) == 1 ) {
2016-08-25 13:20:38 -04:00
$post_type = $post_type [ 0 ];
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_status_join = true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( 'attachment' , ( array ) $post_type , true ) ) {
2016-08-25 13:20:38 -04:00
$post_status_join = true ;
}
}
/*
* Ensure that 'taxonomy' , 'term' , 'term_id' , 'cat' , and
* 'category_name' vars are set for backward compatibility .
*/
if ( ! empty ( $this -> tax_query -> queried_terms ) ) {
/*
* Set 'taxonomy' , 'term' , and 'term_id' to the
* first taxonomy other than 'post_tag' or 'category' .
*/
if ( ! isset ( $q [ 'taxonomy' ] ) ) {
foreach ( $this -> tax_query -> queried_terms as $queried_taxonomy => $queried_items ) {
if ( empty ( $queried_items [ 'terms' ][ 0 ] ) ) {
continue ;
}
2020-04-04 23:02:11 -04:00
if ( ! in_array ( $queried_taxonomy , array ( 'category' , 'post_tag' ), true ) ) {
2016-08-25 13:20:38 -04:00
$q [ 'taxonomy' ] = $queried_taxonomy ;
if ( 'slug' === $queried_items [ 'field' ] ) {
$q [ 'term' ] = $queried_items [ 'terms' ][ 0 ];
} else {
$q [ 'term_id' ] = $queried_items [ 'terms' ][ 0 ];
}
// Take the first one we find.
break ;
}
}
}
2020-01-28 19:45:18 -05:00
// 'cat', 'category_name', 'tag_id'.
2016-08-25 13:20:38 -04:00
foreach ( $this -> tax_query -> queried_terms as $queried_taxonomy => $queried_items ) {
if ( empty ( $queried_items [ 'terms' ][ 0 ] ) ) {
continue ;
}
if ( 'category' === $queried_taxonomy ) {
$the_cat = get_term_by ( $queried_items [ 'field' ], $queried_items [ 'terms' ][ 0 ], 'category' );
if ( $the_cat ) {
$this -> set ( 'cat' , $the_cat -> term_id );
$this -> set ( 'category_name' , $the_cat -> slug );
}
unset ( $the_cat );
}
if ( 'post_tag' === $queried_taxonomy ) {
$the_tag = get_term_by ( $queried_items [ 'field' ], $queried_items [ 'terms' ][ 0 ], 'post_tag' );
if ( $the_tag ) {
$this -> set ( 'tag_id' , $the_tag -> term_id );
}
unset ( $the_tag );
}
}
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $this -> tax_query -> queries ) || ! empty ( $this -> meta_query -> queries ) ) {
2016-10-10 02:38:31 -04:00
$groupby = " { $wpdb -> posts } .ID " ;
2016-08-25 13:20:38 -04:00
}
2020-01-28 19:45:18 -05:00
// Author/user stuff.
2016-08-25 13:20:38 -04:00
2020-02-09 11:55:09 -05:00
if ( ! empty ( $q [ 'author' ] ) && '0' != $q [ 'author' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'author' ] = addslashes_gpc ( '' . urldecode ( $q [ 'author' ] ) );
2017-11-30 18:11:00 -05:00
$authors = array_unique ( array_map ( 'intval' , preg_split ( '/[,\s]+/' , $q [ 'author' ] ) ) );
2016-08-25 13:20:38 -04:00
foreach ( $authors as $author ) {
2017-11-30 18:11:00 -05:00
$key = $author > 0 ? 'author__in' : 'author__not_in' ;
$q [ $key ][] = abs ( $author );
2016-08-25 13:20:38 -04:00
}
$q [ 'author' ] = implode ( ',' , $authors );
}
if ( ! empty ( $q [ 'author__not_in' ] ) ) {
$author__not_in = implode ( ',' , array_map ( 'absint' , array_unique ( ( array ) $q [ 'author__not_in' ] ) ) );
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_author NOT IN ( $author__not_in ) " ;
2016-08-25 13:20:38 -04:00
} elseif ( ! empty ( $q [ 'author__in' ] ) ) {
$author__in = implode ( ',' , array_map ( 'absint' , array_unique ( ( array ) $q [ 'author__in' ] ) ) );
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_author IN ( $author__in ) " ;
2016-08-25 13:20:38 -04:00
}
2020-01-28 19:45:18 -05:00
// Author stuff for nice URLs.
2016-08-25 13:20:38 -04:00
2020-05-16 14:42:12 -04:00
if ( '' !== $q [ 'author_name' ] ) {
2017-11-30 18:11:00 -05:00
if ( strpos ( $q [ 'author_name' ], '/' ) !== false ) {
$q [ 'author_name' ] = explode ( '/' , $q [ 'author_name' ] );
if ( $q [ 'author_name' ][ count ( $q [ 'author_name' ] ) - 1 ] ) {
2020-01-28 19:45:18 -05:00
$q [ 'author_name' ] = $q [ 'author_name' ][ count ( $q [ 'author_name' ] ) - 1 ]; // No trailing slash.
2016-08-25 13:20:38 -04:00
} else {
2020-01-28 19:45:18 -05:00
$q [ 'author_name' ] = $q [ 'author_name' ][ count ( $q [ 'author_name' ] ) - 2 ]; // There was a trailing slash.
2016-08-25 13:20:38 -04:00
}
}
$q [ 'author_name' ] = sanitize_title_for_query ( $q [ 'author_name' ] );
2017-11-30 18:11:00 -05:00
$q [ 'author' ] = get_user_by ( 'slug' , $q [ 'author_name' ] );
if ( $q [ 'author' ] ) {
2016-08-25 13:20:38 -04:00
$q [ 'author' ] = $q [ 'author' ] -> ID ;
2017-11-30 18:11:00 -05:00
}
$whichauthor .= " AND ( { $wpdb -> posts } .post_author = " . absint ( $q [ 'author' ] ) . ')' ;
2016-08-25 13:20:38 -04:00
}
2017-07-01 07:25:44 -04:00
// Matching by comment count.
if ( isset ( $q [ 'comment_count' ] ) ) {
// Numeric comment count is converted to array format.
if ( is_numeric ( $q [ 'comment_count' ] ) ) {
$q [ 'comment_count' ] = array (
2020-10-08 17:15:13 -04:00
'value' => ( int ) $q [ 'comment_count' ],
2017-07-01 07:25:44 -04:00
);
}
if ( isset ( $q [ 'comment_count' ][ 'value' ] ) ) {
2017-11-30 18:11:00 -05:00
$q [ 'comment_count' ] = array_merge (
array (
'compare' => '=' ,
2018-08-16 21:51:36 -04:00
),
$q [ 'comment_count' ]
2017-11-30 18:11:00 -05:00
);
2017-07-01 07:25:44 -04:00
// Fallback for invalid compare operators is '='.
$compare_operators = array ( '=' , '!=' , '>' , '>=' , '<' , '<=' );
if ( ! in_array ( $q [ 'comment_count' ][ 'compare' ], $compare_operators , true ) ) {
$q [ 'comment_count' ][ 'compare' ] = '=' ;
}
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .comment_count { $q [ 'comment_count' ][ 'compare' ] } %d " , $q [ 'comment_count' ][ 'value' ] );
}
}
2020-01-28 19:45:18 -05:00
// MIME-Type stuff for attachment browsing.
2016-08-25 13:20:38 -04:00
2020-05-16 14:42:12 -04:00
if ( isset ( $q [ 'post_mime_type' ] ) && '' !== $q [ 'post_mime_type' ] ) {
2016-10-10 02:38:31 -04:00
$whichmimetype = wp_post_mime_type_where ( $q [ 'post_mime_type' ], $wpdb -> posts );
2016-08-25 13:20:38 -04:00
}
$where .= $search . $whichauthor . $whichmimetype ;
if ( ! empty ( $this -> meta_query -> queries ) ) {
2016-10-10 02:38:31 -04:00
$clauses = $this -> meta_query -> get_sql ( 'post' , $wpdb -> posts , 'ID' , $this );
2016-08-25 13:20:38 -04:00
$join .= $clauses [ 'join' ];
$where .= $clauses [ 'where' ];
}
$rand = ( isset ( $q [ 'orderby' ] ) && 'rand' === $q [ 'orderby' ] );
if ( ! isset ( $q [ 'order' ] ) ) {
$q [ 'order' ] = $rand ? '' : 'DESC' ;
} else {
$q [ 'order' ] = $rand ? '' : $this -> parse_order ( $q [ 'order' ] );
}
2019-01-07 22:33:49 -05:00
// These values of orderby should ignore the 'order' parameter.
$force_asc = array ( 'post__in' , 'post_name__in' , 'post_parent__in' );
if ( isset ( $q [ 'orderby' ] ) && in_array ( $q [ 'orderby' ], $force_asc , true ) ) {
$q [ 'order' ] = '' ;
}
2016-08-25 13:20:38 -04:00
// Order by.
if ( empty ( $q [ 'orderby' ] ) ) {
/*
* Boolean false or empty array blanks out ORDER BY ,
* while leaving the value unset or otherwise empty sets the default .
*/
if ( isset ( $q [ 'orderby' ] ) && ( is_array ( $q [ 'orderby' ] ) || false === $q [ 'orderby' ] ) ) {
$orderby = '' ;
} else {
2016-10-10 02:38:31 -04:00
$orderby = " { $wpdb -> posts } .post_date " . $q [ 'order' ];
2016-08-25 13:20:38 -04:00
}
2020-05-16 14:42:12 -04:00
} elseif ( 'none' === $q [ 'orderby' ] ) {
2016-08-25 13:20:38 -04:00
$orderby = '' ;
} else {
$orderby_array = array ();
if ( is_array ( $q [ 'orderby' ] ) ) {
foreach ( $q [ 'orderby' ] as $_orderby => $order ) {
$orderby = addslashes_gpc ( urldecode ( $_orderby ) );
$parsed = $this -> parse_orderby ( $orderby );
if ( ! $parsed ) {
continue ;
}
$orderby_array [] = $parsed . ' ' . $this -> parse_order ( $order );
}
$orderby = implode ( ', ' , $orderby_array );
} else {
$q [ 'orderby' ] = urldecode ( $q [ 'orderby' ] );
$q [ 'orderby' ] = addslashes_gpc ( $q [ 'orderby' ] );
foreach ( explode ( ' ' , $q [ 'orderby' ] ) as $i => $orderby ) {
$parsed = $this -> parse_orderby ( $orderby );
// Only allow certain values for safety.
if ( ! $parsed ) {
continue ;
}
$orderby_array [] = $parsed ;
}
$orderby = implode ( ' ' . $q [ 'order' ] . ', ' , $orderby_array );
if ( empty ( $orderby ) ) {
2016-10-10 02:38:31 -04:00
$orderby = " { $wpdb -> posts } .post_date " . $q [ 'order' ];
2016-08-25 13:20:38 -04:00
} elseif ( ! empty ( $q [ 'order' ] ) ) {
$orderby .= " { $q [ 'order' ] } " ;
}
}
}
// Order search results by relevance only when another "orderby" is not specified in the query.
if ( ! empty ( $q [ 's' ] ) ) {
$search_orderby = '' ;
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'search_orderby_title' ] ) && ( empty ( $q [ 'orderby' ] ) && ! $this -> is_feed ) || ( isset ( $q [ 'orderby' ] ) && 'relevance' === $q [ 'orderby' ] ) ) {
2016-08-25 13:20:38 -04:00
$search_orderby = $this -> parse_search_order ( $q );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( ! $q [ 'suppress_filters' ] ) {
/**
* Filters the ORDER BY used when ordering search results .
*
* @ since 3.7 . 0
*
* @ param string $search_orderby The ORDER BY clause .
* @ param WP_Query $this The current WP_Query instance .
*/
$search_orderby = apply_filters ( 'posts_search_orderby' , $search_orderby , $this );
}
2017-11-30 18:11:00 -05:00
if ( $search_orderby ) {
2016-08-25 13:20:38 -04:00
$orderby = $orderby ? $search_orderby . ', ' . $orderby : $search_orderby ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
if ( is_array ( $post_type ) && count ( $post_type ) > 1 ) {
$post_type_cap = 'multiple_post_type' ;
} else {
2017-11-30 18:11:00 -05:00
if ( is_array ( $post_type ) ) {
2016-08-25 13:20:38 -04:00
$post_type = reset ( $post_type );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_type_object = get_post_type_object ( $post_type );
2017-11-30 18:11:00 -05:00
if ( empty ( $post_type_object ) ) {
2016-08-25 13:20:38 -04:00
$post_type_cap = $post_type ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
if ( isset ( $q [ 'post_password' ] ) ) {
2016-10-10 02:38:31 -04:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .post_password = %s " , $q [ 'post_password' ] );
2016-08-25 13:20:38 -04:00
if ( empty ( $q [ 'perm' ] ) ) {
$q [ 'perm' ] = 'readable' ;
}
} elseif ( isset ( $q [ 'has_password' ] ) ) {
2016-10-10 02:38:31 -04:00
$where .= sprintf ( " AND { $wpdb -> posts } .post_password %s '' " , $q [ 'has_password' ] ? '!=' : '=' );
2016-08-25 13:20:38 -04:00
}
if ( ! empty ( $q [ 'comment_status' ] ) ) {
2016-10-10 02:38:31 -04:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .comment_status = %s " , $q [ 'comment_status' ] );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $q [ 'ping_status' ] ) ) {
2016-10-10 02:38:31 -04:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .ping_status = %s " , $q [ 'ping_status' ] );
2016-08-25 13:20:38 -04:00
}
2020-05-16 14:42:12 -04:00
if ( 'any' === $post_type ) {
2017-11-30 18:11:00 -05:00
$in_search_post_types = get_post_types ( array ( 'exclude_from_search' => false ) );
2016-08-25 13:20:38 -04:00
if ( empty ( $in_search_post_types ) ) {
$where .= ' AND 1=0 ' ;
} else {
2020-10-18 13:27:06 -04:00
$where .= " AND { $wpdb -> posts } .post_type IN (' " . implode ( " ', ' " , array_map ( 'esc_sql' , $in_search_post_types ) ) . " ') " ;
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
} elseif ( ! empty ( $post_type ) && is_array ( $post_type ) ) {
2020-10-18 13:27:06 -04:00
$where .= " AND { $wpdb -> posts } .post_type IN (' " . implode ( " ', ' " , esc_sql ( $post_type ) ) . " ') " ;
2016-08-25 13:20:38 -04:00
} elseif ( ! empty ( $post_type ) ) {
2017-11-30 18:11:00 -05:00
$where .= $wpdb -> prepare ( " AND { $wpdb -> posts } .post_type = %s " , $post_type );
$post_type_object = get_post_type_object ( $post_type );
2016-08-25 13:20:38 -04:00
} elseif ( $this -> is_attachment ) {
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_type = 'attachment' " ;
$post_type_object = get_post_type_object ( 'attachment' );
2016-08-25 13:20:38 -04:00
} elseif ( $this -> is_page ) {
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_type = 'page' " ;
$post_type_object = get_post_type_object ( 'page' );
2016-08-25 13:20:38 -04:00
} else {
2017-11-30 18:11:00 -05:00
$where .= " AND { $wpdb -> posts } .post_type = 'post' " ;
$post_type_object = get_post_type_object ( 'post' );
2016-08-25 13:20:38 -04:00
}
$edit_cap = 'edit_post' ;
$read_cap = 'read_post' ;
if ( ! empty ( $post_type_object ) ) {
2017-11-30 18:11:00 -05:00
$edit_others_cap = $post_type_object -> cap -> edit_others_posts ;
2016-08-25 13:20:38 -04:00
$read_private_cap = $post_type_object -> cap -> read_private_posts ;
} else {
2017-11-30 18:11:00 -05:00
$edit_others_cap = 'edit_others_' . $post_type_cap . 's' ;
2016-08-25 13:20:38 -04:00
$read_private_cap = 'read_private_' . $post_type_cap . 's' ;
}
$user_id = get_current_user_id ();
$q_status = array ();
if ( ! empty ( $q [ 'post_status' ] ) ) {
$statuswheres = array ();
2017-11-30 18:11:00 -05:00
$q_status = $q [ 'post_status' ];
if ( ! is_array ( $q_status ) ) {
$q_status = explode ( ',' , $q_status );
}
2016-08-25 13:20:38 -04:00
$r_status = array ();
$p_status = array ();
$e_status = array ();
2020-04-04 23:02:11 -04:00
if ( in_array ( 'any' , $q_status , true ) ) {
2016-08-25 13:20:38 -04:00
foreach ( get_post_stati ( array ( 'exclude_from_search' => true ) ) as $status ) {
2020-04-04 23:02:11 -04:00
if ( ! in_array ( $status , $q_status , true ) ) {
2016-10-10 02:38:31 -04:00
$e_status [] = " { $wpdb -> posts } .post_status <> ' $status ' " ;
2016-08-25 13:20:38 -04:00
}
}
} else {
foreach ( get_post_stati () as $status ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $status , $q_status , true ) ) {
2020-05-16 14:42:12 -04:00
if ( 'private' === $status ) {
2016-10-10 02:38:31 -04:00
$p_status [] = " { $wpdb -> posts } .post_status = ' $status ' " ;
2016-08-25 13:20:38 -04:00
} else {
2016-10-10 02:38:31 -04:00
$r_status [] = " { $wpdb -> posts } .post_status = ' $status ' " ;
2016-08-25 13:20:38 -04:00
}
}
}
}
2020-05-16 14:42:12 -04:00
if ( empty ( $q [ 'perm' ] ) || 'readable' !== $q [ 'perm' ] ) {
2017-11-30 18:11:00 -05:00
$r_status = array_merge ( $r_status , $p_status );
unset ( $p_status );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $e_status ) ) {
2020-10-18 13:27:06 -04:00
$statuswheres [] = '(' . implode ( ' AND ' , $e_status ) . ')' ;
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $r_status ) ) {
2020-05-16 14:42:12 -04:00
if ( ! empty ( $q [ 'perm' ] ) && 'editable' === $q [ 'perm' ] && ! current_user_can ( $edit_others_cap ) ) {
2020-10-18 13:27:06 -04:00
$statuswheres [] = " ( { $wpdb -> posts } .post_author = $user_id " . 'AND (' . implode ( ' OR ' , $r_status ) . '))' ;
2016-08-25 13:20:38 -04:00
} else {
2020-10-18 13:27:06 -04:00
$statuswheres [] = '(' . implode ( ' OR ' , $r_status ) . ')' ;
2016-08-25 13:20:38 -04:00
}
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $p_status ) ) {
2020-05-16 14:42:12 -04:00
if ( ! empty ( $q [ 'perm' ] ) && 'readable' === $q [ 'perm' ] && ! current_user_can ( $read_private_cap ) ) {
2020-10-18 13:27:06 -04:00
$statuswheres [] = " ( { $wpdb -> posts } .post_author = $user_id " . 'AND (' . implode ( ' OR ' , $p_status ) . '))' ;
2016-08-25 13:20:38 -04:00
} else {
2020-10-18 13:27:06 -04:00
$statuswheres [] = '(' . implode ( ' OR ' , $p_status ) . ')' ;
2016-08-25 13:20:38 -04:00
}
}
if ( $post_status_join ) {
2016-10-10 02:38:31 -04:00
$join .= " LEFT JOIN { $wpdb -> posts } AS p2 ON ( { $wpdb -> posts } .post_parent = p2.ID) " ;
2016-08-25 13:20:38 -04:00
foreach ( $statuswheres as $index => $statuswhere ) {
2017-11-30 18:11:00 -05:00
$statuswheres [ $index ] = " ( $statuswhere OR ( { $wpdb -> posts } .post_status = 'inherit' AND " . str_replace ( $wpdb -> posts , 'p2' , $statuswhere ) . '))' ;
2016-08-25 13:20:38 -04:00
}
}
$where_status = implode ( ' OR ' , $statuswheres );
if ( ! empty ( $where_status ) ) {
$where .= " AND ( $where_status ) " ;
}
2017-11-30 18:11:00 -05:00
} elseif ( ! $this -> is_singular ) {
2016-10-10 02:38:31 -04:00
$where .= " AND ( { $wpdb -> posts } .post_status = 'publish' " ;
2016-08-25 13:20:38 -04:00
// Add public states.
2017-11-30 18:11:00 -05:00
$public_states = get_post_stati ( array ( 'public' => true ) );
2016-08-25 13:20:38 -04:00
foreach ( ( array ) $public_states as $state ) {
2020-05-16 14:42:12 -04:00
if ( 'publish' === $state ) { // Publish is hard-coded above.
2016-08-25 13:20:38 -04:00
continue ;
2017-11-30 18:11:00 -05:00
}
2016-10-10 02:38:31 -04:00
$where .= " OR { $wpdb -> posts } .post_status = ' $state ' " ;
2016-08-25 13:20:38 -04:00
}
if ( $this -> is_admin ) {
// Add protected states that should show in the admin all list.
2017-11-30 18:11:00 -05:00
$admin_all_states = get_post_stati (
array (
'protected' => true ,
'show_in_admin_all_list' => true ,
)
);
2016-08-25 13:20:38 -04:00
foreach ( ( array ) $admin_all_states as $state ) {
2016-10-10 02:38:31 -04:00
$where .= " OR { $wpdb -> posts } .post_status = ' $state ' " ;
2016-08-25 13:20:38 -04:00
}
}
if ( is_user_logged_in () ) {
// Add private states that are limited to viewing by the author of a post or someone who has caps to read private states.
2017-11-30 18:11:00 -05:00
$private_states = get_post_stati ( array ( 'private' => true ) );
2016-08-25 13:20:38 -04:00
foreach ( ( array ) $private_states as $state ) {
2016-10-10 02:38:31 -04:00
$where .= current_user_can ( $read_private_cap ) ? " OR { $wpdb -> posts } .post_status = ' $state ' " : " OR { $wpdb -> posts } .post_author = $user_id AND { $wpdb -> posts } .post_status = ' $state ' " ;
2016-08-25 13:20:38 -04:00
}
}
$where .= ')' ;
}
/*
* Apply filters on where and join prior to paging so that any
* manipulations to them are reflected in the paging by day queries .
*/
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'suppress_filters' ] ) {
2016-08-25 13:20:38 -04:00
/**
* Filters the WHERE clause of the query .
*
* @ since 1.5 . 0
*
* @ param string $where The WHERE clause of the query .
2020-08-18 08:39:03 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$where = apply_filters_ref_array ( 'posts_where' , array ( $where , & $this ) );
/**
* Filters the JOIN clause of the query .
*
* @ since 1.5 . 0
*
2020-08-18 08:39:03 -04:00
* @ param string $join The JOIN clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$join = apply_filters_ref_array ( 'posts_join' , array ( $join , & $this ) );
}
2020-01-28 19:45:18 -05:00
// Paging.
2017-11-30 18:11:00 -05:00
if ( empty ( $q [ 'nopaging' ] ) && ! $this -> is_singular ) {
$page = absint ( $q [ 'paged' ] );
if ( ! $page ) {
2016-08-25 13:20:38 -04:00
$page = 1 ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
// If 'offset' is provided, it takes precedence over 'paged'.
if ( isset ( $q [ 'offset' ] ) && is_numeric ( $q [ 'offset' ] ) ) {
$q [ 'offset' ] = absint ( $q [ 'offset' ] );
2017-11-30 18:11:00 -05:00
$pgstrt = $q [ 'offset' ] . ', ' ;
2016-08-25 13:20:38 -04:00
} else {
$pgstrt = absint ( ( $page - 1 ) * $q [ 'posts_per_page' ] ) . ', ' ;
}
$limits = 'LIMIT ' . $pgstrt . $q [ 'posts_per_page' ];
}
2020-01-28 19:45:18 -05:00
// Comments feeds.
2016-08-25 13:20:38 -04:00
if ( $this -> is_comment_feed && ! $this -> is_singular ) {
if ( $this -> is_archive || $this -> is_search ) {
2017-11-30 18:11:00 -05:00
$cjoin = " JOIN { $wpdb -> posts } ON ( { $wpdb -> comments } .comment_post_ID = { $wpdb -> posts } .ID) $join " ;
$cwhere = " WHERE comment_approved = '1' $where " ;
2016-10-10 02:38:31 -04:00
$cgroupby = " { $wpdb -> comments } .comment_id " ;
2020-01-28 19:45:18 -05:00
} else { // Other non-singular, e.g. front.
2017-11-30 18:11:00 -05:00
$cjoin = " JOIN { $wpdb -> posts } ON ( { $wpdb -> comments } .comment_post_ID = { $wpdb -> posts } .ID ) " ;
$cwhere = " WHERE ( post_status = 'publish' OR ( post_status = 'inherit' AND post_type = 'attachment' ) ) AND comment_approved = '1' " ;
2016-08-25 13:20:38 -04:00
$cgroupby = '' ;
}
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'suppress_filters' ] ) {
2016-08-25 13:20:38 -04:00
/**
* Filters the JOIN clause of the comments feed query before sending .
*
* @ since 2.2 . 0
*
* @ param string $cjoin The JOIN clause of the query .
2020-08-18 08:39:03 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$cjoin = apply_filters_ref_array ( 'comment_feed_join' , array ( $cjoin , & $this ) );
/**
* Filters the WHERE clause of the comments feed query before sending .
*
* @ since 2.2 . 0
*
* @ param string $cwhere The WHERE clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$cwhere = apply_filters_ref_array ( 'comment_feed_where' , array ( $cwhere , & $this ) );
/**
* Filters the GROUP BY clause of the comments feed query before sending .
*
* @ since 2.2 . 0
*
* @ param string $cgroupby The GROUP BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$cgroupby = apply_filters_ref_array ( 'comment_feed_groupby' , array ( $cgroupby , & $this ) );
/**
* Filters the ORDER BY clause of the comments feed query before sending .
*
* @ since 2.8 . 0
*
* @ param string $corderby The ORDER BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$corderby = apply_filters_ref_array ( 'comment_feed_orderby' , array ( 'comment_date_gmt DESC' , & $this ) );
/**
* Filters the LIMIT clause of the comments feed query before sending .
*
* @ since 2.8 . 0
*
* @ param string $climits The JOIN clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
2017-11-30 18:11:00 -05:00
$climits = apply_filters_ref_array ( 'comment_feed_limits' , array ( 'LIMIT ' . get_option ( 'posts_per_rss' ), & $this ) );
2016-08-25 13:20:38 -04:00
}
2019-07-02 21:14:57 -04:00
2016-08-25 13:20:38 -04:00
$cgroupby = ( ! empty ( $cgroupby ) ) ? 'GROUP BY ' . $cgroupby : '' ;
$corderby = ( ! empty ( $corderby ) ) ? 'ORDER BY ' . $corderby : '' ;
2019-07-02 21:14:57 -04:00
$climits = ( ! empty ( $climits ) ) ? $climits : '' ;
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$comments = ( array ) $wpdb -> get_results ( " SELECT $distinct { $wpdb -> comments } .* FROM { $wpdb -> comments } $cjoin $cwhere $cgroupby $corderby $climits " );
2020-01-28 19:45:18 -05:00
// Convert to WP_Comment.
2017-11-30 18:11:00 -05:00
$this -> comments = array_map ( 'get_comment' , $comments );
$this -> comment_count = count ( $this -> comments );
2016-08-25 13:20:38 -04:00
$post_ids = array ();
2017-11-30 18:11:00 -05:00
foreach ( $this -> comments as $comment ) {
2016-08-25 13:20:38 -04:00
$post_ids [] = ( int ) $comment -> comment_post_ID ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-10-18 13:27:06 -04:00
$post_ids = implode ( ',' , $post_ids );
2017-11-30 18:11:00 -05:00
$join = '' ;
2016-08-25 13:20:38 -04:00
if ( $post_ids ) {
2016-10-10 02:38:31 -04:00
$where = " AND { $wpdb -> posts } .ID IN ( $post_ids ) " ;
2016-08-25 13:20:38 -04:00
} else {
2017-11-30 18:11:00 -05:00
$where = 'AND 0' ;
2016-08-25 13:20:38 -04:00
}
}
$pieces = array ( 'where' , 'groupby' , 'join' , 'orderby' , 'distinct' , 'fields' , 'limits' );
/*
* Apply post - paging filters on where and join . Only plugins that
* manipulate paging queries should use these hooks .
*/
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'suppress_filters' ] ) {
2016-08-25 13:20:38 -04:00
/**
* Filters the WHERE clause of the query .
*
* Specifically for manipulating paging queries .
*
* @ since 1.5 . 0
*
* @ param string $where The WHERE clause of the query .
2020-08-18 08:39:03 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$where = apply_filters_ref_array ( 'posts_where_paged' , array ( $where , & $this ) );
/**
* Filters the GROUP BY clause of the query .
*
* @ since 2.0 . 0
*
* @ param string $groupby The GROUP BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$groupby = apply_filters_ref_array ( 'posts_groupby' , array ( $groupby , & $this ) );
/**
* Filters the JOIN clause of the query .
*
* Specifically for manipulating paging queries .
*
* @ since 1.5 . 0
*
2020-08-18 08:39:03 -04:00
* @ param string $join The JOIN clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$join = apply_filters_ref_array ( 'posts_join_paged' , array ( $join , & $this ) );
/**
* Filters the ORDER BY clause of the query .
*
* @ since 1.5 . 1
*
* @ param string $orderby The ORDER BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$orderby = apply_filters_ref_array ( 'posts_orderby' , array ( $orderby , & $this ) );
/**
* Filters the DISTINCT clause of the query .
*
* @ since 2.1 . 0
*
* @ param string $distinct The DISTINCT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$distinct = apply_filters_ref_array ( 'posts_distinct' , array ( $distinct , & $this ) );
/**
* Filters the LIMIT clause of the query .
*
* @ since 2.1 . 0
*
* @ param string $limits The LIMIT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$limits = apply_filters_ref_array ( 'post_limits' , array ( $limits , & $this ) );
/**
* Filters the SELECT clause of the query .
*
* @ since 2.1 . 0
*
* @ param string $fields The SELECT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$fields = apply_filters_ref_array ( 'posts_fields' , array ( $fields , & $this ) );
/**
* Filters all query clauses at once , for convenience .
*
* Covers the WHERE , GROUP BY , JOIN , ORDER BY , DISTINCT ,
* fields ( SELECT ), and LIMITS clauses .
*
* @ since 3.1 . 0
*
2018-03-25 15:33:31 -04:00
* @ param string [] $clauses Associative array of the clauses for the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$clauses = ( array ) apply_filters_ref_array ( 'posts_clauses' , array ( compact ( $pieces ), & $this ) );
2017-11-30 18:11:00 -05:00
$where = isset ( $clauses [ 'where' ] ) ? $clauses [ 'where' ] : '' ;
$groupby = isset ( $clauses [ 'groupby' ] ) ? $clauses [ 'groupby' ] : '' ;
$join = isset ( $clauses [ 'join' ] ) ? $clauses [ 'join' ] : '' ;
$orderby = isset ( $clauses [ 'orderby' ] ) ? $clauses [ 'orderby' ] : '' ;
$distinct = isset ( $clauses [ 'distinct' ] ) ? $clauses [ 'distinct' ] : '' ;
$fields = isset ( $clauses [ 'fields' ] ) ? $clauses [ 'fields' ] : '' ;
$limits = isset ( $clauses [ 'limits' ] ) ? $clauses [ 'limits' ] : '' ;
2016-08-25 13:20:38 -04:00
}
/**
* Fires to announce the query ' s current selection parameters .
*
* For use by caching plugins .
*
* @ since 2.3 . 0
*
* @ param string $selection The assembled selection query .
*/
do_action ( 'posts_selection' , $where . $groupby . $orderby . $limits . $join );
/*
* Filters again for the benefit of caching plugins .
* Regular plugins should use the hooks above .
*/
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'suppress_filters' ] ) {
2016-08-25 13:20:38 -04:00
/**
* Filters the WHERE clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $where The WHERE clause of the query .
2020-08-18 08:39:03 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$where = apply_filters_ref_array ( 'posts_where_request' , array ( $where , & $this ) );
/**
* Filters the GROUP BY clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $groupby The GROUP BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$groupby = apply_filters_ref_array ( 'posts_groupby_request' , array ( $groupby , & $this ) );
/**
* Filters the JOIN clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
2020-08-18 08:39:03 -04:00
* @ param string $join The JOIN clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$join = apply_filters_ref_array ( 'posts_join_request' , array ( $join , & $this ) );
/**
* Filters the ORDER BY clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $orderby The ORDER BY clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$orderby = apply_filters_ref_array ( 'posts_orderby_request' , array ( $orderby , & $this ) );
/**
* Filters the DISTINCT clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $distinct The DISTINCT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$distinct = apply_filters_ref_array ( 'posts_distinct_request' , array ( $distinct , & $this ) );
/**
* Filters the SELECT clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $fields The SELECT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$fields = apply_filters_ref_array ( 'posts_fields_request' , array ( $fields , & $this ) );
/**
* Filters the LIMIT clause of the query .
*
* For use by caching plugins .
*
* @ since 2.5 . 0
*
* @ param string $limits The LIMIT clause of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$limits = apply_filters_ref_array ( 'post_limits_request' , array ( $limits , & $this ) );
/**
* Filters all query clauses at once , for convenience .
*
* For use by caching plugins .
*
* Covers the WHERE , GROUP BY , JOIN , ORDER BY , DISTINCT ,
* fields ( SELECT ), and LIMITS clauses .
*
* @ since 3.1 . 0
*
2018-03-25 15:33:31 -04:00
* @ param string [] $pieces Associative array of the pieces of the query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$clauses = ( array ) apply_filters_ref_array ( 'posts_clauses_request' , array ( compact ( $pieces ), & $this ) );
2017-11-30 18:11:00 -05:00
$where = isset ( $clauses [ 'where' ] ) ? $clauses [ 'where' ] : '' ;
$groupby = isset ( $clauses [ 'groupby' ] ) ? $clauses [ 'groupby' ] : '' ;
$join = isset ( $clauses [ 'join' ] ) ? $clauses [ 'join' ] : '' ;
$orderby = isset ( $clauses [ 'orderby' ] ) ? $clauses [ 'orderby' ] : '' ;
$distinct = isset ( $clauses [ 'distinct' ] ) ? $clauses [ 'distinct' ] : '' ;
$fields = isset ( $clauses [ 'fields' ] ) ? $clauses [ 'fields' ] : '' ;
$limits = isset ( $clauses [ 'limits' ] ) ? $clauses [ 'limits' ] : '' ;
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $groupby ) ) {
2016-08-25 13:20:38 -04:00
$groupby = 'GROUP BY ' . $groupby ;
2017-11-30 18:11:00 -05:00
}
if ( ! empty ( $orderby ) ) {
2016-08-25 13:20:38 -04:00
$orderby = 'ORDER BY ' . $orderby ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$found_rows = '' ;
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'no_found_rows' ] && ! empty ( $limits ) ) {
2016-08-25 13:20:38 -04:00
$found_rows = 'SQL_CALC_FOUND_ROWS' ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2019-07-02 19:42:58 -04:00
$old_request = " SELECT $found_rows $distinct $fields FROM { $wpdb -> posts } $join WHERE 1=1 $where $groupby $orderby $limits " ;
$this -> request = $old_request ;
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! $q [ 'suppress_filters' ] ) {
2016-08-25 13:20:38 -04:00
/**
* Filters the completed SQL query before sending .
*
* @ since 2.0 . 0
*
* @ param string $request The complete SQL query .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$this -> request = apply_filters_ref_array ( 'posts_request' , array ( $this -> request , & $this ) );
}
/**
* Filters the posts array before the query takes place .
*
2020-09-17 06:45:03 -04:00
* Return a non - null value to bypass WordPress ' default post queries .
2016-08-25 13:20:38 -04:00
*
* Filtering functions that require pagination information are encouraged to set
* the `found_posts` and `max_num_pages` properties of the WP_Query object ,
* passed to the filter by reference . If WP_Query does not perform a database
* query , it will not have enough information to generate these values itself .
*
* @ since 4.6 . 0
*
* @ param array | null $posts Return an array of post data to short - circuit WP ' s query ,
* or null to allow WP to run its normal queries .
2017-10-02 18:14:46 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$this -> posts = apply_filters_ref_array ( 'posts_pre_query' , array ( null , & $this ) );
2020-05-16 14:42:12 -04:00
if ( 'ids' === $q [ 'fields' ] ) {
2016-08-25 13:20:38 -04:00
if ( null === $this -> posts ) {
2016-10-10 02:38:31 -04:00
$this -> posts = $wpdb -> get_col ( $this -> request );
2016-08-25 13:20:38 -04:00
}
2017-11-30 18:11:00 -05:00
$this -> posts = array_map ( 'intval' , $this -> posts );
2016-08-25 13:20:38 -04:00
$this -> post_count = count ( $this -> posts );
$this -> set_found_posts ( $q , $limits );
return $this -> posts ;
}
2020-05-16 14:42:12 -04:00
if ( 'id=>parent' === $q [ 'fields' ] ) {
2016-08-25 13:20:38 -04:00
if ( null === $this -> posts ) {
2016-10-10 02:38:31 -04:00
$this -> posts = $wpdb -> get_results ( $this -> request );
2016-08-25 13:20:38 -04:00
}
$this -> post_count = count ( $this -> posts );
$this -> set_found_posts ( $q , $limits );
$r = array ();
foreach ( $this -> posts as $key => $post ) {
2017-11-30 18:11:00 -05:00
$this -> posts [ $key ] -> ID = ( int ) $post -> ID ;
2016-08-25 13:20:38 -04:00
$this -> posts [ $key ] -> post_parent = ( int ) $post -> post_parent ;
$r [ ( int ) $post -> ID ] = ( int ) $post -> post_parent ;
}
return $r ;
}
if ( null === $this -> posts ) {
2020-05-16 14:42:12 -04:00
$split_the_query = ( $old_request == $this -> request && " { $wpdb -> posts } .* " === $fields && ! empty ( $limits ) && $q [ 'posts_per_page' ] < 500 );
2016-08-25 13:20:38 -04:00
/**
* Filters whether to split the query .
*
* Splitting the query will cause it to fetch just the IDs of the found posts
* ( and then individually fetch each post by ID ), rather than fetching every
* complete row at once . One massive result vs . many small results .
*
* @ since 3.4 . 0
*
* @ param bool $split_the_query Whether or not to split the query .
* @ param WP_Query $this The WP_Query instance .
*/
$split_the_query = apply_filters ( 'split_the_query' , $split_the_query , $this );
if ( $split_the_query ) {
2020-01-28 19:45:18 -05:00
// First get the IDs and then fill in the objects.
2016-08-25 13:20:38 -04:00
2016-10-10 02:38:31 -04:00
$this -> request = " SELECT $found_rows $distinct { $wpdb -> posts } .ID FROM { $wpdb -> posts } $join WHERE 1=1 $where $groupby $orderby $limits " ;
2016-08-25 13:20:38 -04:00
/**
* Filters the Post IDs SQL request before sending .
*
* @ since 3.4 . 0
*
* @ param string $request The post ID request .
* @ param WP_Query $this The WP_Query instance .
*/
$this -> request = apply_filters ( 'posts_request_ids' , $this -> request , $this );
2016-10-10 02:38:31 -04:00
$ids = $wpdb -> get_col ( $this -> request );
2016-08-25 13:20:38 -04:00
if ( $ids ) {
$this -> posts = $ids ;
$this -> set_found_posts ( $q , $limits );
_prime_post_caches ( $ids , $q [ 'update_post_term_cache' ], $q [ 'update_post_meta_cache' ] );
} else {
$this -> posts = array ();
}
} else {
2016-10-10 02:38:31 -04:00
$this -> posts = $wpdb -> get_results ( $this -> request );
2016-08-25 13:20:38 -04:00
$this -> set_found_posts ( $q , $limits );
}
}
// Convert to WP_Post objects.
if ( $this -> posts ) {
$this -> posts = array_map ( 'get_post' , $this -> posts );
}
if ( ! $q [ 'suppress_filters' ] ) {
/**
* Filters the raw post results array , prior to status checks .
*
* @ since 2.3 . 0
*
2018-03-25 15:33:31 -04:00
* @ param WP_Post [] $posts Array of post objects .
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$this -> posts = apply_filters_ref_array ( 'posts_results' , array ( $this -> posts , & $this ) );
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $this -> posts ) && $this -> is_comment_feed && $this -> is_singular ) {
2016-08-25 13:20:38 -04:00
/** This filter is documented in wp-includes/query.php */
$cjoin = apply_filters_ref_array ( 'comment_feed_join' , array ( '' , & $this ) );
/** This filter is documented in wp-includes/query.php */
$cwhere = apply_filters_ref_array ( 'comment_feed_where' , array ( " WHERE comment_post_ID = ' { $this -> posts [ 0 ] -> ID } ' AND comment_approved = '1' " , & $this ) );
/** This filter is documented in wp-includes/query.php */
$cgroupby = apply_filters_ref_array ( 'comment_feed_groupby' , array ( '' , & $this ) );
$cgroupby = ( ! empty ( $cgroupby ) ) ? 'GROUP BY ' . $cgroupby : '' ;
/** This filter is documented in wp-includes/query.php */
$corderby = apply_filters_ref_array ( 'comment_feed_orderby' , array ( 'comment_date_gmt DESC' , & $this ) );
$corderby = ( ! empty ( $corderby ) ) ? 'ORDER BY ' . $corderby : '' ;
/** This filter is documented in wp-includes/query.php */
2017-11-30 18:11:00 -05:00
$climits = apply_filters_ref_array ( 'comment_feed_limits' , array ( 'LIMIT ' . get_option ( 'posts_per_rss' ), & $this ) );
2016-08-25 13:20:38 -04:00
2016-10-10 02:38:31 -04:00
$comments_request = " SELECT { $wpdb -> comments } .* FROM { $wpdb -> comments } $cjoin $cwhere $cgroupby $corderby $climits " ;
2017-11-30 18:11:00 -05:00
$comments = $wpdb -> get_results ( $comments_request );
2020-01-28 19:45:18 -05:00
// Convert to WP_Comment.
2017-11-30 18:11:00 -05:00
$this -> comments = array_map ( 'get_comment' , $comments );
$this -> comment_count = count ( $this -> comments );
2016-08-25 13:20:38 -04:00
}
// Check post status to determine if post should be displayed.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $this -> posts ) && ( $this -> is_single || $this -> is_page ) ) {
$status = get_post_status ( $this -> posts [ 0 ] );
2020-02-04 20:33:05 -05:00
2016-08-25 13:20:38 -04:00
if ( 'attachment' === $this -> posts [ 0 ] -> post_type && 0 === ( int ) $this -> posts [ 0 ] -> post_parent ) {
2017-11-30 18:11:00 -05:00
$this -> is_page = false ;
$this -> is_single = true ;
2016-08-25 13:20:38 -04:00
$this -> is_attachment = true ;
}
// If the post_status was specifically requested, let it pass through.
2020-04-04 23:02:11 -04:00
if ( ! in_array ( $status , $q_status , true ) ) {
2020-02-04 20:33:05 -05:00
$post_status_obj = get_post_status_object ( $status );
2016-08-25 13:20:38 -04:00
2020-02-04 20:33:05 -05:00
if ( $post_status_obj && ! $post_status_obj -> public ) {
if ( ! is_user_logged_in () ) {
// User must be logged in to view unpublished posts.
$this -> posts = array ();
} else {
if ( $post_status_obj -> protected ) {
// User must have edit permissions on the draft to preview.
if ( ! current_user_can ( $edit_cap , $this -> posts [ 0 ] -> ID ) ) {
$this -> posts = array ();
} else {
$this -> is_preview = true ;
2020-05-16 14:42:12 -04:00
if ( 'future' !== $status ) {
2020-02-04 20:33:05 -05:00
$this -> posts [ 0 ] -> post_date = current_time ( 'mysql' );
}
2020-02-04 18:02:09 -05:00
}
2020-02-04 20:33:05 -05:00
} elseif ( $post_status_obj -> private ) {
if ( ! current_user_can ( $read_cap , $this -> posts [ 0 ] -> ID ) ) {
$this -> posts = array ();
}
} else {
2016-08-25 13:20:38 -04:00
$this -> posts = array ();
2017-11-30 18:11:00 -05:00
}
2020-02-04 20:33:05 -05:00
}
} elseif ( ! $post_status_obj ) {
// Post status is not registered, assume it's not public.
if ( ! current_user_can ( $edit_cap , $this -> posts [ 0 ] -> ID ) ) {
2020-02-04 18:02:09 -05:00
$this -> posts = array ();
2016-08-25 13:20:38 -04:00
}
}
}
if ( $this -> is_preview && $this -> posts && current_user_can ( $edit_cap , $this -> posts [ 0 ] -> ID ) ) {
/**
* Filters the single post for preview mode .
*
* @ since 2.7 . 0
*
* @ param WP_Post $post_preview The Post object .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$this -> posts [ 0 ] = get_post ( apply_filters_ref_array ( 'the_preview' , array ( $this -> posts [ 0 ], & $this ) ) );
}
}
2020-01-28 19:45:18 -05:00
// Put sticky posts at the top of the posts array.
2017-11-30 18:11:00 -05:00
$sticky_posts = get_option ( 'sticky_posts' );
if ( $this -> is_home && $page <= 1 && is_array ( $sticky_posts ) && ! empty ( $sticky_posts ) && ! $q [ 'ignore_sticky_posts' ] ) {
$num_posts = count ( $this -> posts );
2016-08-25 13:20:38 -04:00
$sticky_offset = 0 ;
// Loop over posts and relocate stickies to the front.
for ( $i = 0 ; $i < $num_posts ; $i ++ ) {
2020-04-09 11:43:10 -04:00
if ( in_array ( $this -> posts [ $i ] -> ID , $sticky_posts , true ) ) {
2017-11-30 18:11:00 -05:00
$sticky_post = $this -> posts [ $i ];
2020-01-28 19:45:18 -05:00
// Remove sticky from current position.
2017-11-30 18:11:00 -05:00
array_splice ( $this -> posts , $i , 1 );
2020-01-28 19:45:18 -05:00
// Move to front, after other stickies.
2017-11-30 18:11:00 -05:00
array_splice ( $this -> posts , $sticky_offset , 0 , array ( $sticky_post ) );
2016-08-25 13:20:38 -04:00
// Increment the sticky offset. The next sticky will be placed at this offset.
$sticky_offset ++ ;
2020-01-28 19:45:18 -05:00
// Remove post from sticky posts array.
2020-04-09 11:43:10 -04:00
$offset = array_search ( $sticky_post -> ID , $sticky_posts , true );
2017-11-30 18:11:00 -05:00
unset ( $sticky_posts [ $offset ] );
2016-08-25 13:20:38 -04:00
}
}
// If any posts have been excluded specifically, Ignore those that are sticky.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $sticky_posts ) && ! empty ( $q [ 'post__not_in' ] ) ) {
$sticky_posts = array_diff ( $sticky_posts , $q [ 'post__not_in' ] );
}
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// Fetch sticky posts that weren't in the query results.
2017-11-30 18:11:00 -05:00
if ( ! empty ( $sticky_posts ) ) {
$stickies = get_posts (
array (
'post__in' => $sticky_posts ,
'post_type' => $post_type ,
'post_status' => 'publish' ,
'nopaging' => true ,
)
);
2016-08-25 13:20:38 -04:00
foreach ( $stickies as $sticky_post ) {
array_splice ( $this -> posts , $sticky_offset , 0 , array ( $sticky_post ) );
$sticky_offset ++ ;
}
}
}
// If comments have been fetched as part of the query, make sure comment meta lazy-loading is set up.
if ( ! empty ( $this -> comments ) ) {
wp_queue_comments_for_comment_meta_lazyload ( $this -> comments );
}
if ( ! $q [ 'suppress_filters' ] ) {
/**
* Filters the array of retrieved posts after they ' ve been fetched and
* internally processed .
*
* @ since 1.5 . 0
*
2018-03-25 15:33:31 -04:00
* @ param WP_Post [] $posts Array of post objects .
2020-08-18 08:39:03 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
$this -> posts = apply_filters_ref_array ( 'the_posts' , array ( $this -> posts , & $this ) );
}
// Ensure that any posts added/modified via one of the filters above are
// of the type WP_Post and are filtered.
if ( $this -> posts ) {
$this -> post_count = count ( $this -> posts );
$this -> posts = array_map ( 'get_post' , $this -> posts );
2017-11-30 18:11:00 -05:00
if ( $q [ 'cache_results' ] ) {
update_post_caches ( $this -> posts , $post_type , $q [ 'update_post_term_cache' ], $q [ 'update_post_meta_cache' ] );
}
2016-08-25 13:20:38 -04:00
$this -> post = reset ( $this -> posts );
} else {
$this -> post_count = 0 ;
2017-11-30 18:11:00 -05:00
$this -> posts = array ();
2016-08-25 13:20:38 -04:00
}
if ( $q [ 'lazy_load_term_meta' ] ) {
wp_queue_posts_for_term_meta_lazyload ( $this -> posts );
}
return $this -> posts ;
}
/**
* Set up the amount of found posts and the number of pages ( if limit clause was used )
* for the current query .
*
* @ since 3.5 . 0
*
* @ param array $q Query variables .
* @ param string $limits LIMIT clauses of the query .
*/
private function set_found_posts ( $q , $limits ) {
2016-10-10 02:38:31 -04:00
global $wpdb ;
2016-08-25 13:20:38 -04:00
// Bail if posts is an empty array. Continue if posts is an empty string,
// null, or false to accommodate caching plugins that fill posts later.
2017-11-30 18:11:00 -05:00
if ( $q [ 'no_found_rows' ] || ( is_array ( $this -> posts ) && ! $this -> posts ) ) {
2016-08-25 13:20:38 -04:00
return ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
if ( ! empty ( $limits ) ) {
/**
* Filters the query to run for retrieving the found posts .
*
* @ since 2.1 . 0
*
2020-07-05 17:34:02 -04:00
* @ param string $found_posts_query The query to run to find the found posts .
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
2020-07-05 17:34:02 -04:00
$found_posts_query = apply_filters_ref_array ( 'found_posts_query' , array ( 'SELECT FOUND_ROWS()' , & $this ) );
$this -> found_posts = ( int ) $wpdb -> get_var ( $found_posts_query );
2016-08-25 13:20:38 -04:00
} else {
2018-01-23 20:21:31 -05:00
if ( is_array ( $this -> posts ) ) {
$this -> found_posts = count ( $this -> posts );
} else {
2018-03-18 10:23:33 -04:00
if ( null === $this -> posts ) {
2018-01-23 20:21:31 -05:00
$this -> found_posts = 0 ;
} else {
$this -> found_posts = 1 ;
}
}
2016-08-25 13:20:38 -04:00
}
/**
* Filters the number of found posts for the query .
*
* @ since 2.1 . 0
*
* @ param int $found_posts The number of posts found .
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
2020-07-05 17:34:02 -04:00
$this -> found_posts = ( int ) apply_filters_ref_array ( 'found_posts' , array ( $this -> found_posts , & $this ) );
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( ! empty ( $limits ) ) {
2016-08-25 13:20:38 -04:00
$this -> max_num_pages = ceil ( $this -> found_posts / $q [ 'posts_per_page' ] );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
/**
* Set up the next post and iterate current post index .
*
* @ since 1.5 . 0
*
* @ return WP_Post Next post .
*/
public function next_post () {
$this -> current_post ++ ;
2017-11-30 18:11:00 -05:00
$this -> post = $this -> posts [ $this -> current_post ];
2016-08-25 13:20:38 -04:00
return $this -> post ;
}
/**
* Sets up the current post .
*
* Retrieves the next post , sets up the post , sets the 'in the loop'
* property to true .
*
* @ since 1.5 . 0
*
2019-08-04 08:28:56 -04:00
* @ global WP_Post $post Global post object .
2016-08-25 13:20:38 -04:00
*/
public function the_post () {
global $post ;
$this -> in_the_loop = true ;
2020-02-09 11:55:09 -05:00
if ( - 1 == $this -> current_post ) { // Loop has just started.
2016-08-25 13:20:38 -04:00
/**
* Fires once the loop is started .
*
* @ since 2.0 . 0
*
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
do_action_ref_array ( 'loop_start' , array ( & $this ) );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post = $this -> next_post ();
$this -> setup_postdata ( $post );
}
/**
* Determines whether there are more posts available in the loop .
*
* Calls the { @ see 'loop_end' } action when the loop is complete .
*
* @ since 1.5 . 0
*
2020-07-08 07:11:04 -04:00
* @ return bool True if posts are available , false if end of the loop .
2016-08-25 13:20:38 -04:00
*/
public function have_posts () {
if ( $this -> current_post + 1 < $this -> post_count ) {
return true ;
} elseif ( $this -> current_post + 1 == $this -> post_count && $this -> post_count > 0 ) {
/**
* Fires once the loop has ended .
*
* @ since 2.0 . 0
*
2017-10-02 18:03:33 -04:00
* @ param WP_Query $this The WP_Query instance ( passed by reference ) .
2016-08-25 13:20:38 -04:00
*/
do_action_ref_array ( 'loop_end' , array ( & $this ) );
2020-01-28 19:45:18 -05:00
// Do some cleaning up after the loop.
2016-08-25 13:20:38 -04:00
$this -> rewind_posts ();
2017-06-22 21:55:44 -04:00
} elseif ( 0 === $this -> post_count ) {
/**
* Fires if no results are found in a post query .
*
* @ since 4.9 . 0
*
* @ param WP_Query $this The WP_Query instance .
*/
do_action ( 'loop_no_results' , $this );
2016-08-25 13:20:38 -04:00
}
$this -> in_the_loop = false ;
return false ;
}
/**
* Rewind the posts and reset post index .
*
* @ since 1.5 . 0
*/
public function rewind_posts () {
$this -> current_post = - 1 ;
if ( $this -> post_count > 0 ) {
$this -> post = $this -> posts [ 0 ];
}
}
/**
* Iterate current comment index and return WP_Comment object .
*
* @ since 2.2 . 0
*
* @ return WP_Comment Comment object .
*/
public function next_comment () {
$this -> current_comment ++ ;
2017-11-30 18:11:00 -05:00
$this -> comment = $this -> comments [ $this -> current_comment ];
2016-08-25 13:20:38 -04:00
return $this -> comment ;
}
/**
* Sets up the current comment .
*
* @ since 2.2 . 0
2020-06-16 17:07:14 -04:00
*
2019-10-04 18:19:57 -04:00
* @ global WP_Comment $comment Global comment object .
2016-08-25 13:20:38 -04:00
*/
public function the_comment () {
global $comment ;
$comment = $this -> next_comment ();
2020-02-09 11:55:09 -05:00
if ( 0 == $this -> current_comment ) {
2016-08-25 13:20:38 -04:00
/**
* Fires once the comment loop is started .
*
* @ since 2.2 . 0
*/
do_action ( 'comment_loop_start' );
}
}
/**
* Whether there are more comments available .
*
* Automatically rewinds comments when finished .
*
* @ since 2.2 . 0
*
2020-07-08 07:11:04 -04:00
* @ return bool True if comments are available , false if no more comments .
2016-08-25 13:20:38 -04:00
*/
public function have_comments () {
if ( $this -> current_comment + 1 < $this -> comment_count ) {
return true ;
} elseif ( $this -> current_comment + 1 == $this -> comment_count ) {
$this -> rewind_comments ();
}
return false ;
}
/**
* Rewind the comments , resets the comment index and comment to first .
*
* @ since 2.2 . 0
*/
public function rewind_comments () {
$this -> current_comment = - 1 ;
if ( $this -> comment_count > 0 ) {
$this -> comment = $this -> comments [ 0 ];
}
}
/**
* Sets up the WordPress query by parsing query string .
*
* @ since 1.5 . 0
*
2020-07-13 18:10:07 -04:00
* @ see WP_Query :: parse_query () for all available arguments .
*
2016-12-09 11:23:42 -05:00
* @ param string | array $query URL query string or array of query arguments .
2018-08-27 10:28:26 -04:00
* @ return WP_Post [] | int [] Array of post objects or post IDs .
2016-08-25 13:20:38 -04:00
*/
public function query ( $query ) {
$this -> init ();
2019-07-02 19:42:58 -04:00
$this -> query = wp_parse_args ( $query );
$this -> query_vars = $this -> query ;
2016-08-25 13:20:38 -04:00
return $this -> get_posts ();
}
/**
2020-10-06 04:59:04 -04:00
* Retrieves the currently queried object .
2016-08-25 13:20:38 -04:00
*
* If queried object is not set , then the queried object will be set from
* the category , tag , taxonomy , posts page , single post , page , or author
* query variable . After it is set up , it will be returned .
*
* @ since 1.5 . 0
*
2020-10-10 15:14:04 -04:00
* @ return WP_Term | WP_Post_Type | WP_Post | WP_User | null The queried object .
2016-08-25 13:20:38 -04:00
*/
public function get_queried_object () {
2017-11-30 18:11:00 -05:00
if ( isset ( $this -> queried_object ) ) {
2016-08-25 13:20:38 -04:00
return $this -> queried_object ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$this -> queried_object = null ;
2016-08-25 13:20:38 -04:00
$this -> queried_object_id = null ;
if ( $this -> is_category || $this -> is_tag || $this -> is_tax ) {
if ( $this -> is_category ) {
if ( $this -> get ( 'cat' ) ) {
$term = get_term ( $this -> get ( 'cat' ), 'category' );
} elseif ( $this -> get ( 'category_name' ) ) {
$term = get_term_by ( 'slug' , $this -> get ( 'category_name' ), 'category' );
}
} elseif ( $this -> is_tag ) {
if ( $this -> get ( 'tag_id' ) ) {
$term = get_term ( $this -> get ( 'tag_id' ), 'post_tag' );
} elseif ( $this -> get ( 'tag' ) ) {
$term = get_term_by ( 'slug' , $this -> get ( 'tag' ), 'post_tag' );
}
} else {
// For other tax queries, grab the first term from the first clause.
2016-09-09 15:49:29 -04:00
if ( ! empty ( $this -> tax_query -> queried_terms ) ) {
$queried_taxonomies = array_keys ( $this -> tax_query -> queried_terms );
2017-11-30 18:11:00 -05:00
$matched_taxonomy = reset ( $queried_taxonomies );
$query = $this -> tax_query -> queried_terms [ $matched_taxonomy ];
2016-08-25 13:20:38 -04:00
2016-09-09 15:37:38 -04:00
if ( ! empty ( $query [ 'terms' ] ) ) {
2020-05-16 14:42:12 -04:00
if ( 'term_id' === $query [ 'field' ] ) {
2016-08-25 13:20:38 -04:00
$term = get_term ( reset ( $query [ 'terms' ] ), $matched_taxonomy );
} else {
$term = get_term_by ( $query [ 'field' ], reset ( $query [ 'terms' ] ), $matched_taxonomy );
}
}
}
}
2017-11-30 18:11:00 -05:00
if ( ! empty ( $term ) && ! is_wp_error ( $term ) ) {
$this -> queried_object = $term ;
2016-08-25 13:20:38 -04:00
$this -> queried_object_id = ( int ) $term -> term_id ;
2017-11-30 18:11:00 -05:00
if ( $this -> is_category && 'category' === $this -> queried_object -> taxonomy ) {
2016-08-25 13:20:38 -04:00
_make_cat_compat ( $this -> queried_object );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
} elseif ( $this -> is_post_type_archive ) {
$post_type = $this -> get ( 'post_type' );
2017-11-30 18:11:00 -05:00
if ( is_array ( $post_type ) ) {
2016-08-25 13:20:38 -04:00
$post_type = reset ( $post_type );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$this -> queried_object = get_post_type_object ( $post_type );
} elseif ( $this -> is_posts_page ) {
2017-11-30 18:11:00 -05:00
$page_for_posts = get_option ( 'page_for_posts' );
$this -> queried_object = get_post ( $page_for_posts );
2016-08-25 13:20:38 -04:00
$this -> queried_object_id = ( int ) $this -> queried_object -> ID ;
} elseif ( $this -> is_singular && ! empty ( $this -> post ) ) {
2017-11-30 18:11:00 -05:00
$this -> queried_object = $this -> post ;
2016-08-25 13:20:38 -04:00
$this -> queried_object_id = ( int ) $this -> post -> ID ;
} elseif ( $this -> is_author ) {
2017-11-30 18:11:00 -05:00
$this -> queried_object_id = ( int ) $this -> get ( 'author' );
$this -> queried_object = get_userdata ( $this -> queried_object_id );
2016-08-25 13:20:38 -04:00
}
return $this -> queried_object ;
}
/**
2020-10-06 04:59:04 -04:00
* Retrieves the ID of the currently queried object .
2016-08-25 13:20:38 -04:00
*
* @ since 1.5 . 0
*
* @ return int
*/
public function get_queried_object_id () {
$this -> get_queried_object ();
2017-11-30 18:11:00 -05:00
if ( isset ( $this -> queried_object_id ) ) {
2016-08-25 13:20:38 -04:00
return $this -> queried_object_id ;
}
return 0 ;
}
/**
* Constructor .
*
* Sets up the WordPress query , if parameter is not empty .
*
* @ since 1.5 . 0
*
2020-07-13 18:10:07 -04:00
* @ see WP_Query :: parse_query () for all available arguments .
*
2016-08-25 13:20:38 -04:00
* @ param string | array $query URL query string or array of vars .
*/
public function __construct ( $query = '' ) {
if ( ! empty ( $query ) ) {
$this -> query ( $query );
}
}
/**
* Make private properties readable for backward compatibility .
*
* @ since 4.0 . 0
*
* @ param string $name Property to get .
* @ return mixed Property .
*/
public function __get ( $name ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $name , $this -> compat_fields , true ) ) {
2016-08-25 13:20:38 -04:00
return $this -> $name ;
}
}
/**
* Make private properties checkable for backward compatibility .
*
* @ since 4.0 . 0
*
* @ param string $name Property to check if set .
* @ return bool Whether the property is set .
*/
public function __isset ( $name ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $name , $this -> compat_fields , true ) ) {
2016-08-25 13:20:38 -04:00
return isset ( $this -> $name );
}
}
/**
* Make private / protected methods readable for backward compatibility .
*
* @ since 4.0 . 0
*
2020-07-23 16:01:04 -04:00
* @ param string $name Method to call .
* @ param array $arguments Arguments to pass when calling .
2016-08-25 13:20:38 -04:00
* @ return mixed | false Return value of the callback , false otherwise .
*/
public function __call ( $name , $arguments ) {
2020-04-04 23:02:11 -04:00
if ( in_array ( $name , $this -> compat_methods , true ) ) {
2019-09-15 07:53:56 -04:00
return $this -> $name ( ... $arguments );
2016-08-25 13:20:38 -04:00
}
2016-08-25 15:42:43 -04:00
return false ;
2016-08-25 13:20:38 -04:00
}
2016-08-31 12:53:29 -04:00
/**
2017-11-30 18:11:00 -05:00
* Is the query for an existing archive page ?
2016-08-31 12:53:29 -04:00
*
2017-11-30 18:11:00 -05:00
* Month , Year , Category , Author , Post Type archive ...
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing archive page .
2017-11-30 18:11:00 -05:00
*/
2016-08-31 12:53:29 -04:00
public function is_archive () {
return ( bool ) $this -> is_archive ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query for an existing post type archive page ?
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param string | string [] $post_types Optional . Post type or array of posts types
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing post type archive page .
2016-08-25 13:20:38 -04:00
*/
public function is_post_type_archive ( $post_types = '' ) {
2017-11-30 18:11:00 -05:00
if ( empty ( $post_types ) || ! $this -> is_post_type_archive ) {
2016-08-25 13:20:38 -04:00
return ( bool ) $this -> is_post_type_archive ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_type = $this -> get ( 'post_type' );
2017-11-30 18:11:00 -05:00
if ( is_array ( $post_type ) ) {
2016-08-25 13:20:38 -04:00
$post_type = reset ( $post_type );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_type_object = get_post_type_object ( $post_type );
2020-04-04 23:02:11 -04:00
return in_array ( $post_type_object -> name , ( array ) $post_types , true );
2016-08-25 13:20:38 -04:00
}
/**
* Is the query for an existing attachment page ?
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param int | string | int [] | string [] $attachment Optional . Attachment ID , title , slug , or array of such
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing attachment page .
2016-08-25 13:20:38 -04:00
*/
public function is_attachment ( $attachment = '' ) {
if ( ! $this -> is_attachment ) {
return false ;
}
if ( empty ( $attachment ) ) {
return true ;
}
$attachment = array_map ( 'strval' , ( array ) $attachment );
$post_obj = $this -> get_queried_object ();
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $post_obj -> ID , $attachment , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $post_obj -> post_title , $attachment , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $post_obj -> post_name , $attachment , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
}
return false ;
}
/**
* Is the query for an existing author archive page ?
*
* If the $author parameter is specified , this function will additionally
* check if the query is for one of the authors specified .
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param int | string | int [] | string [] $author Optional . User ID , nickname , nicename , or array of such
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing author archive page .
2016-08-25 13:20:38 -04:00
*/
public function is_author ( $author = '' ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_author ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $author ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$author_obj = $this -> get_queried_object ();
$author = array_map ( 'strval' , ( array ) $author );
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $author_obj -> ID , $author , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $author_obj -> nickname , $author , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $author_obj -> user_nicename , $author , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
return false ;
}
/**
* Is the query for an existing category archive page ?
*
* If the $category parameter is specified , this function will additionally
* check if the query is for one of the categories specified .
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param int | string | int [] | string [] $category Optional . Category ID , name , slug , or array of such
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing category archive page .
2016-08-25 13:20:38 -04:00
*/
public function is_category ( $category = '' ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_category ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $category ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$cat_obj = $this -> get_queried_object ();
$category = array_map ( 'strval' , ( array ) $category );
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $cat_obj -> term_id , $category , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $cat_obj -> name , $category , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $cat_obj -> slug , $category , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
return false ;
}
/**
* Is the query for an existing tag archive page ?
*
* If the $tag parameter is specified , this function will additionally
* check if the query is for one of the tags specified .
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param int | string | int [] | string [] $tag Optional . Tag ID , name , slug , or array of such
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing tag archive page .
2016-08-25 13:20:38 -04:00
*/
public function is_tag ( $tag = '' ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_tag ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $tag ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$tag_obj = $this -> get_queried_object ();
$tag = array_map ( 'strval' , ( array ) $tag );
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $tag_obj -> term_id , $tag , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $tag_obj -> name , $tag , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $tag_obj -> slug , $tag , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
return false ;
}
/**
* Is the query for an existing custom taxonomy archive page ?
*
* If the $taxonomy parameter is specified , this function will additionally
* check if the query is for that specific $taxonomy .
*
* If the $term parameter is specified in addition to the $taxonomy parameter ,
* this function will additionally check if the query is for one of the terms
* specified .
*
* @ since 3.1 . 0
*
* @ global array $wp_taxonomies
*
2020-03-01 05:38:07 -05:00
* @ param string | string [] $taxonomy Optional . Taxonomy slug or slugs to check against .
2020-03-01 12:21:06 -05:00
* Default empty .
* @ param int | string | int [] | string [] $term Optional . Term ID , name , slug , or array of such
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing custom taxonomy archive page .
* True for custom taxonomy archive pages , false for built - in taxonomies
2020-03-01 12:21:06 -05:00
* ( category and tag archives ) .
2016-08-25 13:20:38 -04:00
*/
public function is_tax ( $taxonomy = '' , $term = '' ) {
global $wp_taxonomies ;
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_tax ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $taxonomy ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$queried_object = $this -> get_queried_object ();
2017-11-30 18:11:00 -05:00
$tax_array = array_intersect ( array_keys ( $wp_taxonomies ), ( array ) $taxonomy );
$term_array = ( array ) $term ;
2016-08-25 13:20:38 -04:00
// Check that the taxonomy matches.
2020-04-04 23:02:11 -04:00
if ( ! ( isset ( $queried_object -> taxonomy ) && count ( $tax_array ) && in_array ( $queried_object -> taxonomy , $tax_array , true ) ) ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2020-01-28 19:45:18 -05:00
// Only a taxonomy provided.
2017-11-30 18:11:00 -05:00
if ( empty ( $term ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
return isset ( $queried_object -> term_id ) &&
2017-11-30 18:11:00 -05:00
count (
array_intersect (
array ( $queried_object -> term_id , $queried_object -> name , $queried_object -> slug ),
$term_array
)
);
2016-08-25 13:20:38 -04:00
}
/**
* Whether the current URL is within the comments popup window .
*
* @ since 3.1 . 0
* @ deprecated 4.5 . 0
*
2020-07-10 16:23:06 -04:00
* @ return false Always returns false .
2016-08-25 13:20:38 -04:00
*/
public function is_comments_popup () {
_deprecated_function ( __FUNCTION__ , '4.5.0' );
return false ;
}
2016-08-31 12:53:29 -04:00
/**
* Is the query for an existing date archive ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing date archive .
2016-08-31 12:53:29 -04:00
*/
public function is_date () {
return ( bool ) $this -> is_date ;
}
/**
* Is the query for an existing day archive ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing day archive .
2016-08-31 12:53:29 -04:00
*/
public function is_day () {
return ( bool ) $this -> is_day ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query for a feed ?
*
* @ since 3.1 . 0
*
2020-03-01 12:21:06 -05:00
* @ param string | string [] $feeds Optional . Feed type or array of feed types
* to check against . Default empty .
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a feed .
2016-08-25 13:20:38 -04:00
*/
public function is_feed ( $feeds = '' ) {
2017-11-30 18:11:00 -05:00
if ( empty ( $feeds ) || ! $this -> is_feed ) {
2016-08-25 13:20:38 -04:00
return ( bool ) $this -> is_feed ;
2017-11-30 18:11:00 -05:00
}
2020-07-10 16:23:06 -04:00
2016-08-25 13:20:38 -04:00
$qv = $this -> get ( 'feed' );
2020-05-16 14:42:12 -04:00
if ( 'feed' === $qv ) {
2016-08-25 13:20:38 -04:00
$qv = get_default_feed ();
2017-11-30 18:11:00 -05:00
}
2020-07-10 16:23:06 -04:00
2020-04-04 23:02:11 -04:00
return in_array ( $qv , ( array ) $feeds , true );
2016-08-25 13:20:38 -04:00
}
2016-08-31 12:53:29 -04:00
/**
* Is the query for a comments feed ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a comments feed .
2016-08-31 12:53:29 -04:00
*/
public function is_comment_feed () {
return ( bool ) $this -> is_comment_feed ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query for the front page of the site ?
*
* This is for what is displayed at your site ' s main URL .
*
* Depends on the site 's "Front page displays" Reading Settings ' show_on_front ' and ' page_on_front ' .
*
* If you set a static page for the front page of your site , this function will return
* true when viewing that page .
*
* Otherwise the same as @ see WP_Query :: is_home ()
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for the front page of the site .
2016-08-25 13:20:38 -04:00
*/
public function is_front_page () {
2020-01-28 19:45:18 -05:00
// Most likely case.
2020-05-16 14:42:12 -04:00
if ( 'posts' === get_option ( 'show_on_front' ) && $this -> is_home () ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-05-16 14:42:12 -04:00
} elseif ( 'page' === get_option ( 'show_on_front' ) && get_option ( 'page_on_front' )
&& $this -> is_page ( get_option ( 'page_on_front' ) )
) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
} else {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
}
/**
* Is the query for the blog homepage ?
*
* This is the page which shows the time based blog content of your site .
*
* Depends on the site 's "Front page displays" Reading Settings ' show_on_front ' and ' page_for_posts ' .
*
* If you set a static page for the front page of your site , this function will return
* true only on the page you set as the " Posts page " .
*
* @ see WP_Query :: is_front_page ()
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for the blog homepage .
2016-08-25 13:20:38 -04:00
*/
public function is_home () {
return ( bool ) $this -> is_home ;
}
2019-03-21 15:48:50 -04:00
/**
* Is the query for the Privacy Policy page ?
*
* This is the page which shows the Privacy Policy content of your site .
*
* Depends on the site 's "Change your Privacy Policy page" Privacy Settings ' wp_page_for_privacy_policy ' .
*
* This function will return true only on the page you set as the " Privacy Policy page " .
*
* @ since 5.2 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for the Privacy Policy page .
2019-03-21 15:48:50 -04:00
*/
public function is_privacy_policy () {
2020-05-16 14:42:12 -04:00
if ( get_option ( 'wp_page_for_privacy_policy' )
&& $this -> is_page ( get_option ( 'wp_page_for_privacy_policy' ) )
) {
2019-03-21 15:48:50 -04:00
return true ;
} else {
return false ;
}
}
2016-08-31 12:53:29 -04:00
/**
* Is the query for an existing month archive ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing month archive .
2016-08-31 12:53:29 -04:00
*/
public function is_month () {
return ( bool ) $this -> is_month ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query for an existing single page ?
*
* If the $page parameter is specified , this function will additionally
* check if the query is for one of the pages specified .
*
* @ see WP_Query :: is_single ()
* @ see WP_Query :: is_singular ()
*
* @ since 3.1 . 0
*
2020-03-01 12:29:06 -05:00
* @ param int | string | int [] | string [] $page Optional . Page ID , title , slug , path , or array of such
* to check against . Default empty .
2016-08-25 13:20:38 -04:00
* @ return bool Whether the query is for an existing single page .
*/
public function is_page ( $page = '' ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_page ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $page ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$page_obj = $this -> get_queried_object ();
$page = array_map ( 'strval' , ( array ) $page );
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $page_obj -> ID , $page , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $page_obj -> post_title , $page , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $page_obj -> post_name , $page , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
} else {
foreach ( $page as $pagepath ) {
if ( ! strpos ( $pagepath , '/' ) ) {
continue ;
}
$pagepath_obj = get_page_by_path ( $pagepath );
if ( $pagepath_obj && ( $pagepath_obj -> ID == $page_obj -> ID ) ) {
return true ;
}
}
}
return false ;
}
2016-08-31 12:53:29 -04:00
/**
2020-07-10 16:23:06 -04:00
* Is the query for a paged result and not for the first page ?
2016-08-31 12:53:29 -04:00
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a paged result .
2016-08-31 12:53:29 -04:00
*/
public function is_paged () {
return ( bool ) $this -> is_paged ;
}
/**
* Is the query for a post or page preview ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a post or page preview .
2016-08-31 12:53:29 -04:00
*/
public function is_preview () {
return ( bool ) $this -> is_preview ;
}
/**
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
* Is the query for the robots . txt file ?
2016-08-31 12:53:29 -04:00
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for the robots . txt file .
2016-08-31 12:53:29 -04:00
*/
public function is_robots () {
return ( bool ) $this -> is_robots ;
}
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
/**
* Is the query for the favicon . ico file ?
*
* @ since 5.4 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for the favicon . ico file .
Bootstrap/Load: Make handling the `/favicon.ico` requests more flexible.
Previously, `wp_favicon_request()` was introduced in [13205] to avoid a performance hit of serving a full 404 page on every favicon request.
While working as intended, that implementation did not provide a way for theme or plugin authors to manage the behavior of favicon requests.
This changeset implements the following logic (only applied if WordPress is installed in the root directory):
* If there is a Site Icon set in Customizer, redirect `/favicon.ico` requests to that icon.
* Otherwise, use the WordPress logo as a default icon.
* If a physical `/favicon.ico` file exists, do nothing, let the server handle the request.
Handling `/favicon.ico` is now more consistent with handling `/robots.txt` requests.
New functions and hooks:
* Introduce `is_favicon()` conditional tag to complement `is_robots()`.
* Introduce `do_favicon` action to complement `do_robots` and use it in template loader.
* Introduce `do_favicon()` function, hooked to the above action by default, to complement `do_robots()`.
* Introduce `do_faviconico` action to complement `do_robotstxt`, for plugins to override the default behavior.
* Mark `wp_favicon_request()` as deprecated in favor of `do_favicon()`.
Props jonoaldersonwp, birgire, joostdevalk, mukesh27, SergeyBiryukov.
Fixes #47398.
Built from https://develop.svn.wordpress.org/trunk@47018
git-svn-id: http://core.svn.wordpress.org/trunk@46818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2019-12-28 16:20:04 -05:00
*/
public function is_favicon () {
return ( bool ) $this -> is_favicon ;
}
2016-08-31 12:53:29 -04:00
/**
* Is the query for a search ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a search .
2016-08-31 12:53:29 -04:00
*/
public function is_search () {
return ( bool ) $this -> is_search ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query for an existing single post ?
*
2016-10-31 02:34:34 -04:00
* Works for any post type excluding pages .
2016-08-25 13:20:38 -04:00
*
* If the $post parameter is specified , this function will additionally
* check if the query is for one of the Posts specified .
*
* @ see WP_Query :: is_page ()
* @ see WP_Query :: is_singular ()
*
* @ since 3.1 . 0
*
2020-03-01 12:29:06 -05:00
* @ param int | string | int [] | string [] $post Optional . Post ID , title , slug , path , or array of such
* to check against . Default empty .
2016-08-25 13:20:38 -04:00
* @ return bool Whether the query is for an existing single post .
*/
public function is_single ( $post = '' ) {
2017-11-30 18:11:00 -05:00
if ( ! $this -> is_single ) {
2016-08-25 13:20:38 -04:00
return false ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
if ( empty ( $post ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_obj = $this -> get_queried_object ();
$post = array_map ( 'strval' , ( array ) $post );
2020-04-04 23:02:11 -04:00
if ( in_array ( ( string ) $post_obj -> ID , $post , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $post_obj -> post_title , $post , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
2020-04-04 23:02:11 -04:00
} elseif ( in_array ( $post_obj -> post_name , $post , true ) ) {
2016-08-25 13:20:38 -04:00
return true ;
} else {
foreach ( $post as $postpath ) {
if ( ! strpos ( $postpath , '/' ) ) {
continue ;
}
$postpath_obj = get_page_by_path ( $postpath , OBJECT , $post_obj -> post_type );
if ( $postpath_obj && ( $postpath_obj -> ID == $post_obj -> ID ) ) {
return true ;
}
}
}
return false ;
}
/**
2017-02-23 05:30:43 -05:00
* Is the query for an existing single post of any post type ( post , attachment , page ,
* custom post types ) ?
2016-08-25 13:20:38 -04:00
*
* If the $post_types parameter is specified , this function will additionally
* check if the query is for one of the Posts Types specified .
*
* @ see WP_Query :: is_page ()
* @ see WP_Query :: is_single ()
*
* @ since 3.1 . 0
*
2020-03-01 12:29:06 -05:00
* @ param string | string [] $post_types Optional . Post type or array of post types
* to check against . Default empty .
2020-03-01 12:21:06 -05:00
* @ return bool Whether the query is for an existing single post
* or any of the given post types .
2016-08-25 13:20:38 -04:00
*/
public function is_singular ( $post_types = '' ) {
2017-11-30 18:11:00 -05:00
if ( empty ( $post_types ) || ! $this -> is_singular ) {
2016-08-25 13:20:38 -04:00
return ( bool ) $this -> is_singular ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
$post_obj = $this -> get_queried_object ();
2020-04-04 23:02:11 -04:00
return in_array ( $post_obj -> post_type , ( array ) $post_types , true );
2016-08-25 13:20:38 -04:00
}
2016-08-31 12:53:29 -04:00
/**
* Is the query for a specific time ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a specific time .
2016-08-31 12:53:29 -04:00
*/
public function is_time () {
return ( bool ) $this -> is_time ;
}
/**
* Is the query for a trackback endpoint call ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for a trackback endpoint call .
2016-08-31 12:53:29 -04:00
*/
public function is_trackback () {
return ( bool ) $this -> is_trackback ;
}
/**
* Is the query for an existing year archive ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an existing year archive .
2016-08-31 12:53:29 -04:00
*/
public function is_year () {
return ( bool ) $this -> is_year ;
}
/**
* Is the query a 404 ( returns no results ) ?
*
* @ since 3.1 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is a 404 error .
2016-08-31 12:53:29 -04:00
*/
public function is_404 () {
return ( bool ) $this -> is_404 ;
}
/**
* Is the query for an embedded post ?
*
* @ since 4.4 . 0
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is for an embedded post .
2016-08-31 12:53:29 -04:00
*/
public function is_embed () {
return ( bool ) $this -> is_embed ;
}
2016-08-25 13:20:38 -04:00
/**
* Is the query the main query ?
*
* @ since 3.3 . 0
*
2019-08-03 21:59:56 -04:00
* @ global WP_Query $wp_query WordPress Query object .
2016-08-25 13:20:38 -04:00
*
2020-07-10 16:23:06 -04:00
* @ return bool Whether the query is the main query .
2016-08-25 13:20:38 -04:00
*/
public function is_main_query () {
global $wp_the_query ;
return $wp_the_query === $this ;
}
/**
* Set up global post data .
*
* @ since 4.1 . 0
* @ since 4.4 . 0 Added the ability to pass a post ID to `$post` .
*
2019-05-22 17:48:52 -04:00
* @ global int $id
* @ global WP_User $authordata
* @ global string $currentday
* @ global string $currentmonth
* @ global int $page
* @ global array $pages
* @ global int $multipage
* @ global int $more
* @ global int $numpages
2016-08-25 13:20:38 -04:00
*
* @ param WP_Post | object | int $post WP_Post instance or Post ID / object .
* @ return true True when finished .
*/
public function setup_postdata ( $post ) {
global $id , $authordata , $currentday , $currentmonth , $page , $pages , $multipage , $more , $numpages ;
if ( ! ( $post instanceof WP_Post ) ) {
$post = get_post ( $post );
}
if ( ! $post ) {
return ;
}
2019-03-20 11:49:49 -04:00
$elements = $this -> generate_postdata ( $post );
if ( false === $elements ) {
return ;
}
$id = $elements [ 'id' ];
$authordata = $elements [ 'authordata' ];
$currentday = $elements [ 'currentday' ];
$currentmonth = $elements [ 'currentmonth' ];
$page = $elements [ 'page' ];
$pages = $elements [ 'pages' ];
$multipage = $elements [ 'multipage' ];
$more = $elements [ 'more' ];
$numpages = $elements [ 'numpages' ];
2019-05-04 17:00:52 -04:00
/**
2020-06-21 06:36:07 -04:00
* Fires once the post data has been set up .
2019-05-04 17:00:52 -04:00
*
* @ since 2.8 . 0
* @ since 4.1 . 0 Introduced `$this` parameter .
*
* @ param WP_Post $post The Post object ( passed by reference ) .
* @ param WP_Query $this The current Query object ( passed by reference ) .
*/
do_action_ref_array ( 'the_post' , array ( & $post , & $this ) );
2019-03-20 11:49:49 -04:00
return true ;
}
/**
* Generate post data .
*
* @ since 5.2 . 0
*
* @ param WP_Post | object | int $post WP_Post instance or Post ID / object .
2020-06-19 18:55:12 -04:00
* @ return array | bool Elements of post or false on failure .
2019-03-20 11:49:49 -04:00
*/
public function generate_postdata ( $post ) {
if ( ! ( $post instanceof WP_Post ) ) {
$post = get_post ( $post );
}
if ( ! $post ) {
return false ;
}
2016-08-25 13:20:38 -04:00
$id = ( int ) $post -> ID ;
2017-11-30 18:11:00 -05:00
$authordata = get_userdata ( $post -> post_author );
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$currentday = mysql2date ( 'd.m.y' , $post -> post_date , false );
$currentmonth = mysql2date ( 'm' , $post -> post_date , false );
$numpages = 1 ;
$multipage = 0 ;
$page = $this -> get ( 'page' );
if ( ! $page ) {
2016-08-25 13:20:38 -04:00
$page = 1 ;
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
/*
* Force full post content when viewing the permalink for the $post ,
* or when on an RSS feed . Otherwise respect the 'more' tag .
*/
2020-02-09 11:55:09 -05:00
if ( get_queried_object_id () === $post -> ID && ( $this -> is_page () || $this -> is_single () ) ) {
2016-08-25 13:20:38 -04:00
$more = 1 ;
} elseif ( $this -> is_feed () ) {
$more = 1 ;
} else {
$more = 0 ;
}
$content = $post -> post_content ;
if ( false !== strpos ( $content , '<!--nextpage-->' ) ) {
$content = str_replace ( " \n <!--nextpage--> \n " , '<!--nextpage-->' , $content );
$content = str_replace ( " \n <!--nextpage--> " , '<!--nextpage-->' , $content );
$content = str_replace ( " <!--nextpage--> \n " , '<!--nextpage-->' , $content );
2018-12-17 14:29:51 -05:00
// Remove the nextpage block delimiters, to avoid invalid block structures in the split content.
$content = str_replace ( '<!-- wp:nextpage -->' , '' , $content );
$content = str_replace ( '<!-- /wp:nextpage -->' , '' , $content );
2016-08-25 13:20:38 -04:00
// Ignore nextpage at the beginning of the content.
2017-11-30 18:11:00 -05:00
if ( 0 === strpos ( $content , '<!--nextpage-->' ) ) {
2016-08-25 13:20:38 -04:00
$content = substr ( $content , 15 );
2017-11-30 18:11:00 -05:00
}
2016-08-25 13:20:38 -04:00
2017-11-30 18:11:00 -05:00
$pages = explode ( '<!--nextpage-->' , $content );
2016-08-25 13:20:38 -04:00
} else {
$pages = array ( $post -> post_content );
}
/**
* Filters the " pages " derived from splitting the post content .
*
* " Pages " are determined by splitting the post content based on the presence
* of `<!-- nextpage -->` tags .
*
* @ since 4.4 . 0
*
2018-03-25 15:33:31 -04:00
* @ param string [] $pages Array of " pages " from the post content split by `<!-- nextpage -->` tags .
* @ param WP_Post $post Current post object .
2016-08-25 13:20:38 -04:00
*/
$pages = apply_filters ( 'content_pagination' , $pages , $post );
$numpages = count ( $pages );
if ( $numpages > 1 ) {
if ( $page > 1 ) {
$more = 1 ;
}
$multipage = 1 ;
} else {
2017-11-30 18:11:00 -05:00
$multipage = 0 ;
}
2016-08-25 13:20:38 -04:00
2019-03-20 11:49:49 -04:00
$elements = compact ( 'id' , 'authordata' , 'currentday' , 'currentmonth' , 'page' , 'pages' , 'multipage' , 'more' , 'numpages' );
return $elements ;
2016-08-25 13:20:38 -04:00
}
/**
* After looping through a nested query , this function
* restores the $post global to the current post in this query .
*
* @ since 3.7 . 0
*
2019-08-04 08:28:56 -04:00
* @ global WP_Post $post Global post object .
2016-08-25 13:20:38 -04:00
*/
public function reset_postdata () {
if ( ! empty ( $this -> post ) ) {
$GLOBALS [ 'post' ] = $this -> post ;
$this -> setup_postdata ( $this -> post );
}
}
/**
* Lazyload term meta for posts in the loop .
*
* @ since 4.4 . 0
* @ deprecated 4.5 . 0 See wp_queue_posts_for_term_meta_lazyload () .
*
* @ param mixed $check
* @ param int $term_id
* @ return mixed
*/
public function lazyload_term_meta ( $check , $term_id ) {
_deprecated_function ( __METHOD__ , '4.5.0' );
return $check ;
}
/**
* Lazyload comment meta for comments in the loop .
*
* @ since 4.4 . 0
* @ deprecated 4.5 . 0 See wp_queue_comments_for_comment_meta_lazyload () .
*
* @ param mixed $check
* @ param int $comment_id
* @ return mixed
*/
public function lazyload_comment_meta ( $check , $comment_id ) {
_deprecated_function ( __METHOD__ , '4.5.0' );
return $check ;
}
}