WordPress Development Stack Exchange is a question and answer site for WordPress developers and administrators. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I want to list 'n' number of posts (ordered by latest first) -- post's title linked to the post's permalink -- from a tag on my WordPress blog. I also want to assign each link its own class or ID.

I checked this doc on WordPress Codex, which is very relevant to what I need, but makes little sense to me (and I'm therefore unable to modify it to my needs).

Hope I am clear enough, if not, I can try to clarify.

EDIT: Just so it's clear, I want to be able to list the posts wherever I want. Any template.

share|improve this question
Get any theme and look inside (Twenty Eleven for example). You will find there all you need. – Alexey May 2 '12 at 8:46
@Alexey Oh, thanks, I will check. But please note that I want to define the number of posts I want to show, and assign a different class to each post. I don't think any theme has it like that, but I will check anyway. – its_me May 2 '12 at 9:07
Is the main loop (on your taxonomy-term archive page)? Or is a secondary loop in a template page? – Stephen Harris May 2 '12 at 9:18

get_posts() is for 'secondary' loops - ones that exist along-side the main Loop, usually in a side-bar or at the bottom listing 'related' posts etc. get_posts() is called from within a template page. So it is the wrong thing to use here.

You'll want to alter the main query as outlined in: When to use WP_query(), query_posts() and pre_get_posts

function wpse50857_alter_query($query){

      //Check other conditionals depending on when you want to alter the loop
      if( $query->is_main_query() && is_home() ){

        $tax_query = array(array(
                        'taxonomy' => 'post_tag',
                        'field' => 'slug',
                        'terms' => 'my-tag'

Note this over-rides any previous tax_query (this doesn't matter in this context - but if it should you can get the previous tax_query and merge it with the new one...)

Other conditionals available here.

To edit how the posts are display, you'll need to edit the appropriate template page (home.php?, front-page.php?).

The loop will be something like:

if( have_posts() ):
    while( have_posts() ): the_post();
       //The loop 
       <h1 class="entry-title"><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h1>

and you can edit that the display whatever you like.

share|improve this answer
up vote 0 down vote accepted

I don't know PHP, so'll try to explain after showing you the example PHP code that's needed to do what's asked in the question.


<!-- Featured Posts -->
<div id="featured-posts">
    $count = 0;
    $some_featured_posts = new WP_Query(array('tag' => 'example2', 'posts_per_page' => 7));
    while ($some_featured_posts->have_posts()): 
        <div class="featured-posts-wrapper<?php echo $count; ?> featured-posts-wrapper<?php echo ($count == 7) ? ' no-margin-right' : ''; ?>">
            <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><img id="featured<?php echo $count; ?>" class="featured" alt="<?php the_title_attribute(); ?>" src="<?php echo get_post_meta($post->ID, 'image', true); ?>" /></a>
            <a id="featured-text<?php echo $count; ?>" href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><?php the_title(); ?></a>
<!-- Featured Posts -->

PS: I've included the div tags and classes hoping that they'll help the clueless. So, first put the code in a template, and check how and what it outputs, to get a better idea.


  • Add the code in any template of your choice (header.php, index.php, home.php, archive.php, search.php, content.php, or any other). That's where you'll see the output.

  • Change the number (7) in this line to a number that's equal to the number of posts you want it to show:

    $some_featured_posts = new WP_Query(array('tag' => 'example2', 'posts_per_page' => 7));

    In the above code, the 'tag' => 'example2' says that the latest posts tagged "example2" are to be shown. If you want to have a category instead, use 'category_name' => 'example2'

  • In this line:

    <div class="featured-posts-wrapper<?php echo $count; ?> featured-posts-wrapper<?php echo ($count == 7) ? ' no-margin-right' : ''; ?>">

    I use class="featured-posts-wrapper<?php echo $count; ?> so that I can have a different class for each post that's output. To be specific, the code above outputs as class="featured-posts-wrapper1" for the first post, class="featured-posts-wrapper2" for the second post, and so on.

    On the other hand, <?php echo ($count == 7) ? ' no-margin-right' : ''; ?> allows you to set a specific class for the last entry (as per the example, the 7th post). The code above, adds no-margin-right class to the last post in the output.

  • In this line:

    <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>"><img id="featured<?php echo $count; ?>" class="featured" alt="<?php the_title_attribute(); ?>" src="<?php echo get_post_meta($post->ID, 'image', true); ?>" /></a>

    <?php echo get_post_meta($post->ID, 'image', true); ?> outputs the image URL you assigned to the post using the "image" custom field and its value (an image URL).

  • Rest of the values I used are pretty standard. <?php the_permalink(); ?> outputs the permalink URL, <?php the_title_attribute(); ?> and <?php the_title(); ?> output the title of the post.

Here's an example of what you can pull off (you can actually do anything):


share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.