Inspecting internal information using Webcit

As you already know, Citadel keeps its informations collected in rooms. Webcit hides some of them from you, or uses special renderers to polish their content for you.

Special Rooms / Aliases

• My Citadel Config
  per user preferences room; every user has one; hidden per default These special messages can be found:
  • __ WebCit Preferences __ your personal webcit settings; key value list.
    
  • XMPP Mortuary
    
  • (your Name) Your personal vcard with your configured emails; bcc'ed into the Global addressbook if you're allowed to edit your email addresses
• _MAIL_
  your personal mailbox; every user has one.
• _TRASH_
  your personal trashbin; every user has one.
• _DRAFTS_
  your personal drafts room; every user has one.
• _CALENDAR_
  your personal calendar; every user has one; rendered as calendar by default
• _TASKS_
  your personal tasks; every user has one; rendered as tasklist by default
• _CONTACTS_
  your personal addressbook; every user has one; rendered as addresslist by default
• _NOTES_
  your personal notes room; every user has one; rendered in the notes view
• _BASEROOM_
  usually the lobby; clients return to this room when there is no new content to be viewed
• _BITBUCKET_
  the room discarded users messages are moved to
• __CitadelSMTPspoolout__
  The systems outbound mail queue; rendered as a queue view by default

Webcit room Renderers

Since rooms can contain different kinds of messages, different renderers are used to display their contents to the user. Some roomtypes are hard associated with renderers, some allow switching between renderers with the dropdown menu in the upper right of the screen.

  C / Template Name       Maps to number | Renders as... 
|VIEW_BBS		| 0	         | Bulletin board view 
|VIEW_MAILBOX		| 1	         | Mailbox summary 
|VIEW_ADDRESSBOOK	| 2	         | Address book view 
|VIEW_CALENDAR		| 3	         | Calendar view 
|VIEW_TASKS		| 4	         | Tasks view 
|VIEW_NOTES		| 5	         | Notes view 
|VIEW_WIKI		| 6	         | Wiki view 
|VIEW_CALBRIEF		| 7	         | Brief Calendar view 
|VIEW_JOURNAL		| 8	         | Journal view 
|VIEW_DRAFTS		| 9	         | Drafts view 
|VIEW_BLOG		| 10	         | Blog view 
|VIEW_QUEUE		| 11             | SMTP/... QUEUE rooms 
|VIEW_WIKIMD		| 12	         | Markdown Wiki view 
|VIEW_MAX               |(moveable)      | Marker to separate disk stored room renderers.. 
|VIEW_JSON_LIST         |(VIEW_MAX + 1)  | Payload list for VIEW_MAILBOX; may not be used as permanent renderer. 

Hacking it by self composing URLs

i.e. for debugging purposes, you might want to force webcit to go into rooms, and force another renderer than the default one. A good candidate for this is VIEW_MAILBOX, since it simply renders a list of messages, and allows to move / delete unwanted messages.

So for example you want to inspect the mail queue by hand for maintenance, editing the URL like this would work:

dotgoto?room=__CitadelSMTPspoolout__&view=1

Another example; go to your users config settings room:

dotgoto?room=My Citadel Config&view=1

Feel free to combine the two tables above, but don't complain if it doesn't work out ;-)