WordPress Plugin: List Category Posts

This plugin List Category Posts has reached almost 400,000 downloads in less than 4-years (up to 28/03/2013 as I write this update), which is always a good sign of a valued plugin.

I have to say that the plugin works perfectly in a range of positions such as sidebars, within posts, etc., and personally I think it is a really great piece of work.

The programmer is Picando Código and according to its description the plugin provides pretty much everything that one could hope for:

  • name - To display posts from a category using the category’s name
    Ex: [catlist name=mycategory]
  • id - To display posts from a category using the category’s id
    Ex: [catlist id=24]
  • orderby - To customize the order. Valid values are:
    • author - Sort by the numeric author IDs
    • category - Sort by the numeric category IDs
    • content - Sort by content
    • date - Sort by creation date
    • modified - Sort by last modified date
    • title - Sort by title
  • order - How to sort orderby. Valid values are:
    • ASC - Ascending (lowest to highest)
    • DESC - Descending (highest to lowest)
      Ex: [catlist name=mycategory orderby=title order=asc]
  • numberposts - Number of posts to return. Set to 0 to use the max number of posts per page. Set to -1 to remove the limit. Default: 5
    Ex: [catlist name=mycategory numberposts=10]
  • date - Display post’s date next to the title. Default is ‘no’, use date=yes to activate it
  • author - Display the post’s author next to the title. Default is ‘no’, use author=yes to activate it
  • excerpt - Display the post’s excerpt. Default is ‘no’, use
  • catlink – Show the link to the category. Use the template system to customize its display using the variable $cat_link_string. Default is ‘no’
    Ex: [catlist catlink=yes]
  • comments – Show comments count for each post. Default is ‘no’.
    Ex: [catlist comments=yes]</li>

Sounds too good to be true, yes..?

Last Update: 10 January 2011

Categories:Wordpress Tips

4 Responses to “WordPress Plugin: List Category Posts”

  1. 16 January 2011 at 4:30 am #

    Hi, I’m the developer for List Category Posts.

    The plugin started as a short script I used for my personal blog two years ago. I decided to submit it to WordPress because I thought someone else might find it useful. Apparently more than a thousand WordPress users did. Not 89.000, since that’s the total number of downloads. And every new version download counts, even if it’s from the same user.

    Anyway, people started asking for new features, so I started adding them whenever I had some free time as a hobby. And that’s how the plugin is still being mantained. I’m not even strong with PHP coding, this is the only PHP coding I do at all.

    Whenever I do an update, I generally hack in the new functionality and sort of test in on my blog, but don’t really have a professional development environment around it. It’s just a hobby for me, and since I’m not charging for it, I guessed people would understand this. Also, this is free software, you are free to modify and redistribute this software as long as you respect the GPL.

    Knowing this, the plugin has had a lot of code contributions and fixes from different users. There’s some old code which hasn’t been revised like the one you mention on your first example. This will be fixed on the next release.

    But the second example don’t really make sense. The default template file is for users to take as an example.

    If you check the code, there’s a couple of To-do’s before I release a 1.0 version, which would mean I consider the plugin “stable and complete”. I’m on version 0.14 now, and I’m not really sure when 1.0 will be reached. But simplifying the template system to make it user friendly. Something like a short code or WYSIWYG editor for the users to have a pretty simple way to use the plugin as they like.

    Haven’t had time to implement this. As I said, this plugin is a hobby for me, but I do take in consideration user feedback and code contributions for it’s development.

    Hope I get to a 1.0 version soon, so that you can try the plugin again, see if it works for you then.


  2. Soccerwidow
    16 January 2011 at 5:42 pm #

    Hi Fernando,

    I apologize should my review have offended you, I certainly didn’t mean it. On the contrary I’m very grateful to all you guys who are constantly developing new plugins and all this open source software because without this input amateurs like me would never be able to have their own website.

    However, what I would recommend is that you take out the misleading descriptions, and be honest about the things the plugin can do and cannot do. I certainly would have found it beneficial if somewhere I would have read that the plugin is not finished yet, and that you do it as a hobby, and that the plugin is still being maintained. and you are not “not even strong with PHP coding” – all this stuff.

    Then I would not have expected a perfect working plugin and saved myself one and a half day trying to fix something far beyond my skills.

    Greetings to Uruguay,

  3. 16 January 2011 at 11:55 pm #

    Don’t worry I didn’t feel offended, I understand you. I myself have felt frustrated with software several times, but it’s ok as long as we recognize the effort developers invest in coding.

    Now, thanks to your post, I realized the catlink parameter was not working, so I fixed it on version 0.14.1, so thanks for that!

    Regarding the misleading descriptions of the plugin, could you please let me know which parts you consider misleading? It may happen that something breaks on an update, but I think there’s nothing there the plugin doesn’t actually do.

    About the “finished version” of the plugin, there’s a wise saying that goes: “Software projects are never finished, they are abandoned”
    The version number of the plugin shows the 1.0 (generally considered stable release) hasn’t been reached yet.

    Anyway, never mind, sorry for the trouble you went through with the plugin, hope you changed your mind at least a bit about it :)


  4. Das
    12 February 2011 at 4:29 pm #

    I’m in the middle of developing a WP multisite network, and I’ve network-activated the plugin List Category Posts. I wanted to use it to call in posts from different categories to targeted sections on the home page (apart from the main blog section), and this was possible to do by creating pages, inserting the appropriate catlist shortcode, and then using php code to call the page into the targeted sections on the home page. It works very well, for my purposes, and behaves just according to the parameters set within the shortcode, with one exception – it is not calling the thumbnails along with the posts. But I confess that I have not identified the hangup: it is possible that it is a problem unrelated to the plugin. Fernando has also updated the plugin to correct the path to the template files from STYLESHEETPATH to TEMPLATEPATH, since the former sends the plugin looking for a template inside the child theme’s folder whereas the templates are supposed to be located inside a folder inside the parent theme. (The correct call to the parent theme’s folder is TEMPLATEPATH.) So I’m one happy List Category Posts user.

Leave a Reply

seven × = 7

Notify me of followup comments via e-mail. You can also subscribe without commenting.