This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP Category Post List Widget


WP Category Posts List is a WordPress Widget & Shortcode plugin to show your posts filtered by category.

Built on the latest WP widget class, it has multiple widget instance support. Also you can modify the HTML structure of the widget in what ever manner you want.

Every thing is made simple from the widget options. It supports post thumbnails which would fetch thumbnails you have added from the wp editor. You can also set the CSS class, alternate list css style and much more. Also, you have complete control over the sorting method of the plugin.

New from Version 2 is the shortcode support using which you can make magazine style list of posts from a category. See the screenshots for more details.


Check the Installation and FAQ page. For detailed documentation check HERE at out blog

Widget Feature List

  • A total of 30 (new in V2) options to choose from. (For this version! It will increase over time).
  • We have kept the basic and advanced sets of options seperately to not to overwhelm you with options. And hey, if you are an advanced user, just click the Toggle switch.
  • NEW Use the Current Category to automatically fetch the main category of the currently displayed post and list down other posts from that category. Suspends widget output if no category is found.
  • Ability to write custom tags on the widget title. Such as %widget_num% will get replaced by the number of posts on the category list.
  • NEW Ability to show the original category as Read more button below the widget with full supported HTML
  • NEW Ability to show category feed subscription link with full supported HTML.
  • Of course the ability to specify the number of posts for each widget.
  • Turn on/off post thumbnail.
  • Add custom CSS class to the post thumbnail.
  • Ability to specify sort using date, id, title, comment or random
  • NEW Choose whether or not to display hardcoded/auto-generated post excerpts
  • NEW Added options for displaying author name, publish date etc.
  • Set the sorting order ascending or descending.
  • Selecting the default HTML underordered list or set up your very own custom HTML structure
  • Specify custom HTML tag before/after the list and each link. In shorty design your own HTML nest.
  • Exclude post by ID, or even make some particular posts sticky
  • Decide whether the links would be opened on a new tab or on the present tab.
  • Apply alternate CSS classes to the link list, so you can design easily.
  • Also, include/exclude the plugin’s default CSS from the plugins Settings page.

Shortcode Feature List

[wp_cpl_sc attr="val"]

* 15 attributes to work with.
* Select CSS theme (bundled or your own via filters) for every instances of shortcodes
* All options to control all output aspects of shortcode, including blog style post-meta, excerpt, thumbnail etc…
Check the documentation for more information.

Plugin Feature List

  • Added option to specify the thumbnail width & height of widgets and shortcodes individually.
  • Added option to globally enable css themes which you can select from widget or shortcodes individually. So two widgets can easily have different themes now.
  • Added filter API using which you can use your own CSS file inside this plugin. Check the documentation for more information.
  • Added a Master Reset button to reset all the options to default. (useful in case of errors)

And many more features… Check the Plugins Setting page for FAQs.

Version 2.0.3 Released. Bugfix

Version 2.0.2 Released. Immediate bugfix to some errors

Version 2.0.0 Released. The first release of shortcodes and automatic category selection widget


  • Widget with basic options
  • Widget with Advanced options
  • The plugins settings page
  • Output of the widget
  • Output of the shortcode


Uploading The Plugin

Extract all files from the ZIP file, making sure to keep the file/folder structure intact, and then upload it to /wp-content/plugins/.

See Also: “Installing Plugins” article on the WP Codex

Plugin Activation

Go to the admin area of your WordPress install and click on the “Plugins” menu. Click on “Activate” for the “WP Category Post List Widget” plugin.

Widget Usage

This is pretty much straight forward…

  • Go to Appearance > Widgets
  • Drag and drop the WP Category Post List to your sidebar/footer wherever.
  • Customize the options.
  • Go to Settings > Category Posts (WP CPL) and set the global theming options and thumbnail sizes.

Shortcode Usage

The basic shortcode usage of the plugin is
[wp_cpl_sc cat_id=1 css_theme=2 list_num=5]
where you change the cat_id, list_num and css_theme values. For more information on attributes check the documentation page

Upgrading the Plugin

So far we have released a few versions of this plugin. You can just deactivate and delete old version and install the latest one from here.

Alternately you can use WordPress’ own auto-update feature and forget about updating manually.


My Thumbnails are not showing up exactly as the size I have selected

WP CPL uses the default Thumbnail or Featured Image Feature of WP 2.9+. So, the thumbs are created when you upload the picture. For older pictures, it is not generated automatically. Not even when you change the thumb size. In such case just install and run this Regenerate Thumbnail Plugin. After installing it first time or whenever you change the Thumb size, it is recommended that you run this plugin once

Can I use different thumbnail for different widget?

This is not yet supported and I really don’t feel like using timthumb to generate thumbnails. However in future if I ever feel, then I will incorporate this feature

How can I use my own CSS for the widget?

Now this can be done using our CSS Theme filter API. A detailed instruction can be found HERE

Is it possible to use different CSS for different widget/shortcode?

Technically & simply Yes. Now you can simply choose the css theme from the dropdown (widgets) or mention the id in shortcode.


Works Great Right up to 4.4

Although this hasn’t been updated for some years – it still works really well. I’ve used it on a variety of themes through all the version 3 WordPress installations and now on 4.4. No other plugin gives the same level of reliable control over what posts show where and when. All the selection options work – all the time. Many of other plugins have issues with category or individual post exclusion – this one works and keeps working.

Thank you.

Read all 15 reviews

Contributors & Developers

“WP Category Post List Widget” is open source software. The following people have contributed to this plugin.



Version 2.0.3

  • Bug fix: On wp_cpl_output_gen.php file
  • Added: Current Post category is now current post/archive page category. So a category archive page will populate the widget.

Version 2.0.2

  • Bug fix to the occasion when no theme is selected
  • Added a Reset button to reset all the options in case of corruption

Version 2.0.1

  • Immediate bug fix to the WordPress auto-update.

Version 2.0.0

  • Ability to select the category of the current post (Auto category detection)
  • Shortcode support
  • Post excerpt and other options like html enabled Readmore and subscription.
  • Different height and width for widget and shortcode thumbnail
  • Display author, date and other post meta.
  • Added filter API to use your own CSS Theme with the plugin (both for widget and shortcode)

Version 1.1.0

  • Not released in the WILD
  • Ability to select the category of the current post
  • Shortcode support (proposed)
  • Minor bug fixes
  • Options to show post date, author and excerpt
  • New interface for read more and feed link

Version 1.0.0

  • Public Release
  • Several bugs fixed
  • Fixed the Read More permalink bug
  • Added 2 more themes
  • Added Teaser Option

Version 0.9.0 RC

  • Themeing Support
  • Complete Widget Interface
  • Stand alone support for WordPress post thumbnail activation. Even if your theme does not support.
  • All Documentation can be found in the Plugins Settings page

Version 0.0.9 alpha

  • Added basic widget querying of posts
  • Added thumbnail support etc.
  • Still under development. Please dont install

Version 0.0.8 alpha

  • Initial Upload to WP SVN
  • Under development. Please dont’t install