have_posts()
Whether current WordPress query has results to loop over.
Description
Return
(bool)
Source
File: wp-includes/query.php
function have_posts() {
global $wp_query;
return $wp_query->have_posts();
}
Changelog
| Version | Description |
|---|---|
| 1.5.0 | Introduced. |
More Information
This function checks whether there are more posts available in the main WP_Query object to loop over. It calls have_posts() method on the global $wp_query object.
If there are no more posts in the loop, it will trigger the loop_end action and then call call rewind_posts() method.
Default use:
The following example can be used to determine if any posts exist and loop through them if they do.
if ( have_posts() ) : while ( have_posts() ) : the_post(); // Your loop code endwhile; else : _e( 'Sorry, no posts were found.', 'textdomain' ); endif;Avoiding infinite loops:
Calling this function within the loop will cause an infinite loop. For example, see the following code:
while ( have_posts() ) : the_post(); // Display post if ( have_posts() ) : // If this is the last post, the loop will start over // Do something if this isn't the last post endif; endwhile;If you want to check if there are more posts in the current loop without this unfortunate side effect, you can use this function:
In your
functions.phpfile:/** * Check if a loop has any more posts left. * * @global $wp_query * * @return bool True if there are any more posts in this loop, false if not. */ function wpdocs_has_more_posts() { global $wp_query; return $wp_query->current_post + 1 < $wp_query->post_count; }In your template file:
while ( have_posts() ) : the_post(); // Display post if ( wpdocs_has_more_posts() ) : // Do something if this isn't the last post endif; endwhile;