The Reservation Module
Groups, objects and reservations
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.
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.
Each user may be assigned one of four authorisation stages for each reservation group:
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.
Users who are logged in can see their own requests awaiting moderation and may delete them.
In the view "List Objects" the moderators of the respective objects are shown in the tooltip. Just move the mouse over the column "moderated?".
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.
Different calendar views are available in a similar manner to the events module: Yearly, monthly, weekly and daily views are available. The detailed description of these views is in the documentation for the events module.
Additionally the reservations for a particular event may be combined in the reservation module. First you'll have to set this option for each event group and then there is a global option in the settings for the reservation module to enable or disable the combined view.
In the ressources view, the various reservation objects are shown individually. This is helpful when checking which objects are still available during a set time frame. E.g. which room is available for the seminary to be held on Tuesday night? With the drag&drop function reservations may be easily moved from one object to another, f.e. when an event is to be moved to a different location.
Choose between ressource view for one month, one week or one day.
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.
A user with authorisation 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. In Addition you may apply this filter manually to logins or login groups by setting the flag 'Force global time filter' in the settings page of the login or login group.
Settings for current user
Global settings (access level 4)
Import reservations to Sunbird, iCal or Outlook
The reservations in the kOOL database can be imported into a calendar program using an iCal file. All reservations defined in kOOL, starting from today are published. If you only wish to publish certain reservations items, it is possible to define a preset in kOOL, called "ical" which contains the required reservations items. This is used to filter the reservations exported to iCal.
In order to download the iCal file, you must log in with your kOOL Login. If you cancel the password dialogue or enter a wrong password, only the publicly viewable reservations are exported, i.e. those which you would see in kOOL, without being logged in. The URL for downloading the iCal file is:
http:// YOUR.KOOL.DOMAIN/resical (e.g. http:// kool.church.org/resical)
In order to access the public reservations only without authentication the following URL may be used:
http:// YOUR.KOOL.DOMAIN/resical/?ko_guest (e.g. http:// kool.church.org/resical/?ko_guest)
Older versions of outlook do not support iCal very well. It is best to use Outlook 2003 or even better, Outlook 2007. There is a plugin for use with Outlook 2003, which simplifies the administration of remote calendars: remotecalendars.sourceforge.net
Further information on iCal may be found on Wikipedia: en.wikipedia.org/wiki/ICalendar