index.docbook 33.6 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
 "dtd/kdedbx45.dtd" [
  <!ENTITY PIM "<acronym>PIM</acronym>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book id="kontact" lang="&language;">

<bookinfo>

<title>The &kontact; Handbook</title>

<authorgroup>
<author>
<firstname>Cornelius</firstname>
<surname>Schumacher</surname>
<affiliation><address>&Cornelius.Schumacher.mail;</address></affiliation>
</author>

<author>
<firstname>Antonio</firstname>
<surname>Salazar</surname>
<affiliation><address><email>savedfastcool@gmail.com</email>
    </address></affiliation>
</author>

<author>
<firstname>Daniel</firstname>
<surname>Molkentin</surname>
<affiliation><address>&Daniel.Molkentin.mail;</address></affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>


<copyright>
<year>2003-2005</year><holder>&Cornelius.Schumacher;</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

44 45
<date>2016-12-08</date>
<releaseinfo>5.4.40 (Applications 16.12)</releaseinfo>
46 47 48 49 50

<abstract><para>&kontact; is the integrated solution to your personal
information management (&PIM;) needs. It combines well-known &kde;
applications such as &kmail;, &korganizer; and &kaddressbook; into a
single interface to provide easy access to mail, scheduling,
51
address book and other &PIM; functionality.</para></abstract>
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104

<keywordset>
<keyword>KDE</keyword>
<keyword>kdepim</keyword>
<keyword>KMail</keyword>
<keyword>Organizer</keyword>
<keyword>KAddressBook</keyword>
<keyword>KNotes</keyword>
<keyword>Akregator</keyword>
<keyword>PIM</keyword>
<keyword>groupware</keyword>
<keyword>Outlook</keyword>
<keyword>Evolution</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title>Introduction</title>

<para>&kontact; is the integrated solution for personal information
management.  It combines the well-known &kde; applications for email,
scheduling, address book, and notes (&kmail;, &korganizer;,
&kaddressbook;, and &knotes;)
into a single interface. Being
based on a true component framework &kontact; provides exactly the
same functionality as the stand-alone applications, and adds more
features, by making use of the integrated way &kontact; runs the
applications as components. Users still retain the choice of which
applications are run within &kontact; and which are run
stand-alone.</para>

<para>In addition to the functionality of the individual applications &kontact;
provides a summary view and advanced drag &amp; drop features between
components.
</para>

</chapter>


<chapter id="components">
<title>&kontact; Components</title>

<para>
&kontact; integrates the following applications. See the individual
application manuals for details on how to use them. These apply to
running them as components inside &kontact; just as well as running
them stand-alone.
</para>

<variablelist>
    <varlistentry>
Burkhard Lück's avatar
Burkhard Lück committed
105
        <term><ulink url="help:/kmail2">&kmail;</ulink></term>
106 107 108
        <listitem><para>The &kde; mail client.</para></listitem>
    </varlistentry>
    <varlistentry>
Burkhard Lück's avatar
Burkhard Lück committed
109
        <term><ulink url="help:/korganizer">&korganizer;</ulink></term>
110 111 112 113
        <listitem><para>The &kde; calendar and scheduling application.</para>
            </listitem>
    </varlistentry>
    <varlistentry>
Burkhard Lück's avatar
Burkhard Lück committed
114
        <term><ulink url="help:/kaddressbook">&kaddressbook;</ulink></term>
115 116 117
        <listitem><para>The &kde; contact manager.</para></listitem>
    </varlistentry>
    <varlistentry>
Burkhard Lück's avatar
Burkhard Lück committed
118
        <term><ulink url="help:/knotes">&knotes;</ulink></term>
119 120 121
        <listitem><para>The &kde; sticky notes application.</para></listitem>
    </varlistentry>
    <varlistentry>
Burkhard Lück's avatar
Burkhard Lück committed
122
        <term><ulink url="help:/akregator">&akregator;</ulink></term>
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356
        <listitem><para>The &kde; RSS feed reader.</para>
            </listitem>
    </varlistentry>
</variablelist>

</chapter>

<chapter id="main-window">
<title>The &kontact; Main Window</title>

<para>The Main Window consists of a side pane on the left showing the icons of
the available components, a main view on the right which contains the main
window of the active component and the usual menu, tool and status bars.</para>

<sect1 id="side-pane">
<title>Side Pane</title>

<para>The Side Pane serves multiple purposes. It allows for switching between
components, shows which component is active and serves as the target for
drag &amp; drop operations to the different applications.</para>

<screenshot>
<screeninfo>&kontact;'s Side Pane</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="side-pane.png" /></imageobject>
<textobject>
<phrase>&kontact;'s Side Pane</phrase>
</textobject>
<caption>
<para>
&kontact;'s Side Pane
</para>
</caption>
</mediaobject>
</screenshot>

<para>For switching between components simply click on the corresponding icon.
The main window of the component is shown and the menu, tool and status bars are
adapted to reflect the functionality of the active component. If you activate a
component for the first time there might be a small delay until the main view
is changed, because components are loaded on demand. This means you don't waste
memory for components not in use.</para>

<para>The icons in the Side Pane can also be used as targets for drag &amp; drop
operations. For example, you can drag a mail message from the mail part and
drop it on the icon of the to-do list or the calendar to create a to-do
or event associated with this mail.</para>

<para>Finally, you can change the size of the icons in the Side Pane.
Right-clicking on the Side Pane will give you the option to use Large,
Normal, or Small icons, as well as the option to use text only
instead of icons.</para>

<para>If you dislike the Side Pane, you can simply hide it by dragging the
splitter. An alternative navigation between parts is provided by the 
<guilabel>Navigator</guilabel> toolbar, which can be freely positioned. See
<xref linkend="bars" /> for more on the <guilabel>Navigator</guilabel>
toolbar.</para>

</sect1>


<sect1 id="main-view">

<title>Main View</title>

<para>The view on the right which takes up most of the area of the &kontact;
main window shows the active component. This exactly corresponds to the main
window the component uses when run as a stand-alone application. The highlighted
icon in the Side Pane indicates to which application the Main View belongs.
&kontact; remembers the active component when exiting, so the next time
&kontact; starts it initially displays that component in the Main View.</para>

<screenshot>
<screeninfo>&kontact;'s Main View</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="main-view.png"/></imageobject>
<textobject>
<phrase>&kontact;'s Main View</phrase>
</textobject>
<caption>
<para>
    &kontact;'s Main View
</para>
</caption>
</mediaobject>
</screenshot>

<para>In addition, there are two ways of overriding the component that &kontact;
starts with. The first is supplying an argument to the &kontact; program call
(see <xref linkend="command-line"/>). The second is a setting in the
&kontact; Settings dialog that will allow you to always start &kontact; in a 
certain mode.</para>

<para>To get to it, go to <menuchoice><guimenu>Settings</guimenu>
<guimenuitem>Configure Kontact</guimenuitem></menuchoice> and click on
<guilabel>Kontact</guilabel> in the list.</para>

<screenshot>
<screeninfo>&kontact; Starting Component Setting</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="configuration-starting-component.png"/></imageobject>
<textobject>
<phrase>&kontact; Starting Component Setting</phrase>
</textobject>
<caption>
<para>
    &kontact; Starting Component Setting
</para>
</caption>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="bars">
<title>Menu, Tool and Status Bars</title>

<para>The menu, tool and status bars are adapted to the active component. That
means that, in addition to some common functions like the help menu which are
shown for all components, there are actions which are switched when the active
component is switched. These actions available for each component are the same
as those available when running the application stand-alone.</para>

<screenshot>
<screeninfo>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</screeninfo>
<mediaobject>
<imageobject>
    <imagedata format="PNG" fileref="menu-bar-summary.png"/></imageobject>
<textobject>
<phrase>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</phrase>
</textobject>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</screeninfo>
<mediaobject>
<imageobject>
    <imagedata format="PNG" fileref="menu-bar-kmail.png"/></imageobject>
<textobject>
<phrase>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</phrase>
</textobject>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</screeninfo>
<mediaobject>
<imageobject>
    <imagedata format="PNG" fileref="menu-bar-korganizer.png"/></imageobject>
<textobject>
<phrase>Views of &kontact;'s menubars in the Summary View, Mail View, and
    Calendar View</phrase>
</textobject>
<caption>
<para>
    Views of &kontact;'s menubars in the Summary View, Mail View, and Calendar
    View.
</para>
</caption>
</mediaobject>
</screenshot>

<para>In addition, &kontact; can show the <guilabel>Navigator</guilabel>
toolbar, which allows you access to the &kontact; components very much as the
Side Pane does. However, unlike the Side Pane, buttons in the
<guilabel>Navigator</guilabel> toolbar cannot be used for drag &amp; drop
operations to other components.</para>

<para>To activate the toolbar, select <menuchoice><guimenu>Settings</guimenu>
<guisubmenu>Toolbars Shown</guisubmenu>
<guimenuitem>Navigator</guimenuitem></menuchoice>.
</para>

<screenshot>
<screeninfo>&kontact;'s <guimenuitem>Navigator</guimenuitem>
    toolbar.</screeninfo>
<mediaobject>
<imageobject>
    <imagedata format="PNG" fileref="navigator-bar-kontact.png"/></imageobject>
<textobject>
<phrase>&kontact;'s <guimenuitem>Navigator</guimenuitem> toolbar.</phrase>
</textobject>
<caption>
<para>
    &kontact;'s <guimenuitem>Navigator</guimenuitem> toolbar.
</para>
</caption>
</mediaobject>
</screenshot>

<para>A special action common to all components is the
<guimenuitem>New</guimenuitem> action. It allows creation of new objects
including emails, contacts, appointments and to-dos independently of which
component is active. The component responsible for processing the
selected object is started, if required, and takes over the created
object.</para>

<screenshot>
<screeninfo>&kontact;'s New Menu</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="new-menu.png"/></imageobject>
<textobject>
<phrase>&kontact;'s New Menu</phrase>
</textobject>
<caption>
<para>
&kontact;'s New Menu
</para>
</caption>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="side-pane-drag-and-drop">
<title>Drag and Drop Functionality</title>

<para>&kontact; provides advanced drag and drop functionality between 
the programs it contains. Following is a brief description of each of
the specific drag and drop operations that can be used and the
result of each.</para>

<sect2 id="side-pane-drag-and-drop-kmail-todo">
<title>&kmail; -&gt; &korganizer; To-do List</title>

<para>
Dragging a message from 
Burkhard Lück's avatar
Burkhard Lück committed
357
<ulink url="help:/kmail2/using-kmail.html#the-mail-reader-window">&kmail;'s Headers pane</ulink>
358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379
to the icon for &korganizer;'s To-do list 
(<guiicon><inlinemediaobject><imageobject>
<imagedata fileref="todo-list-sidebar-icon.png" format="PNG"/>
</imageobject></inlinemediaobject></guiicon>)
will create a new To-do with 
<guilabel>Mail: <replaceable>Subject</replaceable></guilabel> as the title and 
<guilabel>From: <replaceable>Sender</replaceable>
To: <replaceable>Receiver</replaceable>
Subject: <replaceable>Subject</replaceable></guilabel> as the contents
(where text that looks <guilabel><replaceable>like
this</replaceable></guilabel> is information
from the message itself), as well as the email message itself as an
attachment.
</para>

</sect2>

<sect2 id="side-pane-drag-and-drop-kmail-calendar">
<title>&kmail; -&gt; &korganizer; Calendar</title>

<para>
Dragging a message from 
Burkhard Lück's avatar
Burkhard Lück committed
380
<ulink url="help:/kmail2/using-kmail.html#the-mail-reader-window">&kmail;'s Headers pane</ulink>
381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398
to the icon for &korganizer;'s Calendar
(<guiicon><inlinemediaobject><imageobject>
<imagedata fileref="calendar-sidebar-icon.png" format="PNG"/>
</imageobject></inlinemediaobject></guiicon>)
will create a new Event with 
<guilabel>Mail: <replaceable>Subject</replaceable></guilabel> as the title and 
<guilabel>From: <replaceable>Sender</replaceable>
To: <replaceable>Receiver</replaceable>
Subject: <replaceable>Subject</replaceable></guilabel> as the contents
(where text that looks <guilabel><replaceable>like
this</replaceable></guilabel> is information
from the message itself), as well as the email message itself as an
attachment.
</para>

<para>Note that dragging onto the To-do button creates a To-do,
whereas dragging onto the Calendar creates an Event. More on this
distinction is available in the 
Burkhard Lück's avatar
Burkhard Lück committed
399
<ulink url="help:/korganizer">&korganizer; documentation</ulink>
400 401 402 403 404 405 406 407 408 409
</para>

</sect2>


<sect2 id="side-pane-drag-and-drop-kmail-contacts">
<title>&kmail; -&gt; &kaddressbook;</title>

<para>
Dragging a message from 
Burkhard Lück's avatar
Burkhard Lück committed
410
<ulink url="help:/kmail2/using-kmail.html#the-mail-reader-window">&kmail;'s Headers pane</ulink>
411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428
 to the icon for &kaddressbook;
(<guiicon><inlinemediaobject><imageobject> <imagedata
                                           fileref="kaddressbook-sidebar-icon.png" 
                                           format="PNG" />
</imageobject></inlinemediaobject></guiicon>) will create a contact
from the email address of the sender, unless a contact with that name
already exists. A dialog box notifies you of this action.
</para>


</sect2>


<sect2 id="side-pane-drag-and-drop-kaddressbook-todo">
<title>&kaddressbook; -&gt; &korganizer; To-do List</title>

<para>
Dragging any number of entries from <ulink
Burkhard Lück's avatar
Burkhard Lück committed
429
url="help:/kaddressbook/using-kaddressbook.html">&kaddressbook;'s main
430 431 432 433 434 435 436 437 438 439 440 441
window</ulink> to the icon for &korganizer;'s To-do List
(<guiicon><inlinemediaobject><imageobject> <imagedata
                                           fileref="todo-list-sidebar-icon.png" 
                                           format="PNG"/>
</imageobject></inlinemediaobject></guiicon>) will create a new To-do
with &quot;Meeting&quot; as the title and the selected contacts as
attendees.
</para>

<para>Note that dragging onto the To-do button creates a To-do,
whereas dragging onto the Calendar creates an Event. More on this
distinction is available in the 
Burkhard Lück's avatar
Burkhard Lück committed
442
<ulink url="help:/korganizer">&korganizer; documentation</ulink>
443 444 445 446 447 448 449 450 451 452
</para>

</sect2>


<sect2 id="side-pane-drag-and-drop-kaddressbook-calendar">
<title>&kaddressbook; -&gt; &korganizer; Calendar</title>

<para>
Dragging any number of entries from <ulink
Burkhard Lück's avatar
Burkhard Lück committed
453
url="help:/kaddressbook/using-kaddressbook.html">&kaddressbook;'s main
454 455 456 457 458 459 460 461 462 463 464 465
window</ulink> to the icon for &korganizer;'s Calendar
(<guiicon><inlinemediaobject><imageobject> <imagedata
                                           fileref="calendar-sidebar-icon.png" 
                                           format="PNG"/>
</imageobject></inlinemediaobject></guiicon>) will create a new Event
with &quot;Meeting&quot; as the title and the selected contacts as
attendees.
</para>

<para>Note that dragging onto the To-do button creates a To-do,
whereas dragging onto the Calendar creates an Event. More on this
distinction is available in the 
Burkhard Lück's avatar
Burkhard Lück committed
466
<ulink url="help:/korganizer">&korganizer; documentation</ulink>
467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659
</para>

</sect2>


</sect1>

</chapter>

<chapter id="summary-view">
<title>The Summary View</title>

<para>The default view when starting &kontact; for the first time is the Summary
View. It shows an overview of the most relevant information provided by the
selected &kontact; components. These can be notes, imminent
appointments or birthdays, due to-dos, new messages &etc; Which information is
shown is configurable by selecting the corresponding components in the <link
linkend="configuration">&kontact; configuration dialog</link>.</para>

<screenshot>
<screeninfo>&kontact;'s Summary View</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="summary-view.png"/></imageobject>
<textobject>
<phrase>&kontact;'s Summary View</phrase>
</textobject>
<caption>
<para>
&kontact;'s Summary View
</para>
</caption>
</mediaobject>
</screenshot>

<!-- not in kde4 para>If you think the information you see is outdated, you can click on the
<guibutton>Refresh</guibutton> button (<guiicon><inlinemediaobject><imageobject>
<imagedata fileref="summary-view-refresh-button.png" format="PNG"/>
</imageobject></inlinemediaobject></guiicon>)
in the Summary View toolbar to refresh
the data.</para-->

<sect1 id="summary-view-component-reposition">
<title>Repositioning Summary View Components</title>

<para>The Summary View allows you to change where the
components are in the view itself. So, if you prefer to
have your Special Dates in the lower left and your To-dos in
the upper right, you can rearrange the Summary View to
reflect that.</para>

<para>Repositioning components in the Summary View is as simple
as dragging them to the new location you want them to be in. Hold down the
&Ctrl; key, click and hold on the gray title area of the component and drag
the component to wherever you want it to be. Note that this positioning is done
compared to other components. So you can move the Mail component to be
below the To-do component in the view, but you cannot place it in a specific
position. If you have only one component in your Summary View, the only option
is to move it between the two columns of the view; two components can either
be two in one column or one in each column; and so on and so forth. Whenever
you are dragging a component, you will see a small preview box following your
mouse around showing you the component.</para>

<screenshot>
<screeninfo>Rearranging &kontact;'s Summary View</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="summary-view-repositioning.png"/></imageobject>
<textobject>
<phrase>Rearranging &kontact;'s Summary View</phrase>
</textobject>
<caption>
<para>
Rearranging &kontact;'s Summary View
</para>
</caption>
</mediaobject>
</screenshot>
</sect1>

</chapter>


<chapter id="configuration">
<title>Configuring &kontact;</title>

<sect1 id="main-config">
<title>&kontact; Configuration Window</title>

<para>When selecting the <guimenuitem>Configure &kontact;</guimenuitem>
action from the <guimenu>Settings</guimenu> menu, the &kontact;
configuration dialog is shown. It provides a list of the
configurations for all the active components of &kontact;. You can
click the <guilabel>&gt;</guilabel> symbol next to the component name to
expand the tree so that you can view the options for that
component. Selecting one of the configuration
options under a heading will bring up that configuration section on
the right.</para>

<screenshot>
<screeninfo>&kontact;'s Configuration Window</screeninfo>
<mediaobject>
<imageobject><imagedata format="PNG" fileref="configuration-main.png"/></imageobject>
<textobject>
<phrase>&kontact;'s Configuration Window</phrase>
</textobject>
<caption>
<para>
&kontact;'s Configuration Window
</para>
</caption>
</mediaobject>
</screenshot>

<para>By checking the box next to the component title you select the
component to be visible in the Side Pane and the Summary View. The
component is loaded and shown in the Main Window when
clicking on its icon in the Side Pane. By
unchecking the check box the component is removed from the Side Pane and
Summary View. Changes become effective by clicking the
<guibutton>Apply</guibutton> or <guibutton>OK</guibutton>
buttons.</para>

<para>You can also configure individual components by clicking on the
corresponding icon in the Side Pane and then selecting the menu item
<guimenuitem>Configure <replaceable>application name</replaceable></guimenuitem>
from the <guimenu>Settings</guimenu> menu.</para>

<screenshot>
<screeninfo>&kontact; Settings Menu When &kmail; is Selected</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="settings-menu-kmail.png"/>
</imageobject>
<textobject>
<phrase>&kontact; Settings Menu When &kmail; is Selected</phrase>
</textobject>
<caption>
<para>
&kontact; Settings Menu When &kmail; is Selected
</para>
</caption>
</mediaobject>
</screenshot>

</sect1>

<sect1 id="summary-view-config">
<title>Configuring &kontact;'s Summary View</title>

<para>When you select <guilabel>Summaries</guilabel>
in the &kontact; settings dialog, a page is displayed that allows you to select which summary
plugins &kontact; should show in its summary view.
Here is a brief list of the currently available plugins and what they do:
</para>

<screenshot>
<screeninfo>Summary Selection</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-selection.png"/>
</imageobject>
<textobject>
<phrase>Summary Selection</phrase>
</textobject>
<caption><para>Summary Selection</para></caption>
</mediaobject>
</screenshot>

<sect2 id="summary-view-config-calendar">
<title>&kontact; Summary Plugins: Calendar</title>

<para>
The <quote>Calendar</quote> plugin for &kontact;'s Summary View adds
an area in the view labeled <guilabel>Upcoming Events</guilabel>. This
will display any events that currently apply.
</para>

<screenshot>
<screeninfo>&kontact; Calendar Summary Plugin</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-view-calendar.png"/>
</imageobject>
<textobject>
<phrase>&kontact; Calendar Summary Plugin</phrase>
</textobject>
<caption>
<para>
&kontact; Calendar Summary Plugin
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>
660

661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790
<sect2 id="summary-view-config-mail">
<title>&kontact; Summary Plugins: Mail</title>

<para>
The <quote>Mail</quote> plugin for &kontact;'s Summary View adds an
area in the view labeled <guilabel>New Messages</guilabel>. This area
is updated every time you receive new messages to inform you how many
of these messages there are and which folder they are in.
</para>

<screenshot>
<screeninfo>&kontact; Mail Summary Plugin</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-view-mail.png"/>
</imageobject>
<textobject>
<phrase>&kontact; Mail Summary Plugin</phrase>
</textobject>
<caption>
<para>
&kontact; Mail Summary Plugin
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="summary-view-config-notes">
<title>&kontact; Summary Plugins: Notes</title>

<para>
The <quote>Notes</quote> plugin for &kontact;'s Summary View adds an
area in the view labeled <guilabel>Popup Notes</guilabel>. This area
displays all current notes' titles (titles default to the date/time
the note was created). Clicking on the title of a note will bring up
the Notes area.
</para>

<screenshot>
<screeninfo>&kontact; Notes Summary Plugin</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-view-notes.png"/>
</imageobject>
<textobject>
<phrase>&kontact; Notes Summary Plugin</phrase>
</textobject>
<caption>
<para>
&kontact; Notes Summary Plugin
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="summary-view-config-todo-list">
<title>&kontact; Summary Plugins: To-do List</title>

<para>
The <quote>To-do List</quote> plugin for &kontact;'s Summary View adds
an area in the view labeled <guilabel>Pending To-dos</guilabel>. This area
contains all current to-dos, including ones that have been completed.
It displays the title of the to-do, the percentage of completion, and
the current status of the to-do. Note that you can purge all completed
to-dos via the &kontact; To-do List. Clicking on a to-do's title will
currently do nothing.
</para>

<screenshot>
<screeninfo>&kontact; To-do List Summary Plugin</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-view-todos.png"/>
</imageobject>
<textobject>
<phrase>&kontact; To-do List Summary Plugin</phrase>
</textobject>
<caption>
<para>
&kontact; To-do List Summary Plugin
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>

<sect2 id="summary-view-config-special-dates">
<title>&kontact; Summary Plugins: Special Dates</title>

<para>
The <quote>Special Dates</quote> plugin for &kontact;'s Summary View adds an
area in the view labeled <guilabel>Upcoming Special Dates</guilabel>.
This area contains information based on the criteria selected in the
configuration area of the plugin in &kontact;'s Summary View configuration.
The <quote>Special Dates</quote> plugin is especially useful because it can
display birthdays, anniversaries, holidays, and special occasions from both
the calendar and the contact list in one place.
</para>

<screenshot>
<screeninfo>&kontact; Special Dates Plugin</screeninfo>
<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="summary-view-special-dates.png"/>
</imageobject>
<textobject>
<phrase>&kontact; Special Dates Plugin</phrase>
</textobject>
<caption>
<para>
&kontact; Special Dates Plugin
</para>
</caption>
</mediaobject>
</screenshot>
</sect2>
</sect1>

</chapter>


<chapter id="command-line">
<title>&kontact; On the Command Line</title>

<para>&kontact; has several command line arguments
that can be used for certain actions.</para>

<para>First of all, &kontact; supports command line arguments
791
that all &kf5;/&Qt; applications support, see the man pages qt5options and kf5options.
792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910
</para>

<para>&kontact; also supports several command line arguments
specific to it.</para>

<sect1 id="command-line-arguments">
<title>Command Line Arguments</title>

<sect2 id="command-line-module">
<title>Module-related Arguments</title>

<para>To get a list of available &kontact; modules, you can type:</para>

<para>
<prompt>&percnt;</prompt> <command>kontact --list</command>
</para>

<para>Then, to start &kontact; with a module active, type:</para>

<para>
<prompt>&percnt;</prompt> <command>kontact --module <replaceable>moduleName</replaceable></command>
</para>

<para>Where <replaceable>moduleName</replaceable> is one of the modules obtained using the
previous command.</para>

</sect2>

<sect2 id="command-line-startup">
<title>Startup-related Arguments</title>

<para>To start &kontact; in iconified mode<footnote><para>Iconified mode is also
called minimized; it is when the application window is hidden and the
application is available only in the taskbar.</para></footnote>, you can
type:</para>

<para>
<prompt>&percnt;</prompt> <command>kontact --iconify</command>
</para>

</sect2>

</sect1>

</chapter>


<chapter id="technology">
<title>Under The Hood</title>

<para>&kontact; makes extensive use of several &kde; key technologies, most
notably KParts and &DBus;.</para>

<para>The &GUI; integration of the components is done by plugins
providing KParts versions of the applications. This only needs a thin
additional layer on top of the already existing code of the
stand-alone applications.</para>

<para>For communication between the components &DBus; is used. This
has the nice characteristic that it is completely transparent to
whether the application is run stand-alone or embedded as KPart into
&kontact;. When running inside of &kontact; an efficient in-process
mode of &DBus; is used.</para>

</chapter>


<chapter id="credits">
<title>Credits and License</title>

<para>&kontact;</para>

<para>Program copyright 2004-2005, The &kde; Developers</para>

<para>Contributors:</para>

<itemizedlist>
<listitem><para>&Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para>
    </listitem>
<listitem><para>&Daniel.Molkentin; &Daniel.Molkentin.mail;</para>
    </listitem>
<listitem><para>&Don.Sanders; &Don.Sanders.mail;</para>
    </listitem>
<listitem><para>&Tobias.Koenig; &Tobias.Koenig.mail;</para>
    </listitem>
<listitem><para>Allen Winter <email>winter@kde.org</email></para></listitem>
<listitem><para>Matthis H&ouml;lzer-Kl&uuml;pfel <email>mhk@kde.org</email>, the
original author of the &kontact; framework.</para>
    </listitem>

<listitem><para>All the valued developers of the applications &kontact; is
integrating. They did almost all the work.</para>
    </listitem>
</itemizedlist>

<para>Documentation copyright 2004-2005</para>

<para>Contributors:

<itemizedlist>
<listitem><para>&Cornelius.Schumacher; &Cornelius.Schumacher.mail;</para>
</listitem>
<listitem><para>Antonio Salazar <email>savedfastcool@gmail.com</email></para>
</listitem>
<listitem><para>&Daniel.Molkentin; &Daniel.Molkentin.mail;</para>
</listitem>

<listitem><para>All the members of the &kde; documentation list who
assisted with markup and style issues.</para>
</listitem>
</itemizedlist>
</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;

</chapter>

911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050
<appendix id="kontact-admin">
<title>Administrator's Guide</title>
<!-- Section Compatibility -->
<sect1 id="compat">
<title>Compatibility Issues</title>

<para>
This section provides help with how to make &kontact;
communicate effectively with various groupware solutions.
</para>

<sect2 id="compat-outlook">
<title>Outlook and Exchange</title>

<para>
In the &kontact; configuration dialog, under <menuchoice><guimenu>Mail</guimenu>
<guimenuitem>Misc</guimenuitem></menuchoice> on the <guilabel>Invitations</guilabel> page 
you will find the following options that will help the user communicate
with Microsoft Outlook(tm) running in a Kolab environment or in a
Microsoft Exchange(tm) environment.
</para>

<variablelist>

<varlistentry>
<term><guilabel>Mangle From:/To: headers in replies to invitations</guilabel></term>
<listitem>
<para>Enable this option to make Microsoft Outlook(tm) understand your answers to invitation replies.</para>
<para>Microsoft Outlook has a number of shortcomings in its implementation of
the iCalendar standard; this option works around one of them. If you 
have problems with Outlook users not being able to get your replies,
try setting this option.</para>
<para>Details: When mailing an iCal invitation this makes the message have 
the From: header the same as the To: header. It also sets header
 X-KMail-Identity to the To:'s UIOD and makes sure the BCC: is blank.
Outlook will only understand the reply if the From: header is 
the same as the To: header of the invitation message.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Send invitations in the mail body</guilabel></term>
<listitem>
<para>Invitations are normally sent as attachments to a mail. This switch
changes the invitation to be sent in the text of the mail instead;
this is necessary to send invitations and replies to Microsoft Outlook.
But, when you do this, you no longer get descriptive text that mail
programs can read; so, to people who have email programs that do not
understand the invitations, the resulting messages look very odd.
People that have email programs that do understand invitations will
still be able to work with this.</para>
<para>Details: When mailing an iCal invitation this option makes the
message body from the attachment data and sets the Content-Type header
to 'text/calendar; method=something; charset="utf-8"'.</para>
<para>Auto-sending is also turned on so there is no human intervention
required for composing.</para>
<note><para>Encryption and self-signing are disabled.</para></note>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Exchange-compatible invitation naming</guilabel></term>
<listitem>
<para>Microsoft Outlook, when used in combination with a Microsoft Exchange(tm)
server, has a problem understanding standards-compliant groupware email.
Enable this option to send groupware invitations in a way that Microsoft
Exchange(tm) understands. The invitation will be sent as an attachment with name
<filename>ical.ics</filename>.</para>
<para>Details: When mailing an iCal invitation this makes
the message have the subject "(Declined|Tentative|Accepted|Delegated): subject".
The invitation will be sent as an attachment with name <filename>ical.ics</filename>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Outlook-compatible attachment naming</guilabel></term>
<listitem>
<para>Turn this option on to make Outlook(tm) understand attachment names
containing non-English characters.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>

<!-- Section Behavior -->
<sect1 id="behavior">
<title>Behavioral Issues</title>

<para>
This section provides instructions on how to make &kontact; 
behave more like other groupware clients.
</para>

<sect2 id="behave-composing">
<title>Composing Messages</title>

<para>
Outlook users are accustomed to typing a list of addresses in the To:,
CC: or BCC: fields separated by a semicolon (';') character in addition
to a comma (',').  By default, &kontact; only allows the comma as an address
separator character.  To also allow the semicolon, change the
<option>AllowSemicolonAsAddressSeparator</option> from false to true
in the installed <filename>share/config.kcfg/messagecomposer.kcfg</filename> file. 
</para>

</sect2>
</sect1>

<!-- Section RFC Compromises -->
<sect1 id="nonrfc">
<title>RFC Compromises</title>

<para>&kontact; is designed to interoperate as well as is possible
with a wide variety of groupware solutions.  To that end, we sometimes
make design compromises with respect to the various Internet RFCs
that provide the basis for low-level libraries on which &kontact;
relies heavily.</para>

<note><para>We never knowingly violate any RFC.</para></note>

<para>The following list of RFC compromises is made by &kontact; or
the low-levels libraries used by &kontact;:</para>
<!--FIXME is this correct?-->
<itemizedlist>
<listitem>
<para>
When writing duration values into iCalendar files, &kontact; never
writes the DURATION property in terms of weeks (i.e., 1*DIGIT "W"); 
instead, the integer number of weeks is always multiplied by 7 and written
in terms of days (i.e. 1*DIGIT "D").
</para>
</listitem>
</itemizedlist>

</sect1>

</appendix>
1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->