Secondary WordPress Loops


In coding WordPress plugins and themes, I have often found it necessary to create secondary WordPress loops in the code to show a list of articles or posts on the site that wouldn’t normally appear on the page used to display them. For example, on the homepage of this site, I list articles from three different blog categories in three different lists. The way in which this is accomplished is relatively simple and straightforward.

First, you have to create a new instance of the WP_Query object from WordPress. Due to some complications with the WordPress code, you will need to store the original $wp_query variable in a $temp variable, and override it with your own.  You would do this with something like the following code:

$temp = $wp_query;
$wp_query = null;
$wp_query = new WP_Query(); 

This constructs a new WP Query object for you which you can then use for subsequent calls in the loop.  Once you’ve constructed this object, you will want to define your query variables and run your query.

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$query = 'cat=5&paged=' . $paged;    // Query to pull posts from category ID 5
$wp_query->query($query);  // Run the query on the $newposts object.

Now that you have retrieved the necessary posts from your blog, you can begin your secondary loop.  The format is slightly different however, in that you should run the have_posts() methods on the new object, rather than as WP functions as is seen below.

if ($wp_query->have_posts()) :
  while ($wp_query->have_posts()) :

… regular loop style WP code such as…

  <a href="<?php the_permalink() ?>" rel="bookmark"
     title="Permanent Link to <?php the_title(); ?>"
     ><?php the_title(); ?></a>

… then close the loop.

<?php endwhile; endif; ?>

If necessary you can also add paging controls with the following:

<div class='navigation'>
  <div class='alignleft'>
    <?php next_posts_link('&laquo; Older Entries') ?>
  <div class='alignright'>
    <?php previous_posts_link('Newer Entries &raquo;') ?>

Finally, you need to restore the original $wp_query variable with what you stored in $temp.

<?php $wp_query = null; $wp_query = $temp; ?>

I’d love to hear your feedback on this or if you have any suggestions to improve it.  Feel free to comment.

Related Reading:

WordPress: The Missing Manual (Missing Manuals)WordPress: The Missing Manual (Missing Manuals)

WordPress lets you build everything from a simple blog to a full-blown, dynamic website, but the program's rich feature set can be difficult to mas... Read More >

Wordpress for Beginners 2017: A Visual Step-by-Step Guide to Mastering WordPressWordPress for Beginners 2017: A Visual Step-by-Step Guide to Mastering WordPress

Master WordPress using our step-by-step visual approach (over 250 screenshots). Updated 5th June 2017. Now also includes a comprehensive index. Read More >

WordPress: Visual QuickStart Guide (3rd Edition)WordPress: Visual QuickStart Guide (3rd Edition)Provides step-by-step instructions on using WordPress to create and maintain blogs and Web sites.
Filed in: Code Snippets, WordPress Related

2 Responses to “Secondary WordPress Loops”

  1. Loren Says:

    I guess I don’t understand why one would want to reuse the $wp_query variable. Why not just create a new variable such as $myNew_query = new WP_Query(); and just leave the original $wp_query as is and run any secondary loops on their own named query objects?
    `Five Most Recent Articles on…`

    `have_posts()) : $recentPosts->the_post(); ?>`
    `<a href="” rel=”bookmark”> by `

    That way in the code the variable naming can make it is clear what this particular snippet is doing.

  2. Loren Says:

    hmmm…. how to make the code show up as text?