summaryrefslogtreecommitdiffstats
path: root/doc/userguide/groupware-kontact.docbook
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit4aed2c8219774f5d797760606b8489a92ddc5163 (patch)
tree3f8c130f7d269626bf6a9447407ef6c35954426a /doc/userguide/groupware-kontact.docbook
downloadtdebase-4aed2c8219774f5d797760606b8489a92ddc5163.tar.gz
tdebase-4aed2c8219774f5d797760606b8489a92ddc5163.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc/userguide/groupware-kontact.docbook')
-rw-r--r--doc/userguide/groupware-kontact.docbook614
1 files changed, 614 insertions, 0 deletions
diff --git a/doc/userguide/groupware-kontact.docbook b/doc/userguide/groupware-kontact.docbook
new file mode 100644
index 000000000..beaf1f338
--- /dev/null
+++ b/doc/userguide/groupware-kontact.docbook
@@ -0,0 +1,614 @@
+<chapter id="groupware-with-kontact">
+
+<chapterinfo>
+<authorgroup>
+<author>
+<personname>
+<firstname>Marco</firstname>
+<surname>Menardi</surname>
+</personname>
+<email>gnu@kde.org</email>
+</author>
+</authorgroup>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+
+</chapterinfo>
+<title>Sharing data with &kontact; via <acronym>IMAP</acronym></title>
+
+<sect1 id="kontact-imap-intro">
+<title>Introduction</title>
+
+<para>For my small office, I was looking for a long time for a
+<acronym>PIM</acronym> solution that let me share data, so my secretary and
+I can share contacts, appointments and so on. Being a &kde; user, I've heard
+about the Kroupware project and wait its completion. But when I saw how
+complicated is the architecture and setup of the
+<application>Kolab</application> server 1.0 (the server side of the
+project), I gave up, waiting for an easier to deploy
+<application>Kolab</application> 2.0. In any case, the
+<application>Kolab</application> stuff was clearly too much for my
+needs. Fortunately in the &kde; wiki I've found some piece of
+<acronym>IRC</acronym> conversation where they were talking about sharing
+data without the <application>Kolab</application> infrastructure... mmm so
+interesting!</para>
+
+<para>For small offices and needs, you can have &kontact; use shared data
+without the need of installing the <application>Kolab</application> server
+or another groupware backend. It can work with just an
+<acronym>IMAP</acronym> server, that can be easily set up.</para>
+
+<para>My scenario is a server with Debian unstable and &kde; 3.4. I access
+&kontact; and other fabulous GNU/Linux apps from windows using Cygwin/X,
+while waiting Wine project to be able to run the last Windows programs I
+need (and that are not available under GNU/Linux). I want to share contacts,
+events, todo, notes with my secretary.</para>
+
+</sect1>
+
+<sect1 id="kontact-imap-whatis">
+<title>What is <acronym>IMAP</acronym></title>
+
+<para>This definition is from the <ulink
+url="http://computeruser.com">ComputerUser.com High-Tech Dictionary:</ulink>
+<blockquote><para>Internet Message Access Protocol. A protocol that allows a
+user to perform certain electronic mail functions on a remote server rather
+than on a local computer. Through IMAP the user can create, delete, or
+rename mailboxes; get new messages; delete messages; and perform search
+functions on mail. A separate protocol is required for sending mail. Also
+called Internet Mail Access Protocol.</para></blockquote> </para>
+
+<para>So it can be considered a data storage. To use it you you need an
+<acronym>IMAP</acronym> server, such as <application>Cyrus</application>,
+<application>Courier</application> or <application>UW</application>.</para>
+
+</sect1>
+
+<sect1 id="kontact-kolab-or-imap">
+<title><application>Kolab</application> or <acronym>IMAP</acronym>?</title>
+
+<para><application>Kolab</application> brings the ability to share data
+between different clients. It makes possible for your secretary to use
+<application>Outlook</application> and you use &kontact;, for
+instance.</para>
+
+<para>You will have a configuration interface which does user management, mail
+account setup, a central <acronym>LDAP</acronym> config data and addressbook
+server, spam and virus filtering, vacation scripts, free busy list handling,
+resource handling (rooms, cars), groups, distribution lists, automatic
+invitation handling, &etc;</para>
+
+<para>But that can cause initial setup troubles. For a newbie like me it
+means: a long long frustrating nightmare, and too much complexity to manage
+once working. So no, thanks, I'll go to simple
+<acronym>IMAP</acronym>.</para>
+
+</sect1>
+
+<sect1 id="kontact-imap-cyrus">
+<title>How to set up <acronym>IMAP</acronym> server <application>Cyrus</application></title>
+
+<para>My choice is <application>Cyrus</application>, that is part of the
+<application>Kolab</application> set of software, so if l will go for
+<application>Kolab</application> in the future, at least I'm acquainted with
+it.</para> <para>Let's start the installation and the setup!</para>
+
+<para>Become <systemitem class="username">root</systemitem>.</para>
+
+<screen># <userinput><command>apt-get</command> <command>install</command> cyrus21-imapd cyrus21-common cyrus21-admin cyrus21-client sasl-bin sasl2-bin</userinput>
+<computeroutput>Installing cyrus21-imapd...</computeroutput><lineannotation>The installer asks something I've not understood about an search address... I just pressed <keycap>Enter</keycap></lineannotation>.</screen>
+
+<para>The installer also created the user <systemitem
+class="username">cyrus</systemitem> that is in the (automatically created)
+group <systemitem class="groupname">sasl</systemitem>, that is the
+<quote>owner</quote> of all cyrus files. At the end with <command>ps
+<option>-A</option></command> you can find the new processes:
+<command>cyrmaster</command> and <command>notifyd</command>.</para>
+
+<para>The real problem in setting up <application>Cyrus</application> is the
+authentication, just because it's not trivial and I'm a newbie, with limited
+knowledge about what I'm doing.</para>
+
+<para><application>Cyrus</application> can use different
+<acronym>SASL</acronym> (Simple Authentication and Security Layer)
+mechanisms, the default being sasldb (it stores usernames and passwords in
+the SASL secrets file <filename>sasldb</filename>), but also getpwent,
+kerberos4, kerberos5, PAM, rimap, shadow and LDAP are supported.</para>
+
+<para> Since I don't want to define users/passwords different than the ones
+that access my &Linux; box I choose then <quote>shadow</quote> mechanism so
+<application>Cyrus</application> will use &Linux; passwords for
+authenticate.</para>
+
+<para>To do so we have to tell sasl to use <command>saslauthd</command> as
+password authentication method, and then setup <command>saslauthd</command>
+to use <quote>shadow</quote> (or <quote>getpwent</quote>) as the
+authentication mechanism.</para>
+
+<para>OK, let's start!</para>
+
+<para>As <systemitem class="username">root</systemitem>, change the Linux
+password of <systemitem class="username">cyrus</systemitem> user:</para>
+
+<screen># <userinput><command>passwd <option>cyrus</option></command></userinput></screen>
+
+<para>Enter the password you like (and you will remember) we will use for
+this example <quote>cyrus</quote> as the <application>cyrus</application>
+administrator password.</para>
+
+<screen># <command>vi</command> <filename>/etc/imapd.conf</filename></screen>
+
+<programlisting>sasl_pwcheck_method: <userinput>saslauthd</userinput> <lineannotation>instead of the default <literal>auxprop</literal></lineannotation></programlisting>
+
+<para>remove the <literal>#</literal> remark from the line:</para>
+
+<programlisting>#admins: cyrus</programlisting>
+
+<para>this way you can administer <application>cyrus</application> logging
+in as <systemitem class="username">cyrus</systemitem> user (what a fantasy I
+have!)</para>
+
+<screen># <userinput><command>vi</command> <filename>/etc/default/saslauthd</filename></userinput></screen>
+
+<para>Uncomment the line:</para>
+
+<programlisting># START=yes</programlisting>
+
+<para>(otherwise the <application>saslauthd</application> will not start at
+boot time, even if referenced in some <filename
+class="directory">/etc/rcx.d</filename>!)</para>
+
+<para>and instead of <literal>MECHANISMS="pam"</literal> put
+<userinput>MECHANISMS="shadow"</userinput> this way at the boot a
+<command>saslauthd</command> <option>-a
+<parameter>shadow</parameter></option> will be executed.</para>
+
+<para>Once exited from your editor, restart <application>sasl</application>
+and <application>cyrus</application>.</para>
+
+<para>To test <acronym>IMAP</acronym>:</para>
+
+<screen> <userinput><command>su</command> <option>cyrus</option></userinput>
+$ <userinput><command>imtest</command> <option>-m login -p imap localhost</option></userinput></screen>
+
+<para>You are prompted for the <systemitem
+class="username">cyrus</systemitem> (user) password, so enter it.</para>
+
+<para>If the user <systemitem class="username">cyrus</systemitem> is
+correctly authenticated, the following lines will appear:</para>
+
+<screen><computeroutput>S: L01 OK User logged in
+Authenticated.</computeroutput></screen>
+<para>To exit type <userinput>. logout</userinput> (&ie; dot space <quote>logout</quote>)</para>
+
+<para>Now add a user named <systemitem
+class="username">groupware</systemitem> and set a password for it, using
+your usual system tools. It should be in an unprivileged group such as
+<systemitem class="groupname">nobody</systemitem> and does not require a
+login shell or a home directory.</para>
+
+<para>Now I have to create the user and an <acronym>IMAP</acronym> in
+<application>cyrus</application> also:</para>
+
+<screen># <userinput><command>cyradm</command> <option>--user cyrus localhost</option></userinput>
+after entering the password for the admin user <systemitem class="username">cyrus</systemitem>, you get the prompt <prompt>localhost&gt;</prompt>
+<prompt>localhost&gt;</prompt> <userinput><command>cm</command> <option>user.groupware</option></userinput>
+<prompt>localhost&gt;</prompt> <userinput><command>lm</command></userinput> <lineannotation>lists the mailbox only just created</lineannotation>
+<computeroutput>user.groupware (\HasNoChildren))</computeroutput>
+<prompt>localhost&gt;</prompt> <userinput><command>quit</command></userinput></screen>
+
+<para>You can type <userinput><command>help</command></userinput> for a list
+of available commands.</para>
+
+<para>You can check what has happened with:</para>
+
+<screen># <userinput><command>ls</command> <option>-l</option> <filename class="directory">/var/spool/cyrus/mail/g/user/groupware</filename></userinput>
+<computeroutput>total 12
+-rw------- 1 cyrus mail 4 Oct 29 20:55 cyrus.cache
+-rw------- 1 cyrus mail 155 Oct 29 20:55 cyrus.header
+-rw------- 1 cyrus mail 76 Oct 29 20:55 cyrus.index</computeroutput></screen>
+
+<para>Now you should be able to connect with an <acronym>IMAP</acronym> client
+as the <systemitem class="username">groupware</systemitem> user and see the
+<literal>INBOX</literal>.</para>
+<note><para>In the <acronym>IMAP</acronym> protocol, selecting the mailbox
+<literal>INBOX</literal> is a magic word, a sort of <quote>alias</quote> for
+the above directory structure. The client sees <literal>INBOX</literal>, and
+the <acronym>IMAP</acronym> server maps it in the <filename
+class="directory">/var/spool/cyrus/mail/...</filename> folder and file
+structure.</para></note>
+
+</sect1>
+
+<sect1 id="kontact-imap-clients">
+<title>How to setup &kontact; clients</title>
+
+<para>I connect to my GNU/Linux office server PC (a sort of "black box"
+without monitor and keyboard) from 2 &Windows; 2000 PC with
+<application>Cygwin/X</application>, using them as a X-Window server (in the
+near future I hope to replace both with 2 mini-itx thin clients using the
+LTSP). With this setup every user runs &kontact; on the same machine where
+<application>Cyrus</application> is installed and running
+(localhost).</para>
+
+<para>To have &kontact; work with <acronym>IMAP</acronym>, there are these
+steps to complete:</para>
+
+<procedure>
+
+<step><para>Create an <acronym>IMAP</acronym> account on the
+<application>Cyrus</application> for fake <systemitem
+class="username">groupware</systemitem> user (already previously
+done!)</para></step>
+
+<step><para>Create/configure an <acronym>IMAP</acronym> account in &kmail;
+for login as that user</para></step> <step><para>Use kresources to make
+&kontact; components work with data taken from <acronym>IMAP</acronym>
+source</para></step>
+
+<step><para>Enable groupware functionality and make related subfolders of
+that <acronym>IMAP</acronym> <literal>INBOX</literal> (if not
+already)</para></step>
+
+<step><para>Enjoy &kontact; and shared data through
+<application>Cyrus</application> IMAP</para></step>
+
+</procedure>
+
+<para>So login to &kde; with the first <quote>real user</quote> account you
+want to provide groupware functionality to.</para>
+
+<para>Let's create the IMAP account in &kmail;.</para>
+
+<para>Run &kontact; and select <guilabel>Mail</guilabel> (the &kmail;
+component). From the menu choose
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure KMail
+</guimenuitem><guilabel>Accounts</guilabel><guilabel>Receiving</guilabel></menuchoice> tab, press the <guibutton>Add...</guibutton> button. You will then be
+prompted for the type of your email account, and select
+<guilabel>disconnected IMAP</guilabel> (not just
+<guilabel>IMAP</guilabel>). Then in the <guilabel>General</guilabel> tab
+enter the following data:</para>
+
+<variablelist>
+<varlistentry>
+<term><guilabel>Account Name:</guilabel> <userinput>office_gwdata</userinput></term>
+<listitem>
+<para>A name that will be used for the <quote>local</quote> folder that
+points to this <acronym>IMAP</acronym> account.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Login:</guilabel> <userinput>groupware</userinput></term>
+<listitem>
+<para>The <application>Cyrus</application> user we have chosen as
+<quote>owner</quote> of all of the office data</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><guilabel>Password:</guilabel></term>
+<listitem>
+<para>The password of the <systemitem
+class="username">groupware</systemitem> user.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Host:</guilabel> <userinput>localhost</userinput></term>
+<listitem>
+<para>Remember for our example, the &kontact; client runs on the same
+computer as the <acronym>IMAP</acronym> server</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Port:</guilabel> <userinput>143</userinput></term>
+<listitem>
+<para>The default</para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+<para>Check <guilabel>store IMAP password</guilabel>
+so you will not be asked for it next time you run &kontact;. Check the
+<guilabel>Enable interval mail checking</guilabel> and set a value in
+minutes.</para>
+
+<para>Note that we have checked the <guilabel>disconnected IMAP</guilabel>
+type account. This has the effect that a copy of the groupware data is
+stored <quote>locally</quote> to the client (under the home folder), and it
+is synchronized every time the client connects. This seems very inefficient,
+since your data is duplicated many times (&ie; if you have 10 users that use
+&kontact;, you have 10+1 times the data), but it is the only way to make
+things run fast, because at every connection &kontact; has to fetch all data
+and have &korganizer; and &kaddressbook; interpret it. If you use
+<quote>disconnected IMAP</quote> data is cached locally, and only the
+<quote>delta</quote> (&ie; the data that has changed) is sent.</para>
+
+<para>On the other end, if your users run &korganizer; on the same PC that
+runs the <acronym>IMAP</acronym> server, it seems reasonable to use
+<acronym>IMAP</acronym> (that is called <quote>online IMAP</quote>) to save
+space, since transfer speed should not be an issue. But unfortunately this
+does not work because &kontact; does not update automatically the
+<guilabel>Calendar</guilabel> folder in <quote>online IMAP</quote>, so you
+are not updated when someone adds events (you must manually switch to
+&kmail; application and click on the <guilabel>Calendar</guilabel>
+folder). In addition, at start up when it does read
+<guilabel>Calendar</guilabel> folders, you may see a tremendous flicker and
+slow data updates.</para>
+
+<para>Now we have to tell &kontact; to use <acronym>IMAP</acronym> as the
+data source for it's various components. From the &kmenu;, choose
+<guimenuitem>Run command</guimenuitem>, run <userinput><command>kcmshell
+kresources</command></userinput>. In the combo box select
+<guilabel>Contacts</guilabel>, then press the <guibutton>Add...</guibutton>
+button, and choose <guilabel>Addressbook on IMAP Server via KMail</guilabel>. Then select that new line and
+press <guibutton>Use as Standard</guibutton> button. Do the same for
+<guilabel>Calendar</guilabel> and <guilabel>Notes</guilabel>.</para>
+
+<para>Now we have to enable the &kmail; (and as a consequence, the whole
+&kontact;) groupware functionality:</para>
+
+<procedure>
+<step>
+<para>Choose from the menu
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+KMail</guimenuitem><guilabel>Misc</guilabel><guilabel>Groupware</guilabel></menuchoice></para>
+</step>
+<step>
+<para>Check <guilabel>Enable IMAP resource functionality</guilabel></para>
+</step>
+<step>
+<para>Choose <guilabel>English</guilabel> as <guilabel>Language of the
+groupware folders</guilabel> (this is in case you already have the folders
+in the <acronym>IMAP</acronym> server created by a different program in a
+different language).</para>
+</step>
+<step>
+<para>Now move to <guilabel>Resource folder are in account</guilabel> and
+select the the <guilabel>Inbox</guilabel> subfolder of the
+<guilabel>office_gwdata</guilabel> folder.</para>
+<para>Leave <guilabel>Hide groupware folders</guilabel> unchecked for now,
+so we can see that happens. You can return here and check it once everything
+is clear.</para>
+</step>
+<step>
+<para>When you press OK you are prompted with:
+<computeroutput>&kmail; will now create the required folders for the IMAP
+resource as subfolders of Inbox</computeroutput> </para>
+<para>If you do not want this, press <guibutton>No</guibutton>, and the
+<acronym>IMAP</acronym> resource will be disabled. Press
+<guibutton>Yes</guibutton> (this happens only the first time with the first
+<quote>real user</quote>). You will immediately see that in the &kmail;
+folder tree, under
+<menuchoice><guilabel>office_gwdata</guilabel><guilabel>Inbox</guilabel></menuchoice>
+these subfolders are created:</para>
+<simplelist>
+<member>Calendar</member>
+<member>Contacts</member>
+<member>Notes</member>
+<member>Tasks</member>
+<member>Journal</member>
+</simplelist>
+<para>if you now do a:</para>
+<screen># <command>ls</command> <option>-l /var/spool/cyrus/mail/g/user/groupware/</option>
+<computeroutput>drwx------ 2 cyrus mail 144 Oct 31 16:36 Calendar
+drwx------ 2 cyrus mail 144 Oct 31 16:36 Contacts
+drwx------ 2 cyrus mail 144 Oct 31 16:36 Journal
+drwx------ 2 cyrus mail 144 Oct 31 16:36 Notes
+drwx------ 2 cyrus mail 144 Oct 31 16:36 Tasks
+-rw------- 1 cyrus mail 4 Oct 31 15:28 cyrus.cache
+-rw------- 1 cyrus mail 155 Oct 29 20:55 cyrus.header
+-rw------- 1 cyrus mail 76 Oct 31 15:28 cyrus.index</computeroutput></screen>
+
+<para>As you see, the <guilabel>office_gwdata Inbox</guilabel> is stored not
+local to the &kontact; current user home, but in the <acronym>IMAP</acronym>
+<systemitem class="username">groupware</systemitem> user's folders.</para>
+</step>
+</procedure>
+
+<para>Now &kontact; is ready to work and store data there. In the calendar
+application, if &kmail; <acronym>IMAP</acronym> account was of type
+<quote>disconnected</quote>, the <guilabel>resource</guilabel> window should
+display the item <guilabel>Imap resource</guilabel> with 3 subitems, that
+are paths to local home files. Instead, the <guilabel>Contacts</guilabel>
+application does not show subitems below the <guilabel>Imap
+resource</guilabel>.</para>
+
+<para>You can now login to &kde; with a different username and set up
+his/her &kontact; client in a very similar manner:</para>
+
+<procedure>
+<step>
+<para>Open &kontact; and in the <guilabel>Mail</guilabel> component add an
+<acronym>IMAP</acronym> account specifying as <guilabel>host</guilabel> the
+computer where <application>Cyrus</application> server runs (in my case:
+<literal>192.168.1.3</literal>).</para>
+
+<para>Remember to check the <guilabel>Enable interval mail
+checking</guilabel> and set a value in minutes. When you confirm, you are
+not prompted for the subfolder creation (since they are found in the
+<acronym>IMAP</acronym> server), and you see them in the folder tree.</para>
+</step>
+<step>
+<para>Activate the groupware functionality to be able to save data in the
+<acronym>IMAP</acronym> server.</para>
+</step>
+</procedure>
+<para>Beware that in <quote>disconnected <acronym>IMAP</acronym></quote>,
+data are transmitted from a client to <acronym>IMAP</acronym> server only
+when the clients connects to check for new mail. So if you have your
+&kontact; clients with an <guilabel>interval mail checking</guilabel> of,
+for instance, 5 minutes, in the worst case you have a 10 minutes delay
+between the event being written and it's appearance to the other
+users.</para>
+</sect1>
+<sect1 id="kontact-imap-readonly">
+<title>How to have Read Only Access</title>
+
+<note><para>Beware that I've been confirmed that Notes
+<acronym>IMAP</acronym> implementation in &kontact; prior to version 1.01 is
+broken, so this setup will not work for them, so you want to use them, you
+need to use the previous setup.</para></note>
+
+<para>In the previous setup, we have the same <quote>fake</quote> user, named
+<systemitem class="username">groupware</systemitem>, that is used by all the
+<quote>real</quote> &kontact; users (&ie; <systemitem
+class="username">tony</systemitem>, <systemitem
+class="username">rohn</systemitem>, <systemitem
+class="username">amanda</systemitem>, &etc;) through the
+<acronym>IMAP</acronym> account with it's login and password. But this way
+every real user has the same read/write permissions of the others, since
+everyone connects as the user <systemitem
+class="username">groupware</systemitem> to the <acronym>IMAP</acronym>
+server.</para>
+
+<para>To limit access to some users (typically, providing read-only access),
+we can use the <acronym>ACL</acronym> (Access Control Lists).</para>
+
+<para>Select in &kmail; a subfolder of <guilabel>office_gwdata</guilabel>
+inbox, for instance <guilabel>Calendar</guilabel>, and right click the
+mouse. Select <guilabel>Properties</guilabel><guilabel>Access
+Control</guilabel> tab. Here you can enter the users you want give access to
+this folder and what they can do.</para>
+
+<para>Just to experiment trying to exchange events, we give
+<quote>All</quote> permission to the user <systemitem
+class="username">mary</systemitem></para>
+
+<para>At <application>cyrus</application> level (in the
+<acronym>PC</acronym> that runs <acronym>IMAP</acronym> server cyrus, with
+<application>cyrus</application> tools), we first need to add the user
+<systemitem class="username">mary</systemitem>, so it's an
+<acronym>IMAP</acronym> recognized user, and create an
+<acronym>IMAP</acronym> folder for her.</para>
+
+<para>Then we login to GNU/Linux as <systemitem
+class="username">mary</systemitem> and enter &kontact;. As previously shown,
+we will setup an <acronym>IMAP</acronym> account in &kmail; with the same
+data but the one of the user (instead of the fake user <systemitem
+class="username">groupware</systemitem> and it's password, we will use
+<systemitem class="username">mary</systemitem> and her password).</para>
+
+<para>In &kmail; folder tree, this time you will see this structure:
+<menuchoice><guimenu>office_gwdata</guimenu><guisubmenu>user</guisubmenu>
+<guisubmenu>groupware</guisubmenu><guimenuitem>Calendar and
+Tasks</guimenuitem></menuchoice>. Check the mail
+(<menuchoice><guimenu>File</guimenu><guimenuitem>Check
+Mail</guimenuitem></menuchoice>) and you will also have an
+<quote>inbox</quote> folder under <quote>office_gwdata</quote>.</para>
+
+<para>Now enable &kmail; groupware functionality, and in <guilabel>Resource
+folders are subfolders of</guilabel> put the
+<guimenuitem>inbox</guimenuitem> that is subfolder of
+<quote>office_gwdata</quote>.</para>
+
+<para>Now enable &kmail; groupware functionality, and in <guilabel>Resource
+folders are subfolders of</guilabel> put the
+<guimenuitem>inbox</guimenuitem> that is subfolder of
+<guisubmenu>office_gwdata</guisubmenu>.</para>
+
+<para>Now you have two branches of folder under
+<quote>office_gwdata</quote>:</para>
+
+<orderedlist>
+<listitem>
+<para><quote>inbox</quote> with Calendar, Contacts, Notes, Tasks and
+Journal, that are saved on <systemitem class="username">mary</systemitem>
+<acronym>IMAP</acronym> folders on the <acronym>IMAP</acronym> server</para>
+</listitem>
+<listitem>
+<para><quote>user</quote>, with the subfolder <quote>groupware</quote> and
+the subfolders to which <systemitem class="username">mary</systemitem> has
+access to (in this example, Calendar and Tasks)</para>
+</listitem>
+</orderedlist>
+<para>&RMB; click on the <quote>user</quote> <quote>Calendar</quote> and
+check if it's of type Calendar (if not, set it to be), and also if
+<quote>user</quote><quote>Tasks</quote> is of type Tasks.</para>
+<para>Now in Calendar you have two available <acronym>IMAP</acronym>
+resources to write against, so if you create a new event, you are prompted
+which one use (or if you left the local resources available, you have
+3!).</para>
+<para>You have go to the lower left small window in Calendar, the one that
+shows available resources, and uncheck the ones that don't point to
+<guilabel>.groupware.directory</guilabel> path (see the tail part of each
+resource path).</para>
+
+</sect1>
+
+<sect1 id="kontact-imap-credits">
+<title>Credits</title>
+
+<para>I'm a newbie, and for this howto I've only provided my time and my
+will. For the knowledge I have really to thank some guys in freenode
+channels for their competence, patience and helpfulness.</para>
+
+<itemizedlist>
+<title>Special thanks to:</title>
+<listitem>
+<para>For the <application>Cyrus</application> <acronym>IMAP</acronym> part
+in #cyrus channel:</para>
+<itemizedlist>
+<listitem>
+<para>[protagonist] Andy Morgan <email>morgan@orst.edu</email></para>
+</listitem>
+<listitem>
+<para>[plixed] Okke Timm <email>okke.timm@web.de</email></para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
+<para>For the &kontact; part in #kontact channel:</para>
+<itemizedlist>
+<listitem>
+<para>[till] Till Adam <email>adam@kde.org</email></para>
+</listitem>
+<listitem>
+<para>[dfaure] David Faure <email>faure@kde.org</email></para>
+</listitem>
+<listitem>
+<para>[mdouhan] Matt Douhan <email>matt@fruitsalad.org</email></para>
+</listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+
+<para>Thank a lot guys!</para>
+
+<para>Ah, and there is also me, [markit] Marco Menardi
+<email>mmenaz@mail.com</email></para>
+
+</sect1>
+
+<sect1 id="kontact-imap-further-reading">
+<title>Further Reading</title>
+
+<itemizedlist>
+<title>Reference</title>
+<listitem><para>KDE: <ulink url="http://www.kde.org">http://www.kde.org</ulink></para></listitem>
+<listitem><para>&kontact; website: <ulink url="http://www.kontact.org">http://www.kontact.org</ulink></para></listitem>
+<listitem><para>Kroupware project: <ulink url="http://www.kroupware.org">http://www.kroupware.org</ulink></para></listitem>
+<listitem><para>&kde; Community Wiki: <ulink url="http://wiki.kde.org">http://wiki.kde.org</ulink></para></listitem>
+<listitem><para>Wine project: <ulink url="http://www.winehq.org">http://www.winehq.org</ulink></para></listitem>
+<listitem><para>Cygwin/X project <ulink url="http://x.cygwin.com">http://x.cygwin.com</ulink></para></listitem>
+<listitem><para>LTSP project: <ulink url="http://www.ltsp.org">http://www.ltsp.org</ulink></para></listitem>
+</itemizedlist>
+
+</sect1>
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: xml
+sgml-omittag:nil
+sgml-shorttag:nil
+sgml-namecase-general:nil
+sgml-general-insert-case:lower
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:0
+sgml-indent-data:true
+sgml-parent-document:("index.docbook" "book" "chapter")
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->