An object is reserved using a reservation object. This object can be a room, some equipment, or something else. To keep it generic it is called a reservation object. This object has the following attributes within kOOL; a name, description and optionally a colour.

A reservation object may be reserved at a particular date and time. Also stored with the reservation are the name and contact details of the person reserving it.

If extra control over the reservation objects is required, they can be set to have changes moderated. Reservations to a moderated object are not applied immediately, a "moderator", (e.g. the pastor) must first approve the reservation. When a reservation of a moderated object is made, an email may be sent to the moderators. Also, the moderators will all see the number of open moderated reservations on the front module under "Reservations", or in the "Moderation" submenu of the reservation module. Reservations which require moderation are still shown in the calendar view. There is more information about reservations below.

Since a large number of reservation objects can accumulate very quickly, authorisations are not assigned to the actual object. Instead objects are combined into groups. For example, all meeting rooms could be combined into the "Meeting room" group, or all equipment such as projector, camera, etc. could be grouped into a "Multimedia" group. This allows permissions to be assigned to logins at the group level. Different groups may have different moderators.

Linked objects

A reservation object ("Object A") can be linked to other objects ("objects"). This means that a reservation for "object A" also blocks the reservation for "objects". For example, if there is a building with several rooms. An object may be created for each room, to allow an individual room to be booked. In addition, the building itself could be created as an object, which contains all the rooms as linked objects, to allow the building to be booked. This concept can also be used for rooms with removable partitions.

The object which contains linked objects is a reservation object in its own right. Therefore permissions must be defined for this object, e.g. whether it is to be moderated etc.

In the list view of the reservation objects, the number of linked objects appears in brackets after the object name. When creating a reservation, the list of linked objects appears in the description of the object, as a sub-menu.

Permissions

Each user may be assigned one of four authorisation stages for each reservation group:

View: Reservations of this group may be viewed, however no new reservations may be requested nor may existing ones be edited.
New: New reservations can be added or requested for moderated objects. You may edit or delete your own reservations when logged in or with the correct reservation codes.
Edit: All reservations of this group may be edited and also deleted. Moderated objects can be reserved without confirmation from a moderator.
Moderate: In addition to the permissions listed above, reservation requests on moderated objects may be accepted or rejected.

Moderation

A reservation object may be moderated. The moderation options "Yes" and "Yes: E-Mail" are the same, except that after a reservation is requested on an object with the latter option set, an email is sent to all moderators of the object being reserved.

Once a reservation is accepted or rejected, an email may be sent to the user who requested it, so they are informed about the decision. A form email is sent whose text may be modified if necessary.

A user with authorisation stage 3 or above may reserve objects without the need for moderation. They can also reserve objects which are not moderated.

Calendar View

In the calendar view, the reservations are shown in the colour given to the reservation object. This helps a user to see at a glance the type of reservation that has taken place.

A user with the correct privileges may change the individual reservations by clicking on it's name. It may be deleted by clicking on the dustbin symbol. Reservations which need to be moderated appear to moderators in the calendar view with a dashed lined around the border. In addition to the dustbin delete icon is a tick icon. Clicking it will accept the reservation.

Objects that still need moderation are always shown to moderators, even if normal reservations of the object are not selected to be shown.

Different calendar views are available in a similar manner to the events module: Yearly, monthly and week views are available. The detailed description of these views is in the documentation for the events module.

Additionally the reservations for a particular object for a particular event may be combined in the month or week view in the reservation module. The appropriate setting within the admin module should be set, under general settings. Once this is done, all reservations for a particular event are shown in summary form, which makes the view clearer. This setting also applies to PDF export.

Creating and editing reservations

The procedure differs depending upon the user's permissions:

Authorisation Stage 2 "new": New reservations for unmoderated objects can be created immediately. For moderated objects a moderator must confirm the reservation. Once created, reservations can be edited or deleted only if the correct code is entered for this reservation. Alternatively, a user who is logged in and has authorisation stage 2 may edit or delete their own reservations without the code.

Stage 3 "Editing": All reservations may be created as well as edited or deleted. Reservations for moderation may not be accepted or rejected.

A user may reserve several objects at once, so the contact details and purpose only need to be entered once. This option is not available for the guest user, but it may be activated with a setting (See below).

Repeated reservations - series

When creating a new reservation, it is possible to define it to be repeated. The repetition can be defined in various ways. These reservations are created together in a series and may be edited or deleted later as a series.

While editing or deleting a reservation in a series, it is necessary to choose whether the modifications apply to the particular date being changed, or to the entire series.

Filter

The displayed reservations can be filtered temporally, making it easier to find specific reservations. For example:

Show all reservations from the current month (i.e. do not show reservations from past months). This is the default setting.
Show reservations during the next summer holiday (July and August).

A user with athorisation stage 4 (Moderator) can store a filter as global. This means that users of kOOL who may only create, but not edit reservations (Up to authorisation stage 2) may only see reservations within the defined period.

Settings

A user with authorization stage 4 may alter the following settings for the reservation module:

Mandatory fields for new reservations: Select the fields which a user is compelled to fill out when creating a new reservation.
Highlight Sundays in list view: Select this option to make the events that appear on a Sunday stand out in the list view.
Show times in the PDF calendar: The monthly calendar when exported as PDF may show the date and time, or just the date. If the time is not shown, there is more space available to display the title.
Show Purpose in the PDF calendar: If set to yes, the purpose of the reservation is included on a second line in the calendar PDF export.
Show name and email for guest: It is possible to hide the personal data for a reservation when viewed by the guest account. So name and email address of a reservation are only shown for users logged in to kOOL.
Summarise reservations for an event: If there are many reservations for a particular event, the view, particularly in the weekly calendar, can become cluttered. The reservations for a particular event are combined on the calendar if this option is selected. This option can be defined for individual event groups if the "Combine reservations" option is set.
For each reservation requested, send an Email to: List one or more (Comma separated) E-Mail addresses, which should receive a confirmation email for each reservation that is created. These are all unmoderated reservations in addition to all accepted moderated reservations.
Guest may reserve multiple objects: A user who is logged in may select several objects together to be reserved. This option, when selected, also allows the guest user to do this.
Monthly calendar: Use this as title: Choose the title for the reservations in the monthly calendar: Object, Purpose or Requester name