<?php

/**

 * WordPress Query API

 *

 * The query API attempts to get which part of WordPress to the user is on. It

 * also provides functionality to getting URL query information.

 *

 * @link http://codex.wordpress.org/The_Loop More information on The Loop.

 *

 * @package WordPress

 * @subpackage Query

 */

/**

 * Retrieve variable in the WP_Query class.

 *

 * @see WP_Query::get()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @param string $var The variable key to retrieve.

 * @return mixed

 */

function get_query_var($var) {

	global $wp_query;

	return $wp_query->get($var);

}

/**

 * Retrieve the currently-queried object. Wrapper for $wp_query->get_queried_object()

 *

 * @uses WP_Query::get_queried_object

 *

 * @since 3.1.0

 * @access public

 *

 * @return object

 */

function get_queried_object() {

	global $wp_query;

	return $wp_query->get_queried_object();

}

/**

 * Retrieve ID of the current queried object. Wrapper for $wp_query->get_queried_object_id()

 *

 * @uses WP_Query::get_queried_object_id()

 *

 * @since 3.1.0

 * @access public

 *

 * @return int

 */

function get_queried_object_id() {

	global $wp_query;

	return $wp_query->get_queried_object_id();

}

/**

 * Set query variable.

 *

 * @see WP_Query::set()

 * @since 2.2.0

 * @uses $wp_query

 *

 * @param string $var Query variable key.

 * @param mixed $value

 * @return null

 */

function set_query_var($var, $value) {

	global $wp_query;

	return $wp_query->set($var, $value);

}

/**

 * Set up The Loop with query parameters.

 *

 * This will override the current WordPress Loop and shouldn't be used more than

 * once. This must not be used within the WordPress Loop.

 *

 * @since 1.5.0

 * @uses $wp_query

 *

 * @param string $query

 * @return array List of posts

 */

	$GLOBALS['wp_query'] = new WP_Query();

	return $GLOBALS['wp_query']->query($query);

}

/**

 * Destroy the previous query and set up a new query.

 *

 * This should be used after {@link query_posts()} and before another {@link

 * query_posts()}. This will remove obscure bugs that occur when the previous

 * wp_query object is not destroyed properly before another is set up.

 *

 * @since 2.3.0

 * @uses $wp_query

 */

function wp_reset_query() {

	$GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];

	wp_reset_postdata();

}

/**

 * After looping through a separate query, this function restores

 * the $post global to the current post in the main query

 *

 * @since 3.0.0

 * @uses $wp_query

 */

function wp_reset_postdata() {

	global $wp_query;

	if ( !empty($wp_query->post) ) {

		$GLOBALS['post'] = $wp_query->post;

		setup_postdata($wp_query->post);

	}

}

/*

 * Query type checks.

 */

/**

 *

 * Month, Year, Category, Author, Post Type archive...

 *

 * @see WP_Query::is_archive()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_archive() {

	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_archive();

}

/**

 *

 * @see WP_Query::is_post_type_archive()

 * @since 3.1.0

 * @uses $wp_query

 *

 * @param mixed $post_types Optional. Post type or array of posts types to check against.

 * @return bool

 */

function is_post_type_archive( $post_types = '' ) {

	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_post_type_archive( $post_types );

}

/**

 *

 * @see WP_Query::is_attachment()

 * @since 2.0.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_attachment() {

	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_attachment();

}

/**

 *

 * If the $author parameter is specified, this function will additionally

 * check if the query is for one of the authors specified.

 *

 * @see WP_Query::is_author()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @param mixed $author Optional. User ID, nickname, nicename, or array of User IDs, nicknames, and nicenames

 * @return bool

 */

function is_author( $author = '' ) {

	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_author( $author );

}

/**

 *

 * If the $category parameter is specified, this function will additionally

 * check if the query is for one of the categories specified.

 *

 * @see WP_Query::is_category()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @param mixed $category Optional. Category ID, name, slug, or array of Category IDs, names, and slugs.

 * @return bool

 */

function is_category( $category = '' ) {

	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_category( $category );

}

/**

 *

 * If the $tag parameter is specified, this function will additionally

 * check if the query is for one of the tags specified.

 *

 * @see WP_Query::is_tag()

 * @since 2.3.0

 * @uses $wp_query

 *

 * @param mixed $slug Optional. Tag slug or array of slugs.

 * @return bool

 */

function is_tag( $slug = '' ) {

	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_tag( $slug );

}

/**

 *

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

 *

 * @see WP_Query::is_tax()

 * @since 2.5.0

 * @uses $wp_query

 *

 * @param mixed $taxonomy Optional. Taxonomy slug or slugs.

 * @param mixed $term Optional. Term ID, name, slug or array of Term IDs, names, and slugs.

 * @return bool

 */

function is_tax( $taxonomy = '', $term = '' ) {

	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_tax( $taxonomy, $term );

}

/**

 * Whether the current URL is within the comments popup window.

 *

 * @see WP_Query::is_comments_popup()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_comments_popup() {

	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_comments_popup();

}

/**

 *

 * @see WP_Query::is_date()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_date() {

	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_date();

}

/**

 *

 * @see WP_Query::is_day()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_day() {

	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_day();

}

/**

 * Is the query for a feed?

 *

 * @see WP_Query::is_feed()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @param string|array $feeds Optional feed types to check.

 * @return bool

 */

function is_feed( $feeds = '' ) {

	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_feed( $feeds );

}

/**

 * Is the query for a comments feed?

 *

 * @see WP_Query::is_comments_feed()

 * @since 3.0.0

 * @uses $wp_query

 *

 * @return bool

 */

function is_comment_feed() {

	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_comment_feed();

}

/**

 * 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 is_home()

 *

 * @see WP_Query::is_front_page()

 * @since 2.5.0

 * @uses is_home()

 * @uses get_option()

 *

 * @return bool True, if front of site.

 */

function is_front_page() {

	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_front_page();

}

/**

 * 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 is_front_page()

 *

 * @see WP_Query::is_home()

 * @since 1.5.0

 * @uses $wp_query

 *

 * @return bool True if blog view homepage.

 */

function is_home() {

	global $wp_query;