Chapter 7. KOrganizer Configuration

To change KOrganizer's look and behavior, choose the SettingsConfigure KOrganizer... menu item. You can get more information about all the configure options and possibilities in the section called “KOrganizer Main Configuration”.

To customize the set of tools available on the bar, choose the SettingsConfigure Toolbars... menu item and read the Section Customizing Toolbars in the KDE Fundamentals.

Localization information like date and time formats can be configured from System Settings within the modules Language, and Formats. These control modules can be accessed from within KOrganizer: just choose the SettingsConfigure Date & Time... menu item. KOrganizer has to be restarted for changes done in System Settings to take effect.

To configure where KOrganizer stores and retrieves calendar events, journal entries and to-dos, (in local files, groupware servers etc.), please check the section called “Calendar Resources”.

KOrganizer Main Configuration

The options dialog lets you configure a number of different areas of KOrganizer.

General page

Personal tab

The personal options relate to your personal identity, and other miscellaneous things that do not fall under any of the other general categories.

Full name

Full name is initially set to Anonymous with an email address of nobody@nowhere. You can change your name by directly entering it here. This name will be displayed by default as Organizer in to-dos and Events.

Email address

Email address will be used to identify the owner of the calendar. When another person opens your calendar or events, he/she will not be able to modify it because it will be read-only.

Default Email Attachment Method

This option allows you to select the way an email is attached to an event. You can attach an email as the complete email including attachments, the email excluding attachments or only a link to the email.

Note that attaching an email without attachments might invalidate its signature.

Save tab

Confirm deletes

When you check Confirm deletes box, KOrganizer will ask you to confirm each deletion. If this is not checked, KOrganizer will not ask before deleting events.

New Events, To-dos and Journal Entries Should

This option lets you choose between adding new items to the default calendar or making KOrganizer ask you which calendar should be used to save each new item.

Kolab2 server specificity: It is recommended to choose Be asked which calendar to use, if you intend to use the shared folder functionality of the Kolab server. This will allow you to keep control of which information is available only to you, and which information is published in the shared folders.

Time and Date

Regional tab

Day begins at

Select the time you start your day from the drop down list. It could be the time when you usually get up, or the time when you start working. This setting does not prevent you from adding or viewing items before this time, it just sets the time that will be displayed by default on the top of the calendar view. Use the scrollbar to display earlier or later events in the Agenda view.

Holidays

Select your country from the drop down list, or if it is not listed, select (None). If your country is selected, KOrganizer will recognize and display its important dates and holidays in the calendar view.

Working Period

The options Daily starting hour and Daily ending hour let you specify when your working day starts and when it ends. KOrganizer sets the working hours apart by marking them with a different color from the non working hours, holidays and non working days.

Additionally, you have check boxes beside each day of the week. Check the week days that are working days for you, in order to mark the working hours in these days. Checking Exclude holidays prevents KOrganizer from marking the working hours for the holiday days in the region defined in the Use holiday region drop down above.

Weekly Start Day

Select the first day of each week. Normally, you can ignore this since it is set in your locale.

Default Values tab

Default appointment time

Select the default start time for events from the drop down list. When you choose New Event from the Actions Menu, or create an event in some other manner such that KOrganizer cannot guess when you would like your event to start, KOrganizer will put this hour in the start time editor as the default value.

Default duration of new appointment (HH:MM):

Select the default duration for events using the spin box. When you choose New Event from the Actions Menu, or create an event in some other manner such that KOrganizer cannot guess its duration, KOrganizer will use this as the default value.

Reminders

Select a Default reminder time to determine how long before the actual event's scheduled time the reminder will activate.

Set a file to be used as the default sound file for new reminders. You can always specify another file in the Advanced Reminder accessible from the event or to-do editors.

Check the next two boxes if you want to enable reminders for all newly created events or to-dos. You can always turn-off the reminders in the editor dialogs.

Views

These options let you configure KOrganizer views:

General tab

Next x days:

This option allows you to change the number of days shown by the Next x Days menu item in the Go menu.

Enable tooltips for displaying summaries

If your summary for an event is longer than would fit in the current View, the remaining characters are not displayed. Check Enable tooltips for displaying summaries if you want the full summary displayed when hovering the mouse pointer over the appointment for a few seconds.

To-dos use tag colors

Check this box so that to-dos will use tag colors and not colors specific to their due, due today or overdue state.

Date Navigator options:

Show items that recur daily

If the Show items that recur daily box is checked, the days containing daily recurring events are shown in bold typeface in the Date Navigator.

Show items that recur weekly

If the Show items that recur weekly box is checked, the days containing weekly recurring events are shown in bold typeface in the Date Navigator.

Show to-dos instead of events when in Todo View

Check this box to show the days containing to-dos in bold typeface in the Date Navigator when in To-do view.

Show journals instead of events when in Journal View

Check this box to show the days containing journals in bold typeface in the Date Navigator when in Journal view.

Week numbers select a work week when in work week mode

If the Week numbers select a work week when in work week mode box is checked, clicking on the week numbers along the side of the Date Navigator will navigate through work weeks rather than through normal 7-day weeks.

Agenda View tab

Agenda View options:

Hour size:

By using this you can control the height of the rows in the Agenda view.

Show icons in agenda view items

Check this box to display icons (reminder, recursion etc.) in Agenda view items

Show to-dos

This check box toggles the display of to-dos in the Day, Week and Month views in the Agenda view. If you have too many to-dos which have a due date associated, you may want to turn them off to avoid clutter.

Show current-time (Marcus Bains) line

This check box toggles on or off a red line in the Day or Week view indicating the current time (Marcus Bains line). This line gives you an indication of how much time is left e.g. until a meeting takes place.

Show seconds on current-time (Marcus Bains) line

This check box toggles on or off the seconds on the current-time line (Marcus Bains line).

Time range selection in agenda view starts event editor

Check this box to start the event editor automatically when you select a time range in the daily and weekly view. To select a time range, drag the mouse from the start time to the end time of the event you are about to plan.

Color Usage

Select the Tag inside, calendar outside option if you would like to draw calendar items in their associated tag's color, with the item's border drawn in the color of its calendar.

Select the Calendar inside, tag outside option if you would like to draw calendar items in their associated calendar color, with the item's border drawn in the color of its tag.

Select the Only tag option if you would like to draw calendar items (both inside and border) in the color of their associated tag.

Select the Only calendar option if you would like to draw calendar items (both inside and border) in the color of their calendar.

Please use the Colors and Fonts configuration page for setting these colors.

Color busy days with a different background color

Check this box if you want Agenda view's background to be filled with a different color on days which have at least one all day event marked as busy.

Please look in the Colors configuration area to select the Agenda view background busy color of your choosing.

Multiple Calendar Display

Select if all calendars should be merged into one Agenda view, each calendar should be displayed in its own Agenda view or if each view should be available via tabs. The side by side view can be customized with Configure View from the context menu.

Month View tab

Month view options:

Display Options

Use the first four check boxes to display the time, icons (reminder, recursion etc.), to-dos or journals in Month view.

Color busy days with a different background color

Check this box if you want Month view's background to be filled with a different color on days which have at least one all day event marked as busy.

Please look in the Colors configuration area to select the Agenda/Month view background busy color of your choosing.

Color Usage

Configure the colors for the Month view as in Agenda view.

Todo View tab

Todo view options:

Always display completed to-dos at the bottom of the list

If you enable this option, all completed to-dos will be always grouped at the bottom of the To-do List.

Record completed to-dos in journal entries

If you check this box, KOrganizer will automatically add a journal entry for every completed to-do.

Colors and Fonts

Colors

Choose the color used for holidays, for highlighting, and for specific event tags. You can choose a different color for each tag. Of course too many colors may be confusing, so use common sense. The use of color depends also on the view preferences.

Holiday color

This button opens the Select Color dialog, allowing you to select the holiday color. The holiday color will be used for the holiday name in the Month view and the holiday date in the Date Navigator.

Agenda view background color

This button opens the Select Color dialog, allowing you to select the Agenda view background color.

Busy days background color

This button opens the Select Color dialog, allowing you to select the Agenda or Month view background busy color. This color is only used when the option for drawing busy days with a different color is set in either of these views.

Agenda view current-time line color

This button opens the Select Color dialog, allowing you to select a color for the current-time (Marcus Bains) line.

Working hours color

This button opens the Select Color dialog, allowing you to select the color of the working hours background in the Agenda view.

To-do due today color

This button opens the Select Color dialog, allowing you to select the to-do due today color.

To-do overdue color

This button opens the Select Color dialog, allowing you to select the to-do overdue color.

Tags

This group allows you to assign a color to each tag. Select a tag in the drop down list, and press the button to open the Select Color dialog, allowing you to select the color for that tag. Depending on the view preferences, this color will be used to mark events and to-dos which bear this tag in the Agenda and Month views.

Resources

This group allows you to assign a color to each resource. Select a resource in the drop down list, and press the button to open the Select Color dialog, allowing you to select the color for that resource. Depending on the view preferences, this color will be used to mark events and to-dos which are stored using this resource in the Agenda and Month views.

Fonts tab

Time bar

Press this button to pick the font, font style and size for the time bar.

Month view

Press this button to pick the font, font style and size for the Month view.

Agenda view

Press this button to pick the font, font style and size for the Agenda view (Day, Week and Work Week views).

Current-time line

Press this button to pick the font, font style and size for the Marcus Bains line (a colored line in the Agenda view indicating the current time).

Group Scheduling

Use Groupware Communication

Check this box to automatically send emails when creating, updating or deleting events or to-dos which involve others. This email can be an invitation to attendees of an event you created, a cancellation of an event you created, an answer or an update on your invitation status, an event change request, etc. Check this option if you want to use the groupware functionality (e.g. Configuring Kontact as a KDE Kolab client).

Send copy to owner when mailing events

When you check the Send copy to owner when mailing events box, you will get a copy of all email messages that KOrganizer sends at your request to the event attendees.

Mail transport

Here you can choose which type of mail transport you would like to use. You can either use KMail or the sendmail® command (which must be installed on your system in order to work).

Free/Busy

The free/busy information represents an availability schedule. By presenting the intervals when one already has previous commitments, others can avoid arranging appointments for these periods. Note that only the times are published, not the events, reasons or attendees.

KOrganizer supports publishing and retrieving free/busy information, either manually or automatically.

Publish

By publishing your free/busy information, you allow others to take your busy time schedule into account when inviting you to an event.

Publish free/busy information automatically

Enable this option if you wish your Free/Busy information to be uploaded automatically. Note that you may skip this option and choose to mail or upload your Free/Busy information via the Schedule menu of KOrganizer.

If your application is setup to work as a KDE Kolab client, this is not required. The Kolab2 server can take care of publishing your Free/Busy information and manage the access to it from other users.

Minimum time between uploads (in minutes)

If you choose to publish your information automatically, you can configure the interval of time in minutes between each upload.

Publish (default 60) days of free/busy information

Configure the number of calendar days you wish to be published and available to others

Server URL

Enter the URL for the server on which your Free/Busy information will be published. Ask the server administrator for this information.

Kolab2 server example: webdavs://kolab2.com/freebusy/joe@kolab2.com.ifb

Username

Enter the login information relative to your account on the server

Kolab2 server specificity: your registered UID (Unique IDentifier), by default, would be similar to your email address on the Kolab2 server but it may be different. In this case enter your UID. Ask the server administrator about your UID if you do not know it.

Password

Enter your password (server login password) here.

Remember password

Check this option if you want KOrganizer to remember your password and skip asking you each time it uploads your Free/Busy information.

Warning

It is not recommended to store your password in the configuration file for security reasons.

Retrieve

By retrieving other people's free/busy information, you can take their busy time schedule into account when inviting them to an event.

Retrieve other people's free/busy information automatically

Automate the process for retrieving other users free/busy time. Fill in the server information section below to enable this option.

Use full email address for retrieval

This setting lets you change the name of the file which will be fetched from the server. If you check this option, it will download a free/busy file called user@domain.ifb, else it will fetch user.ifb. Ask the server administrator if you are not sure about how to configure this option.

Kolab2 server specificity: If you are configuring KOrganizer as a component to a KDE Kolab client (Kontact/Kolab) you have to check this option.

Server URL

Enter the URL for the server from which your Free/Busy information will be fetched. Ask the server administrator for this information.

Kolab2 server example: webdavs://kolab2.com/freebusy/

Username

Enter the login information relative to your account on the server.

Password

Enter your password (server login password) here.

Remember password

Check this option if you want KOrganizer to remember your password and skip asking you each time it fetches the free/busy files.

Warning

It is not recommended to store your password in the configuration file for security reasons.

Plugins

For more information about configuring plugins, please refer to Chapter 8, Plugins

Custom Pages

This page allows you to add your own GUI Elements to store your own values into KOrganizer.

Create your elements as described in How does this work?