{maketoc}
! What are Pigeonholes?
Pigeonholes is a feature that replaces the legacy ((CategoriesPackage|categories)) package. Pigeonholes makes it easy to organize, search and group content in hierarchically nested categories.

!! What it does
as said, it's a categorisation system. it allows you to create a set of containers (each of which is a pigeonhole) and you can move them relative to each other in a nested system. here is an example to illustrate this (pigeonholes are in red and content in blue)
* ~~red:pigeonhole 1~~
** ~~blue:wiki page 1~~
** ~~blue:wiki page 2~~
** ~~blue:wiki page 3~~
** ~~blue:blog post 1~~
** ~~red:pigeonhole 1.1~~
*** ~~blue:image 1~~
*** ~~blue:image 2~~
*** ~~blue:wiki page 1~~
*** ~~red:pigeonhole 1.1.1~~
**** ~~blue:image 1~~
**** ~~blue:image 2~~
** ~~red:pigeonhole 1.2~~
*** ~~blue:blog post 1~~
*** ~~blue:blog post 2~~
*** ~~blue:image 1~~

the red content sits in their respective categories. there are options on how to display the related items in the same category and you can assign multiple content items easily by using the assign content page. this allows you to select a number of content items and add them to individual categories by simply checking the appropriate checkboxes. it's a very easy and quick way to keep your data categorised and up to date.

!! Incorporation
Pigeonholes is a service and therefore incorporates itself seamlessly into any content package that supports services. these include articles, wiki, blog posts...

when it comes to editing a wiki page or a blog post, you can assign the content to one or more pigeonholes by selecting them using a list such as this one:
{code}
[ ] pigeonhole 1
[ ] pigeonhole 1 >> pigeonhole 1.1
[ ] pigeonhole 1 >> pigeonhole 1.1 >> pigeonhole 1.1.1
[ ] pigeonhole 1 >> pigeonhole 1.2
{/code}

!! Security
(future developments) Pigeonholes in our HEAD branch have just undergone some major changes. One change is the addition of security. It is now possible in that branch to assign a group or a permission to a given category and users of only that group or have a given permission may view the content within it. (This is not possible in version 1.3) Pigeonhole permissions are inherited from their parents. For instance, in the above example, if __pigeonhole 1.1__ were assigned to the group __Registered__ only registered users can view that content. The same applies for __pigeonhole 1.1.1__ but not for __pigeonhole 1.2__.


!! Memory
LibertyStructure has been tightened to only use a couple of database queries per structure. this means that wiki books and pigeonholes have greatly increased in performance and lowered database access numbers considerably.
Page History
Date/CommentUserIPVersion
09 Oct 2008 (05:40 UTC)
added alias, changed wording
laetzer85.178.37.1412
Current • Source
Kozuch85.207.244.16011
View • Compare • Difference • Source
mlpvolt206.248.132.1099
View • Compare • Difference • Source
mlpvolt206.248.132.1098
View • Compare • Difference • Source
realname212.27.36.17
View • Compare • Difference • Source
mlpvolt69.195.4.526
View • Compare • Difference • Source
mlpvolt69.195.4.525
View • Compare • Difference • Source
xing194.152.164.454
View • Compare • Difference • Source
xing194.152.164.453
View • Compare • Difference • Source
xing194.152.164.452
View • Compare • Difference • Source
xing194.152.164.451
View • Compare • Difference • Source