Latest TweetsNew version of Disable Gutenberg includes options to disable for specific theme templates and/or post/page IDs. wordpress.org/plugins/disable-…
Perishable Press

Horizontally Sequenced Display Order for WordPress Posts in Two Columns

Most WordPress-powered blogs display posts in sequential order within a single column. Like this, for example:

[ Diagram: Default WordPress Post Display Order ]

But what if you wanted to display your posts in two columns, sequentially ordered from left to right? For example:

[ Diagram: Horizontally Sequenced WordPress Post Display Order ]

This is easily accomplished using two default loops and the rewind_posts() function. The first loop will display the posts in the first column, while the second loop will display the posts in the second column. To do this, we use PHP’s modulus operator to filter out every other post from the first loop, which will display posts as follows:

  • the first most recent post
  • the third most recent post
  • the fifth most recent post

..and so on. Meanwhile, the second loop will feature all of the posts that were filtered out of the first loop:

  • the second most recent post
  • the fourth most recent post
  • the sixth most recent post

and so on, depending on the specified number of displayed posts. As you can see, this configuration divides the posts into “odd” and “even” groups. Note that there is nothing inherently “odd” or “even” about the posts in either group; we are arbitrarily assigning “oddness” and “evenness” based on location of each post within the default sequence. Thus, posts with odd-numbered IDs may appear in the “even” loop and vice versa. having said that, let’s examine the code that will make this happen:

<?php if (have_posts()) : while(have_posts()) : $i++; if(($i % 2) == 0) : $wp_query->next_post(); else : the_post(); ?>

<div id="left-column">
<h1><?php the_permalink(); ?></h1>
<?php the_content(); ?>
</div>

<?php endif; endwhile; else: ?>
<div>Alternate content</div>
<?php endif; ?>

<?php $i = 0; rewind_posts(); ?>

<?php if (have_posts()) : while(have_posts()) : $i++; if(($i % 2) !== 0) : $wp_query->next_post(); else : the_post(); ?>

<div id="right-column">
<h1><?php the_permalink(); ?></h1>
<?php the_content(); ?>
</div>

<?php endif; endwhile; else: ?>
<div>Alternate content</div>
<?php endif; ?>

With that code in place, oddly numbered posts will appear within a division identified with an attribute of id="left-column". Likewise, even-numbered posts will appear within a division identified with an attribute of id="right-column". Thus, we may apply the following CSS to position the divisions as two adjacent columns:

div#left-column {
	width: 333px;
	float: left;
	clear: none;
	}
div#right-column {
	width: 333px;
	float: right;
	clear: none;
	}

Of course, when it comes to configuring the WordPress loop and styling your page with CSS, anything is possible. Feel free to experiment and adapt this technique to suit your own diabolical purposes ;) For now, let’s continue with an explanation of the functionality behind this dual-loop technique.

Technical Breakdown

Perhaps the most straightforward way to explain the dual-loop code is to break it down line-by-line via comments placed within the code itself:

// initiate the default wordpress loop as usual
<?php if (have_posts()) : while(have_posts()) : 

// set a count variable to increase with each loop
$i++; 

// test the variable modulus against a zero value
// odd values return true, even values return false
// see proceding discussion for more information
if(($i % 2) == 0) : 

// skip to next post if variable is an even number
$wp_query->next_post(); 

// display the post if variable is an odd number
else : the_post(); ?>

// open a division for the left column
<div id="left-column">

// display the title of the post
<h1><?php the_permalink(); ?></h1>

// display the post content
<?php the_content(); ?>

// close the division
</div>

// close the first if statement
<?php endif; 

// close the loop
endwhile; 

// if there are no posts that meet the criteria
else: ?>

// display some alternate content
<div>Alternate content</div>

// close the second if statement
<?php endif; ?>

// reset the count variable to zero
<?php $i = 0; 

// reset the loop
rewind_posts(); ?>

// the second loop is essentially the same as the first
// the only difference is that we are testing the count variable against a non-zero value to display only even numbers
<?php if (have_posts()) : while(have_posts()) : $i++; if(($i % 2) !== 0) : $wp_query->next_post(); else : the_post(); ?>

// and of course a unique div id for the right column
<div id="right-column">
<h1><?php the_permalink(); ?></h1>
<?php the_content(); ?>
</div>

<?php endif; endwhile; else: ?>
<div>Alternate content</div>
<?php endif; ?>

As for the crazy PHP modulus operator ( % ), suffice it to say that its purpose is to test the oddness or evenness of the $i variable. The modulus operator returns the numerical remainder resulting from the division of the $i variable by the specified number (“2” in this case). In the first loop, because all even post numbers are evenly divisible by two, the modulus is equal to zero and thus the evenly numbered posts are skipped until the next loop. In the second loop, the odd post numbers are not evenly divisible by two, resulting in a non-zero numerical remainder. Thus, in the second loop, we test that the modulus is not equal to zero, thereby skipping the oddly numbered posts. Perhaps this numerical pattern will help clarify the concept:

  • Post #1: $i = 1 [remainder of 1/2 = 1]
  • Post #2: $i = 2 [remainder of 2/2 = 0]
  • Post #3: $i = 3 [remainder of 3/2 = 1]
  • Post #4: $i = 4 [remainder of 4/2 = 0]
  • Post #5: $i = 5 [remainder of 5/2 = 1]
  • Post #6: $i = 6 [remainder of 6/2 = 0]
  • Post #7: $i = 7 [remainder of 7/2 = 1]
  • Post #8: $i = 8 [remainder of 8/2 = 0]

From this we can see how testing the modulus against zero (or non-zero) results in two groups of (odd and even) numbers. For more mental torture, here is more information on the PHP modulus operator. But enough of this boring math stuff — let’s move on, shall we?

Pure CSS Method

As the astute reader may have observed, displaying two columns of horizontally sequenced posts is also possible using a single, default WordPress loop and a little bit of CSS. Consider the following code:

<div id="container_division">
<?php if (have_posts()) : while (have_posts()) : the_post(); ?>

<div class="post-block">
<h1><?php the_permalink(); ?></h1>
<?php the_content(); ?>


</div>

<?php endwhile; else: ?>
<?php endif; ?>
</div>

With each post enclosed within a “post-block” division (i.e., <div class="post-block">), we can achieve a two-column post-display similar to that generated via the dual-loop method by declaring a width for each of the post blocks and then placing them within a fixed-width container division. Or, to express this idea visually:

[ Diagram: Two Columns of Horizontally Sequenced Divs ]

With all of the post-block divisions floated to the left, they will automatically “stack” according to the diagram. Here’s an example of CSS that would make this work:

div.post-block {
	width: 333px;
	float: left;
	clear: none;
	}
div#container_division {
	width: 700px;
	}

As useful as this “pure-CSS” technique happens to be, it is not as flexible as the dual-loop version. Independently functioning loops provide greater control over layout and thus greater design flexibility. For example, using two individual loops, the post columns need not appear side-by-side, but may be placed anywhere on the page.

Peace Out

That’s it for this Perishable Press tutorial. If you have any questions, concerns, or criticisms, please share them in the comments section for this article. As always, thanks for reading! :)

Jeff Starr
About the Author Jeff Starr = Web Developer. Book Author. Secretly Important.
Archives
58 responses
  1. Chris: Not sure exactly what the issue is (perhaps someone else can be more specific in their assistance) but the following article was very helpful whilst working with this tutorial. Check out the overflow properties of your divs.

    http://warpspire.com/tipsresources/web-production/css-column-tricks/

  2. Jeff Starr

    @Chris: There are so many different things involved with any given layout that it is difficult to troubleshoot and solve problems without a working example to look at. I am sure that someone here would be able to help you if you provided a link to a test case demonstrating the issue.

  3. Hey guys, thanks for getting back to me. I just tried it out using a new theme and it seems to be working fine so far! If I run into bother and require your assistance once more, I’ll be sure to check back in, but for now, that is all. :] Keep up the great work, it’s much appreciated!

  4. I want to have 3 columns going horizontally, so, post 1, post 2 and post 3 all on the same line. I just wanted to use CSS and use the float method but it all just stacks vertically no matter what I do. It’s not width or padding causing it, do you have any suggestions? It’s really driving me quite bonkers :)

  5. Jeff Starr

    @Chris: Great to hear that you got it working! Thanks for the follow-up! :)

    @Frances: See comment #38; the idea expressed there would apply to your question as well..

  6. Thanks a lot for this tutorial, I had been looking for it for a long time;
    but I’m not able to make it work out properly… http://www.boqueria.eu/wordpress/ if you have any idea of what’s my problem I would realy apreciate (why the second row is not in its place?)

  7. Jeff Starr

    @FloiT: your site is looking great! It looks like you have resolved the second-row layout issue, yes?

  8. thanks a lot for you comment, mr. Starr (the site is under constructionand it will be, I think, for at least one month).
    Yes, I could solve the problem after three days trying it ! ;) I think this is the best way to learn things (With the help of priceless sites like yours, of course!)

  9. Hi mate, these stuff is amazing! I really appreciate what you wrote here :-)

    I was wondering if you could help me please with a little issue I’m having on this blog: http://www.travelgeneration.com (actually I’m testing it on: http://www.travelgeneration.com/blog/new-blog), here’s the deal:

    I’ve got a last post which I want to show it with a different style (“latestPost” class), then I pause the loop, div’s in between I continue the loop and show 6 more posts -class =”recentPosts”- (without telling the loop to show 6 more, only by stablishing it on the reading settings: post = 7) stating not to duplicate the first post.

    When I click on “next page” it shows the same structure on the following 7 post; but I want to display 6 more instead with the class “recentPosts”.. so what I’ve done is to determine that the first div .latestPost is only displayed if its home page. Now the challenge is to display 6 posts rather than 7 (as it was set on the reading settings). Do I explain myself?

    Hope you can help me mate,

    Thanks again!

    Joaquín.-

  10. hello.

    I am trying to do the 3-column thing… what do you mean by “use the CSS method described in the second half of the post”.

    thank you!!

  11. Jeff Starr

    @will: In the article, the second half of the post covers a “Pure CSS Method” for producing the 2-column layout. By extrapolating this technique, it is possible to create any number of columns featuring horizontally sequenced post order. Simply adjust the block widths so that three will fit inside of your fixed-width parent container and you are good to go.

  12. Jeff Starr

    @Ozh: Post now updated with actual image graphics instead of that atrocious ascii art! ;)

[ Comments are closed for this post ]