May 19, 2006
How To Admin /
Configure Categories

The default naming convention of ProWiki is to use "folders" instead of categories but you can reconfigure that to any name you want. Read FolderSystem for information about how the system works in general.

Whatever you want to configure ("Category" is just an example), all FolderPages have to start with the same string which is defined and must be redefined in Option/HeadFolders. The default is multilingual but you need not keep it that way.

Variable HeadFolders:

The result of changing HeadFolders is that (1) the usage of pages starting with the string defined in HeadFolders is specifically cached for performance and (2) the the current cache is not synchronized anymore and must be rebuilt by ActionBpx.

The rest of the work is adapting the UserInterface, especially the LinkBar, to reflect these changes. See the nine FolderOptions for detail.

Recipe for classical setting

Copy to your TopConfiguration and adapt it to your needs:

Then you have to execute the command once to synchronize the PageCache:

ThisWiki:action=bpx (don't forget to rebuild the page index)


The classical category naming scheme has the disadvantage that it's not always clear whether to use the singular or plural, e. g. "CategoryBook" or "CategoryBooks". Usually it is the singular in the sense of "this page represents a book", but not always. For example you would intuitively use the plural form for book lists. The "List" and "Folder" naming schemes to not have this disadvantage because its always clear they mean plural "list for books" or "folder for books".

A FolderPage becomes a FolderPage because it is put in the "folder of folders" by being marked with the PageName defined in "PageFolders". That the name of a FolderPage starts with the string defined in "HeadFolders" is just a necessary precondition.

Using folders or categories is cheap with ProWiki because of the clever caching mechanism that avoids searching. So there is no reason not to use folders (or categories) and to offer them freely in the UserInterface.