Skip to Content

Changes for page Calendar Application

Last modified by Ecaterina Valica on 2014/01/15 13:50
From version 9.6
edited by Silvia Rusu
on 2011/06/20 13:54
Change comment: There is no comment for this version
To version 22.1
edited by Vlad Merticariu
on 2011/07/06 17:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.SilviaRusu
1 +XWiki.vladm
Content
... ... @@ -17,7 +17,7 @@
17 17  * Import/export: // tbd - ical feeds //
18 18  * Microformats support: // tbd//
19 19  * JS drag & drop on the calendar table for changing the dates/hours of the events ?: // an event can be dragged from one slot of the calendar table to another slot//
20 -* RSS notifications: // tbd//
20 +* RSS notifications: // a document to generate RSS feed will be created//
21 21  * Email notifications: // emails with information about the event are sent to the calendar creator and to the selected users (when?)//
22 22  * Privacy settings on events: // events can be public or private, public events are visible to everyone, private events are visible only to the calendar creator//
23 23  * Privacy settings on calendar
... ... @@ -30,8 +30,28 @@
30 30  * Daily view of the calendar, listing all the events in that day
31 31  * Have an API for accessing events
32 32  * Each event must be stored in its own document
33 -* Have different calendars for each space
33 +* Each calendar is stored in its own space (only 1 calendar/space)
34 34  
35 += Alternatives =
36 +
37 +**Calendar aggregator**
38 +
39 +The WebHome of the application is an aggregated calendar which displays the events from all the calendars of a user.
40 +The user creates several calendars (e.g. Personal, Work) which can be visualized both individually and together, on the main page of the application.
41 +This is very similar to Google Calendar, following the same approach. The main advantage of this is the ease of interaction between users' calendars (e.g. sharing a calendar with another user means displaying the specific calendar among his own calendars, inside the WebHome).
42 +
43 +
44 +**Individual calendars with categories**
45 +
46 +The users creates calendars which are individual entities and each event is assigned a category when added.
47 +When the user is invited to other events he can choose to view those events in one or more of his calendars while when another user shares a calendar with him he can only view that calendar, on a separate page.
48 +The current technicalities are meant for this alternative.
49 +
50 +**Unique calendar/user**
51 +
52 +Every user has only one calendar. Events can be categorized just as above.
53 +For sharing the user has 2 options: share the entire calendar or share a category, which, as functionality, makes it similar to the Calendar aggregator alternative.
54 +
35 35  = Detailed Functionality =
36 36  
37 37  == Adding events ==
... ... @@ -44,12 +44,12 @@
44 44  Each calendar will be stored in a space. A space can only contain one calendar. Each event must be stored in its own document and should have:
45 45  
46 46  * **Name**
47 -* **Date**: User should be able to mark an event as **recurring**. Similarly to Google Calendar, event recurrence should be customizable
67 +* **Date**: User should be able to mark an event as **recurring**.
48 48  * **Location**: Link to Google Maps
49 49  * **Description**
50 -* **Category**
70 +* **Category** (e.g. Personal, Work)
51 51  * **Color**: The event will have a default color and event creators may select a different color for the new event from a given list
52 -* **Notifications**: Email notifications may be sent to the event creator and the users he selects **n** minutes/hours/days/weeks before the event (n = a number the event creator fills in; minutes/hours/days/weeks are options in a drop-down). The event creator can also choose to be notified via RSS about event changes.
72 +* **Notifications**: Email notifications may be sent to the event creator and the users he selects (10 minutes, 30 minutes, 1 hour, 1 day, 1 week)
53 53  * **Privacy options**: Default, Private, Public
54 54  * The possibility to **add guests**. Guests can appear in the form of wiki users or email addresses. Suggestions should be available if the event creator starts typing in a user's name. Guests will be notified by email they have been invited to the event and they should be able to RSVP (confirm their presence) via email
55 55  * **Set rights for guests**. The event creator can grant users one, some or all of the following rights: modify the event, invite other guests to the event, see the guest list
... ... @@ -99,34 +99,81 @@
99 99  
100 100  * **Viewing events you are invited to in your calendar**: Calendar owners will have view right by default for their own calendar (space). View rights should also be granted for events he is invited to. This means having view rights on event pages that are located in other calendars (spaces). Other rights, such as edit and comment can also be granted, depending on the settings established by the the owner when creating the event.
101 101  
102 -**View event list:** A page (modal window) with the list of all the events in the calendar is displayed, using LiveTable, were the user can filter and edit/delete events (if he has the right to do it, additional view to administrate events)
122 +**View event list:** A page (modal window) with the list of all the events in the calendar is displayed, using LiveTable, were the user can filter and edit/delete events (if he has the right to do it, additional view to administrate events) // ? Do we need this once the events can be viewed in calendar table? //
103 103  
104 104  == Settings ==
105 105  
106 -=== Privacy Settings ===
126 +=== General ===
107 107  
128 +* Calendar **name**
129 +* **Owner**
130 +* **Description**
131 +* **Location**
132 +
133 +* Week starts on Sunday/Monday/Saturday ? //should this be done automatically depending on the user's location?//
134 +* Show events you have declined: Yes/No
135 +* Automatically add invitations to my calendar: Yes/No
136 +
137 +=== Privacy ===
138 +
108 108  **Privacy settings for calendar**
109 109  The calendar can be:
141 +
110 110  * Public
111 -* Visible for specific wiki users
143 +* Visible for specific wiki users -> Share calendar
112 112  * Private
113 113  
146 +**Privacy settings for the categories**
147 +Each category can be:
148 +
149 +* Public
150 +* Visible for specific wiki users -> Share category
151 +* Private
152 +
114 114  **Default privacy settings for events**
115 115  Events can be
155 +
116 116  * Public: visible to everyone specified in the calendar settings
117 117  * Private: visible only to the event creator
118 118  
119 119  === Notifications ===
120 120  
121 -=== Date and Language ===
161 +A calendar owner may choose to receive notifications for:
122 122  
163 +|=Events he is invited to |=Events he owns
164 +|(((
165 +* New invitations
166 +* Changed invitations
167 +* Canceled invitations
168 +* Invitation replies
169 +)))|(((
170 +* RSVPs from guests (attending, canceling presence)
171 +* Attachments being added
172 +* Comments being added
173 +)))
174 +
175 +In addition, **reminders** can be **sent by default to the calendar owner** via email: 10 minutes, 30 minutes, 1 hour, 1 day, 1 week
176 +
177 +== Search ==
178 +
179 +The "View event list" livetable can be used to filter events by date, location, and even to do searches within the event descriptions.
180 +
123 123  == Suggestions ==
124 124  
125 125  * Ability to print calendar
126 126  * Keyboard shortcuts
127 127  * Tips or link to documentation
186 +* Notifications by SMS could be interesting
128 128  * Gadget integration
129 129  
189 +== Further work ==
190 +
191 +* Select language?
192 +* Select from different time zones?
193 +* Select date format?
194 +* Select time format?
195 +* Similarly to Google Calendar, event recurrence should be customizable
196 +
130 130  = Technicalities =
131 131  
132 132  The event-calendar part of the application will be implemented in the following way:
... ... @@ -137,24 +137,42 @@
137 137  
138 138  Event class properties:
139 139  
140 -* title (Title: text): // the title of the event//
141 -* description (Description: text): // a short description of the event//
142 -* location (Location: text): // the location where the event will take place//
207 +* name (Name: text): // the title of the event//
143 143  * startDate (Start date: date(dd/MM/yyy)): // the date when the event starts//
144 144  * startTime (Start time: static list): // the hour when the event starts//
145 145  * endDate (End date: date(dd/MM/yyyy)): // the date when the event ends//
146 146  * endTime (End time: static list): //the hour when the event ends//
147 -* category(Category: database list): // the category of the event//
148 -* privacySettings(Privacy: static list): // set the event to be public (visible to everyone) or private (visible only to the user)//
149 -* notifications(notifications: bool): // indicates if the notifications are activated or not//
150 -* userNotifiationList(Users to receive notifications: ?): // the list of users to be notified about the event//
212 +* allDay (All day: bool): //checkbox which indicates that startTime is 00:00 of the startDate and endTime is 00:00 of the day after endDate//
213 +* repeats (Repeats: static list (daily, weekly, monthly, yearly)): // how often the event repeats //
214 +* repeatsUntil (Until: date(dd/MM/yyyy)): // the date when the recursion of the event ends//
215 +* description (Description: text): // a short description of the event//
216 +* location (Location: text): // the location where the event will take place//
217 +* category (Category: database list): // the category of the event//
218 +* color (Color: static list): // the color of the event//
219 +* privacy(Privacy: static list): // set the event to be default, public (visible to everyone) or private (visible only to the user)//
220 +* emailNotifications (Email Notifications: static list): // indicates when the reminders for the event should be sent to the creator and to the guest list//
221 +* guestViewList (Guest View List: database list): // the list of users invited to the event, having view rights, waiting for confirmation//
222 +* guestEditList (Guest Edit List: database list): // the list of users invited to the event, having edit rights, waiting for confirmation//
223 +* attendingGuests (Attending guests: database list): // the list of users who have confirmed their attendance to the event//
224 +* nonattendingGuests (Non-attending guests: database list): // the list of users who have declined their attendance to the event//
225 +* notifiedGuests (Notified Guests: database list): // the list of guests who have received notifications about their event invitation //
151 151  
227 +XWikiRights objects will be added to event documents in the following way:
228 +
229 +* default events: //**edit** object for guestEditList and owner, **delete** object for owner//
230 +* public events: //**view** object for XWikiAll group, edit object for guestEditList and owner, delete object for owner//
231 +* private events: //**view** object for guestEditList, guestViewList and owner, **edit** object for guestEditList and **owner**, delete object for owner//
232 +
152 152  Calendar class properties:
153 153  
154 -* title (Title: text): // the title of the calendar//
235 +* name (Name: text): // the name of the calendar//
155 155  * description(Description: text): // a short description of the calendar//
156 -* privacySettings(Privacy: static list): // set the calendar to be public(visible to everyone) or private(visisble only to the user)//
237 +* privacy(Privacy: static list): // set the calendar to be public(visible to everyone), visible to specific users or private(visisble only to the user)//
238 +* shareList(Share calendar: user list): // if privacy is set to visible for specific users, this list will contain the users who can view it//
157 157  * owner(Owner: user): // the user who owns the calendar//
240 +* weekStart(Week starts on: static list): // The day when the week starts (Sunday, Monday or Saturday) ? should this be done automatically depending on the user's location?//
241 +* showDeclinedEvents(Show Events you have declined: bool): // Indicates if events which have been declined should be added to the calendar//
242 +* addInvitations(Automatically add invitations to the calendar: bool): // Indicates if the events to which the user has been invited should be added to the calendar//
158 158  
159 159  Calendar class sheets:
160 160  
... ... @@ -161,8 +161,8 @@
161 161  * CalendarViewDaySheet: // contains the display of the calendar table in "day" view//
162 162  * CalendarViewWeekSheet: // contains the display of the calendar table in "week" view//
163 163  * CalendarViewMonthSheet: // contains the display of the calendar table in "month" view//
164 -* CalendarViewYearSheet?
165 -* CalendarFormSheet: // contains the form for adding new events//
249 +* CalendarViewYearSheet: // contains the display of the calendar table in "year" view//
250 +* CreateCalendarEvent: // contains the form for adding new events//
166 166  * CalendarEventListSheet: // contains the list of events for the specific calendar, with edit and delete links if the user has editing rights//
167 167  
168 168  Category class properties:
actions.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +70.2 KB
Content
addMenu.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +18.1 KB
Content
eventFields.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +73.9 KB
Content
monthView.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +87.5 KB
Content
weekView.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +62.2 KB
Content
yearView.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Size
... ... @@ -1,0 +1,1 @@
1 +75.8 KB
Content
XWiki.XWikiComments[0]
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.evalica
Comment
... ... @@ -1,0 +1,3 @@
1 +I don't think we will need a livetable to list all the events since you can see/delete/edit all events in the year/month/week views. The calendar events are much powerful when they are in a timeline than seeing them in a list.
2 +
3 +Also I don't think is necessary the concept of categories when you can have multiple calendars. Right now in Google Calendar you can create multiple calendars and attribute each calendar a goal (have a personal one, a xwiki one, a birthday, etc). In this use case the concept of categories is replaced by multiple calendars.
Date
... ... @@ -1,0 +1,1 @@
1 +2011-06-22 11:59:17.0
XWiki.XWikiComments[1]
Author
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.Enygma
Comment
... ... @@ -1,0 +1,7 @@
1 +I agree with this.
2 +
3 +We should have a 2 views:
4 +1. Individual calendar view, that should be available on each calendar's space WebHome
5 +2. Aggregated calendar view for all the calendars and events that are visible to the current user. This could be a new tab in the user's profile (harder for an application to extend right now) or, alternatively, in the Calendar application's space WebHome (easier and makes the Calendar application space useful).
6 +
7 +The event livetable might be useful for an 'advanced search' functionality, allowing to filter events nicely.
Date
... ... @@ -1,0 +1,1 @@
1 +2011-06-22 12:35:20.0
Reply To
... ... @@ -1,0 +1,1 @@
1 +0