Help us to improve the Codex by filling out our documentation survey!Function Reference/wp reset query
Languages: English • Italiano • (Add your language)
Contents |
Description
wp_reset_query() restores the $wp_query and global post data to the original main query. This function should be called after query_posts().
Usage
<?php wp_reset_query(); ?>
Parameters
This function does not accept any parameters.
Return Values
This function does not return any values.
Examples
The following example shows how to use wp_reset_query() after a custom loop. Note that the loop in the example is probably being used in addition to the main loop.
<?php
$args = array ( 'post_parent' => 5 );
$custom_query = new WP_Query( $args );
if ( $custom_query->have_posts() ):
while ( $custom_query->have_posts() ) :
$custom_query->the_post();
// Do stuff with the post content.
the_title();
the_permalink(); // Etc.
endwhile;
else:
// Insert any content or load a template for no posts found.
endif;
wp_reset_query();
?>
query_posts() will change your main query and is not recommended. Only use if absolutely necessary (see query_posts: Caveats). Creating a new instance of WP_Query or get_posts() is preferred for secondary loops. If you would like to modify the main query, use the pre_get_posts action.
<?php query_posts( 'post_parent=5' ); if ( have_posts() ) : while ( have_posts() ) : the_post(); ?><a href="<?php the_permalink() ?>"><?php the_title() ?></a><br /><?php endwhile; endif; wp_reset_query(); ?>
Change Log
- Since: 2.3.0
Source File
wp_reset_query() is located in wp-includes/query.php.
Related
- 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
