Parses a query string and sets query type booleans.

Parameters

$querystring|arrayoptional

Array or string of Query parameters.

• attachment_id int

  Attachment post ID. Used for 'attachment' post_type.

• author int|string

  Author ID, or comma-separated list of IDs.

• author_name string

  User 'user_nicename'.

• author__in int[]

  An array of author IDs to query from.

• author__not_in int[]

  An array of author IDs not to query from.

• cache_results bool

  Whether to cache post information. Default true.

• cat int|string

  Category ID or comma-separated list of IDs (this or any children).

• category__and int[]

  An array of category IDs (AND in).

• category__in int[]

  An array of category IDs (OR in, no children).

• category__not_in int[]

  An array of category IDs (NOT in).

• category_name string

  Use category slug (not name, this or any children).

• comment_count array|int

  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.

• comment_status string

  Comment status.

• comments_per_page int

  The number of comments to return per page.
  Default 'comments_per_page' option.

• date_query array
• day int

  Day of the month. Default empty. Accepts numbers 1-31.

• exact bool

  Whether to search by exact keyword. Default false.

• fields string

  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 ''.

• hour int

  Hour of the day. Default empty. Accepts numbers 0-23.

• ignore_sticky_posts int|bool

  Whether to ignore sticky posts or not. Setting this to false excludes stickies from 'post__in'. Accepts 1|true, 0|false.
  Default false.

• m int

  Combination YearMonth. Accepts any four-digit year and month numbers 01-12. Default empty.

• meta_key string|string[]

  Meta key or keys to filter by.

• meta_value string|string[]

  Meta value or values to filter by.

• meta_compare string

  MySQL operator used for comparing the meta value.
  See WP_Meta_Query::__construct() for accepted values and default value.

• meta_compare_key string

  MySQL operator used for comparing the meta key.
  See WP_Meta_Query::__construct() for accepted values and default value.

• meta_type string

  MySQL data type that the meta_value column will be CAST to for comparisons.
  See WP_Meta_Query::__construct() for accepted values and default value.

• meta_type_key string

  MySQL data type that the meta_key column will be CAST to for comparisons.
  See WP_Meta_Query::__construct() for accepted values and default value.

• meta_query array
• menu_order int

  The menu order of the posts.

• minute int

  Minute of the hour. Default empty. Accepts numbers 0-59.

• monthnum int

  The two-digit month. Default empty. Accepts numbers 1-12.

• name string

  Post slug.

• nopaging bool

  Show all posts (true) or paginate (false). Default false.

• no_found_rows bool

  Whether to skip counting the total rows found. Enabling can improve performance. Default false.

• offset int

  The number of posts to offset before retrieval.

• order string

  Designates ascending or descending order of posts. Default 'DESC'.
  Accepts 'ASC', 'DESC'.

• orderby string|array

  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. Accepts:

  • 'none'
  • 'name'
  • 'author'
  • 'date'
  • 'title'
  • 'modified'
  • 'menu_order'
  • 'parent'
  • 'ID'
  • 'rand'
  • 'relevance'
  • 'RAND(x)' (where 'x' is an integer seed value)
  • 'comment_count'
  • 'meta_value'
  • 'meta_value_num'
  • 'post__in'
  • 'post_name__in'
  • 'post_parent__in'
  • The array keys of $meta_query.

  Default is 'date', except when a search is being performed, when the default is 'relevance'.

• p int

  Post ID.

• page int

  Show the number of posts that would show up on page X of a static front page.

• paged int

  The number of the current page.

• page_id int

  Page ID.

• pagename string

  Page slug.

• perm string

  Show posts if user has the appropriate capability.

• ping_status string

  Ping status.

• post__in int[]

  An array of post IDs to retrieve, sticky posts will be included.

• post__not_in int[]

  An array of post IDs not to retrieve. Note: a string of comma- separated IDs will NOT work.

• post_mime_type string

  The mime type of the post. Used for 'attachment' post_type.

• post_name__in string[]

  An array of post slugs that results must match.

• post_parent int

  Page ID to retrieve child pages for. Use 0 to only retrieve top-level pages.

• post_parent__in int[]

  An array containing parent page IDs to query child pages from.

• post_parent__not_in int[]

  An array containing parent page IDs not to query child pages from.

• post_type string|string[]

  A post type slug (string) or array of post type slugs.
  Default 'any' if using 'tax_query'.

• post_status string|string[]

  A post status (string) or array of post statuses.

• posts_per_page int

  The number of posts to query for. Use -1 to request all posts.

• posts_per_archive_page int

  The number of posts to query for by archive page. Overrides 'posts_per_page' when is_archive() , or is_search() are true.

• s string

  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'. The character used for exclusion can be modified using the the 'wp_query_search_exclusion_prefix' filter.

• search_columns string[]

  Array of column names to be searched. Accepts 'post_title', 'post_excerpt' and 'post_content'. Default empty array.

• second int

  Second of the minute. Default empty. Accepts numbers 0-59.

• sentence bool

  Whether to search by phrase. Default false.

• suppress_filters bool

  Whether to suppress filters. Default false.

• tag string

  Tag slug. Comma-separated (either), Plus-separated (all).

• tag__and int[]

  An array of tag IDs (AND in).

• tag__in int[]

  An array of tag IDs (OR in).

• tag__not_in int[]

  An array of tag IDs (NOT in).

• tag_id int

  Tag id or comma-separated list of IDs.

• tag_slug__and string[]

  An array of tag slugs (AND in).

• tag_slug__in string[]

  An array of tag slugs (OR in). unless 'ignore_sticky_posts' is true. Note: a string of comma-separated IDs will NOT work.

• tax_query array
• title string

  Post title.

• update_post_meta_cache bool

  Whether to update the post meta cache. Default true.

• update_post_term_cache bool

  Whether to update the post term cache. Default true.

• update_menu_item_cache bool

  Whether to update the menu item cache. Default false.

• lazy_load_term_meta bool

  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.

• w int

  The week number of the year. Default empty. Accepts numbers 0-53.

• year int

  The four-digit year. Default empty. Accepts any four-digit year.

Source

public function parse_query( $query = '' ) {
	if ( ! empty( $query ) ) {
		$this->init();
		$this->query      = wp_parse_args( $query );
		$this->query_vars = $this->query;
	} elseif ( ! isset( $this->query ) ) {
		$this->query = $this->query_vars;
	}

	$this->query_vars         = $this->fill_query_vars( $this->query_vars );
	$query_vars               = &$this->query_vars;
	$this->query_vars_changed = true;

	if ( ! empty( $query_vars['robots'] ) ) {
		$this->is_robots = true;
	} elseif ( ! empty( $query_vars['favicon'] ) ) {
		$this->is_favicon = true;
	}

	if ( ! is_scalar( $query_vars['p'] ) || (int) $query_vars['p'] < 0 ) {
		$query_vars['p']     = 0;
		$query_vars['error'] = '404';
	} else {
		$query_vars['p'] = (int) $query_vars['p'];
	}

	$query_vars['page_id']  = is_scalar( $query_vars['page_id'] ) ? absint( $query_vars['page_id'] ) : 0;
	$query_vars['year']     = is_scalar( $query_vars['year'] ) ? absint( $query_vars['year'] ) : 0;
	$query_vars['monthnum'] = is_scalar( $query_vars['monthnum'] ) ? absint( $query_vars['monthnum'] ) : 0;
	$query_vars['day']      = is_scalar( $query_vars['day'] ) ? absint( $query_vars['day'] ) : 0;
	$query_vars['w']        = is_scalar( $query_vars['w'] ) ? absint( $query_vars['w'] ) : 0;
	$query_vars['m']        = is_scalar( $query_vars['m'] ) ? preg_replace( '|[^0-9]|', '', $query_vars['m'] ) : '';
	$query_vars['paged']    = is_scalar( $query_vars['paged'] ) ? absint( $query_vars['paged'] ) : 0;
	$query_vars['cat']      = preg_replace( '|[^0-9,-]|', '', $query_vars['cat'] ); // Array or comma-separated list of positive or negative integers.
	$query_vars['author']   = is_scalar( $query_vars['author'] ) ? preg_replace( '|[^0-9,-]|', '', $query_vars['author'] ) : ''; // Comma-separated list of positive or negative integers.
	$query_vars['pagename'] = is_scalar( $query_vars['pagename'] ) ? trim( $query_vars['pagename'] ) : '';
	$query_vars['name']     = is_scalar( $query_vars['name'] ) ? trim( $query_vars['name'] ) : '';
	$query_vars['title']    = is_scalar( $query_vars['title'] ) ? trim( $query_vars['title'] ) : '';

	if ( is_scalar( $query_vars['hour'] ) && '' !== $query_vars['hour'] ) {
		$query_vars['hour'] = absint( $query_vars['hour'] );
	} else {
		$query_vars['hour'] = '';
	}

	if ( is_scalar( $query_vars['minute'] ) && '' !== $query_vars['minute'] ) {
		$query_vars['minute'] = absint( $query_vars['minute'] );
	} else {
		$query_vars['minute'] = '';
	}

	if ( is_scalar( $query_vars['second'] ) && '' !== $query_vars['second'] ) {
		$query_vars['second'] = absint( $query_vars['second'] );
	} else {
		$query_vars['second'] = '';
	}

	if ( is_scalar( $query_vars['menu_order'] ) && '' !== $query_vars['menu_order'] ) {
		$query_vars['menu_order'] = absint( $query_vars['menu_order'] );
	} else {
		$query_vars['menu_order'] = '';
	}

	// Fairly large, potentially too large, upper bound for search string lengths.
	if ( ! is_scalar( $query_vars['s'] ) || ( ! empty( $query_vars['s'] ) && strlen( $query_vars['s'] ) > 1600 ) ) {
		$query_vars['s'] = '';
	}

	// Compat. Map subpost to attachment.
	if ( is_scalar( $query_vars['subpost'] ) && '' != $query_vars['subpost'] ) {
		$query_vars['attachment'] = $query_vars['subpost'];
	}
	if ( is_scalar( $query_vars['subpost_id'] ) && '' != $query_vars['subpost_id'] ) {
		$query_vars['attachment_id'] = $query_vars['subpost_id'];
	}

	$query_vars['attachment_id'] = is_scalar( $query_vars['attachment_id'] ) ? absint( $query_vars['attachment_id'] ) : 0;

	if ( ( '' !== $query_vars['attachment'] ) || ! empty( $query_vars['attachment_id'] ) ) {
		$this->is_single     = true;
		$this->is_attachment = true;
	} elseif ( '' !== $query_vars['name'] ) {
		$this->is_single = true;
	} elseif ( $query_vars['p'] ) {
		$this->is_single = true;
	} elseif ( '' !== $query_vars['pagename'] || ! empty( $query_vars['page_id'] ) ) {
		$this->is_page   = true;
		$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 ( '' !== $query_vars['second'] ) {
			$this->is_time = true;
			$this->is_date = true;
		}

		if ( '' !== $query_vars['minute'] ) {
			$this->is_time = true;
			$this->is_date = true;
		}

		if ( '' !== $query_vars['hour'] ) {
			$this->is_time = true;
			$this->is_date = true;
		}

		if ( $query_vars['day'] ) {
			if ( ! $this->is_date ) {
				$date = sprintf( '%04d-%02d-%02d', $query_vars['year'], $query_vars['monthnum'], $query_vars['day'] );
				if ( $query_vars['monthnum'] && $query_vars['year'] && ! wp_checkdate( $query_vars['monthnum'], $query_vars['day'], $query_vars['year'], $date ) ) {
					$query_vars['error'] = '404';
				} else {
					$this->is_day  = true;
					$this->is_date = true;
				}
			}
		}

		if ( $query_vars['monthnum'] ) {
			if ( ! $this->is_date ) {
				if ( 12 < $query_vars['monthnum'] ) {
					$query_vars['error'] = '404';
				} else {
					$this->is_month = true;
					$this->is_date  = true;
				}
			}
		}

		if ( $query_vars['year'] ) {
			if ( ! $this->is_date ) {
				$this->is_year = true;
				$this->is_date = true;
			}
		}

		if ( $query_vars['m'] ) {
			$this->is_date = true;
			if ( strlen( $query_vars['m'] ) > 9 ) {
				$this->is_time = true;
			} elseif ( strlen( $query_vars['m'] ) > 7 ) {
				$this->is_day = true;
			} elseif ( strlen( $query_vars['m'] ) > 5 ) {
				$this->is_month = true;
			} else {
				$this->is_year = true;
			}
		}

		if ( $query_vars['w'] ) {
			$this->is_date = true;
		}

		$this->query_vars_hash = false;
		$this->parse_tax_query( $query_vars );

		foreach ( $this->tax_query->queries as $tax_query ) {
			if ( ! is_array( $tax_query ) ) {
				continue;
			}

			if ( isset( $tax_query['operator'] ) && 'NOT IN' !== $tax_query['operator'] ) {
				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 );

		if ( empty( $query_vars['author'] ) || ( '0' == $query_vars['author'] ) ) {
			$this->is_author = false;
		} else {
			$this->is_author = true;
		}

		if ( '' !== $query_vars['author_name'] ) {
			$this->is_author = true;
		}

		if ( ! empty( $query_vars['post_type'] ) && ! is_array( $query_vars['post_type'] ) ) {
			$post_type_obj = get_post_type_object( $query_vars['post_type'] );
			if ( ! empty( $post_type_obj->has_archive ) ) {
				$this->is_post_type_archive = true;
			}
		}

		if ( $this->is_post_type_archive || $this->is_date || $this->is_author || $this->is_category || $this->is_tag || $this->is_tax ) {
			$this->is_archive = true;
		}
	}

	if ( '' != $query_vars['feed'] ) {
		$this->is_feed = true;
	}

	if ( '' != $query_vars['embed'] ) {
		$this->is_embed = true;
	}

	if ( '' != $query_vars['tb'] ) {
		$this->is_trackback = true;
	}

	if ( '' != $query_vars['paged'] && ( (int) $query_vars['paged'] > 1 ) ) {
		$this->is_paged = true;
	}

	// If we're previewing inside the write screen.
	if ( '' != $query_vars['preview'] ) {
		$this->is_preview = true;
	}

	if ( is_admin() ) {
		$this->is_admin = true;
	}

	if ( str_contains( $query_vars['feed'], 'comments-' ) ) {
		$query_vars['feed']         = str_replace( 'comments-', '', $query_vars['feed'] );
		$query_vars['withcomments'] = 1;
	}

	$this->is_singular = $this->is_single || $this->is_page || $this->is_attachment;

	if ( $this->is_feed && ( ! empty( $query_vars['withcomments'] ) || ( empty( $query_vars['withoutcomments'] ) && $this->is_singular ) ) ) {
		$this->is_comment_feed = true;
	}

	if ( ! ( $this->is_singular || $this->is_archive || $this->is_search || $this->is_feed
			|| ( wp_is_serving_rest_request() && $this->is_main_query() )
			|| $this->is_trackback || $this->is_404 || $this->is_admin || $this->is_robots || $this->is_favicon ) ) {
		$this->is_home = true;
	}

	// Correct `is_*` for 'page_on_front' and 'page_for_posts'.
	if ( $this->is_home && 'page' === get_option( 'show_on_front' ) && get_option( 'page_on_front' ) ) {
		$_query = wp_parse_args( $this->query );
		// 'pagename' can be set and empty depending on matched rewrite rules. Ignore an empty 'pagename'.
		if ( isset( $_query['pagename'] ) && '' === $_query['pagename'] ) {
			unset( $_query['pagename'] );
		}

		unset( $_query['embed'] );

		if ( empty( $_query ) || ! array_diff( array_keys( $_query ), array( 'preview', 'page', 'paged', 'cpage' ) ) ) {
			$this->is_page         = true;
			$this->is_home         = false;
			$query_vars['page_id'] = get_option( 'page_on_front' );
			// Correct <!--nextpage--> for 'page_on_front'.
			if ( ! empty( $query_vars['paged'] ) ) {
				$query_vars['page'] = $query_vars['paged'];
				unset( $query_vars['paged'] );
			}
		}
	}

	if ( '' !== $query_vars['pagename'] ) {
		$this->queried_object = get_page_by_path( $query_vars['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( $query_vars['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 );
		}

		if ( 'page' === get_option( 'show_on_front' ) && isset( $this->queried_object_id ) && get_option( 'page_for_posts' ) == $this->queried_object_id ) {
			$this->is_page       = false;
			$this->is_home       = true;
			$this->is_posts_page = true;
		}

		if ( isset( $this->queried_object_id ) && get_option( 'wp_page_for_privacy_policy' ) == $this->queried_object_id ) {
			$this->is_privacy_policy = true;
		}
	}

	if ( $query_vars['page_id'] ) {
		if ( 'page' === get_option( 'show_on_front' ) && get_option( 'page_for_posts' ) == $query_vars['page_id'] ) {
			$this->is_page       = false;
			$this->is_home       = true;
			$this->is_posts_page = true;
		}

		if ( get_option( 'wp_page_for_privacy_policy' ) == $query_vars['page_id'] ) {
			$this->is_privacy_policy = true;
		}
	}

	if ( ! empty( $query_vars['post_type'] ) ) {
		if ( is_array( $query_vars['post_type'] ) ) {
			$query_vars['post_type'] = array_map( 'sanitize_key', array_unique( $query_vars['post_type'] ) );
			sort( $query_vars['post_type'] );
		} else {
			$query_vars['post_type'] = sanitize_key( $query_vars['post_type'] );
		}
	}

	if ( ! empty( $query_vars['post_status'] ) ) {
		if ( is_array( $query_vars['post_status'] ) ) {
			$query_vars['post_status'] = array_map( 'sanitize_key', array_unique( $query_vars['post_status'] ) );
			sort( $query_vars['post_status'] );
		} else {
			$query_vars['post_status'] = preg_replace( '|[^a-z0-9_,-]|', '', $query_vars['post_status'] );
		}
	}

	if ( $this->is_posts_page && ( ! isset( $query_vars['withcomments'] ) || ! $query_vars['withcomments'] ) ) {
		$this->is_comment_feed = false;
	}

	$this->is_singular = $this->is_single || $this->is_page || $this->is_attachment;
	// Done correcting `is_*` for 'page_on_front' and 'page_for_posts'.

	if ( '404' == $query_vars['error'] ) {
		$this->set_404();
	}

	$this->is_embed = $this->is_embed && ( $this->is_singular || $this->is_404 );

	$this->query_vars_hash    = md5( serialize( $this->query_vars ) );
	$this->query_vars_changed = false;

	/**
	 * Fires after the main query vars have been parsed.
	 *
	 * @since 1.5.0
	 *
	 * @param WP_Query $query The WP_Query instance (passed by reference).
	 */
	do_action_ref_array( 'parse_query', array( &$this ) );
}

View all references View on Trac View on GitHub

Hooks

do_action_ref_array( ‘parse_query’, WP_Query $query )

Fires after the main query vars have been parsed.

Changelog