Did you know?
- 👷🏻 This plugin is actively maintained and contributors are really committed to it!
- 🎖 Excellent plugin. It's one of the Top 100 WordPress plugins here.
- ❤️ Mindblowing! More than 105,010 people use plugins from this team.
- 🏂 84% of 100,000+ users are on the latest version.
- 📥 Seems like a popular plugin - 598 people download this plugin everyday.
- 👨👨👧👧 One man show!! Only a single contributor for this plugin.
- 📢 Aweful or Awesome?? 147 total updates and 147 in just last 12 months. That's a lot!
- 🎂 This plugin is going to celebrate it's 11th anniversary after 3 weeks.
- 100,000+ Active Installs
- 4.7 Avg. Users Rating
- 215 Total Ratings
- 2,265,908 Total Downloads
- 2008-08-16 Added
- 147 Releases in 12 Months
- 2018-10-10 Last Update
- 0.79 Current Version
|1||List category posts||4.4||100,000+||4.7|
|2||Category to Pages WUD||1.3||8,000+||4.7|
|4||Awesome Featured Post Widget||1||30+||5|
|5||Recent Posts Shortcode & Widget||1||1,000+||5|
|6||WP Fanatico Display Recent Posts Shortcode||0.9||70+||5|
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.
[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.
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 the documentation for usage. You can also check this nice tutorial which gives lots of tips and how-to’s to customize how to display the posts.
Great to use WordPress as a CMS, and create pages with several categories posts.
Klemens Starybrat has created a GUI for List Category Posts. It helps you create a shortcode from a nice visual interface in WordPress’ text editor. Check it out:
GUI for List Category Posts
Since WordPress 4.9, you can use shortcode in text widgets. So you can just add a text widget in Appearence > Widgets and write the List Category Posts shortcode.
The plugin also includes a widget as a simple interface for its functionality. 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.
Some users have made videos on how to use the plugin (thank you, you are awesome!), check them out here:
- Manage WordPress Content with List Category Posts Plugin
- WordPress: How to List Category Posts on a Page
Support the plugin
If you’ve found the plugin useful, consider making a donation via PayPal.
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 🙂
Since the documentation on how to use the plugin has passed wordpress.org’s character limit, the text was cut. I’ve since started using a wiki for more comfortable reading and maintaining. Please check it out, suggestions are welcome on GitHub issues!
Instructions on how to use the plugin
Below you can find common shortcode use cases. You can use the shortcode while editing posts, pages, custom post types, text widgets and in all “page builder” plugins that support shortcodes.
Read the full documentation to discover many more features, including:
- advanced post selection options (by date, search terms, custom fields, post types, custom taxonomies and more)
- output customizations (show each post’s date, author, excerpt, thumbnail and more)
- custom templates of your own design, based on a simple PHP example
List 10 latest posts:
The default number of listed posts is 10, to modify it you need to specify
List posts from the “Dogs” category:
List posts from the category with id
By default only the “post” post type is included. To list pages use:
and for both posts and pages:
If we combine the above options we can get a shortcode that lists 15 items, including post and pages, from the “Dogs” category:
[catlist name=Dogs post_type=”post,page” numberposts=15]
Most of the parameters you will find in the documentation can be used together.
The plugin can detect current post’s category and use it for listing:
Same goes for tags:
To show each post’s excerpt use:
If you want to show the date, author and comments count next to each post, use:
[catlist date=yes author=yes comments=yes]
You can specify html tags and classes for many elements. Let’s modify the previous shortcode and wrap dates and authors in tags and classes of our choice:
[catlist date=yes date_tag=span date_class=”my-date” author=yes author_tag=p author_class=”my-author” comments=yes]
Read more about this feature
You can order posts by date:
You can also use
ID. More options are described in the documentation.
The plugin also supports pagination. You need to specify
numberposts to tell the plugin how many posts per page you want:
[catlist pagination=yes numberposts=5]
See the wiki: Pagination for more information.
Please read the full documentation for detailed documentation of all plugin features, use cases and shortcode parameters.
Was this useful?
Would you recommend this plugin summary to your friends?
Thank you for your feedback
Try these other plugins too...
Schedule complete automatic backups of your WordPress installation. Decide which content will be stored (Dropbox,…
Want a nifty, cutting-edge, retina-ready, responsive html5 audio player for your site ? ZoomSounds is…
Latest Version: 08.04.2014 – v3.0. Check the changelog Ajax Multi Upload for WordPress is a…
The WooCommerce Table Rate Shipping plugin has the ability to add multiple rates for a…
The simplest and fastest WP Cache system
Super Store Finder for Wordpress Super Store Finder for WordPress is a fully-featured WordPress Plugin…
All Extensions / Store Management / Tax / EU VAT Number EU VAT Number Developed by WooCommerce Allow valid EU businesses…
All Extensions / Store Management / Accounting / WooCommerce Zapier WooCommerce Zapier Developed by OM4 Save time and hassle by automatically…
All Extensions / Payments / Off-Site / WorldPay WorldPay Developed by Andrew Benbow Information & Requirements Only supports UK version of…