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 themIntroduced 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 |
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:
Category:
Status
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}