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:

The substation secondary loop and its failure to handle typical instance(Chinese Edition)The substation secondary loop and its failure to handle typical instance(Chinese Edition)Paperback. Pub Date: 2013 Pages: 358 Language: Chinese in Publisher: China Electric Power Press substation secondary circuit and its failure to deal w... Read More >
Nanoferroics (Springer Series in Materials Science)Nanoferroics (Springer Series in Materials Science)This book covers the physical properties of nanosized ferroics, also called nanoferroics. Nanoferroics are an important class of ceramic materials tha... Read More >
WordPress BibleWordPress BibleA complete and thorough guide to the largest self-hosted blogging tool: WordPress

Has learning WordPress become a pressing issue for you? If so, th... Read More >

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?