PHP Scripts and Programming

PHP scripts, programs and downloads for use by webmasters around the world.

Quick links: content, navigation, search.

Navigation

Secondary WordPress Loops

December 11th, 2009 – Category: WordPress Programming – 2 Comments »

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:

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

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

<?php
if ($wp_query->have_posts()) :
  while ($wp_query->have_posts()) :
    $wp_query->the_post();
?>

… regular loop style WP code such as…

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

… 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>
  <div class='alignright'>
    <?php previous_posts_link('Newer Entries &raquo;') ?>
  </div>
</div>

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.

2 Responses to “Secondary WordPress Loops”

Loren Says:
January 22nd, 2010 at 9:55 am
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.
Loren Says:
January 22nd, 2010 at 9:56 am
hmmm…. how to make the code show up as text?