WordPress.org

Plugin Directory

List category posts

List Category Posts allows you to list posts by category in a post/page using the [catlist] shortcode. This shortcode accepts a category name or id, t

This plugin is looking for maintainers! Please take a look at this issue on GitHub.

List Category Posts allows you to list posts by category in a post or page using the [catlist] shortcode. When you're editing a page or post, directly insert the shortcode in your text and the posts will be listed there. The basic usage would be something like this:

[catlist id=1]
[catlist name="news"]

The shortcode accepts a category name or id, the order in which you want the posts to display, and the number of posts to display. You can also display the post author, date, excerpt, custom field values, even the content! A lot of parameters have been added to customize what to display and how to show it. Check the full documentation to learn about the different ways to use it.

The [catlist] shortcode can be used as many times as needed with different arguments on each post/page.

[catlist id=1 numberposts=10]

There's an options page with only one option -for the moment-, new options will be implemented on demand (as long as they make sense). Right now the only global option is the numberposts parameter, to define a default number of posts to show for each instance (you can override this value by using the numberposts parameter in your shortcode).

Read the instructions to learn which parameters are available and how to use them.

If you want to List Categories instead of posts you can use my other plugin List categories.

You can find Frequently Asked Questions here.

Customization

The different elements to display can be styled with CSS. you can define an HTML tag to wrap the element with, and a CSS class for this tag. Check Other Notes for usage.

Great to use WordPress as a CMS, and create pages with several categories posts.

Widget

The plugin includes a widget which works pretty much the same as the plugin. Just add as many widgets as you want, and select all the available options from the Appearence > Widgets page. Not all the functionality in the shortcode has been implemented in the widget yet. You can use the shortcode for the most flexibility.

Please, read the information on Other Notes and Changelog to be aware of new functionality, and improvements to the plugin.

Videos

Some users have made videos on how to use the plugin, (thank you! you people are awesome!). Check them out here:

Support the plugin

If you've found the plugin useful, consider making a donation via PayPal or visit my Amazon Wishlist for books or comic books :).

Development

Development is being tracked on GitHub. Fork it, code, make a pull request, suggest improvements, etc. over there. I dream of the day all of the WordPress plugins will be hosted on Git :)

Requires: 3.3 or higher
Compatible up to: 4.4.2
Last Updated: 1 month ago
Active Installs: 100,000+

Ratings

4.7 out of 5 stars

Support

4 of 38 support threads in the last two months have been marked resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,1,1
100,3,3 100,1,1
63,8,5 0,1,0 0,1,0
75,4,3 13,8,1 100,1,1 100,3,3
60,10,6 100,1,1 100,11,11
50,2,1 72,18,13
50,2,1 100,6,6 100,1,1 100,1,1 100,1,1 100,2,2
100,3,3 77,26,20 67,6,4 67,3,2 50,2,1
100,5,5
100,6,6
100,2,2 100,1,1 100,2,2
100,1,1 33,3,1
100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 53,15,8
100,4,4 100,1,1
80,5,4
100,7,7
100,1,1
75,4,3 100,1,1
70,20,14 100,2,2 50,4,2 67,3,2 25,4,1 100,1,1 100,4,4 100,2,2 100,1,1 0,1,0 100,9,9 100,2,2 0,1,0 100,1,1
100,1,1 50,2,1 100,1,1 100,4,4 100,2,2
86,7,6 100,1,1 100,5,5 90,21,19 83,6,5
84,25,21
100,1,1
86,21,18 100,1,1
87,15,13 100,2,2 100,1,1
50,4,2 100,1,1 100,4,4 100,1,1 100,3,3 100,2,2 100,2,2
100,2,2 100,3,3 100,1,1 92,13,12 100,2,2 100,12,12
83,6,5
100,8,8
100,4,4 100,3,3 100,1,1 100,3,3 100,1,1
100,1,1 100,1,1
100,1,1 25,4,1 50,2,1 100,3,3 100,3,3 100,5,5 100,3,3 100,2,2 100,3,3 100,1,1 100,1,1
100,2,2 100,1,1 100,2,2 100,2,2 100,3,3 100,2,2 0,1,0 100,1,1
100,2,2 50,2,1 100,1,1 100,2,2 80,5,4 50,2,1 100,2,2 100,1,1 100,5,5
100,1,1
100,5,5
100,4,4 100,2,2 100,3,3 100,1,1 50,2,1 100,2,2
67,3,2 100,2,2
100,7,7 0,1,0
100,4,4
67,3,2 100,2,2 100,2,2 100,1,1 50,2,1 75,4,3 100,2,2 100,1,1
100,3,3 100,2,2 67,3,2 100,1,1 50,2,1
0,3,0 100,7,7 100,6,6
100,1,1 100,1,1 67,3,2 100,1,1
100,1,1 83,6,5 25,4,1 100,3,3
100,3,3
100,3,3
71,7,5 100,2,2