Secondary WordPress Loops

 –  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.

Related Reading:

Web Coding Bible (18 Books in 1 -- HTML, CSS, Javascript, PHP, SQL, XML, SVG, Canvas, WebGL, Java Applet, ActionScript, htaccess, jQuery, WordPress, SEO and many more): An Accelerated CourseWeb Coding Bible (18 Books in 1 -- HTML, CSS, Javascript, PHP, SQL, XML, SVG, Canvas, WebGL, Java Applet, ActionScript, htaccess, jQuery, WordPress, SEO and many more): An Accelerated Course

This special-sized book teaches all essential web technologies from A to Z. Skillfully written, extremely succinct, with a lot of tables, diagrams,... Read More >

Programming: JAVA:  Java Programming, JavaScript, Coding: Programming Guide: LEARN IN A DAY! (JAVA, HTML, Python, SQL, App, iphone, Website Design, Word Press)Programming: JAVA: Java Programming, JavaScript, Coding: Programming Guide: LEARN IN A DAY! (JAVA, HTML, Python, SQL, App, iphone, Website Design, Word Press)Discover the Easy Way to Learn Java and JavaScript! 2nd Edition - New content added at No Additional Cost!
★ Read this book for FREE on Kindle... Read More >
R: In 8 Hours, For Beginners, Learn Coding Fast! R Programming Language, R Crash Course, R QuickStart Guide, and R Tutorial Book by the R Program Example, In Easy Steps! An Ultimate Beginner's Guide!R: In 8 Hours, For Beginners, Learn Coding Fast! R Programming Language, R Crash Course, R QuickStart Guide, and R Tutorial Book by the R Program Example, In Easy Steps! An Ultimate Beginner's Guide!This is a zero-risk investment, If you are not satisfied with the eBook, you can get a full refund within 7 days!

About This Book
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?