= Calendar Management Interface =

Since some users of the calendar system may not have a calendar program or a
mail program that understands calendar data, a Web-based interface is provided
that allows such users to inspect incoming calendar data, consult a schedule
that has been prepared through the work of the [[../AgentPrograms|agent programs]],
and to create events to be shared with others.

The management interface is deployed according to the
[[../WebServerIntegration|Web server integration guide]] and, if enabled, will be
advertised in messages sent by imip-agent to users receiving calendar-related
messages, with links being provided like this (subject to the configuration):

{{{
https://webserver.example.com/imip-manager/eventid
}}}

Upon following such a link, users should be asked to log in. They should then be
presented with the details of an event received via e-mail.

== The Calendar View ==

The root resource of the management interface shows a simple calendar view for
the logged-in user. The following elements are displayed:

 * The name of the user, linking to a profile page

 * Any requests/invitations that require attention, linking to those items in the
 calendar

 * The period being shown, along with controls to navigate forwards and backwards
 in the calendar, and controls to show and hide empty days and busy periods

 * Participants for scheduling: details of other users whose schedules are shown
 alongside the user's own schedule

 * The calendar itself, featuring events, and possibly featuring a column
 containing requests and invitations

=== Group Scheduling ===

Adding scheduling participants, specifying their e-mail address, results in a new
schedule column being added for each new participant in the calendar. When creating
an event, all scheduling participants are automatically added as attendees.

=== Hiding and Showing Days ===

The calendar is divided into days, and these are divided into periods depending on
the nature of any events that feature in the calendar. Days for which no events are
recorded are hidden by default; such days can be shown if desired.

=== Selecting Periods and Creating Events ===

Whole days can be chosen by selecting day headings in the calendar. Similarly,
individual periods can be chosen either by selecting period headings along the side
of the calendar or by selecting cells in the calendar. Upon selecting periods,
controls will appear for the creation of a new event, and if all periods are
deselected, such controls will disappear.

=== Event Periods ===

Events appear in the calendar as filled regions, and their labels correspond to the
summary information defined for each event. These labels link to the event details
unless a request has updated the event: in which case, the request label will link
to the updated event details.

=== Requests and Invitations ===

Requests/invitations appear alongside events in a separate column in the calendar,
and their label links to the details of the request (and thus updated event). Such
items disappear from the calendar once processed by the user.

== The User Profile ==

Each user's profile details are presented in a table mostly corresponding to the
system's [[../Preferences|preferences]], with the most significant settings given
first. Many users will probably only want to change their participation in the
calendar system, their name, language or time zone, at least if the defaults
chosen for deployment are reasonable.

The settings names correspond to the preferences as follows:

## This is generated by the docs/tools/profile_prefs.sh script...

|| '''Label''' || '''Setting''' ||
|| Participate in the calendar system || [[../Preferences#participating|participating]] ||
|| Your common name || [[../Preferences#CN|CN]] ||
|| Language || [[../Preferences#LANG|LANG]] ||
|| Time zone/regime || [[../Preferences#TZID|TZID]] ||
|| How to present incoming calendar messages || [[../Preferences#incoming|incoming]] ||
|| Share free/busy information || [[../Preferences#freebusy_sharing|freebusy_sharing]] ||
|| Bundle free/busy details with messages || [[../Preferences#freebusy_bundling|freebusy_bundling]] ||
|| Publish free/busy details via the Web || [[../Preferences#freebusy_publishing|freebusy_publishing]] ||
|| Deliver details of received free/busy messages || [[../Preferences#freebusy_messages|freebusy_messages]] ||
|| How to respond to messages adding events || [[../Preferences#add_method_response|add_method_response]] ||
|| How to handle event refresh requests || [[../Preferences#event_refreshing|event_refreshing]] ||
|| Recognise whom as a new organiser of an event? || [[../Preferences#organiser_replacement|organiser_replacement]] ||

== The Event View ==

The event view consists of the following elements:

 * Basic event details: summary, start and end dates/times, and the organiser

 * A list of attendees with controls to add and remove attendees, depending on
 the role of the user

 * Some controls to change or process the event

In addition, some other elements may appear in the event view:

 * Periods during which the event recurs

 * Counter-proposals sent by attendees to the organiser of an event, appearing
 if the user has the organiser role, with controls to process these items

 * Periods that conflict with the event's own periods

=== Organiser and Attendee Roles ===

Changes can be made to events in both the organiser and attendee roles. As
organiser, any changes will incorporated into the event, and the new version
will be sent to attendees on choosing to update the event. As attendee,
changes are incorporated into counter-proposals that are sent back to the
organiser for approval or rejection.

=== Editing Event Details ===

Only organisers can edit the core details of an event. They may add and remove
attendees, and they may also add and remove periods associated with the event.

The removal of existing attendees will not cause such attendees to be
instantly deleted from the event details. Instead, such attendees will
initially be marked as removed and, after editing is complete, have
cancellation messages sent to them informing them that their attendance is no
longer required.

Attendees themselves can suggest other attendees by adding them, and they may
also remove those suggested attendees. However, they may not remove existing
attendees.

Attendees can also redefine event periods, but these modifications will merely
be sent back to the organiser for review. Any acceptance of such changes will
occur if the organiser chooses to send out a revised version of the event
featuring those changes. Otherwise, an explicit message declining such changes
may be received.