have_posts(): bool

User Contributed Notes

1. Skip to note 5 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note

   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;
2. Skip to note 6 content

   Codex 9 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   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.php file:

   /**
    * 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;
3. Skip to note 7 content

   Muhammad Jawad Abbasi 3 years ago

   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

   <?php if ( have_posts() ) : while( have_posts()  ) : the_post(); ?>
       <h1><?php the_title(); ?></h1>
       <a href="<?php the_permalink(); ?>">
           <?php the_post_thumbnail( 'full' ); ?>
       </a>
       <p><?php the_excerpt(); ?></p>
   <?php endwhile; endif; ?>

   Output:
   Post title
   Post featured full size image (When anyone click on the image then open post single page)
   Post small description

   Edited by @audrasjb: Small WPCS fixes.
4. Skip to note 8 content

   johnhawley 2 years ago

   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

   Example: if creating a custom WP_Query out of the standard WP loop context. This example uses have_posts() function extended from WP_Query:

   <?php
   // Define args
   $args = array('post_type' => 'custom_post_type');
   
   // Execute query
   $cpt_query = new WP_Query($args);
   
   // Create cpt loop, with a have_posts() check!
   if ($cpt_query->have_posts()) :
     while ($cpt_query->have_posts()) : $cpt_query->the_post(); ?>
   
       <?php the_title(); ?>
   
   <?php endwhile;
   endif; ?>

   • Infinite loop? Loop that hangs your website? Look at the section about Infinite Loops then scan through the other solutions (that didn’t work for me) and finally I came up John Hawley’s comment and that works for me. Thanks to John for posting!

     provopeople 2 weeks ago