WordPress.org

Ready to get started?Download WordPress

Plugin Directory

List category posts

List Category Posts allows you to list posts from a category into a post/page using the [catlist] shortcode. This shortcode accepts a category name or

0.49.1

  • Makes sure "starting_with" queries are case insesitive.
  • Fixes category link on 'catlink' and 'catname' parameters (were showing twice)

0.49

  • Adds author_posts_link, to show an author's page.
  • Adds catname parameter to show just the category name (and not the link). Thanks user sirenAri from the forum.
  • Small bug fix for getting current category. Used to check against simple string, now checking against i18n'ed one.

0.48

  • Bug fixes
  • Adds parameter to show modified date of posts. Thanks Eric Sandine for the Pull Request :)

0.47

  • Adds Ukranian translation by Michael Yunat http://getvoip.com
  • Adds display_id parameter. Set it to yes to show the Post's ID next to the post title.
  • Adds starting_with parameter. Gets posts whose title start with a given letter.

0.46.4

  • Finally (hopefully) fix the excerpt issues.

0.46.3

  • Fix something that I broke on previous update for excerpt :S

0.46.2

  • Some fixes on displaying excerpt.

0.46.1

  • Fixes quotes bug on title tag.
  • Only show ellipsis when title.size > title_limit when using the title_limit param.

0.46

  • Adds "the_excerpt" filter to excerpt to improve compatibility with the Jetpack plugin.
  • Add character limit to title
  • Removes debug warnings
  • Output valid HTML, attribute quotations - thanks Nikolaus Demmel!

0.45

  • Adds ol default template to template parameter.
  • Improves documentation.

0.44.1

  • Removes warning when using current tag in pages
  • Small fix on Readme

0.44

  • Adds the feature to get an author's posts
  • Adds show posts from current post's tags.

0.43.1

  • Show "no posts text" only if it's been set and there are no posts, otherwise behave like before.

0.43

  • Removes filters to order by (should fix issues with order)
  • Adds pagination_prev and pagination_next params to customize the "Previous" and "Next" buttons on pagination navigation.
  • Only show pages in pagination when they are > 1
  • Adds no_posts_text param to display a custom message when no posts are found
  • Fixes "morelink" class parameter (now can be used without specifying an HTML tag and the class is applied to the a tag).

0.42.3

  • Adds missing title attribute from thumbnail links.

0.42.2

  • Fixes pagination numbers
  • Removes warning on wp-debug set to true

0.42.1

  • Fixes some debug warnings (Ruby's nil doesn't apply in the PHP World)

0.42

  • Fixes excludeposts=this.
  • Adds customfield_tag and customfield_class to customize an HTML tag and CSS class for custom fields.

0.41.2

  • Small bugfix with customfield_display_name (wasn't working now it is)

0.41.1

  • Fixes customfield display name.
  • Fixes size in getting thumbnails, now checks for all available sizes and defaults ("thumbnail", "full", etc.)

0.41.0

  • Adds options page, to set the default numberposts value globally.
  • Adds customfield_display_name param.
  • Adds pagination to custom template.
  • Fixes date display.
  • Adds conditions to Vagrantfile to boot faster and not repeat work.
  • Fixes exclude posts, broken when migrating from get_posts to WP_Query.

0.40.1

  • Small fix closing quotes on content when using

0.40

  • Tested with WordPress 3.8
  • Removes unnecessary stuff on wp_enqueue_styles
  • Fixes validation when using quotes in title
  • Fixes on tag
  • Fixes on title HTML tag and CSS class. (See HTML & CSS Customization on Other Notes to check the expected behaviour)

0.39

  • Adds "post suffix" parameter, to add a String after each post listed. Source

0.38

  • Adds pagination. Check Pagination on Other notes to learn how to use it.
  • Adds "How to display thumbnails next to title" to the FAQ.
  • Adds a Vagrant box for developers to be able to start coding with no effort :)

0.37

  • Supports more tag. If there's a <!--more--> tag in the post, then it will behave just as WordPress does: only show the content previous to the more tag.
  • Fixes YouTube thumbnails: Includes "embed" urls for youtube video thumbnails, makes correct img tag when using CSS class.

0.36.2

  • Fixed category_count for several categories.

0.36.1

  • Fixed catlink to display titles for all the categories when using more than one category.

0.36

  • Adds option for "target=_blank" for post links.
  • Adds option to exclude category when using the and relationship: [catlist id=1+2-3] will include posts from categories 1 and 2 but not 3.

0.35

  • Updated Turkish translation, thanks again Hakan Er!
  • Adds feature to order by custom field using the customfield_orderby parameter.

0.34.1

  • Bugfix (removed var_dump)

0.34

  • Now accepts either class or tag or both for styling elements (such as date, author, etc. to display). When just using a tag, it will sorround the element with that tag. When using just a class, it will wrap the element between span tags and the given CSS class. Check Other notes under HTML & CSS Customization for more info.
  • Fixed bug on post_status, it used to show all published posts and if user was logged in, all private ones too. Now you can specify 'private' to just display private posts, and draft, publish, draft, etc (See post_status param on the instructions for more info).

0.33

0.32

0.31

  • Pull request from @cfoellmann, adds testing environment and Travis CI integration. Awesomeness.
  • When searching for a thumbnail, if there's no thumbnail on the post but there's a YouTube video, display the YouTube video thumbnail. (wordpress.org/support/topic/youtube-thumbnail)

0.30.3

  • Bugfix release, fixes current category for post/page

0.30.2

  • Improves 'current category' detection.
  • Adds categorypage parameter to widget

0.30.1

  • excerpt - Fixed default excerpt behaviour from previous release. By default it will strip html tags as it always did. If you want it not to strip tags, you'll have to use excerpt_strip=no. Added a new parameter to have a consistent excerpt. If you want to overwrite WordPress' excerpt when using the plugin and generate one the way the plugin does when there's no excerpt, use excerpt_overwrite=yes.

0.30

  • Adds ability to exclude tags.
  • Changes excerpt. Since lot of users have asked for it, I once again modified the way the excerpt is shown. It now respects your theme's allowed HTML tags and doesn't strip them from the excerpt. If you want to strip tags, use excerpt_strip=yes.

0.29

  • Adds turkish translation, thanks Hakan Er for writing this translation! :)
  • Adds "AND" relationship to several categories. Thanks to hvianna from the WordPress forums who implemented this feature :D
  • More improvements on readme.

0.28

  • Improvements on readme, faqs.
  • New posts_morelink param: adds a 'read more' link to each post.

0.27.1

  • Sets minimum version to WordPress 3.3, since wp_trim_words was introduced in that version. Adds workaround for people using WordPress < 3.3.
  • Adds Slovak translation by Branco from WebHostingGeeks.com.
  • Removes Debug PHP warnings.
  • Checkboxes on Widget save state, i18n for widget.
  • Adds excerpt size to widget.

0.27

  • Fixes to widget.
  • Adds year and month parameters to list posts from a certain year and/or month.
  • Adds search parameter to display posts that match a search term.

0.26

  • Adds i18n, German and Spanish translations. All credit to cfoellmann for implementing this and writing the German translation. Thanks! :)

0.25.1

  • Changed excerpt limit, it uses word count, and is working for WordPress' excerpt and auto generated ones.

0.25

  • Better excerpt
  • Applies title filter, should work with qTranslate
  • Adds post status parameter
  • Adds meta links to plugin page - most importantly: INSTRUCTIONS (please read them).

0.24

  • Fixes "excerpt doesn't strip shortcodes" - https://github.com/picandocodigo/List-Category-Posts/issues/5
  • Exclude currently displayed post - 1, 2
  • Add title to category title 1, will be improved.
  • Attempting to condition whitespaces to WordPress Coding Standard (emacs php-mode sucks for this...)
  • No more git-svn crap, now I'm developing this over at (GitHub)[https://github.com/picandocodigo/List-Category-Posts] and copying it into the WordPress SVN Repo.

0.23.2

  • Bugfix release

0.23.1

  • Bugfix release

0.23

This update is dedicated to Michelle K McGinnis who bought me "Diamond Age" by Neal Stephenson from my Amazon Wishlist. Thanks! :D

  • Added excerpt size. You can set how many characters you want the excerpt to display with 'excerpt_size'.
  • Fixed HTML tag and CSS class for each element (Check Other notes for usage).
  • Removed shortcodes from excerpt.

0.22.3

0.22.2

  • Fixed bug with the categorypage=yes param.
  • Tested with WordPress 3.3.

0.22.1

  • Fixed accidentally deleted line which made the catlink=yes param not work.

0.22

  • Added CSS "current" class hook for current post in the list: .current class attached to either the li or a tag of the currently viewed page in the said list. http://wordpress.stackexchange.com/q/35552/298
  • Added morelink parameter, check Other notes for usage.

0.21.2

  • Removed var_dump... (Sorry about that)

0.21.1

  • Small fixes:
    • Used "empty()" function for some Strings instead of evaluating isset() and != ''.
    • Include parameters on the get_posts args only when they are set (post_parent among others).

0.21

  • Added 'thumbnail_class' parameter, so you can set a CSS class to the thumbnail and style it.

0.20.5

  • Brought back the multiple categories functionality for the id parameter. Hopefully the last 0.20 bugfix release so I can start working on new stuff to implement.
  • Now the name parameter accepts multiple categories too. Just use: [catlist name=category1,category2]

0.20.4

  • Yet another bugfix, regarding nothing being displayed when using tags.

0.20.3

  • Fixed category detection code, which created some messy bugs in some cases

0.20.2

  • Minor bugfix release

0.20.1

0.20

  • Added the possibility to list posts from the current post's category
  • Some fixes to documentation

0.19.3

0.19.2

  • Small fix, missing parameter for taxonomy.

0.19.1

0.19

This update is dedicated to S. Keller from Switzerland who gave me "The Ultimate Hitchhiker's Guide to the Galaxy" from my Amazon Wishlit in appreciation for the plugin. I am really enjoying the read :D. If you, like S would like to show your appreciation, here's my wishlist:

0.18.3

  • Small excerpt fix, some readme file fixing too.
  • Not showing the_content for password protected posts.

0.18.2

  • Small fixes. Should work for name parameter in all cases now.

0.18.1

  • Added slug and name to the fetching of category id from previous update.

0.18

  • Fixed category id bug. Reported and fixed by Eric Celeste - http://eric.clst.org, thanks!
  • Improved template system a liitle bit, now you can pass an HTML tag and a CSS class to sorround each field on your template.
  • Added category link which wasn't working after previous big update.

0.17.1

  • Fixed displaying of "Author:" even when not being called.

0.17

  • Major rewrite. The whole code was rewritten using objects. It's easier now to develop for List Category Posts.
  • Both STYLESHEETPATH and TEMPLATEPATH are checked for templates.

0.16.1

  • Fixed shortcode nesting.

0.16

0.15.1

0.15

  • Added custom fields support. Define both custom field (customfield_name) and value (customfield_value) to use it.

0.14.1

  • Fixed "Show the title of the category with a link to the category" code (catlink param), it broke on some previous update, but now it's working again. Thanks Soccerwidow on the WP Forums for pointing this out.

0.14

  • Added "post_type" and "post_parent" from the underlining "get_posts()" API to be usable within the short-code. By Martin Crawford, thanks!
  • Added the "class" parameter to style the default ul. You can pass a class name, or the plugin will use "lcp_catlist" bby default. Thanks Chocolaterebel (http://wordpress.org/support/topic/plugin-list-category-posts-sharing-my-own-template-in-lcp).
  • Fixed "tags" parameter on the documentation, it used to say "tag", and the plugin looks for "tags".

0.13.2

  • Fixed thumbnail code, added it to default.php template as example.

0.13.1

  • Fixed broken dateformat.

0.13

0.12

  • Added comments count.
  • Updated readme file

0.11.2

  • Another minimal bug fixed with the excerpt...

0.11.1

  • Fixed small bug which made the excerpt show up everytime... (Sorry :S)

0.11

  • Automatic excerpt added in case the user didn't specifically write an excerpt.
  • Widget has been finally fixed. The attributes finally save themselves, and the widget works as expected :D

0.10.1

  • Small fix - added ul tags to default template.
  • Compatible WordPress 3.0 with Twenty Ten theme (thanks again Doug Joseph :) )

0.10

0.9

  • admin parameter now shows "display name" instead of "user nice name".
  • Template system has changed: In older version, custom templates got deleted if an automatic upgrade was done. Now templates are stored in the theme folder. (Thanks Paul Clark)
  • Added tag support

0.8.1

  • Fixed bug for 'content'.
  • There's new stuff on the widget options. I'm still working on it, so some bugs may appear.

0.8

  • Widget implements WP 2.8 Widget API, so at least 2.8 is required. Now you can use as many widgets as necessary, with new params.
  • Updated readme file.

0.7.2

  • Fixed link to category.
  • Improved template system.

0.7.1

  • Fixed uber stupid bug with offset... Sorry about that!

0.7

  • Exclude posts. Contribution by acub.
  • Offset parameter on shortcode to start listing posts with an offset. Contribution by Levi Vasquez
  • Content of the post can now be displayed. Contribution by Lang Zerner.
  • Link to the category available. By request on the plugin's forum.
  • Fixed small bug when using category name.

0.6

  • Minor fix for unclosed ul if not using templates.
  • Added option to list posts from many categories at once.
  • Added option to exclude categories.

0.5

  • Readme.txt validation.
  • Added 'excerpt' parameter. You can now show the excerpt for each post.
  • Added 'dateformat' parameter. Format of the date output. Default is get_option('date_format') - by Verex
  • Added 'template' parameter. Now you can choose template for output of the plugin. File name of template from templates directory without extension. Example: For 'template.php' value is only 'template'. Default is 'default' that means template in code of plugin not in template file -by Verex

0.4.1

  • Fixed some code to enable PHP 4 compatibility. Shouldn't hosting services update to PHP 5?

0.4

  • Added 'date' parameter. Now you can show the post's date when listed.
  • Added 'author' parameter. You can also show the post's author.
  • Sidebar Widget now allows you to add a title in h2 tags.
  • Changed some variable names, to keep better compatibility with other plugins/wordpress variables.
  • Tested with WordPress 2.7.

0.3

  • Broke backwards compatibility. Users of version 0.1 should update their pages and posts for the new shortcode formatting.
  • Option to pass arguments to the plugin, in order to use name of category instead of ID, orderby, order and number of posts are passed through parameters.

0.2

  • Added experimental sidebar widget (use at your own risk, not ready for prime-time yet since it hasn't been tested :P )

0.1.1

  • Fixed major bug, which gave 404 error when trying to use "Options" page.

0.1

  • Option page to limit number of posts.
  • Working using [category=ID] for posts and pages, with several categories support.

Requires: 3.3 or higher
Compatible up to: 3.9.1
Last Updated: 2014-6-30
Downloads: 749,661

Ratings

4 stars
4.4 out of 5 stars

Support

10 of 63 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

3 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