WordPress.org

Function Reference/get query var

Languages: English • Italiano • (Add your language)

Description

Retrieve variable in the WP_Query class of the global $wp_query object.

Usage

<?php get_query_var( $var ) ?>

Parameters

$var

(string) (required) The variable key to retrieve.

Default: None

Return Values

(mixed)

Examples

Getting Current Pagination Number


<?php  $paged = (get_query_var('paged')) ? get_query_var('paged') : 1;  ?>

<h1>Currently Browsing Page <?php echo $paged; ?></h1>

For getting the current pagination number on a static front page (Page template) you have to use the 'page' query variable:

<?php  $paged = (get_query_var('page')) ? get_query_var('page') : 1;  ?>
<h1>Currently Browsing Page <?php echo $paged; ?> On a static front page</h1>

Note: The query variable 'page' holds the pagenumber for a single paginated Post or Page that includes the  Quicktag in the post content.

Notes

See WP_Query::get()
Uses global: (object) $wp_query

Change Log

Since: 1.5.0

Source File

get_query_var() is located in wp-includes/query.php.

Class: WP_Query - Detailed overview of the WP_Query class
Class: $wpdb - Overview of using the $wpdb object
Function: get_query_var()
Function: query_posts() - Make additional custom queries
Function: get_posts() - A specialized function that returns an array of posts
Function: get_pages() - A specialized function that returns an array of pages
Function: have posts() - A conditional that determines if the query returned any posts
Function: the_post() - Used to automatically set up the loop after a query
Function: rewind_posts() - Resets the current loop
Function: setup_postdata() - Setup query data for individual results within a loop
Function: wp_reset_postdata() - Restores the previous query (usually after a loop-within-a-loop)
Function: wp_reset_query()
Function: is_main_query() - Ensures the query being changed is only the main query
Action Hook: pre_get_posts - Modify WordPress queries before they are executed
Filter Hook: found_posts - Modify the WP_Query object's found_posts value
Tutorial: Displaying Posts Using a Custom Select Query
Tutorial: Making Advanced Taxonomy Queries
Tutorial: Making Custom Queries using Offset and Pagination

See also index of Function Reference and index of Template Tags.

WordPress.org

Codex