Chapter 9. Reference

Menus

When KOrganizer starts, the main KOrganizer window appears. The window has several components: a menubar, a toolbar, a month calendar, a main panel with the current view of events, and a to-do list.

The menus provide access to all the common operations that can be performed with the calendar, including saving, loading, adding and deleting events, to-dos and journal entries, printing and more.

Please note that when using KOrganizer as the calendar component of Kontact, the menus differ from the stand alone application.

File

The File menu provides access to functions involving the entire calendar.

FileOpen (Ctrl+O)

Opens a file dialog allowing you to select a new vCalendar or iCalendar file to load. If you have made changes to the current calendar, you will be given the option of saving them before loading a new one.

For more information about this, please refer to the section called “Importing, Exporting and Maintaining Calendars”.

FilePrint (Ctrl+P)

Choose Print or click the Print icon to print the current calendar. You can specify the range of dates to be printed (either manually or with the Calendar Widget) and the Print Style (Day, Week, Month or To-dos and Journal).

FilePrint Preview

If you choose Print Preview or click the Print Preview icon, the current calendar will be printed on your screen, instead of on your printer. Use this feature to check if the printout will be correct before you start printing.

You can specify the range of dates to be printed (either manually or with the Calendar Widget) and the View Type (Day, Week, Month or To-do).

FileImportImport Calendar

If you have a different iCalendar or vCalendar file somewhere, and you would like to merge its contents into your own calendar, add as a new resource or open it as a new window, choose this menu item. A good time to do this would be if you received a vCalendar with a few entries via email, for instance.

For more information about this action, please refer to the section called “Importing Calendars”.

FileImportImport From UNIX Ical Tool

If you have used ical, a popular but older calendar program for UNIX®, you may wish to import your events and to-do directly to KOrganizer. This action will read the .calendar file from your home folder and merge any entries it contains into your current calendar. If any errors or suspicious things occur during the process, you will be notified via a message box.

For more information about this action, please refer to the section called “Importing Calendars”.

FileImportGet Hot New Stuff...

This action will open the Get Hot New Stuff dialog, which offers a list of calendars to download. These events can be added to your calendar.

For more information about this action, please refer to the section called “Downloading Using Get Hot New Stuff”.

FileExportExport Web Page...

You can export your calendar or a part of it as a HTML file, suitable for publishing on the World Wide Web.

For more information about this action, please refer to the section called “Exporting Calendars”.

FileExportExport as iCalendar

This action will export all your active events, to-dos and journal entries (independent of to which resource they belong) as a new iCalendar file.

For more information about this action, please refer to the section called “Exporting Calendars”.

FileExportExport as vCalendar

This action will export all your active events, to-dos and journal entries (independent of to which resource they belong) as a new vCalendar file.

For more information about this action, please refer to the section called “Exporting Calendars”.

FileArchive Old Entries...

From time to time you should delete your old events.

For more information about this action, please refer to the section called “Maintaining Your Calendars”.

FilePurge Completed To-dos

This action will remove all the completed to-dos from your active calendar.

For more information about this action, please refer to the section called “Maintaining Your Calendars”.

FileQuit (Ctrl+Q)

When you choose Quit or click the Quit icon, the current calendar window will quit, prompting you to save if the current calendar has been modified but not yet saved.

This has no effect on other calendar windows which may be opened. You have to quit each calendar window individually.

Edit

With the Edit menu you can edit and search events and to-dos.

Cut, Copy, and Paste menu items behave in the same fashion as in other KDE applications. With the Find menu item you can find events and to-dos across the current calendar.

EditUndo (Ctrl+Z)

Undo the latest action, or in other words, return the calendar to the state it was immediately before the latest action.

EditRedo (Ctrl+Shift+Z)

Redo the latest action, or in other words, return the calendar to the state it was immediately before the latest undo.

EditCut (Ctrl+X)

Cuts the currently selected event(s) to the clipboard, removing them from your calendar.

EditCopy (Ctrl+C)

Copies the currently selected item(s) to the clipboard, but leaving them untouched.

EditPaste (Ctrl+V)

Paste inserts the contents of the clipboard into your calendar. The clipboard must contain a valid vCalendar or iCalendar item, provided either by a previous Cut/Copy operation or from a selection made outside of KOrganizer. You will be warned if the contents of the clipboard cannot be understood.

Tip

However, you can safely use Ctrl+C and Ctrl+V hotkeys to copy text data from any outside application to a KOrganizer Edit Event window and vice versa.

EditDelete

Delete the currently selected item(s), removing them from your calendar.

EditFind (Ctrl+F)

Choose Find from the Edit or click the Find icon to find events, to-dos and journal entries according to their title, description, and/or categories.

For more information about this action, please refer to the section called “Searching”.

View

There are several different views available for displaying your events, to-dos and journal entries. KOrganizer is smart enough to remember in between sessions what the last active view was, and the next time it is started, it will display that view.

In general, each view will provide a way of displaying your journal entries, to-dos and events, constrained to a particular time period or style of display. Click any item to select it for further action. Right click an item to bring up a menu with options such as Edit, Delete, and so on. You can also use the Action menu to perform similar operations.

ViewAgenda

Switch the display to the Agenda view.

For more information about this action, please refer to the section called “Agenda View”.

ViewMonth View

Switch the display to the Month view.

For more information about this action, please refer to the section called “Month View”.

ViewTimeline

Switch the display to the Timeline view.

For more information about this action, please refer to the section called “Timeline View”.

ViewTo-do List

Switch the display to the To-do List view.

For more information about this action, please refer to the section called “To-do List”.

ViewEvent List

Switch the display to the list view.

For more information about this action, please refer to the section called “Event List View”.

ViewWhat's Next

Switch the display to the what's next view.

This view displays your next events and to-dos. Events and to-dos are displayed one per line.

For more information about this action, please refer to the section called “What's Next View”.

ViewJournal

Switch the display to the Journal view.

For more information about this action, please refer to the section called “Journal View”.

ViewRefresh

Updates or refreshes the currently displayed view.

ViewZoom

Use this submenu to adjust the current view to show more or less data.

In the Agenda view (Day(s) or Week view), you can use the zoom actions to show more or less days (ZoomIn Horizontally and ZoomOut Horizontally), or more or less hours in the day (ZoomIn Vertically and ZoomOut Vertically).

ViewFilter

This submenu offers access to the filters already created using the Edit Calendar Filters dialog. Select on this submenu the filter that will be used in KOrganizer view. If you do not want to use a filter, choose No filter.

Go

For more information about browsing KOrganizer views, please refer to the section called “KOrganizer Views”.

GoBackward

Go to the previous day, week or month, depending on the view.

GoForward

Go to the next day, week, or month, depending on the view.

GoTo Today

Go to the period of time that includes the current day.

GoDay

Switch the display to the Day view.

For more information about this action, please refer to the section called “Agenda View”.

GoNext x Days

Switch the display to the Next x Day view, where x is defined in KOrganizer main configuration.

For more information about this action, please refer to the section called “Agenda View”.

GoWork Week

Switch the display to the Work Week view.

This is the same as the Week view, except only the working days of the week are shown.

For more information about this action, please refer to the section called “Agenda View”.

GoWeek

Switch the display to the Week view.

The Week view provides a view similar to the Day view. Events for seven days are shown next to each other. All of the functions available for the Day view are available in the Week view, too.

For more information about this action, please refer to the section called “Agenda View”.

Actions

ActionsNew Event...

Choose New Event... to create a new event.

You can get a detailed description of the event window in the Entering Events section.

ActionsNew To-do...

Choose New To-do... to create a new to-do. Initially the to-do has no due date, but you can specify one.

You can get a detailed description of the to-do window in the Entering To-dos section.

ActionsNew Sub-to-do...

Choose New Sub-to-do... to start writing a new sub-to-do. The currently selected to-do will be the sub-to-do parent. Initially the to-do has no due date, but you can specify one.

You can get a detailed description of the to-do window in Entering To-dos section.

ActionsNew Journal...

Choose New Journal... to start writing a new journal entry.

ActionsShow

Choose Show to open a dialog showing the details of the currently selected journal entry, event or to-do.

ActionsEdit...

Choose Edit... to edit the currently selected journal entry, event or to-do.

ActionsDelete (Del)

Choose Delete to remove the currently selected journal entry, event or to-do.

ActionsMake Sub-to-do Independent

Choose Make Sub-to-do Independent to detach the currently selected sub-to-do item from its parent and make it an independent to-do item.

Schedule

SchedulePublish Item Information...

Email the selected event, to-do or journal entry in the iCalendar format.

For more information about this action, please refer to the section called “Publishing an Event, To-do or Journal Entry”.

ScheduleSend Invitation to Attendees

Send the selected to-do or event to the attendees, and, if necessary, request a response from them.

For more information about this action, please refer to the section called “Sending Invitations and Processing Responses”.

ScheduleSend Status Update

If you changed your status as an attendee, choose this menu item to send your updated status (accepted, tentative, etc.) to the item's organizer.

For more information about this action, please refer to the section called “Answering an Invitation”.

ScheduleSend Cancellation to Attendees

If you plan to cancel an event or to-do, select it, and choose this menu item to notify the attendees about the cancellation.

For more information about this action, please refer to the section called “Cancelling an Event or To-do”.

ScheduleRequest Update

Request the latest version of the selected event or to-do from the organizer.

For more information about this action, please refer to the section called “Requesting the Latest Version of an Event or To-do”.

ScheduleRequest Change

Send an alternative proposal to the organizer of the selected event or to-do.

For more information about this action, please refer to the section called “Sending an Alternative Proposal”.

ScheduleMail Free Busy Information...

Email your Free Busy information to one or more email addresses.

For more information about this action, please refer to the section called “Free Busy information”.

ScheduleUpload Free Busy Information

Upload your Free Busy information to the groupware server. Other users will then be able to retrieve the information.

For more information about this action, please refer to the section called “Free Busy information”.

Settings

SettingsToolbars Shown

Click the menu items of this submenu to show or hide KOrganizer toolbars.

SettingsShow Statusbar

Choose this menu item to toggle the display of the status bar on and off.

SettingsSidebar

Click the menu items of this submenu to show or hide KOrganizer sidebar components. Note that the sidebar is visible only when the current view does not use the full window.

SettingsConfigure Date & Time...

Click this menu item to set the desktop date and time formats. Note that this setting is shared between other desktop applications.

SettingsManage View Filters...

Choose this menu item to open the Edit Filters dialog. Using this dialog, you can create, delete and edit filters that will affect which items will be displayed by KOrganizer.

SettingsManage Categories...

Choose this menu item to open the Edit Categories dialog. Using this dialog, you can create, delete and edit calendar item categories. Categories are used to organize your events and to-dos in related groups.

SettingsConfigure Shortcuts...

Choose this menu item to open the Configure Shortcuts dialog. This dialog allows you to assign shortcuts to KOrganizer actions, and configure the shortcuts already assigned.

SettingsConfigure Toolbars...

Choose this menu item to open the Configure Toolbars dialog. This dialog allows you to add, remove and change the order of the actions in KOrganizer toolbars.

SettingsConfigure KOrganizer...

Choose the SettingsConfigure KOrganizer... menu item to display KOrganizer Configure dialog.

For more information about this action, please refer to the section called “KOrganizer Main Configuration”.

Help

HelpKOrganizer Handbook (F1)

Invokes the KDE Help system starting at the KOrganizer help pages. (this document).

HelpWhat's This? (Shift+F1)

Changes the mouse cursor to a combination arrow and question mark. Clicking on items within KOrganizer will open a help window (if one exists for the particular item) explaining the item's function.

HelpReport Bug...

Opens the Bug report dialog where you can report a bug or request a wishlist feature.

HelpSwitch Application Language...

Opens a dialog where you can edit the Primary language and Fallback language for this application.

HelpAbout KOrganizer

This will display version and author information.

HelpAbout KDE

This displays the KDE version and other basic information.