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

22 files changed, 552 insertions, 0 deletions

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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/kolab/calendar-acl.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/kolab/calendar-header.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/kolab/event-participants.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/alarms-popup.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/calendar-acl.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/calendar-header.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/event-participants.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/event-resize.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/itip-invitation.png
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
--- /dev/null
+++ b/calendar/helpdocs/en_US/_static/larry/itip-reply.png
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 <calendar-edit-event>` 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 <calendar-edit-event>`
+    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 <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.
+
+**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:
+
+    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 <calendar-view>`
+itself, a small :ref:`Calendar Widget <calendar-minicalendar>` 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 <Enter>
+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 <calendar-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 <calendar-lists>`,
+    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 <calendar-edit-properties>`.
+    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 <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.
+