From 50569114acdc64e7c7cae1498635d3f821517c30 Mon Sep 17 00:00:00 2001 From: Daniel Lange Date: Mon, 7 Mar 2016 15:53:16 +0100 Subject: Initial commit of the Faster IT roundcube_calendar plugin distribution This includes: * Kolab plugins 3.2.9 (calendar and libcalendaring) * CalDAV driver 3.2.8 * .htaccess files for at least some security * SabreDAV updated to 1.8.12 (Jan 2015 release) * Support for CURLOPT_SSL_* settings to allow self-signed certificates * Small fixes & improved documentation --- calendar/helpdocs/en_US/_static/_skin | 1 + .../helpdocs/en_US/_static/kolab/alarms-popup.png | 1 + .../helpdocs/en_US/_static/kolab/calendar-acl.png | Bin 0 -> 108292 bytes .../en_US/_static/kolab/calendar-header.png | Bin 0 -> 13036 bytes .../en_US/_static/kolab/event-participants.png | Bin 0 -> 101779 bytes .../helpdocs/en_US/_static/kolab/event-resize.png | 1 + .../en_US/_static/kolab/itip-invitation.png | 1 + .../helpdocs/en_US/_static/kolab/itip-reply.png | 1 + .../helpdocs/en_US/_static/larry/alarms-popup.png | Bin 0 -> 19181 bytes .../helpdocs/en_US/_static/larry/calendar-acl.png | Bin 0 -> 28590 bytes .../en_US/_static/larry/calendar-header.png | Bin 0 -> 23126 bytes .../en_US/_static/larry/event-participants.png | Bin 0 -> 39276 bytes .../helpdocs/en_US/_static/larry/event-resize.png | Bin 0 -> 23728 bytes .../en_US/_static/larry/itip-invitation.png | Bin 0 -> 117940 bytes .../helpdocs/en_US/_static/larry/itip-reply.png | Bin 0 -> 39276 bytes calendar/helpdocs/en_US/importexport.rst | 43 ++++++ calendar/helpdocs/en_US/index.rst | 18 +++ calendar/helpdocs/en_US/invitations.rst | 55 +++++++ calendar/helpdocs/en_US/manage.rst | 169 +++++++++++++++++++++ calendar/helpdocs/en_US/overview.rst | 138 +++++++++++++++++ calendar/helpdocs/en_US/settings.rst | 75 +++++++++ calendar/helpdocs/en_US/sharing.rst | 49 ++++++ 22 files changed, 552 insertions(+) create mode 120000 calendar/helpdocs/en_US/_static/_skin create mode 120000 calendar/helpdocs/en_US/_static/kolab/alarms-popup.png create mode 100644 calendar/helpdocs/en_US/_static/kolab/calendar-acl.png create mode 100644 calendar/helpdocs/en_US/_static/kolab/calendar-header.png create mode 100644 calendar/helpdocs/en_US/_static/kolab/event-participants.png create mode 120000 calendar/helpdocs/en_US/_static/kolab/event-resize.png create mode 120000 calendar/helpdocs/en_US/_static/kolab/itip-invitation.png create mode 120000 calendar/helpdocs/en_US/_static/kolab/itip-reply.png create mode 100644 calendar/helpdocs/en_US/_static/larry/alarms-popup.png create mode 100644 calendar/helpdocs/en_US/_static/larry/calendar-acl.png create mode 100644 calendar/helpdocs/en_US/_static/larry/calendar-header.png create mode 100644 calendar/helpdocs/en_US/_static/larry/event-participants.png create mode 100644 calendar/helpdocs/en_US/_static/larry/event-resize.png create mode 100644 calendar/helpdocs/en_US/_static/larry/itip-invitation.png create mode 100644 calendar/helpdocs/en_US/_static/larry/itip-reply.png create mode 100644 calendar/helpdocs/en_US/importexport.rst create mode 100644 calendar/helpdocs/en_US/index.rst create mode 100644 calendar/helpdocs/en_US/invitations.rst create mode 100644 calendar/helpdocs/en_US/manage.rst create mode 100644 calendar/helpdocs/en_US/overview.rst create mode 100644 calendar/helpdocs/en_US/settings.rst create mode 100644 calendar/helpdocs/en_US/sharing.rst (limited to 'calendar/helpdocs/en_US') diff --git a/calendar/helpdocs/en_US/_static/_skin b/calendar/helpdocs/en_US/_static/_skin new file mode 120000 index 0000000..0137289 --- /dev/null +++ b/calendar/helpdocs/en_US/_static/_skin @@ -0,0 +1 @@ +larry \ No newline at end of file diff --git a/calendar/helpdocs/en_US/_static/kolab/alarms-popup.png b/calendar/helpdocs/en_US/_static/kolab/alarms-popup.png new file mode 120000 index 0000000..874a425 --- /dev/null +++ b/calendar/helpdocs/en_US/_static/kolab/alarms-popup.png @@ -0,0 +1 @@ +../larry/alarms-popup.png \ No newline at end of file diff --git a/calendar/helpdocs/en_US/_static/kolab/calendar-acl.png b/calendar/helpdocs/en_US/_static/kolab/calendar-acl.png new file mode 100644 index 0000000..66834ed Binary files /dev/null and b/calendar/helpdocs/en_US/_static/kolab/calendar-acl.png differ diff --git a/calendar/helpdocs/en_US/_static/kolab/calendar-header.png b/calendar/helpdocs/en_US/_static/kolab/calendar-header.png new file mode 100644 index 0000000..effd2a8 Binary files /dev/null and b/calendar/helpdocs/en_US/_static/kolab/calendar-header.png differ diff --git a/calendar/helpdocs/en_US/_static/kolab/event-participants.png b/calendar/helpdocs/en_US/_static/kolab/event-participants.png new file mode 100644 index 0000000..8e29484 Binary files /dev/null and b/calendar/helpdocs/en_US/_static/kolab/event-participants.png differ diff --git a/calendar/helpdocs/en_US/_static/kolab/event-resize.png b/calendar/helpdocs/en_US/_static/kolab/event-resize.png new file mode 120000 index 0000000..8f78496 --- /dev/null +++ b/calendar/helpdocs/en_US/_static/kolab/event-resize.png @@ -0,0 +1 @@ +../larry/event-resize.png \ No newline at end of file diff --git a/calendar/helpdocs/en_US/_static/kolab/itip-invitation.png b/calendar/helpdocs/en_US/_static/kolab/itip-invitation.png new file mode 120000 index 0000000..228911b --- /dev/null +++ b/calendar/helpdocs/en_US/_static/kolab/itip-invitation.png @@ -0,0 +1 @@ +../larry/itip-invitation.png \ No newline at end of file diff --git a/calendar/helpdocs/en_US/_static/kolab/itip-reply.png b/calendar/helpdocs/en_US/_static/kolab/itip-reply.png new file mode 120000 index 0000000..ecb0556 --- /dev/null +++ b/calendar/helpdocs/en_US/_static/kolab/itip-reply.png @@ -0,0 +1 @@ +../larry/itip-reply.png \ No newline at end of file diff --git a/calendar/helpdocs/en_US/_static/larry/alarms-popup.png b/calendar/helpdocs/en_US/_static/larry/alarms-popup.png new file mode 100644 index 0000000..642704f Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/alarms-popup.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/calendar-acl.png b/calendar/helpdocs/en_US/_static/larry/calendar-acl.png new file mode 100644 index 0000000..753644f Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/calendar-acl.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/calendar-header.png b/calendar/helpdocs/en_US/_static/larry/calendar-header.png new file mode 100644 index 0000000..109478a Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/calendar-header.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/event-participants.png b/calendar/helpdocs/en_US/_static/larry/event-participants.png new file mode 100644 index 0000000..f2205dd Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/event-participants.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/event-resize.png b/calendar/helpdocs/en_US/_static/larry/event-resize.png new file mode 100644 index 0000000..6e1f004 Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/event-resize.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/itip-invitation.png b/calendar/helpdocs/en_US/_static/larry/itip-invitation.png new file mode 100644 index 0000000..dd84697 Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/itip-invitation.png differ diff --git a/calendar/helpdocs/en_US/_static/larry/itip-reply.png b/calendar/helpdocs/en_US/_static/larry/itip-reply.png new file mode 100644 index 0000000..3e2bab7 Binary files /dev/null and b/calendar/helpdocs/en_US/_static/larry/itip-reply.png differ diff --git a/calendar/helpdocs/en_US/importexport.rst b/calendar/helpdocs/en_US/importexport.rst new file mode 100644 index 0000000..d037e92 --- /dev/null +++ b/calendar/helpdocs/en_US/importexport.rst @@ -0,0 +1,43 @@ +.. index:: Import, iCal +.. _calendar-import: + +************* +Import/Export +************* + +Event data is usually exchanged using the standard |iCal|_ format +which is supported for import and export. + + +Importing Events +---------------- + +This is how to add events from an |iCal|_ (.ics) file: + +1. Click the *Import* toolbar button in the calendar view. +2. Then select the file to import from your computer's hard drive. +3. Select the calendar to import the events to. +4. Select the threshold for old events to be imported. +5. Click *Import* and wait for the upload to finish. + +The calendar view will be refreshed to display the newly imported events. +Verify that the according calendar is active if you don't see them. + + +.. index:: Export +.. _calendar-export: + +Exporting Events +---------------- + +Events from your calendars can be exported and downloaded in the |iCal|_ format. + +1. Click the *Export* toolbar button in the calendar view. +2. Select the calendar where events should be exported from. +3. With the *Events from* selector you choose the time constraints for exporting. +4. Click the *Export* button to start the export. +5. Choose where to save the exported .ics file if prompted, otherwise check the "Downloads" folder on your computer. + + +.. |iCal| replace:: iCalendar +.. _iCal: https://en.wikipedia.org/wiki/ICalendar diff --git a/calendar/helpdocs/en_US/index.rst b/calendar/helpdocs/en_US/index.rst new file mode 100644 index 0000000..ce88216 --- /dev/null +++ b/calendar/helpdocs/en_US/index.rst @@ -0,0 +1,18 @@ +.. index:: Calendar +.. _calendar: + +******** +Calendar +******** + +The *Calendar* gives you access to your personal and shared calendar and scheduling functions. + +.. toctree:: + :maxdepth: 2 + + overview + manage + invitations + importexport + sharing + diff --git a/calendar/helpdocs/en_US/invitations.rst b/calendar/helpdocs/en_US/invitations.rst new file mode 100644 index 0000000..f23c13a --- /dev/null +++ b/calendar/helpdocs/en_US/invitations.rst @@ -0,0 +1,55 @@ +.. index:: Invitation, RSVP +.. _calendar-invitations: + +Handle Event Invitations +======================== + +In chapter :ref:`calendar-event-participants` we have learned how to invite +other people to an event. This will send out invitation emails to all the +participants with the event data attached. That allows one to directly accept +or decline an event invitation. + + +Receive Event Invitations +------------------------- + +When the webmail system opens an invitation email with event data attached, it'll +display a yellow box in the preview pane or the email view: + +.. image:: _static/_skin/itip-invitation.png + +Accept/Decline Invitations +-------------------------- + +Right in the box shown above, you can accept or decline the invitation by clicking the according +button. This will send an automated response to the event organizer informing her about your +decision and letting her update your participant status in her calendar. + +In case you accept, by either clicking *Accept* or *Maybe*, this will also copy +the event into your personal calendar. The selector right next to the buttons lets you +choose the right one. + +The copy in your calendar now knows about the invitation and its original sender. If you now +delete it from your calendar, you'll be asked whether this should send a declination +message to the person who organizes the event. + +After acceping or declining, the email message containing the invitation can be deleted. + + +Process Invitation Replies +-------------------------- + +As an organizer who has invited others to an event, you'll receive responses to the +automatically sent invitations when the attendees either accept or decline them. + +Such messages are also identified by the webmail system and again a yellow box appears +in the message view: + +.. image:: _static/_skin/itip-reply.png + +By clicking the *Update the participant's status* button, the original event in +your calendar will be updated with the RSVP status from the person who responded here. + +When you now look at the event details in the calendar view, the status icons next +to each participant now displays the new status. + diff --git a/calendar/helpdocs/en_US/manage.rst b/calendar/helpdocs/en_US/manage.rst new file mode 100644 index 0000000..36292a5 --- /dev/null +++ b/calendar/helpdocs/en_US/manage.rst @@ -0,0 +1,169 @@ +.. _calendar-manage: + +Manage Your Schedule +==================== + +All functions to maintain your events are accessible from the main calendar view. + + +Add Events to a Calendar +------------------------ + +**Via toolbar** + Click the *New event* button in the toolbar to get an empty dialog where you enter + the :ref:`event properties ` such as summary, date/time, reminders, etc. + Click *Save* to finally add it to the selected calendar. + +**At a specific date/time** + Navigate the calendar view to the date you want to add an event for. Then mark the range + of time (or dates in month view) with the mouse by pressing the button at the time the event + should start and releasing it again at time it finishes. This will open the :ref:`event dialog ` + with the selected date/time range already filled in. + + In order to create new all-day events, double-click the desired day in the calendar view. + + +.. index:: Recurring events, Participants, Participants +.. _calendar-edit-event: + +Edit and Reschedule Events +-------------------------- + +The Event Dialog +^^^^^^^^^^^^^^^^ + +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 an notification at a the specified time before the event. +* ``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 `. +* ``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. + +**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 `: +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 ` 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 ``. +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: + + 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. + + 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`. \ No newline at end of file diff --git a/calendar/helpdocs/en_US/overview.rst b/calendar/helpdocs/en_US/overview.rst new file mode 100644 index 0000000..b383319 --- /dev/null +++ b/calendar/helpdocs/en_US/overview.rst @@ -0,0 +1,138 @@ +************* +Overview +************* + +The screen of the calendar module presents the following parts: the :ref:`Calendar View ` +itself, a small :ref:`Calendar Widget ` the :ref:`calendar-lists` as well as the usual +toolbar and search box. + + +.. index:: Month View, Week View, Day View, Agenda +.. _calendar-view: + +Calendar View +============= + +The central part of the screen displays the schedule with events from the active calendars matching the current +date range. The active date range is displayed above the calendar in the toolbar area and can be moved forward or +backward in time using the arrow buttons right next to the title. + +.. image:: _static/_skin/calendar-header.png + + +Change Views +------------ + +You can view your calendar events in Day, Week, Month or Agenda view. Toggle the view mode using the toolbar buttons +above the calendar view. + +**Day** + All events of a single day appear at the time the begin and spawn a box until their end time. The time + scale is displayed in the left side of the view. All-day events appear at the top. + +**Week** + Similar to the day view but lists all days of the week horizontally. All-day events again appear at the top. + +**Month** + Shows all events of the selected month at a time. Each event only appears as a single line and if there are + more events in a day than can be listed, a number at the bottom of the day field indicates that. Click that + link to open a zoomed view of that single day. + +**Agenda** + The agenda view shows a list of events for the selected range in a chronological order and divided by + headers denoting either days, weeks or months. Both the number of the days considered for the listing as well + as the mode how to divide list can be adjusted with the controls at the bottom of the agenda view. + +.. _calendar-minicalendar: + +For all the views, the small calendar on the left highlights the currently listed days. + +Go to a specific Date +--------------------- + +Use the mini calendar widget on the left to jump to a specific date. Simply click a date and the date range of the current +view moves to include the selected day. The left/right arrows in the mini calendar's header quickly cycle through the months. +Use the drop-down menus hidden under the month and year display in the widget header to directly jump to another month or year. + +A shortcut to switch the calendar view back to today or the current week provides the *Today* button located in the toolbar. + + +Show Event Details +------------------ + +Click an event box in the calendar view to open a dialog displaying all details of the event. + + +Searching Events +---------------- + +The search box above the calendar view lets you quickly get a list of events matching the entered keyword +in either the title, location, description or attendees. Enter the search term into the box and press +on your keyboard to start the search. The calendar view will switch to *Agenda* mode in order to display +a list of matches. Of course you can switch the view again to display the search results differently. + +.. note:: Events are searched within a certain date reange only which is displayed above the calendar view. + Use the mini calendar widget or the arrow toolbar buttons and the range selector below the agenda view + to adjust the time frame to search in. + +For searching as well as for normal views, only events from active calendars are displayed. Use the checkboxes +in the :ref:`calendar-lists` to add or hide events from different calendars. + +Reset the search by clicking the *Reset search* icon on the right border of the search box. This will +also switch the calendar view to whatever mode you had before the search. + + + +.. index:: Calendars +.. _calendar-lists: + +Calendars List +============== + +Events can be organized in different calendars which are all displayed in the lower left list. +Use the checkboxes in that list to show or hide events from the specific calendars in the main view. + +.. only:: kolab + + Beside your personal calendars, the list also displays calendars shared by other users + or ones that are shared amongst your workgroup. Small icons in the list give a hint + about the origin and some of them are possibly read-only which is denoted with a small lock icon. + + +Colorized Events +---------------- + +In order to better distinguish the events from various calendars in the calendar view, calendars have +a color assigned which is used to colorize the events on the screen. Check the :ref:`settings-calendar` +for more advanced options how to colorize events in the calendar view. + +You can create any number of calendars to store all your events and name them individually. + + +Create a New Calendar +--------------------- + +1. Click the + icon in the calendars list footer. +2. In the dialog, give the new calendar a unique name and assign a color. +3. Click *Save* to create it. + +The calendar view will reload and list the new calendar on the left. + +.. _calendar-edit-properties: + +Edit Calendar Names and Settings +-------------------------------- + +1. Select the calendar to edit by clicking it in the list. +2. Click the gear icon in the calendars list footer and select *Edit* from the options menu. +3. Adjust name, color or reminders settings in the edit dialog. +4. Click *Save* to finally update the calendar. + +Remove entire Calendars +----------------------- + +1. Select the calendar to edit by clicking it in the list. +2. Click the gear icon in the calendars list footer and select *Remove* from the options menu. +3. After a confirmation dialog, the selected calendar with all its events will be deleted. + Caution: This action cannot be undone! + \ No newline at end of file diff --git a/calendar/helpdocs/en_US/settings.rst b/calendar/helpdocs/en_US/settings.rst new file mode 100644 index 0000000..154e6e8 --- /dev/null +++ b/calendar/helpdocs/en_US/settings.rst @@ -0,0 +1,75 @@ +.. _settings-calendar: + +******************** +Calendar Preferences +******************** + +The settings for the calendar module are listed in *Settings > Preferences* and are grouped by the following sections: + + +Main Options +------------ + +**Default view** + Lets you select the :ref:`calendar-view` which is visible by default when opening the calendar. + +**Time slots per hour** + How one hour in day and week view is divided vertically. If for example set to 2, you will see + events displayed in 30 minute blocks. + +**First weekday** + Which weekday to begin the week view with. + +**First hour to show** + When opening the day or week view, the listing of events starts at this time. Of course all + hours of a day are visible by scrolling further up. + +.. only:: kolab + + **Working hours** + This time range will be used in the :ref:`availability finder ` + when automatically selecting free slots for a meeting. + +**Event coloring** + The coloring of the title of an event block ("outline") as well as the background color of the box ("content") + in day and week views is influenced by the color of the calendar an event belongs to and/or the color of the + category it is assigned to. This setting lets you control which source for coloring to use or if you even + want a combined coloring that reflects both, the assignment of calendars and categories. + +**Default reminder setting** + When creating new events, they'll have this type of reminder set by default. + +**Default reminder time** + When enabling reminders in a new event, use this preset as default. + +**Create new events in** + This is the default selection for saving new events. Used in both the calendar view and when + accepting event invitations. + + +Categories +---------- + +This block allows the management of categories used in your calendar and assign colors to them. +Use the color picker to change the color by clicking on the square color box in the categories list. + +To add a new category, enter its unique name into the text box below the listing and then click +the *Add category** button to add it. Note that you still need to click the *Save* button +at the bottom of the preferences panel in order to finally register the new categories. + + +Birthdays Calendar +------------------ + +The calendar view and also display birthdays from contacts saved in your address book. This +block controls how this is done. + +**Display birthdays calendar** + Enable the birthdays calendar feature with this checkbox. + +**From these address books** + Choose from which address books you'd like to see birthdays in your calendar. + +**Show reminders** + This option controls whether and when to display reminder notifications for + upcoming birthdays. diff --git a/calendar/helpdocs/en_US/sharing.rst b/calendar/helpdocs/en_US/sharing.rst new file mode 100644 index 0000000..34599df --- /dev/null +++ b/calendar/helpdocs/en_US/sharing.rst @@ -0,0 +1,49 @@ +.. _calendar-sharing: + +.. only:: kolab + + .. index:: Sharing + + Sharing Calendars + ================= + + For collaboration, sharing calendars is an important feature. In the :ref:`overview `, + we have already learned how calendars others share with you appear in the calendars list. The following + now explains how to make personal calendars accessible to fellow users. + + + Share a Calendar with others + ---------------------------- + + Sharing is controlled through the :ref:`Calendar Settings Dialog `. + Double-click a calendar in the list on the left and then select the *Sharing* tab at the top of + the dialog box: + + .. image:: _static/_skin/calendar-acl.png + + The table displays who already has permission to see and modify the selected calendar. + In order to share the calendar with a new user do + + 1. Click the *Add entry* button (+) in the table footer + 2. Enter the username or choose one from the autocompletion menu that appears when you start typing. + Instead of a specific user, permissons can be granted for all users or guests. + 3. Select the access rights you want to grant for the user + 4. Click *Save* to add the permission + + Double-click an entry to edit the permissions for a particular user or group. + + For removing existing permissions, select the according entry in the list and then choose + *Delete* from the menu behind the gear icon in the footer of the list. + + + Subscribe to Shared Calendars + ----------------------------- + + Calendars shared by others are not showing up right away in the list within the calendar view. + Switch to :ref:`Settings > Folders ` to see all resources you can access. + There's a shortcut to this: click *Manage folders* in the options menu behind the gear icon + located the footer of the calendars list. + + In order to make a shared calendar appear in the calendars list, locate it in the folder manager + and check the *Subscribed* mark in the list. Only subscribed calendars are visible in the calendar view. + -- cgit v1.2.3