wp_reset_postdata()

After looping through a separate query, this function restores the $post global to the current post in the main query.

Contents

Description Description

Source Source

File: wp-includes/query.php 

function wp_reset_postdata() {
	global $wp_query;

	if ( isset( $wp_query ) ) {
		$wp_query->reset_postdata();
	}
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/class-wp-query.php: WP_Query::reset_postdata()

After looping through a nested query, this function restores the $post global to the current post in this query.

Top ↑

User Contributed Notes User Contributed Notes

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

    WARNING, only reset the post data if the query is successful…

    $query = array(
   //some post query parameters
  );
$post_results = get_posts($query);
if(!empty($post_results)){
  //do something with your query results
  //invoke post data reset here
  wp_reset_postdata();
}
//if you invoke it after the check and the result did not return any posts, it will reset the post data from a previous query
wp_reset_postdata(); // WRONG
  2. Skip to note 2 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 —

    Example of secondary loop and reset

    <?php
// example args
$args = array( 'posts_per_page' => 3 );

// the query
$the_query = new WP_Query( $args );
?>

<?php if ( $the_query->have_posts() ) : ?>

	<!-- start of the secondary loop -->
	<?php while ( $the_query->have_posts() ) : $the_query->the_post(); ?>
		<?php the_title(); ?>
		<?php the_excerpt(); ?>
	<?php endwhile; ?>
	<!-- end of the secondary loop -->

	<!-- put pagination functions here -->

	<!-- reset the main query loop -->
	<?php wp_reset_postdata(); ?>

<?php else:  ?>

	<p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>

<?php endif; ?>

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.