Question

wp_reset_query()

Destroys the previous query and sets up a new query.

---

description

This should be used after query_posts() and before another query_posts(). This will remove obscure bugs that occur when the previous WP_Query object is not destroyed properly before another is set up.

---

源代码

File: wp-includes/query.php

function wp_reset_query() {
	$GLOBALS['wp_query'] = $GLOBALS['wp_the_query'];
	wp_reset_postdata();
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/query.php: wp_reset_postdata()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Using after a Custom Loop

   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 );
   query_posts( $args );
   
   if ( have_posts() ):
       while ( have_posts() ) :
           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. Be sure to put your pre_get_posts filtering in your functions.php file.

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