Skip to Content

Changes for page Calendar Application

Last modified by Ecaterina Valica on 2014/01/15 13:50
From version 18.1
edited by Vlad Merticariu
on 2011/06/22 15:37
Change comment: There is no comment for this version
To version 7.1
edited by Vlad Merticariu
on 2011/06/17 10:14
Change comment: There is no comment for this version

Summary

Details

Page properties
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: // a document to generate RSS feed will be created//
20 +* RSS notifications: // tbd//
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,158 +30,8 @@
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 -* Each calendar is stored in its own space (only 1 calendar/space)
33 +* Have different calendars for each 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 -
49 -= Detailed Functionality =
50 -
51 -== Adding events ==
52 -
53 -You may add an event by:
54 -
55 -1. Clicking a button which opens a modal window, allowing the user to insert details and save
56 -1. Filling in a form on the event page. The user enters all the details and, after submission, he is redirected back to the calendar in view mode
57 -
58 -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:
59 -
60 -* **Name**
61 -* **Date**: User should be able to mark an event as **recurring**.
62 -* **Location**: Link to Google Maps
63 -* **Description**
64 -* **Category** : //? Do we need this once a user can have multiple calendars? //
65 -* **Color**: The event will have a default color and event creators may select a different color for the new event from a given list
66 -* **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)
67 -* **Privacy options**: Default, Private, Public
68 -* 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
69 -* **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
70 -* **Attachments**: Documents can be attached to an event. An icon will indicate in the daily and weekly view modes that the event has attachments
71 -* **Comments**: Users have the ability to comment on an event. An icon will indicate in daily and weekly view modes that the event has comments
72 -
73 -**More actions:**
74 -
75 -* **Change owner**
76 -* **RSVP for guests**: Users who are not event owners, but see an event to which they are invited in a calendar, should be able to click the "RSVP" link and confirm their presence
77 -* **Delete event**
78 -* **Duplicate event**: Copy an event inside the calendar
79 -* **Copy event to a different calendar**: Copy an event from the current calendar to a different calendar
80 -
81 -== Viewing events ==
82 -
83 -**View calendar:**
84 -
85 -* Tabbed day, week, month, yearly view
86 -* **Year view**:
87 -** There should be 12 cells representing the 12 different months
88 -** When users click on a month (e.g. //June 2011//) they should be directed to that specific month in the "Month" tab
89 -** When users click on a day (e.g. //1//) they should be directed to that specific day in the "Day" tab
90 -** Days that have events associated should be marked with bold
91 -** The current day should be highlighted with a distinct color or frame
92 -** Arrows will be available to go to the previous/next year
93 -* **Month view**:
94 -** Table view; each column represents a day of the week (Monday, Tuesday...); each cell represents a specific date (1, 2...)
95 -** When users click on a day (e.g. //1// in the cell header) they should be directed to that specific day in the "Day" tab
96 -** Events should be displayed chronologically inside each cell. The starting hour of the event should be displayed, the name of the event and an icon indicating if notifications have been set. Clicking or hovering (TBD) on the event will bring up a pop-up with more details and links to edit and delete the event
97 -** The current day should be highlighted with a distinct color (same as the one used for the "Year" view)
98 -** Arrows will be available to go to the previous/next month
99 -* **Week view**
100 -** Table view; each column represents a day of the week (Monday, Tuesday...); each row represents an hour of the day
101 -** When users click on a day (e.g. //Fri 6/17// in the table header) they should be directed to that specific day in the "Day" tab
102 -** Events should be displayed chronologically in each column and occupy the number of cells corresponding to the number of hours the event is scheduled to last. An alert icon should be displayed when a notification is set, an attachment icon when an attachment is present, a comment icon when comments have been added. Clicking or hovering (TBD) on the event will bring up a pop-up with more details and links to edit and delete the event
103 -** The current day should be highlighted with a distinct color (same as the one used for the other views)
104 -** Arrows will be available to go to the previous/next week
105 -* **Day view**
106 -** Table view; one column representing one day; each row represents an hour of the day
107 -** Events should be displayed chronologically and occupy the number of cells corresponding to the number of hours the event is scheduled to last. An alert icon should be displayed when a notification is set, an attachment icon when an attachment is present, a comment icon when comments have been added. Clicking or hovering (TBD) on the event will bring up a pop-up with more details and links to edit and delete the event
108 -** The current day should be highlighted with a distinct color (same as the one used for the other views)
109 -** Arrows will be available to go to the previous/next day
110 -
111 -* **Display events by category**: users can select a category and only events from that category will be displayed in the calendar
112 -* **Jump to a specific date**
113 -
114 -* **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.
115 -
116 -**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? //
117 -
118 -== Settings ==
119 -
120 -=== General ===
121 -
122 -* Calendar **name**
123 -* **Owner**
124 -* **Description**
125 -* **Location**
126 -
127 -
128 -* Week starts on Sunday/Monday/Saturday ? //should this be done automatically depending on the user's location?//
129 -* Show events you have declined: Yes/No
130 -* Automatically add invitations to my calendar: Yes/No
131 -
132 -=== Privacy ===
133 -
134 -**Privacy settings for calendar**
135 -The calendar can be:
136 -
137 -* Public
138 -* Visible for specific wiki users -> Share calendar
139 -* Private
140 -
141 -**Default privacy settings for events**
142 -Events can be
143 -
144 -* Public: visible to everyone specified in the calendar settings
145 -* Private: visible only to the event creator
146 -
147 -=== Notifications ===
148 -
149 -A calendar owner may choose to receive notifications for:
150 -
151 -|=Events he is invited to |=Events he owns
152 -|(((
153 -* New invitations
154 -* Changed invitations
155 -* Canceled invitations
156 -* Invitation replies
157 -)))|(((
158 -* RSVPs from guests (attending, canceling presence)
159 -* Attachments being added
160 -* Comments being added
161 -)))
162 -
163 -In addition, **reminders** can be **sent by default to the calendar owner** via email: 10 minutes, 30 minutes, 1 hour, 1 day, 1 week
164 -
165 -== Search ==
166 -
167 -The "View event list" livetable can be used to filter events by date, location, and even to do searches within the event descriptions.
168 -
169 -== Suggestions ==
170 -
171 -* Ability to print calendar
172 -* Keyboard shortcuts
173 -* Tips or link to documentation
174 -* Notifications by SMS could be interesting
175 -* Gadget integration
176 -
177 -==Further work==
178 -
179 -* Select language?
180 -* Select from different time zones?
181 -* Select date format?
182 -* Select time format?
183 -* Similarly to Google Calendar, event recurrence should be customizable
184 -
185 185  = Technicalities =
186 186  
187 187  The event-calendar part of the application will be implemented in the following way:
... ... @@ -192,35 +192,24 @@
192 192  
193 193  Event class properties:
194 194  
195 -* name (Name: text): // the title of the event//
196 -* startDate (Start date: date(dd/MM/yyy)): // the date when the event starts//
197 -* startTime (Start time: static list): // the hour when the event starts//
198 -* endDate (End date: date(dd/MM/yyyy)): // the date when the event ends//
199 -* endTime (End time: static list): //the hour when the event ends//
200 -* 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
201 -* repeats (Repeats: static list (daily, weekly, monthly, yearly)): // how often the event repeats //
202 -* repeatsUntil (Until: date(dd/MM/yyyy)): // the date when the recursion of the event ends//
45 +* title (Title: text): // the title of the event//
203 203  * description (Description: text): // a short description of the event//
204 204  * location (Location: text): // the location where the event will take place//
205 -* category (Category: database list): // the category of the event//
206 -* color (Color: static list): // the color of the event//
207 -* privacy(Privacy: static list): // set the event to be default, public (visible to everyone) or private (visible only to the user)//
208 -* emailNotifications (Email Notifications: static list): // indicates when the reminders for the event should be sent to the creator and to the guest list//
209 -* guestList (Guest List: user list): // the list of users invited to the event, waiting for confirmation//
210 -* confirmedGuests (Attending guests: user list, disabled): // the list of users who have confirmed their attendance to the event//
211 -* declinedGuests (Non-attending guests: user list, disabled): // the list of users who have declined their attendance to the event//
212 -* guestRights (Guests can: static lists): // Indicates if the guests can Modify event, Invite other guests, View guest list //
48 +* startDate (Start date: date(dd/MM/yyy)): // the date when the event starts//
49 +* startTime (Start time: time? (HH/mm)): // the hour when the event starts//
50 +* endDate (End date: date(dd/MM/yyyy)): // the date when the event ends//
51 +* endTime (End time: time? (HH/mm)): //the hour when the event ends//
52 +* calendar(Calendar: text): // the calendar to which the event belongs (its space)//
53 +* category(Category: text): // the category of the event//
54 +* privacySettings(Privacy Settings: text): // set the event to be public (visible to everyone) or private (visible only to the user)//
55 +* emailNotifications(Email Notifications: bool): // indicates if the notifications are activated or not//
56 +* userNotifiationList(Users to receive notifications: ?): // the list of users to be notified about the event//
213 213  
214 214  Calendar class properties:
215 215  
216 -* name (Name: text): // the name of the calendar//
60 +* title (Title: text): // the title of the calendar//
217 217  * description(Description: text): // a short description of the calendar//
218 -* privacy(Privacy: static list): // set the calendar to be public(visible to everyone), visible to specific users or private(visisble only to the user)//
219 -* shareList(Share calendar: user list): // if privacy is set to visible for specific users, this list will contain the users who can view it//
220 220  * owner(Owner: user): // the user who owns the calendar//
221 -* 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?//
222 -* showDeclinedEvents(Show Events you have declined: bool): // Indicates if events which have been declined should be added to the calendar//
223 -* 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//
224 224  
225 225  Calendar class sheets:
226 226  
... ... @@ -227,8 +227,8 @@
227 227  * CalendarViewDaySheet: // contains the display of the calendar table in "day" view//
228 228  * CalendarViewWeekSheet: // contains the display of the calendar table in "week" view//
229 229  * CalendarViewMonthSheet: // contains the display of the calendar table in "month" view//
230 -* CalendarViewYearSheet: // contains the display of the calendar table in "year" view//
231 -* CreateCalendarEvent: // contains the form for adding new events//
69 +* CalendarViewYearSheet?
70 +* CalendarFormSheet: // contains the form for adding new events//
232 232  * CalendarEventListSheet: // contains the list of events for the specific calendar, with edit and delete links if the user has editing rights//
233 233  
234 234  Category class properties:
... ... @@ -235,5 +235,3 @@
235 235  
236 236  * title(Title: text): // the title of the category//
237 237  * description(Description: text): // a short description of the category//
238 -
239 -
actions.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -70.2 KB
Content
addMenu.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -18.1 KB
Content
eventFields.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -73.9 KB
Content
monthView.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -87.5 KB
Content
weekView.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -62.2 KB
Content
yearView.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Size
... ... @@ -1,1 +1,0 @@
1 -75.8 KB
Content
XWiki.XWikiComments[0]
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.evalica
Comment
... ... @@ -1,3 +1,0 @@
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,1 +1,0 @@
1 -2011-06-22 11:59:17.0
XWiki.XWikiComments[1]
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Enygma
Comment
... ... @@ -1,7 +1,0 @@
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,1 +1,0 @@
1 -2011-06-22 12:35:20.0
Reply To
... ... @@ -1,1 +1,0 @@
1 -0