When clicking an event in the calendar view, a dialog showing its details is displayed.
Clicking the *Edit* button in that dialog opens the form to edit all properties of the selected event.
The edit form is divided into different section which can be switched using the tabs on top
of the dialog:
**Summary**
This general section has text fields and selectors for various properties of an event.
Here's a description of all the possible values:
* ``Summary``: The title of the event. This is what you will see in the calendar view.
* ``Location``: Where the event will be taking place.
* ``Description``: Any text that describes the event.
* ``URL``: A link to more information about this event.
* ``Start``: Date and time when the event starts.
* ``End``: Date and time when the event starts.
* ``all-day``: Check this if the event has no start/end time.
* ``Reminder``: Will pop up with a notification at a the specified time before the event. It is possible to select 'Message' (default) or 'Sound'. When Sound is selected, a sound will be played at the selected time. This setting requires the host to be able to play sounds.
* ``Calendar``: The calendar the event is saved in. Change it to move an event from one calendar to another.
* ``Category``: The type of event. Categories can also be used for :ref:`coloring <settings-calendar>`.
* ``Show me as``: The representation in your free/busy scheduling calendar visible to others.
* ``Priority``: The priority value of the event.
* ``Privacy``: Flag an event as "private" or "confidential" when sharing your calendar with others.
**Recurrence**
For periodically recurring event series, this tabs has the settings how an event is repeated
over time.
* ``Repeat``: Start with selecting a repetition interval (e.g. monthly)
* ``Every``: How often the frequency will be relevant. For example, for an event that takes place every other week choose Weekly and then 2.
If you choose a frequency of weekly or monthly you can select which days of the week or month the event will occur.
* ``Until``: Determines the duration of the repetition. The recurrence can either run forever, for a number it times or until a specific date.
**Participants**
An important part of managing your schedule is to invite others to events and track their RSVP.
In this part of the edit dialog you can manage the participants of an event. Read more about this
further down in the :ref:`calendar-event-participants` section.
**Resources**
As with participants, it is possible to manage the provided resources needed for the planned event. The tab is showing a list of the resources reserved for the current event.
* ``Book Resource``: If the name of the resource is known, it can be typed into the textfield, and will be booked when the Book Resource button is pushed.
* ``Find Resource``: If the name of the resource is not known, the Find Resource button is an option. It will open a new popup window showing a list of available resources, The FreeBusy information for these, and the Book Resource button.
**Attachments**
Sometimes a description text isn't enough to collect information for a specific event.
Switch to this tab to attach files to the current event or to remove them again. Adding
files works pretty much the same as :ref:`attaching them to email messages <mail-compose-attachments>`:
first select a file from your local disk and click *Upload* in order to attach it.
.. note:: Don't forget to finally save the changes by clicking *Save* in the event edit dialog.
Even switching back and forth the tabs will not yet save the data.
.. index:: Move, Drag & Drop
Moving and Resizing with the Mouse
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. container:: image-right
.. image:: _static/_skin/event-resize.png
If an existing event shall be rescheduled to another time or date, you'll find it handy
to do that directly in the calendar view without opening the edit form. Simply grab the event
block with the mouse and move it to the new date or time. Release the mouse button to complete.
In *Month* and *Day* view, the event blocks have a small handle at the bottom. Drag this with the
mouse in order to resize the event meaning to adjust its duration.
.. index:: Notifications, Reminders, Alarms
.. _calendar-event-alarms:
Get Notifications
-----------------
.. container:: image-right
.. image:: _static/_skin/alarms-popup.png
While logged in to the webmail, event reminders will be displayed with pop-up boxes at the specified time
before the event starts. You can specify if you want to see alarms for every calendar individually.
Enable or disable reminders in :ref:`Calendar Settings <calendar-edit-properties>` from the :ref:`calendar-lists`.
Dismiss or Snooze Reminders
^^^^^^^^^^^^^^^^^^^^^^^^^^^
When a reminder box pops up, you can either dismiss the notification for all events or each one individually.
When dismissed, no further reminders will be displayed. Choose a time from the *Snooze* menu to get another
reminder after the selected time.
.. index:: Invite, Participants, Attendees
.. _calendar-event-participants:
Inviting Other People
---------------------
If you need to set up a meeting, and keep track of who's attending and who is not, the calendar can do this
as well as you to automatically send invitations and read their responses.
When creating a new event, switch to the *Participants* tab. You're already listed as the organizer of the event.
.. image:: _static/_skin/event-participants.png
1. Enter the name or email address of the person to invite. Contacts from the address book are suggested as you type.
In order to send invitations, make sure the entered contact has an email address. Type it in the form
``Person Name <email@address.com>``.
2. Click *Add participant* to add the person to the list.
3. Select a *Role* (e.g. required or optional) for this person.
4. Repeat 1-3 for further participants.
5. Check the *Send invitations* box if the application should send out invitation emails.
Invitations will be sent out when you click *Save* and the event is created.
-.. only:: kolab
+.. index:: Availability
+.. _calendar-availability-finder:
- .. index:: Availability
- .. _calendar-availability-finder:
+Find Availability
+^^^^^^^^^^^^^^^^^
- Find Availability
- ^^^^^^^^^^^^^^^^^
+Once all the participants are added to the list, you see the individual availability status for each one
+of them, given that this information is available. In case not everybody is free, click the *Find availability...*
+button to open the scheduling dialog. In that dialog, detailed availability information for all participants is
+displayed. Use the *Previous/Next Slot* buttons to find the next time slot where all required participants are
+available. Or drag the gray area representing the event duration with the mouse to manually select a free slot.
- Once all the participants are added to the list, you see the individual availability status for each one
- of them, given that this information is available. In case not everybody is free, click the *Find availability...*
- button to open the scheduling dialog. In that dialog, detailed availability information for all participants is
- displayed. Use the *Previous/Next Slot* buttons to find the next time slot where all required participants are
- available. Or drag the gray area representing the event duration with the mouse to manually select a free slot.
-
- Click *Select* to copy the rescheduled date/time back into the event form and to close this dialog.
+Click *Select* to copy the rescheduled date/time back into the event form and to close this dialog.
Receive Event Invitations
-------------------------
How to process incoming event invitations is described in chapter :ref:`calendar-invitations`.
All the described functions to manage your tasks are accessible from the main task view.
Create new Tasks
----------------
**The New Task Dialog**
Click the *New task* button in the toolbar to get an empty dialog where you enter the
tasks properties like title, description, start/due dates and reminder settings.
Click *Save* to finally add it to the selected task list.
**Quick Entry**
The text box in the centre of the toolbar area lets you add new tasks very fast by
simply entering a title and then press <Enter> on the keyboard. Tasks will be created
in the currently selected list.
Begin the quick entry with a date or time description like "Tomorrow" or "Monday at 16:00"
to directly assign a due date to the task.
.. _tasklist-edit-task:
Edit Tasks
----------
The Edit Dialog
^^^^^^^^^^^^^^^
When clicking a task item in list a dialog showing its details is displayed. Clicking the Edit button
in that dialog opens the form to edit all properties of the selected task.
The edit form is divided into different section which can be switched using the tabs on top of the dialog:
**Summary**
This general section has text fields and selectors for various properties. Here’s a description of all the possible values:
* ``Title``: The title of the task. This is what you will see in the list.
* ``Description``: Any text that describes the task. Links and email addresses will be become clickable.
* ``Tags``: A list of tags assigned to this task. Add one by typing to the text box and hit <Enter>.
* ``Start``: The date/time, the task is supposed to be worked on.
* ``Due``: The date/time this job is due. Define a time when setting a reminder for this task.
* ``Reminder``: Will pop up with a notification at a the specified time before the task is due. It is possible to select 'Message' (default) or 'Sound'. When 'Sound' is selected, a sound will be played at the selected time. This setting requires the host to be able to play sounds.
* ``Complete``: The completeness state of a task in percent. Use the slider or enter a number.
* ``Tasklist``: The list the task is saved in. Change it to move an event from one list to another.
-
-.. only:: kolab
-
-
- **Recurrence**
+**Recurrence**
For periodically recurring task series, this tab has the settings how a task is repeated
over time.
* ``Repeat``: Start with selecting a repetition interval (e.g. monthly)
* ``Every``: How often the frequency will be relevant. For example, for a task that takes place every other week choose Weekly and then 2.
If you choose a frequency of weekly or monthly you can select which days of the week or month the task will occur.
* ``Until``: Determines the duration of the repetition. The recurrence can either run forever, for a number of times or until a specific date.
- **Assignments**
+**Assignments**
One, or a list of, users can be assigned to the task. The list is managed in this tab.
* ``Organizer``: The user organizing (creating) the task. This is set to the default identity of the logged in user, but a diferent identity for this user can be selected.
* ``Add Assignee``: Type three letters of the username, and the search box will show a dropdown list of relevant users. Then clieck the 'Add Assignee' button.
* ``Invitation/notification comment``: When a user is assigned to a task, an email notificatino is sent out. This field is giving the opportunity to add extra test to this mail notification.
- **Attachments**
+**Attachments**
Sometimes a description text isn't enough to collect information for a specific task.
Switch to this tab to attach files to the current task or to remove them again. Adding
files works pretty much the same as :ref:`attaching them to email messages <mail-compose-attachments>`:
first select a file from your local disk and click *Upload* in order to attach it.
.. note:: Don't forget to finally save the changes by clicking *Save* in the task edit dialog.
Switching back and forth between the tabs will not yet save the data.
.. index:: Tags
Assign Tags
^^^^^^^^^^^
Tags help you organize your tasks in the list view. Open the :ref:`Edit Dialog <tasklist-edit-task>` and
enter tags into the according text box:
.. image:: _static/_skin/tags-autocomplete.png
Append a tag by hitting <Enter> and continue typing to add more. While typing, a suggestion of already
used tags will be shown. Use the arrow keys on the keyboard to select one and press <Enter> to select.
Remove tags with a click on the *Remove* icon.
**Drag & Drop Tags**
Existing tags listed in the tags box on the left can also be assigned to tasks directly in the list view
by simply dragging the tag from the box and drop it on a task bar.
.. index:: Due Date
Set Due Dates
^^^^^^^^^^^^^
Assign due dates to your tasks to not miss your deadlines and to enable reminder notifications for them.
The due dates with time can be entered in the :ref:`Edit Dialog <tasklist-edit-task>`. When entering the input
field, a small calendar widget will help you to quickly select a date.
Due dates can also be entered or changed directly in the list view without going to the edit dialog.
Click the due date or the "no date" area on the right end of a task bar and select a date from the calendar widget.
The change will be saved immediately.
.. index:: Complete
Mark Tasks as Complete
^^^^^^^^^^^^^^^^^^^^^^
In the :ref:`tasklist-edit-task` section we learned how to set a percentage value
for a task's completeness. Until a task isn't fully completed, the percentage is displayed as a
think horizontal line in the list view.
In order to mark a task as complete, simply click the checkbox in the list view. The task is now
grayed out and moved to the bottom of the list. After some time or when refreshing the list, completed
tasks will be removed from the view. You can still find them with the *Complete* quick filter.
Uncheck the box to bring it back to the normal list.
Organize Tasks in Groups
------------------------
For bigger jobs or entire projects, tasks can be divided into subtasks and organized hierarchically
to visualize dependencies.
Create a Subtask
^^^^^^^^^^^^^^^^
.. container:: image-right
.. image:: _static/_skin/subtask-menu.png
1. Open the options menu of a task from the arrow icon on the far right of the task bar.
2. Select *Add subtask*
3. Enter the subtask properties in the :ref:`Edit Dialog <tasklist-edit-task>`
4. Press *Save* to insert it
.. index:: Move, Drag & Drop
Re-organize Groups
^^^^^^^^^^^^^^^^^^
The hierarchical nesting of tasks and subtasks can be changed at any time. Simple grab a task with the mouse
and drop onto another one to make it a subtask. This works for entire subtrees equally well. While dragging,
a possible drop target is highlighted when moving over it.
Drop a task onto the small bar on top of the tasks list to make it a main task again.
If you organize your tasks in different lists, dropping a task onto a task list in the box on the left
moves it (and all child tasks) to that particular list.
.. index:: Notifications, Reminders
.. _tasklist-task-alarms:
Get Notifications
-----------------
While logged in to the webmail, reminders about soon-to-be due tasks will be displayed with pop-up boxes at
the specified time before the task is due. You can specify if you want to see reminders for every task list individually.
Enable or disable reminders in :ref:`Task List Settings <tasklist-edit-list>` from the :ref:`tasklist-lists`.
Read how to :ref:`Dismiss or Snooze Reminders <calendar-event-alarms>` in the calendar section.
Delete Tasks
------------
Usually finished tasks are marked as complete. But there are still situations where you might want to actually
delete a task.
1. Open the options menu of a task from the arrow icon on the far right of the task bar.
2. Select *Delete*.
3. Click *Delete* again in the confirmation dialog.