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.

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 ]

Alternatively, a categorize block can be used to categorize objects individually, for objects created by other profiles or data channels for example.

objects:
 -
  type: categorize
  data:
   type: wiki_page
   object: HomePage
   categories:
    - $profile_category

Category Object

Field Name	Mandatory	Value	Tiki version
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.
migrateparent		Parent category ID. If specified will move all of the current items of the category of the same name under migrateparent to the category being updated/created by this profile	9.x