Extension:NiceCategoryList2

The NiceCategoryList2 extension displays a category listing, including sub-categories, in a number of useful formats. This is intended to allow easier navigation of a wiki's category tree. It implements a new tag,, which generates a list of all pages and sub-categories in a given category. The list can display multiple levels of sub-categories, and has several options for the display style.

This extension was originally created by Kichik as Extension:NiceCategoryList, was enhanced by JohanTheGhost and *Surak* and updated in 2015 to work with the latest version of MediaWiki by Crafty Coding.

Parameters
The  tag displays a category list:

Category:Some Category

The tag takes the following parameters, all of which are optional:
 * maxdepth= : maximum category depth to display; default 32
 * headings= : 'head' to display category headings as Wiki headings (default); 'bullet' to display category headings as bullet lists
 * showfirst= : '0' to skip top heading (default), else display it
 * headstart= : with 'headings=head', headstart is the heading level to list top-level categories with; default 2
 * style= : 'bullet' to show category contents as bullet lists (default); 'compact' for a more compact listing
 * showcats= : not '0' to display sub-category links in "bottom" (i.e. maxdepth) categories; default 0
 * showarts= : not '0' to display articles in categories; default 1
 * sort= : not '0' to sort the list alphabetically; else sort the list according to the index key; default 0
 * number= : not '0' to display only up to of articles, else display all articles; default 0
 * random= : with number not '0': display random choice of articles if random not '0', else display the first of articles; default 0

CSS Styles
The original wiki syntax created with version 2.2 was basically left, but all direct formatting was taken out. Instead the discrete elements are enclosed in  and   tags with class names. The benefit is that you can apply styles to the items, either in Common.css, in the current skin's CSS or in your user CSS. The whole category tree is now encapsulated into a DIV container with a classname of.

Each level of the category tree is encapsulated in a div container with a classname of. {headings} means one of the  options, either   or. {x} means a numeric value that starts at zero and is increased on each subordinate level of the category list, until  is reached.

Inside of this top DIV container, two subordinate blocks exist for the heading and the content:


 * The heading is covered by a block with a classname of .  {x} means a numeric value that starts at zero and is increased on each subordinate level of the category list, until   is reached.  If the option , then the first header is not displayed.  This is the default setting, since previous versions of the extension did not display it.  The default can be overwritten by using   in LocalSettings.php.
 * If the option, the block is a DIV block displaying the category as link to the category page as bullet list item.
 * If the option, the block is a usual headings block, starting at .  {n} means a numeric value that starts at {headstart} and is increased on each subordinate level of the category list.  The default setting is  .  It can be set back to the default of previous versions by using   in LocalSettings.php.  If you want to activate the first heading for a certain category list, you can use the option   (or inactivate it with   otherwise).


 * The content is covered by a block with a classname of .  {style} means one of the   options, either   or  .  {x} means a numeric value that starts at zero and is increased on each subordinate level of the category list, until   is reached.  It contains SPAN containers with the subcategories (if  ) and articles (if  ) of the regarding category.
 * Each subcategory is enclosed in a SPAN container with a classname of.
 * Each article is enclosed in a SPAN container with a classname of.

Additionally to the above mentioned classes, some generic classes are defined to apply styles on groups of items:
 * to apply styles to all items with classnames of  and.
 * to apply styles to all items with classnames of.
 * to apply styles to all items with classnames of.
 * to apply styles to all items with classnames of.
 * to apply styles to all items with classnames of  and.
 * to apply styles to all items with classnames of.
 * to apply styles to all items with classnames of.



Examples
Caveat: When used in a template, the category list will not refresh immediately when reloaded; edit and save the article to see updates.

Configuration
If you want to inactivate the cache for pages using the extension, use:

If you want to default the  option to something different than '2', use:

If you want to default the display of the first heading, use: