History: 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.


{CODE(caption=>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 ]
{CODE}

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

{CODE(caption=YAML)}
objects:
 -
  type: categorize
  data:
   type: wiki_page
   object: HomePage
   categories:
    - $profile_category
{CODE}

! 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 types|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||