Plugin Category

This wiki plugin will display a list of categories and objects assigned to those categories. Options let you decide what level of category, what types of objects to list, how they should be sorted, whether to show subcategories, and whether multiple category displays should be split.

Parmeters

List categories and objects assigned to them
Introduced in Tiki 1.
Go to the source code
Preferences required: feature_categories, wikiplugin_category

Parameters Accepted Values Description Default Since
lang lang List only objects in this language. Only apply if type="wiki". 8.0
maxRecords digits Maximum number of objects to list (default is 50) 50 6.1
and (blank)
y
n
If set to y (Yes), only objects in all of the categories will be shown (default is to show objects in any of the categories) 1
showlinks (blank)
y
n
Show children category links (shown by default) y 5.0
showdescription (blank)
y
n
Show descriptions (not shown by default) n 4.1
showname (blank)
y
n
Show object names (shown by default) y 4.1
one (blank)
y
n
Show one object per line (multiple per line shown by default) n 5.0
sort (blank)| created_asc| created_desc| hits_asc| hits_desc| itemId_asc| itemId_desc| name_asc| name_desc| type_asc| type_desc| random Sort ascending or descending based on various attributes (sorted ascending by name by default) 1
split (blank)
y
n
Whether multiple categories will be listed on different lines (default is to split them) 1
sub (blank)
y
n
Also list objects in sub-categories of the categories given (default is to list sub-category objects) n 4.1
showTitle (blank)
y
n
Show title text above category object lists (shown by default) y 6.1
categoryshowlink (blank)
y
n
Show top category link (shown by default) y 5.0
showtype (blank)
y
n
Show type (shown by default) y 4.1
types article, blog, blog post, fgal, forum, newsletter, event, poll, quiz, survey, tracker, wiki, img List of object types to include in the list, separated by "+", for example, article+blog+blog post+fgal * 1
id digits
separator: +
List of category IDs separated by "+", for example, 1+2+3. Default will use category of the current page. 1

How to Determine a Category ID (without guessing)

Browse the categories (see Category User), hover over a category item, and look at the browser's status bar and note the ID number.

How to Change Default Number of Records

By default the plugin limits output to 50 records. You can change this in lib/wiki-plugins/wikiplugin_category.php

Examples

Sort first on imageId and then name

Copy to clipboard
{category id="1" types="img" sort="itemId_asc,name_asc"}

Sort first on articleId and then name

Copy to clipboard
{category id="1" types="article" sort="itemId_asc,name_asc"}

On this site

This code:

Copy to clipboard
{category id="1" sub="n"}


Would produce on this site:

Wrong

No brackets around the id number:

Copy to clipboard
{category id="[2]" types="faq"}

Correct

Copy to clipboard
{category id="2" types="faq+blog+article"}
Copy to clipboard
{category types="wiki" sort="created_asc"}
Copy to clipboard
{category split="y"}
Copy to clipboard
{category}