ocPortal Tutorial: Custom structured content (via CEDI)
Written by Chris Graham, ocProducts
This tutorial will describe the CEDI system.The term 'CEDI' is a play on the phase 'community database' ('CD'), such that it half-rhymes with and reads like 'WIKI', which is a similar system. It also stands for 'Collaborative/encyclopaedic database interface'.
Table of contents
About CEDI
Viewing a CEDI page |
Note: It is worth noting that when CEDI was created, WIKI systems were much more obscure and hence CEDI was independantly developed: since then we have gone back and extended the system so that it can also behave just like a WIKI as desired, but still maintains all the CEDI advantages and the possibility for authorative control.
Pages and posts
Making a CEDI post |
Pages may also contain a list of pages that are 'underneath' their own page; however, a page can be underneath any number of pages, as the CEDI hierarchy is loosely defined (technically it is a node based network). When pages are accessed from different paths, the path to the page as it has been accessed is displayed, so that back-tracking is easier, and that the user does not get confused by the path suddenly changing when they enter a 'child' page.
If you do not choose to develop a tree structure then CEDI navigation will be much like the navigation of a WIKI- Comcode has special WIKI-like support for making quick links between CEDI pages just by writing [[pagename]].
This simple structure of posts, pages, and children, is basically all there is to CEDI. There are of course peripheral features, such as:
- Giving pages some 'page text', which sits above the posts on that page; this text is staff decided, and thus provides an authoritative space.
- Jumping to a random page.
- Seeing a list of recent changes to the database.
- Moving posts.
Editing the CEDI tree |
- Merging posts.
- Viewing the tree structure of the whole database (transferred in a compressed format, and reduced so as only to show a single path to any page).
- Search
- Editing posts
This simplicity is key to the flexibility of the system- it is a system of control built around organised text, and how that text is used and structured is completely up to the website staff.
Maintenance
The full CEDI structure and content may be manipulated from the view pages of CEDI itself. Pages are created on an adhoc basis, by either referencing them in the child-list for a page (available under the 'Edit Tree' button), or by referencing them via the special Comcode syntax ([[pagename]]).The 'Edit CEDI page' selection list in the Content Management zone may be used to find/select pages which have been orphaned from the CEDI hierarchy.
In a typical set-up, staff are given access to modify the CEDI tree, whilst ordinary users relay on the Comcode tag to create new inline links. Whether ordinary users are given access to add new pages often varies substantially between sites, depending heavily on what role CEDI is being used for.
Moderation
As CEDI is (by default) open to posting by any user, you may feel it is necessary to moderate posts: especially as they may detract from the quality of the database.When a member posts, an e-mail is sent to the staff e-mail address: this will help you to moderate posts on the system, as they are made.
It is possible to provide greater open-access to CEDI, so that anyone may edit all page details and navigation, in the same way that they may do so on a WIKI. If you wish to enable the permissions for this then you will likely want to make use of the page history feature to revert unwanted changes, as well as ocPortal's side-wide tracing and moderation abilities.