Categories Details

This page really Needs review. Before today (guess when 😉 it was not modified for 2 years, and does not contain any explanatory documentation, only cryptic tables over things related to categorries. I added some text below, that definitely needs review as I am little more than a newbie with Tiki... Enjoy and correct in the Wikiway

Categories are a feature of Tiki that allows to characterize Wiki pages, Trackers and other elements (which ?).
You should not mix them with Keywords, another feature of Tiki that is less structured.

This page contains mainly tables about Categories, including the relevan permissions, database structures, etc. Since some references are very old, it is probably obsolete to some extent.

Permissions

Perm Name	Default Level	Description
tiki_p_admin_categories	editors	This permission grants access to tiki-admin_categories.php, and is required when a user needs to change categories as well.
tiki_p_view_categories	registered	* can see objects and list of objects in the category. * required to have the display of the categpath (on top) on wiki pages, as well as categobjects at the bottom. * this perm now also is required to categorize anything. This could provide a layer where categs are only visible to a given group for internal management, while other groups won't even know there is a categories system.
tiki_p_edit_categorized	registered	* allows user to edit objects in category * replaces tiki_p_edit_categories(in 1.9 or prev).
tiki_p_view_categorized	registered	* view-only permissions on a category. * replaces tiki_p_view_categories (in 1.9 and prev)

Preferences

Pref name in tiki_preferences table	default value	comment
feature_categories
feature_categoryobjects		Show Category Objects (displays the objects in the categories in which objects of some types are categorized)
feature_categorypath		Show Category Path (displays the categories in which objects of some types are categorized)

Modules

module name	usage
last_category_objects	Displays the last objects categorized in the category with specified id, and of default type (default type is not anything, but Wiki page). The actually displayed objects (and their order) may be incorrect if some were progressively categorized in multiple categories.

Files used

Main files	categorize.php
	templates/categorize.tpl
	categorize_list.php
	tiki-browse_categories.php
	templates/tiki-browse_categories.tpl
	tiki-categpermissions.php
	templates/tiki-categpermissions.tpl

Admin	tiki-admin_categories.php
	templates/tiki-admin-categories.tpl

Libs	lib/categories/categlib.php
	lib/tree/tree.php
	lib/tree/categ_admin_tree.php
	lib/tree/categ_browse_tree.php

Modules	modules/mod-last_category_objects.php
	templates/modules/mod-last_category_objects.tpl

Plugins	lib/wiki-plugins/wikiplugin_category.php

Database

Table	Usage
tiki_categories	Categories and information about them (name description, parent, hits)
tiki_categorized_objects	Categorized objects (type, objId, description, created (date representing the last time the object was not categorized), date, href (URL to access the object), hits)
tiki_category_objects	Categories (categId) in which categorized objects are categorized. Used with tiki_categorized_objects with common field catObjectId