WordPress 4.4
[autoinstalls/wordpress.git] / wp-includes / query.php
index 7cbac9db8886aa6a9134003bf55f95e6ab9684be..a2b236540e9e86410fcb2e487b3093e2ea154b3c 100644 (file)
  * Retrieve variable in the WP_Query class.
  *
  * @since 1.5.0
+ * @since 3.9.0 The `$default` argument was introduced.
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string $var       The variable key to retrieve.
- * @param mixed  $default   Value to return if the query variable is not set. Default ''.
- * @return mixed
+ * @param mixed  $default   Optional. Value to return if the query variable is not set. Default empty.
+ * @return mixed Contents of the query variable.
  */
 function get_query_var( $var, $default = '' ) {
        global $wp_query;
@@ -28,14 +29,16 @@ function get_query_var( $var, $default = '' ) {
 }
 
 /**
- * Retrieve the currently-queried object. Wrapper for $wp_query->get_queried_object()
+ * Retrieve the currently-queried object.
+ *
+ * Wrapper for WP_Query::get_queried_object().
  *
  * @since 3.1.0
  * @access public
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @return object
+ * @return object Queried object.
  */
 function get_queried_object() {
        global $wp_query;
@@ -43,14 +46,15 @@ function get_queried_object() {
 }
 
 /**
- * Retrieve ID of the current queried object. Wrapper for $wp_query->get_queried_object_id()
+ * Retrieve ID of the current queried object.
+ *
+ * Wrapper for WP_Query::get_queried_object_id().
  *
  * @since 3.1.0
- * @access public
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @return int
+ * @return int ID of the queried object.
  */
 function get_queried_object_id() {
        global $wp_query;
@@ -62,10 +66,10 @@ function get_queried_object_id() {
  *
  * @since 2.2.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string $var   Query variable key.
- * @param mixed  $value
+ * @param mixed  $value Query variable value.
  */
 function set_query_var( $var, $value ) {
        global $wp_query;
@@ -80,7 +84,7 @@ function set_query_var( $var, $value ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string $query
  * @return array List of posts
@@ -99,8 +103,8 @@ function query_posts($query) {
  *
  * @since 2.3.0
  *
- * @global WP_Query $wp_query
- * @global WP_Query $wp_the_query
+ * @global WP_Query $wp_query     Global WP_Query instance.
+ * @global WP_Query $wp_the_query Copy of the global WP_Query instance created during wp_reset_query().
  */
 function wp_reset_query() {
        $GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
@@ -113,7 +117,7 @@ function wp_reset_query() {
  *
  * @since 3.0.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  */
 function wp_reset_postdata() {
        global $wp_query;
@@ -134,7 +138,7 @@ function wp_reset_postdata() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -154,7 +158,7 @@ function is_archive() {
  *
  * @since 3.1.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string|array $post_types Optional. Post type or array of posts types to check against.
  * @return bool
@@ -175,7 +179,7 @@ function is_post_type_archive( $post_types = '' ) {
  *
  * @since 2.0.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param int|string|array|object $attachment Attachment ID, title, slug, or array of such.
  * @return bool
@@ -199,7 +203,7 @@ function is_attachment( $attachment = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param mixed $author Optional. User ID, nickname, nicename, or array of User IDs, nicknames, and nicenames
  * @return bool
@@ -223,7 +227,7 @@ function is_author( $author = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param mixed $category Optional. Category ID, name, slug, or array of Category IDs, names, and slugs.
  * @return bool
@@ -247,7 +251,7 @@ function is_category( $category = '' ) {
  *
  * @since 2.3.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param mixed $tag Optional. Tag ID, name, slug, or array of Tag IDs, names, and slugs.
  * @return bool
@@ -275,7 +279,7 @@ function is_tag( $tag = '' ) {
  *
  * @since 2.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string|array     $taxonomy Optional. Taxonomy slug or slugs.
  * @param int|string|array $term     Optional. Term ID, name, slug or array of Term IDs, names, and slugs.
@@ -297,7 +301,7 @@ function is_tax( $taxonomy = '', $term = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -317,7 +321,7 @@ function is_comments_popup() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -337,7 +341,7 @@ function is_date() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -357,7 +361,7 @@ function is_day() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @param string|array $feeds Optional feed types to check.
  * @return bool
@@ -378,7 +382,7 @@ function is_feed( $feeds = '' ) {
  *
  * @since 3.0.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -407,7 +411,7 @@ function is_comment_feed() {
  *
  * @since 2.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool True, if front of site.
  */
@@ -436,7 +440,7 @@ function is_front_page() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool True if blog view homepage.
  */
@@ -456,7 +460,7 @@ function is_home() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -482,10 +486,10 @@ function is_month() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @param mixed $page Page ID, title, slug, or array of such.
- * @return bool
+ * @param int|string|array $page Optional. Page ID, title, slug, or array of such. Default empty.
+ * @return bool Whether the query is for an existing single page.
  */
 function is_page( $page = '' ) {
        global $wp_query;
@@ -503,7 +507,7 @@ function is_page( $page = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -523,7 +527,7 @@ function is_paged() {
  *
  * @since 2.0.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -543,7 +547,7 @@ function is_preview() {
  *
  * @since 2.1.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -563,7 +567,7 @@ function is_robots() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -591,10 +595,10 @@ function is_search() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @param mixed $post Post ID, title, slug, or array of such.
- * @return bool
+ * @param int|string|array $post Optional. Post ID, title, slug, or array of such. Default empty.
+ * @return bool Whether the query is for an existing single post.
  */
 function is_single( $post = '' ) {
        global $wp_query;
@@ -618,10 +622,10 @@ function is_single( $post = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @param mixed $post_types Optional. Post Type or array of Post Types
- * @return bool
+ * @param string|array $post_types Optional. Post type or array of post types. Default empty.
+ * @return bool Whether the query is for an existing single post of any of the given post types.
  */
 function is_singular( $post_types = '' ) {
        global $wp_query;
@@ -639,7 +643,7 @@ function is_singular( $post_types = '' ) {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -659,7 +663,7 @@ function is_time() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -679,7 +683,7 @@ function is_trackback() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -699,7 +703,7 @@ function is_year() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -714,19 +718,45 @@ function is_404() {
        return $wp_query->is_404();
 }
 
+/**
+ * Is the query for an embedded post?
+ *
+ * @since 4.4.0
+ *
+ * @global WP_Query $wp_query Global WP_Query instance.
+ *
+ * @return bool Whether we're in an embedded post or not.
+ */
+function is_embed() {
+       global $wp_query;
+
+       if ( ! isset( $wp_query ) ) {
+               _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1' );
+               return false;
+       }
+
+       return $wp_query->is_embed();
+}
+
 /**
  * Is the query the main query?
  *
  * @since 3.3.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
 function is_main_query() {
        if ( 'pre_get_posts' === current_filter() ) {
-               $message = sprintf( __( 'In <code>%1$s</code>, use the <code>%2$s</code> method, not the <code>%3$s</code> function. See %4$s.' ),
-                       'pre_get_posts', 'WP_Query::is_main_query()', 'is_main_query()', __( 'https://codex.wordpress.org/Function_Reference/is_main_query' ) );
+               $message = sprintf(
+                       /* translators: 1: pre_get_posts 2: WP_Query->is_main_query() 3: is_main_query() 4: link to codex is_main_query() page. */
+                       __( 'In %1$s, use the %2$s method, not the %3$s function. See %4$s.' ),
+                       '<code>pre_get_posts</code>',
+                       '<code>WP_Query->is_main_query()</code>',
+                       '<code>is_main_query()</code>',
+                       __( 'https://codex.wordpress.org/Function_Reference/is_main_query' )
+               );
                _doing_it_wrong( __FUNCTION__, $message, '3.7' );
        }
 
@@ -743,7 +773,7 @@ function is_main_query() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -757,7 +787,7 @@ function have_posts() {
  *
  * @since 2.0.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool True if caller is within loop, false if loop hasn't started or ended.
  */
@@ -771,7 +801,7 @@ function in_the_loop() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  */
 function rewind_posts() {
        global $wp_query;
@@ -783,7 +813,7 @@ function rewind_posts() {
  *
  * @since 1.5.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  */
 function the_post() {
        global $wp_query;
@@ -799,7 +829,7 @@ function the_post() {
  *
  * @since 2.2.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return bool
  */
@@ -813,7 +843,7 @@ function have_comments() {
  *
  * @since 2.2.0
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
  * @return object
  */
@@ -1190,6 +1220,15 @@ class WP_Query {
         */
        public $is_404 = false;
 
+       /**
+        * Set if query is embed.
+        *
+        * @since 4.4.0
+        * @access public
+        * @var bool
+        */
+       public $is_embed = false;
+
        /**
         * Set if query is within comments popup window.
         *
@@ -1292,6 +1331,24 @@ class WP_Query {
         */
         public $thumbnails_cached = false;
 
+       /**
+        * Whether the term meta cache for matched posts has been primed.
+        *
+        * @since 4.4.0
+        * @access protected
+        * @var bool
+        */
+       public $updated_term_meta_cache = false;
+
+       /**
+        * Whether the comment meta cache for matched posts has been primed.
+        *
+        * @since 4.4.0
+        * @access protected
+        * @var bool
+        */
+       public $updated_comment_meta_cache = false;
+
        /**
         * Cached list of search stopwords.
         *
@@ -1425,6 +1482,7 @@ class WP_Query {
                        , 'preview'
                        , 's'
                        , 'sentence'
+                       , 'title'
                        , 'fields'
                        , 'menu_order'
                );
@@ -1434,7 +1492,7 @@ class WP_Query {
                                $array[$key] = '';
                }
 
-               $array_keys = array( 'category__in', 'category__not_in', 'category__and', 'post__in', 'post__not_in',
+               $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' );
 
@@ -1451,6 +1509,8 @@ class WP_Query {
         * @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.
         * @access public
         *
         * @param string|array $query {
@@ -1504,8 +1564,8 @@ class WP_Query {
         *                                                 specific `$meta_query` clause, use that clause's array key.
         *                                                 Default 'date'. Accepts 'none', 'name', 'author', 'date',
         *                                                 'title', 'modified', 'menu_order', 'parent', 'ID', 'rand',
-        *                                                 'comment_count', 'meta_value', 'meta_value_num', and the
-        *                                                 array keys of `$meta_query`.
+        *                                                 'comment_count', 'meta_value', 'meta_value_num', 'post__in',
+        *                                                 and the array keys of `$meta_query`.
         *     @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.
@@ -1527,9 +1587,11 @@ class WP_Query {
         *     @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.
+        *     @type array        $post_name__in           An array of post slugs that results must match.
+        *     @type string       $s                       Search keyword(s). Prepending a term with a hyphen will
+        *                                                 exclude posts matching that term. Eg, 'pillow -sofa' will
+        *                                                 return posts containing 'pillow' but not 'sofa'.
         *     @type int          $second                  Second of the minute. Default empty. Accepts numbers 0-60.
-        *     @type array        $search_terms            Array of search terms.
         *     @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).
@@ -1542,6 +1604,7 @@ class WP_Query {
         *                                                 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 int          $w                       The week number of the year. Default empty. Accepts numbers 0-53.
@@ -1575,6 +1638,7 @@ class WP_Query {
                $qv['author'] = preg_replace( '|[^0-9,-]|', '', $qv['author'] ); // comma separated list of positive or negative integers
                $qv['pagename'] = trim( $qv['pagename'] );
                $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']);
@@ -1747,7 +1811,7 @@ class WP_Query {
                if ( $this->is_feed && ( !empty($qv['withcomments']) || ( empty($qv['withoutcomments']) && $this->is_singular ) ) )
                        $this->is_comment_feed = true;
 
-               if ( !( $this->is_singular || $this->is_archive || $this->is_search || $this->is_feed || $this->is_trackback || $this->is_404 || $this->is_admin || $this->is_comments_popup || $this->is_robots ) )
+               if ( !( $this->is_singular || $this->is_archive || $this->is_search || $this->is_feed || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) || $this->is_trackback || $this->is_404 || $this->is_admin || $this->is_comments_popup || $this->is_robots ) )
                        $this->is_home = true;
 
                // Correct is_* for page_on_front and page_for_posts
@@ -1769,11 +1833,25 @@ class WP_Query {
                }
 
                if ( '' != $qv['pagename'] ) {
-                       $this->queried_object = get_page_by_path($qv['pagename']);
-                       if ( !empty($this->queried_object) )
+                       $this->queried_object = get_page_by_path( $qv['pagename'] );
+
+                       if ( $this->queried_object && 'attachment' == $this->queried_object->post_type ) {
+                               if ( preg_match( "/^[^%]*%(?:postname)%/", get_option( 'permalink_structure' ) ) ) {
+                                       // See if we also have a post with the same slug
+                                       $post = get_page_by_path( $qv['pagename'], OBJECT, 'post' );
+                                       if ( $post ) {
+                                               $this->queried_object = $post;
+                                               $this->is_page = false;
+                                               $this->is_single = true;
+                                       }
+                               }
+                       }
+
+                       if ( ! empty( $this->queried_object ) ) {
                                $this->queried_object_id = (int) $this->queried_object->ID;
-                       else
-                               unset($this->queried_object);
+                       } else {
+                               unset( $this->queried_object );
+                       }
 
                        if  ( 'page' == get_option('show_on_front') && isset($this->queried_object_id) && $this->queried_object_id == get_option('page_for_posts') ) {
                                $this->is_page = false;
@@ -1813,6 +1891,8 @@ class WP_Query {
                if ( '404' == $qv['error'] )
                        $this->set_404();
 
+               $this->is_embed = isset( $qv['embed'] ) && ( $this->is_singular || $this->is_404 );
+
                $this->query_vars_hash = md5( serialize( $this->query_vars ) );
                $this->query_vars_changed = false;
 
@@ -1886,6 +1966,11 @@ class WP_Query {
                        }
                }
 
+               // If querystring 'cat' is an array, implode it.
+               if ( is_array( $q['cat'] ) ) {
+                       $q['cat'] = implode( ',', $q['cat'] );
+               }
+
                // Category stuff
                if ( ! empty( $q['cat'] ) && ! $this->is_singular ) {
                        $cat_in = $cat_not_in = array();
@@ -1961,6 +2046,11 @@ class WP_Query {
                        );
                }
 
+               // If querystring 'tag' is array, implode it.
+               if ( is_array( $q['tag'] ) ) {
+                       $q['tag'] = implode( ',', $q['tag'] );
+               }
+
                // Tag stuff
                if ( '' != $q['tag'] && !$this->is_singular && $this->query_vars_changed ) {
                        if ( strpos($q['tag'], ',') !== false ) {
@@ -2051,7 +2141,8 @@ class WP_Query {
         *
         * @since 3.7.0
         *
-        * @global wpdb $wpdb
+        * @global wpdb $wpdb WordPress database abstraction object.
+        *
         * @param array $q Query variables.
         * @return string WHERE clause.
         */
@@ -2085,13 +2176,24 @@ class WP_Query {
                $searchand = '';
                $q['search_orderby_title'] = array();
                foreach ( $q['search_terms'] as $term ) {
-                       if ( $n ) {
+                       // Terms prefixed with '-' should be excluded.
+                       $include = '-' !== substr( $term, 0, 1 );
+                       if ( $include ) {
+                               $like_op  = 'LIKE';
+                               $andor_op = 'OR';
+                       } else {
+                               $like_op  = 'NOT LIKE';
+                               $andor_op = 'AND';
+                               $term     = substr( $term, 1 );
+                       }
+
+                       if ( $n && $include ) {
                                $like = '%' . $wpdb->esc_like( $term ) . '%';
                                $q['search_orderby_title'][] = $wpdb->prepare( "$wpdb->posts.post_title LIKE %s", $like );
                        }
 
                        $like = $n . $wpdb->esc_like( $term ) . $n;
-                       $search .= $wpdb->prepare( "{$searchand}(($wpdb->posts.post_title LIKE %s) OR ($wpdb->posts.post_content LIKE %s))", $like, $like );
+                       $search .= $wpdb->prepare( "{$searchand}(($wpdb->posts.post_title $like_op %s) $andor_op ($wpdb->posts.post_content $like_op %s))", $like, $like );
                        $searchand = ' AND ';
                }
 
@@ -2161,7 +2263,7 @@ class WP_Query {
                        'Comma-separated list of search stopwords in your language' ) );
 
                $stopwords = array();
-               foreach( $words as $word ) {
+               foreach ( $words as $word ) {
                        $word = trim( $word, "\r\n\t " );
                        if ( $word )
                                $stopwords[] = $word;
@@ -2181,7 +2283,7 @@ class WP_Query {
        /**
         * Generate SQL for the ORDER BY condition based on passed search terms.
         *
-        * @global wpdb $wpdb
+        * @global wpdb $wpdb WordPress database abstraction object.
         *
         * @param array $q Query variables.
         * @return string ORDER BY clause.
@@ -2191,11 +2293,19 @@ class WP_Query {
 
                if ( $q['search_terms_count'] > 1 ) {
                        $num_terms = count( $q['search_orderby_title'] );
-                       $like = '%' . $wpdb->esc_like( $q['s'] ) . '%';
+
+                       // If the search terms contain negative queries, don't bother ordering by sentence matches.
+                       $like = '';
+                       if ( ! preg_match( '/(?:\s|^)\-/', $q['s'] ) ) {
+                               $like = '%' . $wpdb->esc_like( $q['s'] ) . '%';
+                       }
 
                        $search_orderby = '(CASE ';
+
                        // sentence match in 'post_title'
-                       $search_orderby .= $wpdb->prepare( "WHEN $wpdb->posts.post_title LIKE %s THEN 1 ", $like );
+                       if ( $like ) {
+                               $search_orderby .= $wpdb->prepare( "WHEN $wpdb->posts.post_title LIKE %s THEN 1 ", $like );
+                       }
 
                        // sanity limit, sort as sentence when more than 6 terms
                        // (few searches are longer than 6 terms and most titles are not)
@@ -2208,7 +2318,9 @@ class WP_Query {
                        }
 
                        // sentence match in 'post_content'
-                       $search_orderby .= $wpdb->prepare( "WHEN $wpdb->posts.post_content LIKE %s THEN 4 ", $like );
+                       if ( $like ) {
+                               $search_orderby .= $wpdb->prepare( "WHEN $wpdb->posts.post_content LIKE %s THEN 4 ", $like );
+                       }
                        $search_orderby .= 'ELSE 5 END)';
                } else {
                        // single word or sentence search
@@ -2256,7 +2368,7 @@ class WP_Query {
                        $allowed_keys   = array_merge( $allowed_keys, array_keys( $meta_clauses ) );
                }
 
-               if ( ! in_array( $orderby, $allowed_keys ) ) {
+               if ( ! in_array( $orderby, $allowed_keys, true ) ) {
                        return false;
                }
 
@@ -2343,11 +2455,13 @@ class WP_Query {
         * Retrieve query variable.
         *
         * @since 1.5.0
+        * @since 3.9.0 The `$default` argument was introduced.
+        *
         * @access public
         *
         * @param string $query_var Query variable key.
-        * @param mixed  $default   Value to return if the query variable is not set. Default ''.
-        * @return mixed
+        * @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 ] ) ) {
@@ -2379,7 +2493,7 @@ class WP_Query {
         * @since 1.5.0
         * @access public
         *
-        * @global wpdb $wpdb
+        * @global wpdb $wpdb WordPress database abstraction object.
         *
         * @return array List of posts.
         */
@@ -2603,6 +2717,11 @@ class WP_Query {
                        unset($ptype_obj);
                }
 
+               if ( '' !== $q['title'] ) {
+                       $where .= $wpdb->prepare( " AND $wpdb->posts.post_title = %s", stripslashes( $q['title'] ) );
+               }
+
+               // Parameters related to 'post_name'.
                if ( '' != $q['name'] ) {
                        $q['name'] = sanitize_title_for_query( $q['name'] );
                        $where .= " AND $wpdb->posts.post_name = '" . $q['name'] . "'";
@@ -2647,9 +2766,11 @@ class WP_Query {
                        $q['attachment'] = sanitize_title_for_query( wp_basename( $q['attachment'] ) );
                        $q['name'] = $q['attachment'];
                        $where .= " AND $wpdb->posts.post_name = '" . $q['attachment'] . "'";
+               } 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'] );
+                       $where .= " AND $wpdb->posts.post_name IN ('" . implode( "' ,'", $q['post_name__in'] ) . "')";
                }
 
-
                if ( intval($q['comments_popup']) )
                        $q['p'] = absint($q['comments_popup']);
 
@@ -3089,11 +3210,12 @@ class WP_Query {
                        if ( !$page )
                                $page = 1;
 
-                       if ( empty($q['offset']) ) {
-                               $pgstrt = absint( ( $page - 1 ) * $q['posts_per_page'] ) . ', ';
-                       } else { // we're ignoring $page and using 'offset'
-                               $q['offset'] = absint($q['offset']);
+                       // If 'offset' is provided, it takes precedence over 'paged'.
+                       if ( isset( $q['offset'] ) && is_numeric( $q['offset'] ) ) {
+                               $q['offset'] = absint( $q['offset'] );
                                $pgstrt = $q['offset'] . ', ';
+                       } else {
+                               $pgstrt = absint( ( $page - 1 ) * $q['posts_per_page'] ) . ', ';
                        }
                        $limits = 'LIMIT ' . $pgstrt . $q['posts_per_page'];
                }
@@ -3164,7 +3286,9 @@ class WP_Query {
                        $cgroupby = ( ! empty( $cgroupby ) ) ? 'GROUP BY ' . $cgroupby : '';
                        $corderby = ( ! empty( $corderby ) ) ? 'ORDER BY ' . $corderby : '';
 
-                       $this->comments = (array) $wpdb->get_results("SELECT $distinct $wpdb->comments.* FROM $wpdb->comments $cjoin $cwhere $cgroupby $corderby $climits");
+                       $comments = (array) $wpdb->get_results("SELECT $distinct $wpdb->comments.* FROM $wpdb->comments $cjoin $cwhere $cgroupby $corderby $climits");
+                       // Convert to WP_Comment
+                       $this->comments = array_map( 'get_comment', $comments );
                        $this->comment_count = count($this->comments);
 
                        $post_ids = array();
@@ -3504,6 +3628,11 @@ class WP_Query {
                if ( $this->posts )
                        $this->posts = array_map( 'get_post', $this->posts );
 
+
+               if ( $q['update_post_term_cache'] ) {
+                       add_filter( 'get_term_metadata', array( $this, 'lazyload_term_meta' ), 10, 2 );
+               }
+
                if ( ! $q['suppress_filters'] ) {
                        /**
                         * Filter the raw post results array, prior to status checks.
@@ -3535,13 +3664,20 @@ class WP_Query {
                        $climits = apply_filters_ref_array( 'comment_feed_limits', array( 'LIMIT ' . get_option('posts_per_rss'), &$this ) );
 
                        $comments_request = "SELECT $wpdb->comments.* FROM $wpdb->comments $cjoin $cwhere $cgroupby $corderby $climits";
-                       $this->comments = $wpdb->get_results($comments_request);
+                       $comments = $wpdb->get_results($comments_request);
+                       // Convert to WP_Comment
+                       $this->comments = array_map( 'get_comment', $comments );
                        $this->comment_count = count($this->comments);
                }
 
                // Check post status to determine if post should be displayed.
                if ( !empty($this->posts) && ($this->is_single || $this->is_page) ) {
                        $status = get_post_status($this->posts[0]);
+                       if ( 'attachment' === $this->posts[0]->post_type && 0 === (int) $this->posts[0]->post_parent ) {
+                               $this->is_page = false;
+                               $this->is_single = true;
+                               $this->is_attachment = true;
+                       }
                        $post_status_obj = get_post_status_object($status);
                        //$type = get_post_type($this->posts[0]);
 
@@ -3624,6 +3760,11 @@ class WP_Query {
                        }
                }
 
+               // If comments have been fetched as part of the query, make sure comment meta lazy-loading is set up.
+               if ( ! empty( $this->comments ) ) {
+                       add_filter( 'get_comment_metadata', array( $this, 'lazyload_comment_meta' ), 10, 2 );
+               }
+
                if ( ! $q['suppress_filters'] ) {
                        /**
                         * Filter the array of retrieved posts after they've been fetched and
@@ -3663,7 +3804,7 @@ class WP_Query {
         * @since 3.5.0
         * @access private
         *
-        * @global wpdb $wpdb
+        * @global wpdb $wpdb WordPress database abstraction object.
         */
        private function set_found_posts( $q, $limits ) {
                global $wpdb;
@@ -3790,12 +3931,12 @@ class WP_Query {
        }
 
        /**
-        * Iterate current comment index and return comment object.
+        * Iterate current comment index and return WP_Comment object.
         *
         * @since 2.2.0
         * @access public
         *
-        * @return object Comment object.
+        * @return WP_Comment Comment object.
         */
        public function next_comment() {
                $this->current_comment++;
@@ -3809,7 +3950,7 @@ class WP_Query {
         *
         * @since 2.2.0
         * @access public
-        * @global object $comment Current comment.
+        * @global WP_Comment $comment Current comment.
         */
        public function the_comment() {
                global $comment;
@@ -3891,7 +4032,7 @@ class WP_Query {
                        return $this->queried_object;
 
                $this->queried_object = null;
-               $this->queried_object_id = 0;
+               $this->queried_object_id = null;
 
                if ( $this->is_category || $this->is_tag || $this->is_tax ) {
                        if ( $this->is_category ) {
@@ -4368,8 +4509,8 @@ class WP_Query {
         *
         * @since 3.1.0
         *
-        * @param mixed $page Page ID, title, slug, path, or array of such.
-        * @return bool
+        * @param int|string|array $page Optional. Page ID, title, slug, path, or array of such. Default empty.
+        * @return bool Whether the query is for an existing single page.
         */
        public function is_page( $page = '' ) {
                if ( !$this->is_page )
@@ -4461,8 +4602,8 @@ class WP_Query {
         *
         * @since 3.1.0
         *
-        * @param mixed $post Post ID, title, slug, path, or array of such.
-        * @return bool
+        * @param int|string|array $post Optional. Post ID, title, slug, path, or array of such. Default empty.
+        * @return bool Whether the query is for an existing single post.
         */
        public function is_single( $post = '' ) {
                if ( !$this->is_single )
@@ -4507,8 +4648,8 @@ class WP_Query {
         *
         * @since 3.1.0
         *
-        * @param mixed $post_types Optional. Post Type or array of Post Types
-        * @return bool
+        * @param string|array $post_types Optional. Post type or array of post types. Default empty.
+        * @return bool Whether the query is for an existing single post of any of the given post types.
         */
        public function is_singular( $post_types = '' ) {
                if ( empty( $post_types ) || !$this->is_singular )
@@ -4563,12 +4704,23 @@ class WP_Query {
                return (bool) $this->is_404;
        }
 
+       /**
+        * Is the query for an embedded post?
+        *
+        * @since 4.4.0
+        *
+        * @return bool
+        */
+       public function is_embed() {
+               return (bool) $this->is_embed;
+       }
+
        /**
         * Is the query the main query?
         *
         * @since 3.3.0
         *
-        * @global WP_Query $wp_query
+        * @global WP_Query $wp_query Global WP_Query instance.
         *
         * @return bool
         */
@@ -4581,6 +4733,7 @@ class WP_Query {
         * Set up global post data.
         *
         * @since 4.1.0
+        * @since 4.4.0 Added the ability to pass a post ID to `$post`.
         *
         * @global int             $id
         * @global WP_User         $authordata
@@ -4592,12 +4745,20 @@ class WP_Query {
         * @global int             $more
         * @global int             $numpages
         *
-        * @param WP_Post $post Post data.
+        * @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;
+               }
+
                $id = (int) $post->ID;
 
                $authordata = get_userdata($post->post_author);
@@ -4624,8 +4785,6 @@ class WP_Query {
 
                $content = $post->post_content;
                if ( false !== strpos( $content, '<!--nextpage-->' ) ) {
-                       if ( $page > 1 )
-                               $more = 1;
                        $content = str_replace( "\n<!--nextpage-->\n", '<!--nextpage-->', $content );
                        $content = str_replace( "\n<!--nextpage-->", '<!--nextpage-->', $content );
                        $content = str_replace( "<!--nextpage-->\n", '<!--nextpage-->', $content );
@@ -4635,13 +4794,35 @@ class WP_Query {
                                $content = substr( $content, 15 );
 
                        $pages = explode('<!--nextpage-->', $content);
-                       $numpages = count($pages);
-                       if ( $numpages > 1 )
-                               $multipage = 1;
                } else {
                        $pages = array( $post->post_content );
                }
 
+               /**
+                * Filter 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
+                *
+                * @param array   $pages Array of "pages" derived from the post content.
+                *                       of `<!-- nextpage -->` tags..
+                * @param WP_Post $post  Current post object.
+                */
+               $pages = apply_filters( 'content_pagination', $pages, $post );
+
+               $numpages = count( $pages );
+
+               if ( $numpages > 1 ) {
+                       if ( $page > 1 ) {
+                               $more = 1;
+                       }
+                       $multipage = 1;
+               } else {
+                       $multipage = 0;
+               }
+
                /**
                 * Fires once the post data has been setup.
                 *
@@ -4666,9 +4847,129 @@ class WP_Query {
        public function reset_postdata() {
                if ( ! empty( $this->post ) ) {
                        $GLOBALS['post'] = $this->post;
-                       setup_postdata( $this->post );
+                       $this->setup_postdata( $this->post );
                }
        }
+
+       /**
+        * Lazy-loads termmeta for located posts.
+        *
+        * As a rule, term queries (`get_terms()` and `wp_get_object_terms()`) prime the metadata cache for matched
+        * terms by default. However, this can cause a slight performance penalty, especially when that metadata is
+        * not actually used. In the context of a `WP_Query` instance, we're able to avoid this potential penalty.
+        * `update_object_term_cache()`, called from `update_post_caches()`, does not 'update_term_meta_cache'.
+        * Instead, the first time `get_term_meta()` is called from within a `WP_Query` loop, the current method
+        * detects the fact, and then primes the metadata cache for all terms attached to all posts in the loop,
+        * with a single database query.
+        *
+        * This method is public so that it can be used as a filter callback. As a rule, there is no need to invoke it
+        * directly, from either inside or outside the `WP_Query` object.
+        *
+        * @since 4.4.0
+        * @access public
+        *
+        * @param mixed $check  The `$check` param passed from the 'get_term_metadata' hook.
+        * @param int  $term_id ID of the term whose metadata is being cached.
+        * @return mixed In order not to short-circuit `get_metadata()`. Generally, this is `null`, but it could be
+        *               another value if filtered by a plugin.
+        */
+       public function lazyload_term_meta( $check, $term_id ) {
+               /*
+                * We only do this once per `WP_Query` instance.
+                * Can't use `remove_filter()` because of non-unique object hashes.
+                */
+               if ( $this->updated_term_meta_cache ) {
+                       return $check;
+               }
+
+               // We can only lazyload if the entire post object is present.
+               $posts = array();
+               foreach ( $this->posts as $post ) {
+                       if ( $post instanceof WP_Post ) {
+                               $posts[] = $post;
+                       }
+               }
+
+               if ( ! empty( $posts ) ) {
+                       // Fetch cached term_ids for each post. Keyed by term_id for faster lookup.
+                       $term_ids = array();
+                       foreach ( $posts as $post ) {
+                               $taxonomies = get_object_taxonomies( $post->post_type );
+                               foreach ( $taxonomies as $taxonomy ) {
+                                       // Term cache should already be primed by 'update_post_term_cache'.
+                                       $terms = get_object_term_cache( $post->ID, $taxonomy );
+                                       if ( false !== $terms ) {
+                                               foreach ( $terms as $term ) {
+                                                       if ( ! isset( $term_ids[ $term->term_id ] ) ) {
+                                                               $term_ids[ $term->term_id ] = 1;
+                                                       }
+                                               }
+                                       }
+                               }
+                       }
+
+                       /*
+                        * Only update the metadata cache for terms belonging to these posts if the term_id passed
+                        * to `get_term_meta()` matches one of those terms. This prevents a single call to
+                        * `get_term_meta()` from priming metadata for all `WP_Query` objects.
+                        */
+                       if ( isset( $term_ids[ $term_id ] ) ) {
+                               update_termmeta_cache( array_keys( $term_ids ) );
+                               $this->updated_term_meta_cache = true;
+                       }
+               }
+
+               // If no terms were found, there's no need to run this again.
+               if ( empty( $term_ids ) ) {
+                       $this->updated_term_meta_cache = true;
+               }
+
+               return $check;
+       }
+
+       /**
+        * Lazy-load comment meta when inside of a `WP_Query` loop.
+        *
+        * This method is public so that it can be used as a filter callback. As a rule, there is no need to invoke it
+        * directly, from either inside or outside the `WP_Query` object.
+        *
+        * @since 4.4.0
+        *
+        * @param mixed $check     The `$check` param passed from the 'get_comment_metadata' hook.
+        * @param int  $comment_id ID of the comment whose metadata is being cached.
+        * @return mixed The original value of `$check`, to not affect 'get_comment_metadata'.
+        */
+       public function lazyload_comment_meta( $check, $comment_id ) {
+               /*
+                * We only do this once per `WP_Query` instance.
+                * Can't use `remove_filter()` because of non-unique object hashes.
+                */
+               if ( $this->updated_comment_meta_cache ) {
+                       return $check;
+               }
+
+               // Don't use `wp_list_pluck()` to avoid by-reference manipulation.
+               $comment_ids = array();
+               if ( is_array( $this->comments ) ) {
+                       foreach ( $this->comments as $comment ) {
+                               $comment_ids[] = $comment->comment_ID;
+                       }
+               }
+
+               /*
+                * Only update the metadata cache for comments belonging to these posts if the comment_id passed
+                * to `get_comment_meta()` matches one of those comments. This prevents a single call to
+                * `get_comment_meta()` from priming metadata for all `WP_Query` objects.
+                */
+               if ( in_array( $comment_id, $comment_ids ) ) {
+                       update_meta_cache( 'comment', $comment_ids );
+                       $this->updated_comment_meta_cache = true;
+               } elseif ( empty( $comment_ids ) ) {
+                       $this->updated_comment_meta_cache = true;
+               }
+
+               return $check;
+       }
 }
 
 /**
@@ -4678,21 +4979,26 @@ class WP_Query {
  *
  * @since 2.1.0
  *
- * @global WP_Query $wp_query
- * @global wpdb     $wpdb     WordPress database abstraction object.
+ * @global WP_Query   $wp_query   Global WP_Query instance.
+ * @global wpdb       $wpdb       WordPress database abstraction object.
+ * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
  */
 function wp_old_slug_redirect() {
-       global $wp_query;
-       if ( is_404() && '' != $wp_query->query_vars['name'] ) :
+       global $wp_query, $wp_rewrite;
+
+       if ( '' !== $wp_query->query_vars['name'] ) :
                global $wpdb;
 
                // Guess the current post_type based on the query vars.
-               if ( get_query_var('post_type') )
-                       $post_type = get_query_var('post_type');
-               elseif ( !empty($wp_query->query_vars['pagename']) )
+               if ( get_query_var( 'post_type' ) ) {
+                       $post_type = get_query_var( 'post_type' );
+               } elseif ( get_query_var( 'attachment' ) ) {
+                       $post_type = 'attachment';
+               } elseif ( ! empty( $wp_query->query_vars['pagename'] ) ) {
                        $post_type = 'page';
-               else
+               } else {
                        $post_type = 'post';
+               }
 
                if ( is_array( $post_type ) ) {
                        if ( count( $post_type ) > 1 )
@@ -4720,10 +5026,35 @@ function wp_old_slug_redirect() {
                if ( ! $id )
                        return;
 
-               $link = get_permalink($id);
+               $link = get_permalink( $id );
+
+               if ( is_feed() ) {
+                       $link = user_trailingslashit( trailingslashit( $link ) . 'feed' );
+               } elseif ( isset( $GLOBALS['wp_query']->query_vars['paged'] ) && $GLOBALS['wp_query']->query_vars['paged'] > 1 ) {
+                       $link = user_trailingslashit( trailingslashit( $link ) . 'page/' . $GLOBALS['wp_query']->query_vars['paged'] );
+               } elseif( is_embed() ) {
+                       $link = user_trailingslashit( trailingslashit( $link ) . 'embed' );
+               } elseif ( is_404() ) {
+                       // Add rewrite endpoints if necessary.
+                       foreach ( $wp_rewrite->endpoints as $endpoint ) {
+                               if ( $endpoint[2] && false !== get_query_var( $endpoint[2], false ) ) {
+                                       $link = user_trailingslashit( trailingslashit( $link ) . $endpoint[1] );
+                               }
+                       }
+               }
+
+               /**
+                * Filter the old slug redirect URL.
+                *
+                * @since 4.4.0
+                *
+                * @param string $link The redirect URL.
+                */
+               $link = apply_filters( 'old_slug_redirect_url', $link );
 
-               if ( !$link )
+               if ( ! $link ) {
                        return;
+               }
 
                wp_redirect( $link, 301 ); // Permanent redirect
                exit;
@@ -4734,10 +5065,11 @@ function wp_old_slug_redirect() {
  * Set up global post data.
  *
  * @since 1.5.0
+ * @since 4.4.0 Added the ability to pass a post ID to `$post`.
  *
- * @global WP_Query $wp_query
+ * @global WP_Query $wp_query Global WP_Query instance.
  *
- * @param object $post Post data.
+ * @param WP_Post|object|int $post WP_Post instance or Post ID/object.
  * @return bool True when finished.
  */
 function setup_postdata( $post ) {