Home Download News FAQ / Knowledge Base Screenshots Documentation Support Site map
philosophical imaginary

Differences

This shows you the differences between two versions of the page.

faq:troubleshooting:viewhack [2013/12/29 06:09] (current)
dothebart (ab)using renderers
Line 1: Line 1:
 +====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===
 +^Roomname ^ Content^
 +| My Citadel Config | per user preferences room; every user has one; hidden per default These special messages can be found: |
 +| |Sieve configuration - x-citadel-sieve-config | all of a users sieve configuration|
 +| |%%_%%_ 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|
 +| |%%_%%_ Push email settings %%_%%_|your settings for notifications on inbound emails|
 +|_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; we return here per default if a goto fails|
 +|_BITBUCKET_|the room disgraced users messages are moved to|
 +|%%_%%_CitadelSMTPspoolout%%_%%_|The systems outbound mail spool; rendered as mailspool by default|
 +| |x-citadel-delivery-list|spool control message; each paired with...|
 +| |<reference to the mail to be sent>|As you know messages can be visible in several rooms at once; The mail to be sent by SMTP is one such example.|
 +|%%_%%_CitadelFNBLqueue%%_%%_|The systems paging spool; hidden 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 No.    | 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 ;-)
Copyright © 1987-2014 Uncensored Communications Group. All rights reserved.     Login (site admin)