robfelty

Collapsing Categories creates an expandable list of categories and 
subcategories. It can also expand to show posts. The primary usage is as a 
widget, but you can also use the code in your theme manually if you wish (see 
installation instructions)
<h3>Options</h3>
Options can be set 
from the block panel. If you wish to insert the code into your theme manually 
instead of using a widget, you can use the following options. These options 
can be given to the <code>collapsCat()</code> function either as an array or in query 
style, in the same manner as the <code>wp_list_categories</code> function.
<pre><code>$defaults=array(
 'showPostCount' => true,
 'inExclude' => 'exclude',
 'inExcludeCats' => '',
 'showPosts' => true, 
 'showPages' => false,
 'linkToCat' => true,
 'olderThan' => 0,
 'excludeAll' => '0',
 'catSortOrder' => 'ASC',
 'catSort' => 'catName',
 'postSortOrder' => 'ASC',
 'postSort' => 'postTitle',
 'expand' => '0',
 'defaultExpand' => '',
 'postTitleLength' => 0,
 'accordion' => 0,
 'catfeed' => 'none',
 'taxonomy' => 'category',
 'showPostDate' => false,
 'postDateAppend' => 'after',
 'postDateFormat' => 'm/d',
 'useCookies' => true,
 'showTopLevel' => true,
 'postsBeforeCats' => false,
 'expandCatPost' => true,
 'debug'=>'0'
);
</code></pre>
<ul>
<li>inExclude
<ul>
<li>Whether to include or exclude certain categories
<ul>
<li>‘exclude’ (default) </li>
<li>‘include’</li>
</ul>
</li>
</ul>
</li>
<li>inExcludeCats
<ul>
<li>The categories which should be included or excluded</li>
</ul>
</li>
<li>showPages
<ul>
<li>Whether or not to include pages as well as posts. Default if false</li>
</ul>
</li>
<li>linkToCat
<ul>
<li>1 (true), clicking on a category title will link to the category archive (default)</li>
<li>0 (false), clicking on a category title expands and collapses </li>
</ul>
</li>
<li>catSort
<ul>
<li>How to sort the categorys. Possible values:
<ul>
<li>‘catName’ the title of the category (default)</li>
<li>‘catId’ the Id of the category</li>
<li>‘catSlug’ the url of the category</li>
<li>‘catCount’ the number of posts in the category</li>
<li>‘catOrder’ custom order specified in the categorys settings</li>
</ul>
</li>
</ul>
</li>
<li>catSortOrder
<ul>
<li>Whether categories should be sorted in normal or reverse 
order. Possible values:
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0) </li>
</ul>
</li>
</ul>
</li>
<li>postSort
<ul>
<li>How to sort the posts. Possible values:
<ul>
<li>‘postDate’ the date of the post (default)</li>
<li>‘postId’ the Id of the post</li>
<li>‘postTitle’ the title of the post</li>
<li>‘postComment’ the number of comments on the post</li>
<li>‘postOrder’ sort by menu order</li>
</ul>
</li>
</ul>
</li>
<li>postSortOrder
<ul>
<li>Whether post should be sorted in normal or reverse 
order. Possible values:
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0) </li>
</ul>
</li>
</ul>
</li>
<li>expand
<ul>
<li>The symbols to be used to mark expanding and collapsing. Possible values:
<ul>
<li>‘0’ Triangles (default)</li>
<li>‘1’ + –</li>
<li>‘2’ [+] [-]</li>
<li>‘3’ images (you can upload your own if you wish)</li>
<li>‘4’ custom symbols</li>
</ul>
</li>
</ul>
</li>
<li>customExpand
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be 
used to mark expandable link categories</li>
</ul>
</li>
<li>customCollapse
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be 
used to mark collapsible link categories</li>
</ul>
</li>
<li>postTitleLength
<ul>
<li>Truncate post titles to this number of characters (default: 0 = don’t 
truncate)</li>
</ul>
</li>
<li>accordion
<ul>
<li>When set to true, expanding one category closes all others at that level</li>
</ul>
</li>
<li>catfeed
<ul>
<li>Whether to add a link to the rss feed for a category. Possible values:
<ul>
<li>‘none’ (default)</li>
<li>‘text’ shows RSS</li>
<li>‘image’ shows an RSS icon</li>
</ul>
</li>
</ul>
</li>
<li>taxonomy
<ul>
<li>Type of taxonmy to display. Possible values:
<ul>
<li>‘category’ (default)</li>
<li>‘link_category’</li>
<li>‘post_tag’</li>
<li>‘both’ (categories and tags)</li>
<li>any other registered taxononmy (e.g. recipe press uses recipe-categories)</li>
</ul>
</li>
</ul>
</li>
<li>showPostDate
<ul>
<li>When true, show the date of each post</li>
</ul>
</li>
<li>postDateAppend
<ul>
<li>Show the date before or after the post title. Possible values:
<ul>
<li>‘after’ (default)</li>
<li>‘before’</li>
</ul>
</li>
</ul>
</li>
<li>postDateFormat
<ul>
<li>What format the post date is in. This uses the standard php date 
formatting codes</li>
</ul>
</li>
<li>useCookies
<ul>
<li>When true, expanding and collapsing of categories is remembered for each 
visitor. When false, categories are always display collapsed (unless 
explicitly set to auto-expand). Possible values:
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>showTopLevel
<ul>
<li>When set to false, the top level category will not be shown. This could 
be useful if you only want to show subcategories from one particular 
top-level category
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>postsBeforeCats
<ul>
<li>When set to true, posts in category X will be ordered before 
subcategories of category X
<ul>
<li>1 (true)</li>
<li>0 (false) (default)</li>
</ul>
</li>
</ul>
</li>
<li>expandCatPost
<ul>
<li>When set to true, any category to which a post is assigned will 
automatically be expanded on a single post page.
<ul>
<li>1 (true) (default)</li>
<li>0 (false)</li>
</ul>
</li>
</ul>
</li>
<li>showEmptyCat
<ul>
<li>When set to true, empty categories are shown
<ul>
<li>0 (false) (default)</li>
<li>1 (true) </li>
</ul>
</li>
</ul>
</li>
<li>debug
<ul>
<li>When set to true, extra debugging information will be displayed in the 
underlying code of your page (but not visible from the browser). Use 
this option if you are having problems</li>
</ul>
</li>
</ul>
<h4>Examples</h4>
<pre><code>collapsCat('catSort=ASC&expand=3&inExcludeCats=general,uncategorized')
</code></pre>
This will produce a list with: 
* categories shown in alphabetical order 
* using images to mark collapsing and expanding 
* exclude posts from the categories general and uncategorized
<pre><code>`
</code></pre>
<?php 
 echo '
<ul>‘ . “\n”; 
 if (function_exists(‘collapsCat’)) { 
 collapsCat(array( 
 ‘postSort’ => ‘postDate’, 
 ‘postSortOrder’ => ‘DESC’, 
 ) ); 
 } else { 
 wp_get_categories(‘your_options_here’); 
 } 
 echo “</ul>
\n”; 
 ?> 
 `
<h3>Demo</h3>
I use this plugin in my blog at http://robfelty.com
<h3>CAVEAT</h3>
Currently this plugin relies on Javascript to expand and collapse the links. 
If a user’s browser doesn’t support javascript they won’t see the links to the 
posts, but the links to the categories will still work (which is the default 
behavior in wordpress anyways)

Collapsing Categories


	doesn't work with WP 4.9.1
	the code is terrible: it adds a big, ugly javascript in page with the widget html content. Never seen such an horror before.


Amateur work, avoid it.

doesn't work, bad coding

Adds a widget which uses Javascript to dynamically expand or collapse the set of posts for each category.

Fernando Briano

zymeth25

List Category Posts allows you to list posts by category in a post or page using the <code>[catlist]</code> 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:
<pre><code>[catlist id=1]

[catlist name="news"]
</code></pre>
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 <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">the full documentation</a> to learn about the different ways to use it.
The <code>[catlist]</code> 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 a few options, new options will be implemented on demand (as long as they make sense).
<a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">Read the instructions</a> 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 <a href="https://wordpress.org/plugins/list-categories/" rel="ugc">List categories</a>.
You can find Frequently Asked Questions <a href="https://github.com/picandocodigo/List-Category-Posts/blob/master/doc/FAQ.md#frequently-asked-questions" rel="nofollow ugc">here</a>.
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 <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">the documentation</a> for usage. You can also check <a href="http://sundari-webdesign.com/wordpress-the-quest-to-my-perfect-list-view-for-posts-events-and-articles/" rel="nofollow ugc">this nice tutorial</a> 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.
GUI
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: 
<a href="https://wordpress.org/plugins/gui-for-lcp/" rel="ugc">GUI for List Category Posts</a>
AJAX pagination
The ajax pagination feature is maintained in an add-on plugin by Klemens Starybrat. Check it out: 
<a href="https://wordpress.org/plugins/lcp-ajax-pagination" rel="ugc">LCP Ajax Pagination</a>
Widget
Since WordPress 4.9, <a href="https://make.wordpress.org/core/2017/10/24/widget-improvements-in-wordpress-4-9/" rel="nofollow ugc">you can use shortcode in text widgets</a>. 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.
Please, read the information on <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">the wiki</a> and <a href="https://wordpress.org/plugins/list-category-posts/#developers" rel="ugc">Changelog</a> 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 are awesome!), check them out here:
<ul>
<li><a href="http://www.youtube.com/watch?v=kBy_qoGKpdo" rel="nofollow ugc">Manage WordPress Content with List Category Posts Plugin</a></li>
<li><a href="http://www.youtube.com/watch?v=Zfnzk4IWPNA" rel="nofollow ugc">WordPress: How to List Category Posts on a Page</a></li>
</ul>
Support the plugin
Klemens Starybrat has been writing lots of amazing code for this plugin, so if you’ve found it useful and want to pay it forward, consider sponsoring him on GitHub: https://github.com/sponsors/klemens-st
I have a <a href="http://picandocodigo.net/programacion/wordpress/list-category-posts-wordpress-plugin-english/#support" title="Donate via PayPal" rel="nofollow ugc">PayPal account</a> where you can donate too.
Development
Development is being tracked on <a href="https://codeberg.org/picandocodigo/list-category-posts" rel="nofollow ugc">Codeberg</a> and <a href="https://github.com/picandocodigo/List-Category-Posts" rel="nofollow ugc">GitHub</a>. 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. You can find the complete documentation on <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">the wiki</a>. It’s also more comfortable to read and maintain than a txt file. Please check it out, suggestions are welcome on Codeberg/GitHub issues!
<h3>Instructions on how to use the plugin</h3>
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 <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">full documentation</a> to discover many more features, including:
<ul>
<li>advanced post selection options (by date, search terms, custom fields, post types, custom taxonomies and more)</li>
<li>output customizations (show each post’s date, author, excerpt, thumbnail and more)</li>
<li>custom templates of your own design, based on a simple PHP example</li>
</ul>
List 10 latest posts:
<pre><code>[catlist]
</code></pre>
The default number of listed posts is 10, to modify it you need to specify <code>numberposts</code> parameter:
<pre><code>[catlist numberposts=15]
</code></pre>
List posts from the “Dogs” category:
<pre><code>[catlist name=Dogs]
</code></pre>
List posts from the category with id <code>2</code>:
<pre><code>[catlist id=2]
</code></pre>
By default only the “post” post type is included. To list pages use:
<pre><code>[catlist post_type=page]
</code></pre>
and for both posts and pages:
<pre><code>[catlist post_type="post,page"]
</code></pre>
If we combine the above options we can get a shortcode that lists 15 items, including post and pages, from the “Dogs” category:
<pre><code>[catlist name=Dogs post_type="post,page" numberposts=15]
</code></pre>
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:
<pre><code>[catlist categorypage=yes]
</code></pre>
Same goes for tags:
<pre><code>[catlist currenttags=yes]
</code></pre>
To show each post’s excerpt use:
<pre><code>[catlist excerpt=yes]
</code></pre>
If you want to show the date, author and comments count next to each post, use:
<pre><code>[catlist date=yes author=yes comments=yes]
</code></pre>
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:
<pre><code>[catlist date=yes date_tag=span date_class="my-date" author=yes author_tag=p author_class="my-author" comments=yes]
</code></pre>
<a href="https://github.com/picandocodigo/List-Category-Posts/wiki/HTML-&-CSS-Customization" rel="nofollow ugc">Read more about this feature</a>
You can order posts by date:
<pre><code>[catlist orderby=date]
</code></pre>
You can also use <code>title</code>, <code>author</code>, <code>ID</code>. More options are described in the documentation.
The plugin also supports pagination. You need to specify <code>numberposts</code> to tell the plugin how many posts per page you want:
<pre><code>[catlist pagination=yes numberposts=5]
</code></pre>
See the wiki: <a href="https://github.com/picandocodigo/List-Category-Posts/wiki/Pagination" rel="nofollow ugc">Pagination</a> for more information.
Please read the <a href="https://github.com/picandocodigo/List-Category-Posts/wiki" rel="nofollow ugc">full documentation</a> for detailed documentation of all plugin features, use cases and shortcode parameters.

List category posts

Thanks for this plugin. It does exactly what I need and works flawlessly.

Exactly right for what I need

Very customizable plugin to list posts by category (or tag, author and more) in a post, page or widget. Uses the [catlist] shortcode to select posts.

Collapsing Categories vs List category posts