OpenPaaS Documentation logo OpenPaaS Documentation

The calendar module

Table of contents

Overview

The calendar module brings powerful and realtime calendar support into the OpenPaaS platform. It is composed of several components:

Install

OpenPaaS Module

If the calendar module is not provided with the OpenPaaS distribution, you can install it by following the installation instructions in the calendar repository.

Sabre Server

The calendar module needs a Sabre server to run. Thanks to its plugin system, the default Sabre distribution has been extended to provide more advanced features. Installation instructions can be found in the esn-sabre repository.

Features

The calendar module provides standard calendar features:

and more advanced ones:

The following sections will go deep into details of some of the above mentioned features.

Shared Calendars

The calendar module supports two kinds of shared calendars:

There are some differences between these types of shared calendars, the main ones are:

Shared calendars come with rights: Rights are applied to users who are looking at other users calendars.

Public calendars

In order make a calendar public, the user has to change the Public right to Free/Busy, Read or Write during the calendar creation, or on the calendar settings page as shown below.

The calendar settings page, change public level

Once a calendar is public, other users can subscribe to it by going to the Shared Calendars page and by doing a search. Public calendars are linked to their creator, so in order to find them, the user has to search for the creator to find all his public calendars.

In the screenshot below, one public calendar is displayed. In order to subscribe to this public calendar, the user has to click on the Add toggle button then on Save.

The shared calendars page, searching a public calendar

The calendar is now displayed as a Shared calendar. The user can see events and create some if Write rights are set on the public calendar.

Delegated calendars

A user can delegate his calendar by adding users in the delegation section in the calendar settings pages. A user which is added is called a Sharee. In order to add a user as sharee:

  1. Search for user, once found, click on it
  2. Set the right level
  3. Click on Add
  4. The user is added to the list of Sharee

The calendar delegation, adding user step 0

The calendar delegation, adding user step 1

The calendar delegation, adding user step 2

Once the calendar is saved, it is “ready to be delegated”: The sharee can not do anything until he adds the delegated calendar to his calendars. This is possible by going to the Shared calendars page and by doing a search just like for public calendars.

In the screenshot below, one delegated calendar is displayed. In order to add this delegated calendar, the sharee has to click on the Add toggle button then on Save.

The shared calendars page, searching a delegated calendar

The calendar is now displayed as a Shared calendar. The sharee can see events and create some if Write or Administration rights are set on the calendar.

Technical considerations