WordPress.org

Function Reference/have posts

Languages: English • Italiano • (Add your language)

Description

This function checks to see if the current WordPress query has any results to loop over. This is a boolean function, meaning it returns either TRUE or FALSE.

At the end of the loop, will automatically call rewind_posts.

Usage

<?php have_posts(); ?>

Parameters

This function does not accept any parameters.

Return Values

(boolean): True on success, false on failure.

Examples

The following example can be used to determine if any posts exist, and if they do, loop through them.

<?php
if ( have_posts() ) :
	while ( have_posts() ) : the_post();
		// Your loop code
	endwhile;
else :
	echo wpautop( 'Sorry, no posts were found' );
endif;
?>

Note

Calling this function within the loop will cause an infinite loop. For example, see the following code:

<?php
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.

function more_posts() {
  global $wp_query;
  return $wp_query->current_post + 1 < $wp_query->post_count;
}

Change Log

Since: 1.5.0

Source File

have_posts() 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

Function Reference/have posts

Contents