1 = Calendar Management Interface = 2 3 Since some users of the calendar system may not have a calendar program or a 4 mail program that understands calendar data, a Web-based interface is provided 5 that allows such users to inspect incoming calendar data, consult a schedule 6 that has been prepared through the work of the [[../AgentPrograms|agent programs]], 7 and to create events to be shared with others. 8 9 The management interface is deployed according to the 10 [[../WebServerIntegration|Web server integration guide]] and, if enabled, will be 11 advertised in messages sent by imip-agent to users receiving calendar-related 12 messages, with links being provided like this (subject to the configuration): 13 14 {{{ 15 https://webserver.example.com/imip-manager/eventid 16 }}} 17 18 Upon following such a link, users should be asked to log in. They should then be 19 presented with the details of an event received via e-mail. 20 21 == The Calendar View == 22 23 The root resource of the management interface shows a simple calendar view for 24 the logged-in user. The following elements are displayed: 25 26 * The name of the user, linking to a profile page 27 28 * Any requests/invitations that require attention, linking to those items in the 29 calendar 30 31 * The period being shown, along with controls to navigate forwards and backwards 32 in the calendar, and controls to show and hide empty days and busy periods 33 34 * Participants for scheduling: details of other users whose schedules are shown 35 alongside the user's own schedule 36 37 * The calendar itself, featuring events, and possibly featuring a column 38 containing requests and invitations 39 40 Adding scheduling participants, specifying their e-mail address, results in a new 41 schedule column being added for each new participant in the calendar. When creating 42 an event, all scheduling participants are automatically added as attendees. 43 44 The calendar is divided into days, and these are divided into periods depending on 45 the nature of any events that feature in the calendar. Days for which no events are 46 recorded are hidden by default; such days can be shown if desired. 47 48 Whole days can be chosen by selecting day headings in the calendar. Similarly, 49 individual periods can be chosen either by selecting period headings along the side 50 of the calendar or by selecting cells in the calendar. Upon selecting periods, 51 controls will appear for the creation of a new event, and if all periods are 52 deselected, such controls will disappear. 53 54 Events appear in the calendar as filled regions, and their labels correspond to the 55 summary information defined for each event. These labels link to the event details 56 unless a request has updated the event: in which case, the request label will link 57 to the updated event details. 58 59 Requests/invitations appear alongside events in a separate column in the calendar, 60 and their label links to the details of the request (and thus updated event). Such 61 items disappear from the calendar once processed by the user. 62 63 == The User Profile == 64 65 Each user's profile details are presented in a table mostly corresponding to the 66 system's [[../Preferences|preferences]], with the most significant settings given 67 first. Many users will probably only want to change their participation in the 68 calendar system, their name, language or time zone, at least if the defaults 69 chosen for deployment are reasonable. 70 71 The settings names correspond to the preferences as follows: 72 73 ## This is generated by the docs/tools/profile_prefs.sh script... 74 75 || '''Label''' || '''Setting''' || 76 || Participate in the calendar system || [[../Preferences#participating|participating]] || 77 || Your common name || [[../Preferences#CN|CN]] || 78 || Language || [[../Preferences#LANG|LANG]] || 79 || Time zone/regime || [[../Preferences#TZID|TZID]] || 80 || How to present incoming calendar messages || [[../Preferences#incoming|incoming]] || 81 || Share free/busy information || [[../Preferences#freebusy_sharing|freebusy_sharing]] || 82 || Bundle free/busy details with messages || [[../Preferences#freebusy_bundling|freebusy_bundling]] || 83 || Publish free/busy details via the Web || [[../Preferences#freebusy_publishing|freebusy_publishing]] || 84 || Deliver details of received free/busy messages || [[../Preferences#freebusy_messages|freebusy_messages]] || 85 || How to respond to messages adding events || [[../Preferences#add_method_response|add_method_response]] || 86 || How to handle event refresh requests || [[../Preferences#event_refreshing|event_refreshing]] || 87 || Recognise whom as a new organiser of an event? || [[../Preferences#organiser_replacement|organiser_replacement]] || 88 89 == The Event View == 90 91 The event view consists of the following elements: 92 93 * Basic event details: summary, start and end dates/times, and the organiser 94 95 * A list of attendees with controls to add and remove attendees, depending on 96 the role of the user 97 98 * Some controls to change or process the event 99 100 In addition, some other elements may appear in the event view: 101 102 * Periods during which the event recurs 103 104 * Counter-proposals sent by attendees to the organiser of an event, appearing 105 if the user has the organiser role, with controls to process these items 106 107 * Periods that conflict with the event's own periods