![[Show/Hide Left Column]](pics/icons/oleftcol.png "[Show/Hide Left Column]"){kind=icon}
![[Show/Hide Right Column]](pics/icons/orightcol.png "[Show/Hide Right Column]"){kind=icon}
Category Handler
Categories are a powerful feature in Tiki since version 2.0. They are a key to performing complex permission management. This handler only allows you to define categories, create subcategories, and to assign objects to categories. To assign permissions to the categories Permission Management must be used, where you assign that some group has some permissions on a category (which are treated in the handler the same as any other object).Applying categories to objects created in the same profile: You should use object references (and not profilerequests) to categorize objects that are created by the profile itself.
YAML
objects:
-
type: category
ref: profile_category
data:
name: Profiles
description: Base category used to get complete listing
-
type: category
ref: app_category
data:
name: Applications
parent: $profile_category
items:
- [ tracker, $SampleProfiles:bug_tracker_profile ]
- [ wiki_page, TimeAccounting ]
-
type: category
ref: clone_category
data:
name: Clones
parent: $profile_category
items:
- [ wiki_page, WikipediaClone ]
- [ wiki_page, $OtherProfile:some_page ]Category Object
| Field Name | Mandatory | Value |
| name | yes | The category name |
| parent | Parent category ID. No value will create a top level category. | |
| description | Category description | |
| items | List of objects to be added to the category. Each entry must be a pair of object type and object ID, or for wiki the pagename. |