This chapter describes all necessary settings on the IMAP folders in the Kolab storage format.
We will be using the ANNOTATEMORE proposal. If changes are made to this in the standardization process, we will incorporate these. Also, we must support IMAP namespaces. All relevant RFCs will be followed (i.e. folder name encoding is by RFC 3501).
The INBOX is the default inbox of the user. The user can not change this default. The account specific personal IMAP resource folders are subfolders of the INBOX, and this location cannot be set by the user. There is exactly one default resource folder for each type which means
one default calendar folder
one default contact folder
one default notes folder
one default task folder
one default journal folder
The actual names of the folder as stored on the IMAP folder don't matter. E.g. it does not matter if the default calendar is called Calendar or Kalendar as long as exactly one default calendar folder does exist as a direct subfolder of the INBOX folder.
All folders MUST be annotated with an entry /vendor/kolab/folder-type containing the attribute value.shared set to: <type>[.<subtype>]
The <type> can be: mail, event, journal, task, note, or contact.
The <subtype> for a mail folder can be inbox, drafts, sentitems, or junkemail (this one holds spam mails). For the other <type>s, it can only be default, or not set.
There MUST NOT be two folders of a single type having the default subtype. E.g. it is forbidden to have two folders of the type calendar with the subtype default within one Kolab account.
For other client-specific non standardized types of folders, these MUST be prefixed with "k-" for KMail, "h-" for Horde, "o-" for Outlook with the Toltec Connector and "ok-" for Outlook with the KONSEC Konnektor. E.g. "o-voicemail".
The mimetype of the messages stored on the Kolab server is "application/x-vnd.kolab.<type>".
All annotation MUST be set during the initial creation of a folder and cannot be altered afterwards. Clients are allowed to rely upon this requirement.
For folders created with non Kolab IMAP clients, annotations must be preserved. All Kolab clients MUST assume that folders without an explicit type set are email folders.