1 // This module implements iCalendar object processing and the Calendar>
2 // room on a Citadel server. It handles iCalendar objects using the
3 // iTIP protocol. See RFCs 2445 and 2446.
5 // Copyright (c) 1987-2024 by the citadel.org team
7 // This program is open source software. Use, duplication, or disclosure
8 // are subject to the terms of the GNU General Public License version 3.
10 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
12 #include "../../ctdl_module.h"
13 #include <libical/ical.h>
14 #include "../../msgbase.h"
15 #include "../../internet_addressing.h"
16 #include "serv_calendar.h"
17 #include "../../room_ops.h"
18 #include "../../euidindex.h"
19 #include "../../default_timezone.h"
20 #include "../../config.h"
22 struct ical_respond_data {
23 char desired_partnum[SIZ];
28 // Utility function to create a new VCALENDAR component with some of the
29 // required fields already set the way we like them.
30 icalcomponent *icalcomponent_new_citadel_vcalendar(void) {
31 icalcomponent *encaps;
33 encaps = icalcomponent_new_vcalendar();
35 syslog(LOG_ERR, "calendar: could not allocate component");
40 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
42 // Set the Version Number
43 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
49 // Utility function to encapsulate a subcomponent into a full VCALENDAR
50 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
51 icalcomponent *encaps;
53 // If we're already looking at a full VCALENDAR component, don't bother ... just return itself.
54 if (icalcomponent_isa(subcomp) == ICAL_VCALENDAR_COMPONENT) {
58 // Encapsulate the VEVENT component into a complete VCALENDAR
59 encaps = icalcomponent_new_citadel_vcalendar();
60 if (encaps == NULL) return NULL;
62 // Encapsulate the subcomponent inside
63 icalcomponent_add_component(encaps, subcomp);
65 // Return the object we just created.
70 // Write a calendar object into the specified user's calendar room.
71 // If the supplied user is NULL, this function writes the calendar object
72 // to the currently selected room.
73 void ical_write_to_cal(struct ctdluser *u, icalcomponent *cal) {
76 icalcomponent *encaps = NULL;
77 struct CtdlMessage *msg = NULL;
78 icalcomponent *tmp=NULL;
80 if (cal == NULL) return;
82 // If the supplied object is a subcomponent, encapsulate it in
83 // a full VCALENDAR component, and save that instead.
84 if (icalcomponent_isa(cal) != ICAL_VCALENDAR_COMPONENT) {
85 tmp = icalcomponent_new_clone(cal);
86 encaps = ical_encapsulate_subcomponent(tmp);
87 ical_write_to_cal(u, encaps);
88 icalcomponent_free(tmp);
89 icalcomponent_free(encaps);
93 ser = icalcomponent_as_ical_string_r(cal);
94 if (ser == NULL) return;
98 // If the caller supplied a user, write to that user's default calendar room
100 CtdlWriteObject( // This handy API function does all the work for us.
101 USERCALENDARROOM, // which room
102 "text/calendar", // MIME type
104 serlen + 1, // length
111 // If the caller did not supply a user, write to the currently selected room
113 struct CitContext *CCC = CC;
116 msg = malloc(sizeof(struct CtdlMessage));
117 memset(msg, 0, sizeof(struct CtdlMessage));
118 msg->cm_magic = CTDLMESSAGE_MAGIC;
119 msg->cm_anon_type = MES_NORMAL;
120 msg->cm_format_type = 4;
121 CM_SetField(msg, eAuthor, CCC->user.fullname);
122 CM_SetField(msg, eOriginalRoom, CCC->room.QRname);
124 MsgBody = NewStrBufPlain(NULL, serlen + 100);
125 StrBufAppendBufPlain(MsgBody, HKEY("Content-type: text/calendar\r\n\r\n"), 0);
126 StrBufAppendBufPlain(MsgBody, ser, serlen, 0);
128 CM_SetAsFieldSB(msg, eMessageText, &MsgBody);
130 // Now write the data
131 CtdlSubmitMsg(msg, NULL, "");
135 // In either case, now we can free the serialized calendar object
140 // Send a reply to a meeting invitation.
142 // 'request' is the invitation to reply to.
143 // 'action' is the string "accept" or "decline" or "tentative".
144 void ical_send_a_reply(icalcomponent *request, char *action) {
145 icalcomponent *the_reply = NULL;
146 icalcomponent *vevent = NULL;
147 icalproperty *attendee = NULL;
148 char attendee_string[SIZ];
149 icalproperty *organizer = NULL;
150 char organizer_string[SIZ];
151 icalproperty *summary = NULL;
152 char summary_string[SIZ];
153 icalproperty *me_attend = NULL;
154 struct recptypes *recp = NULL;
155 icalparameter *partstat = NULL;
156 char *serialized_reply = NULL;
157 char *reply_message_text = NULL;
159 struct CtdlMessage *msg = NULL;
160 struct recptypes *valid = NULL;
162 *organizer_string = '\0';
163 strcpy(summary_string, "Calendar item");
165 if (request == NULL) {
166 syslog(LOG_ERR, "calendar: trying to reply to NULL event");
170 the_reply = icalcomponent_new_clone(request);
171 if (the_reply == NULL) {
172 syslog(LOG_ERR, "calendar: cannot clone request");
176 // Change the method from REQUEST to REPLY
177 icalcomponent_set_method(the_reply, ICAL_METHOD_REPLY);
179 vevent = icalcomponent_get_first_component(the_reply, ICAL_VEVENT_COMPONENT);
180 if (vevent != NULL) {
181 // Hunt for attendees, removing ones that aren't us.
182 // (Actually, remove them all, cloning our own one so we can
183 // re-insert it later)
184 while (attendee = icalcomponent_get_first_property(vevent, ICAL_ATTENDEE_PROPERTY), (attendee != NULL)) {
185 ch = icalproperty_get_attendee(attendee);
186 if ((ch != NULL) && !strncasecmp(ch, "MAILTO:", 7)) {
187 safestrncpy(attendee_string, ch + 7, sizeof (attendee_string));
188 string_trim(attendee_string);
189 recp = validate_recipients(attendee_string, NULL, 0);
191 if (!strcasecmp(recp->recp_local, CC->user.fullname)) {
192 if (me_attend) icalproperty_free(me_attend);
193 me_attend = icalproperty_new_clone(attendee);
195 free_recipients(recp);
200 icalcomponent_remove_property(vevent, attendee);
201 icalproperty_free(attendee);
204 // We found our own address in the attendee list.
206 // Change the partstat from NEEDS-ACTION to ACCEPT or DECLINE
207 icalproperty_remove_parameter_by_kind(me_attend, ICAL_PARTSTAT_PARAMETER);
209 if (!strcasecmp(action, "accept")) {
210 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_ACCEPTED);
212 else if (!strcasecmp(action, "decline")) {
213 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_DECLINED);
215 else if (!strcasecmp(action, "tentative")) {
216 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_TENTATIVE);
219 if (partstat) icalproperty_add_parameter(me_attend, partstat);
221 // Now insert it back into the vevent.
222 icalcomponent_add_property(vevent, me_attend);
225 // Figure out who to send this thing to
226 organizer = icalcomponent_get_first_property(vevent, ICAL_ORGANIZER_PROPERTY);
227 if (organizer != NULL) {
228 if (icalproperty_get_organizer(organizer)) {
229 strcpy(organizer_string,
230 icalproperty_get_organizer(organizer) );
233 if (!strncasecmp(organizer_string, "MAILTO:", 7)) {
234 strcpy(organizer_string, &organizer_string[7]);
235 string_trim(organizer_string);
238 strcpy(organizer_string, "");
241 // Extract the summary string -- we'll use it as the message subject for the reply
242 summary = icalcomponent_get_first_property(vevent, ICAL_SUMMARY_PROPERTY);
243 if (summary != NULL) {
244 if (icalproperty_get_summary(summary)) {
245 strcpy(summary_string,
246 icalproperty_get_summary(summary) );
251 // Now generate the reply message and send it out.
252 serialized_reply = icalcomponent_as_ical_string_r(the_reply);
253 icalcomponent_free(the_reply); // don't need this anymore
254 if (serialized_reply == NULL) return;
256 reply_message_text = malloc(strlen(serialized_reply) + SIZ);
257 if (reply_message_text != NULL) {
258 sprintf(reply_message_text,
259 "Content-type: text/calendar; charset=\"utf-8\"\r\n\r\n%s\r\n",
263 msg = CtdlMakeMessage(&CC->user,
264 organizer_string, // to
271 summary_string, // Use the event SUMMARY as the message subject
278 valid = validate_recipients(organizer_string, NULL, 0);
279 CtdlSubmitMsg(msg, valid, "");
281 free_recipients(valid);
284 free(serialized_reply);
288 // Callback function for mime parser that hunts for calendar content types
289 // and turns them into calendar objects. If something is found, it is placed
290 // in ird->cal, and the caller now owns that memory and is responsible for freeing it.
291 void ical_locate_part(char *name, char *filename, char *partnum, char *disp,
292 void *content, char *cbtype, char *cbcharset, size_t length, char *encoding,
293 char *cbid, void *cbuserdata) {
295 struct ical_respond_data *ird = NULL;
297 ird = (struct ical_respond_data *) cbuserdata;
299 // desired_partnum can be set to "_HUNT_" to have it just look for
300 // the first part with a content type of text/calendar. Otherwise
301 // we have to only process the right one.
302 if (strcasecmp(ird->desired_partnum, "_HUNT_")) {
303 if (strcasecmp(partnum, ird->desired_partnum)) {
308 if ( (strcasecmp(cbtype, "text/calendar"))
309 && (strcasecmp(cbtype, "application/ics"))
314 if (ird->cal != NULL) {
315 icalcomponent_free(ird->cal);
319 ird->cal = icalcomponent_new_from_string(content);
323 // Respond to a meeting request.
324 void ical_respond(long msgnum, char *partnum, char *action) {
325 struct CtdlMessage *msg = NULL;
326 struct ical_respond_data ird;
329 (strcasecmp(action, "accept"))
330 && (strcasecmp(action, "decline"))
332 cprintf("%d Action must be 'accept' or 'decline'\n", ERROR + ILLEGAL_VALUE);
336 msg = CtdlFetchMessage(msgnum, 1);
338 cprintf("%d Message %ld not found.\n", ERROR + ILLEGAL_VALUE, (long)msgnum);
342 memset(&ird, 0, sizeof ird);
343 strcpy(ird.desired_partnum, partnum);
344 mime_parser(CM_RANGE(msg, eMessageText),
345 *ical_locate_part, // callback function
348 (void *) &ird, // user data
352 // We're done with the incoming message, because we now have a * calendar object in memory.
355 // Here is the real meat of this function. Handle the event.
356 if (ird.cal != NULL) {
357 // Save this in the user's calendar if necessary
358 if (!strcasecmp(action, "accept")) {
359 ical_write_to_cal(&CC->user, ird.cal);
362 // Send a reply if necessary
363 if (icalcomponent_get_method(ird.cal) == ICAL_METHOD_REQUEST) {
364 ical_send_a_reply(ird.cal, action);
367 // We used to delete the invitation after handling it.
368 // We don't do that anymore, but here is the code that handled it:
369 // CtdlDeleteMessages(CC->room.QRname, &msgnum, 1, "");
371 // Free the memory we allocated and return a response.
372 icalcomponent_free(ird.cal);
374 cprintf("%d ok\n", CIT_OK);
378 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
382 // should never get here
386 // Figure out the UID of the calendar event being referred to in a
387 // REPLY object. This function is recursive.
388 void ical_learn_uid_of_reply(char *uidbuf, icalcomponent *cal) {
389 icalcomponent *subcomponent;
392 // If this object is a REPLY, then extract the UID.
393 if (icalcomponent_isa(cal) == ICAL_VEVENT_COMPONENT) {
394 p = icalcomponent_get_first_property(cal, ICAL_UID_PROPERTY);
396 strcpy(uidbuf, icalproperty_get_comment(p));
400 // Otherwise, recurse through any VEVENT subcomponents. We do NOT want the
401 // UID of the reply; we want the UID of the invitation being replied to.
402 for (subcomponent = icalcomponent_get_first_component(cal, ICAL_VEVENT_COMPONENT);
403 subcomponent != NULL;
404 subcomponent = icalcomponent_get_next_component(cal, ICAL_VEVENT_COMPONENT)
406 ical_learn_uid_of_reply(uidbuf, subcomponent);
411 // ical_update_my_calendar_with_reply() refers to this callback function; when we
412 // locate the message containing the calendar event we're replying to, this function
413 // gets called. It basically just sticks the message number in a supplied buffer.
414 void ical_hunt_for_event_to_update(long msgnum, void *data) {
417 msgnumptr = (long *) data;
422 struct original_event_container {
426 // Callback function for mime parser that hunts for calendar content types
427 // and turns them into calendar objects (called by ical_update_my_calendar_with_reply()
428 // to fetch the object being updated)
429 void ical_locate_original_event(char *name, char *filename, char *partnum, char *disp,
430 void *content, char *cbtype, char *cbcharset, size_t length, char *encoding,
431 char *cbid, void *cbuserdata) {
433 struct original_event_container *oec = NULL;
435 if ( (strcasecmp(cbtype, "text/calendar"))
436 && (strcasecmp(cbtype, "application/ics"))
440 oec = (struct original_event_container *) cbuserdata;
441 if (oec->c != NULL) {
442 icalcomponent_free(oec->c);
444 oec->c = icalcomponent_new_from_string(content);
448 // Merge updated attendee information from a REPLY into an existing event.
449 void ical_merge_attendee_reply(icalcomponent *event, icalcomponent *reply) {
451 icalproperty *e_attendee, *r_attendee;
453 // First things first. If we're not looking at a VEVENT component,
454 // recurse through subcomponents until we find one.
455 if (icalcomponent_isa(event) != ICAL_VEVENT_COMPONENT) {
456 for (c = icalcomponent_get_first_component(event, ICAL_VEVENT_COMPONENT);
458 c = icalcomponent_get_next_component(event, ICAL_VEVENT_COMPONENT)
460 ical_merge_attendee_reply(c, reply);
465 // Now do the same thing with the reply.
466 if (icalcomponent_isa(reply) != ICAL_VEVENT_COMPONENT) {
467 for (c = icalcomponent_get_first_component(reply, ICAL_VEVENT_COMPONENT);
469 c = icalcomponent_get_next_component(reply, ICAL_VEVENT_COMPONENT)
471 ical_merge_attendee_reply(event, c);
476 // Clone the reply, because we're going to rip its guts out.
477 reply = icalcomponent_new_clone(reply);
479 // At this point we're looking at the correct subcomponents.
480 // Iterate through the attendees looking for a match.
482 for (e_attendee = icalcomponent_get_first_property(event, ICAL_ATTENDEE_PROPERTY);
484 e_attendee = icalcomponent_get_next_property(event, ICAL_ATTENDEE_PROPERTY)
487 for (r_attendee = icalcomponent_get_first_property(reply, ICAL_ATTENDEE_PROPERTY);
489 r_attendee = icalcomponent_get_next_property(reply, ICAL_ATTENDEE_PROPERTY)
492 // Check to see if these two attendees match...
494 e = icalproperty_get_attendee(e_attendee);
495 r = icalproperty_get_attendee(r_attendee);
497 if ((e != NULL) && (r != NULL) && !strcasecmp(e, r)) {
498 // ...and if they do, remove the attendee from the event
499 // and replace it with the attendee from the reply. (The
500 // reply's copy will have the same address, but an updated
502 icalcomponent_remove_property(event, e_attendee);
503 icalproperty_free(e_attendee);
504 icalcomponent_remove_property(reply, r_attendee);
505 icalcomponent_add_property(event, r_attendee);
507 // Since we diddled both sets of attendees, we have to start
508 // the iteration over again. This will not create an infinite
509 // loop because we removed the attendee from the reply. (That's
510 // why we cloned the reply, and that's what we mean by "ripping
518 // Free the *clone* of the reply.
519 icalcomponent_free(reply);
523 // Handle an incoming RSVP (object with method==ICAL_METHOD_REPLY) for a
524 // calendar event. The object has already been deserialized for us; all
525 // we have to do here is hunt for the event in our calendar, merge in the
526 // updated attendee status, and save it again.
528 // This function returns 0 on success, 1 if the event was not found in the
529 // user's calendar, or 2 if an internal error occurred.
530 int ical_update_my_calendar_with_reply(icalcomponent *cal) {
532 char hold_rm[ROOMNAMELEN];
533 long msgnum_being_replaced = 0;
534 struct CtdlMessage *msg = NULL;
535 struct original_event_container oec;
536 icalcomponent *original_event;
537 char *serialized_event = NULL;
538 char roomname[ROOMNAMELEN];
539 char *message_text = NULL;
541 // Figure out just what event it is we're dealing with
542 strcpy(uid, "--==<< InVaLiD uId >>==--");
543 ical_learn_uid_of_reply(uid, cal);
544 syslog(LOG_DEBUG, "calendar: UID of event being replied to is <%s>", uid);
546 strcpy(hold_rm, CC->room.QRname); // save current room
548 if (CtdlGetRoom(&CC->room, USERCALENDARROOM) != 0) {
549 CtdlGetRoom(&CC->room, hold_rm);
550 syslog(LOG_ERR, "calendar: cannot get user calendar room");
554 // Look in the EUID index for a message with
555 // the Citadel EUID set to the value we're looking for. Since
556 // Citadel always sets the message EUID to the iCalendar UID of
557 // the event, this will work.
558 msgnum_being_replaced = CtdlLocateMessageByEuid(uid, &CC->room);
560 CtdlGetRoom(&CC->room, hold_rm); // return to saved room
562 syslog(LOG_DEBUG, "calendar: msgnum_being_replaced == %ld", msgnum_being_replaced);
563 if (msgnum_being_replaced == 0) {
564 return(1); // no calendar event found
567 // Now we know the ID of the message containing the event being updated.
568 // We don't actually have to delete it; that'll get taken care of by the
569 // server when we save another event with the same UID. This just gives
570 // us the ability to load the event into memory so we can diddle the attendees.
571 msg = CtdlFetchMessage(msgnum_being_replaced, 1);
573 return(2); // internal error
577 CM_RANGE(msg, eMessageText),
578 *ical_locate_original_event, // callback function
585 original_event = oec.c;
586 if (original_event == NULL) {
587 syslog(LOG_ERR, "calendar: original_component is NULL");
591 // Merge the attendee's updated status into the event
592 ical_merge_attendee_reply(original_event, cal);
595 serialized_event = icalcomponent_as_ical_string_r(original_event);
596 icalcomponent_free(original_event); // Don't need this anymore.
597 if (serialized_event == NULL) return(2);
599 CtdlMailboxName(roomname, sizeof roomname, &CC->user, USERCALENDARROOM);
601 message_text = malloc(strlen(serialized_event) + SIZ);
602 if (message_text != NULL) {
603 sprintf(message_text,
604 "Content-type: text/calendar; charset=\"utf-8\"\r\n\r\n%s\r\n",
608 msg = CtdlMakeMessage(&CC->user,
623 CIT_ICAL->avoid_sending_invitations = 1;
624 CtdlSubmitMsg(msg, NULL, roomname);
626 CIT_ICAL->avoid_sending_invitations = 0;
629 free(serialized_event);
634 // Handle an incoming RSVP for an event. (This is the server subcommand part; it
635 // simply extracts the calendar object from the message, deserializes it, and
636 // passes it up to ical_update_my_calendar_with_reply() for processing.
637 void ical_handle_rsvp(long msgnum, char *partnum, char *action) {
638 struct CtdlMessage *msg = NULL;
639 struct ical_respond_data ird;
643 (strcasecmp(action, "update"))
644 && (strcasecmp(action, "ignore"))
646 cprintf("%d Action must be 'update' or 'ignore'\n", ERROR + ILLEGAL_VALUE);
650 msg = CtdlFetchMessage(msgnum, 1);
652 cprintf("%d Message %ld not found.\n",
653 ERROR + ILLEGAL_VALUE,
659 memset(&ird, 0, sizeof ird);
660 strcpy(ird.desired_partnum, partnum);
662 CM_RANGE(msg, eMessageText),
663 *ical_locate_part, // callback function
666 (void *) &ird, // user data
670 // We're done with the incoming message, because we now have a
671 // calendar object in memory.
674 // Here is the real meat of this function. Handle the event.
675 if (ird.cal != NULL) {
676 // Update the user's calendar if necessary
677 if (!strcasecmp(action, "update")) {
678 ret = ical_update_my_calendar_with_reply(ird.cal);
680 cprintf("%d Your calendar has been updated with this reply.\n", CIT_OK);
683 cprintf("%d This event does not exist in your calendar.\n", ERROR + FILE_NOT_FOUND);
686 cprintf("%d An internal error occurred.\n", ERROR + INTERNAL_ERROR);
690 cprintf("%d This reply has been ignored.\n", CIT_OK);
693 // Now that we've processed this message, we don't need it
694 // anymore. So delete it. (Don't do this anymore.)
695 // CtdlDeleteMessages(CC->room.QRname, &msgnum, 1, "");
697 // Free the memory we allocated and return a response.
698 icalcomponent_free(ird.cal);
703 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
707 // should never get here
711 // Search for a property in both the top level and in a VEVENT subcomponent
712 icalproperty *ical_ctdl_get_subprop(
714 icalproperty_kind which_prop
719 p = icalcomponent_get_first_property(cal, which_prop);
721 c = icalcomponent_get_first_component(cal, ICAL_VEVENT_COMPONENT);
723 p = icalcomponent_get_first_property(c, which_prop);
730 // Check to see if two events overlap. Returns nonzero if they do.
731 // (This function is used in both Citadel and WebCit. If you change it in
732 // one place, change it in the other. Better yet, put it in a library.)
733 int ical_ctdl_is_overlap(
734 struct icaltimetype t1start,
735 struct icaltimetype t1end,
736 struct icaltimetype t2start,
737 struct icaltimetype t2end
739 if (icaltime_is_null_time(t1start)) return(0);
740 if (icaltime_is_null_time(t2start)) return(0);
742 // if either event lacks end time, assume end = start
743 if (icaltime_is_null_time(t1end)) {
744 memcpy(&t1end, &t1start, sizeof(struct icaltimetype));
747 if (t1end.is_date && icaltime_compare(t1start, t1end)) {
749 // the end date is non-inclusive so adjust it by one
750 // day because our test is inclusive, note that a day is
751 // not too much because we are talking about all day
753 // if start = end we assume that nevertheless the whole
756 icaltime_adjust(&t1end, -1, 0, 0, 0);
760 if (icaltime_is_null_time(t2end))
761 memcpy(&t2end, &t2start, sizeof(struct icaltimetype));
763 if (t2end.is_date && icaltime_compare(t2start, t2end)) {
764 icaltime_adjust(&t2end, -1, 0, 0, 0);
768 // First, check for all-day events
769 if (t1start.is_date || t2start.is_date) {
770 // If event 1 ends before event 2 starts, we're in the clear.
771 if (icaltime_compare_date_only(t1end, t2start) < 0) return(0);
773 // If event 2 ends before event 1 starts, we're also ok.
774 if (icaltime_compare_date_only(t2end, t1start) < 0) return(0);
779 // syslog(LOG_DEBUG, "Comparing t1start %d:%d t1end %d:%d t2start %d:%d t2end %d:%d",
780 // t1start.hour, t1start.minute, t1end.hour, t1end.minute,
781 // t2start.hour, t2start.minute, t2end.hour, t2end.minute);
783 // Now check for overlaps using date *and* time.
785 // If event 1 ends before event 2 starts, we're in the clear.
786 if (icaltime_compare(t1end, t2start) <= 0) return(0);
787 // syslog(LOG_DEBUG, "calendar: first passed");
789 // If event 2 ends before event 1 starts, we're also ok.
790 if (icaltime_compare(t2end, t1start) <= 0) return(0);
791 // syslog(LOG_DEBUG, "calendar: second passed");
793 // Otherwise, they overlap.
798 // Phase 6 of "hunt for conflicts"
799 // called by ical_conflicts_phase5()
801 // Now both the proposed and existing events have been boiled down to start and end times.
802 // Check for overlap and output any conflicts.
804 // Returns nonzero if a conflict was reported. This allows the caller to stop iterating.
805 int ical_conflicts_phase6(struct icaltimetype t1start,
806 struct icaltimetype t1end,
807 struct icaltimetype t2start,
808 struct icaltimetype t2end,
809 long existing_msgnum,
810 char *conflict_event_uid,
811 char *conflict_event_summary,
814 int conflict_reported = 0;
818 // tt = icaltime_as_timet_with_zone(t1start, t1start.zone);
819 // syslog(LOG_DEBUG, "PROPOSED START: %s", ctime(&tt));
820 // tt = icaltime_as_timet_with_zone(t1end, t1end.zone);
821 // syslog(LOG_DEBUG, " PROPOSED END: %s", ctime(&tt));
822 // tt = icaltime_as_timet_with_zone(t2start, t2start.zone);
823 // syslog(LOG_DEBUG, "EXISTING START: %s", ctime(&tt));
824 // tt = icaltime_as_timet_with_zone(t2end, t2end.zone);
825 // syslog(LOG_DEBUG, " EXISTING END: %s", ctime(&tt));
828 // compare and output
830 if (ical_ctdl_is_overlap(t1start, t1end, t2start, t2end)) {
831 cprintf("%ld||%s|%s|%d|\n",
834 conflict_event_summary,
835 ( (!IsEmptyStr(compare_uid)
836 &&(!strcasecmp(compare_uid,
837 conflict_event_uid))) ? 1 : 0
840 conflict_reported = 1;
843 return(conflict_reported);
847 // Phase 5 of "hunt for conflicts"
848 // Called by ical_conflicts_phase4()
850 // We have the proposed event boiled down to start and end times.
851 // Now check it against an existing event.
852 void ical_conflicts_phase5(struct icaltimetype t1start,
853 struct icaltimetype t1end,
854 icalcomponent *existing_event,
855 long existing_msgnum,
858 char conflict_event_uid[SIZ];
859 char conflict_event_summary[SIZ];
860 struct icaltimetype t2start, t2end;
864 icalproperty *rrule = NULL;
865 struct icalrecurrencetype recur;
866 icalrecur_iterator *ritr = NULL;
867 struct icaldurationtype dur;
871 strcpy(conflict_event_uid, "");
872 strcpy(conflict_event_summary, "");
873 t2start = icaltime_null_time();
874 t2end = icaltime_null_time();
876 // existing event stuff
877 p = ical_ctdl_get_subprop(existing_event, ICAL_DTSTART_PROPERTY);
878 if (p == NULL) return;
879 if (p != NULL) t2start = icalproperty_get_dtstart(p);
880 if (icaltime_is_utc(t2start)) {
881 t2start.zone = icaltimezone_get_utc_timezone();
884 t2start.zone = icalcomponent_get_timezone(existing_event,
885 icalparameter_get_tzid(
886 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
890 t2start.zone = get_default_icaltimezone();
894 p = ical_ctdl_get_subprop(existing_event, ICAL_DTEND_PROPERTY);
896 t2end = icalproperty_get_dtend(p);
898 if (icaltime_is_utc(t2end)) {
899 t2end.zone = icaltimezone_get_utc_timezone();
902 t2end.zone = icalcomponent_get_timezone(existing_event,
903 icalparameter_get_tzid(icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER))
906 t2end.zone = get_default_icaltimezone();
909 dur = icaltime_subtract(t2end, t2start);
912 memset (&dur, 0, sizeof(struct icaldurationtype));
915 rrule = ical_ctdl_get_subprop(existing_event, ICAL_RRULE_PROPERTY);
917 recur = icalproperty_get_rrule(rrule);
918 ritr = icalrecur_iterator_new(recur, t2start);
922 p = ical_ctdl_get_subprop(existing_event, ICAL_UID_PROPERTY);
924 strcpy(conflict_event_uid, icalproperty_get_comment(p));
927 p = ical_ctdl_get_subprop(existing_event, ICAL_SUMMARY_PROPERTY);
929 strcpy(conflict_event_summary, icalproperty_get_comment(p));
932 if (ical_conflicts_phase6(t1start, t1end, t2start, t2end,
933 existing_msgnum, conflict_event_uid, conflict_event_summary, compare_uid)) {
934 num_recur = MAX_RECUR + 1; // force it out of scope, no need to continue
938 t2start = icalrecur_iterator_next(ritr);
939 if (!icaltime_is_null_time(t2end)) {
940 const icaltimezone *hold_zone = t2end.zone;
941 t2end = icaltime_add(t2start, dur);
942 t2end.zone = hold_zone;
947 if (icaltime_compare(t2start, t1end) < 0) {
948 num_recur = MAX_RECUR + 1; // force it out of scope
951 } while ( (rrule) && (!icaltime_is_null_time(t2start)) && (num_recur < MAX_RECUR) );
952 icalrecur_iterator_free(ritr);
956 // Phase 4 of "hunt for conflicts"
957 // Called by ical_hunt_for_conflicts_backend()
959 // At this point we've got it boiled down to two icalcomponent events in memory.
960 // If they conflict, output something to the client.
961 void ical_conflicts_phase4(icalcomponent *proposed_event,
962 icalcomponent *existing_event,
963 long existing_msgnum)
965 struct icaltimetype t1start, t1end;
967 char compare_uid[SIZ];
970 icalproperty *rrule = NULL;
971 struct icalrecurrencetype recur;
972 icalrecur_iterator *ritr = NULL;
973 struct icaldurationtype dur;
977 t1end = icaltime_null_time();
980 // proposed event stuff
982 p = ical_ctdl_get_subprop(proposed_event, ICAL_DTSTART_PROPERTY);
986 t1start = icalproperty_get_dtstart(p);
988 if (icaltime_is_utc(t1start)) {
989 t1start.zone = icaltimezone_get_utc_timezone();
992 t1start.zone = icalcomponent_get_timezone(proposed_event,
993 icalparameter_get_tzid(
994 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
998 t1start.zone = get_default_icaltimezone();
1002 p = ical_ctdl_get_subprop(proposed_event, ICAL_DTEND_PROPERTY);
1004 t1end = icalproperty_get_dtend(p);
1006 if (icaltime_is_utc(t1end)) {
1007 t1end.zone = icaltimezone_get_utc_timezone();
1010 t1end.zone = icalcomponent_get_timezone(proposed_event,
1011 icalparameter_get_tzid(
1012 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
1016 t1end.zone = get_default_icaltimezone();
1020 dur = icaltime_subtract(t1end, t1start);
1023 memset (&dur, 0, sizeof(struct icaldurationtype));
1026 rrule = ical_ctdl_get_subprop(proposed_event, ICAL_RRULE_PROPERTY);
1028 recur = icalproperty_get_rrule(rrule);
1029 ritr = icalrecur_iterator_new(recur, t1start);
1032 p = ical_ctdl_get_subprop(proposed_event, ICAL_UID_PROPERTY);
1034 strcpy(compare_uid, icalproperty_get_comment(p));
1038 ical_conflicts_phase5(t1start, t1end, existing_event, existing_msgnum, compare_uid);
1041 t1start = icalrecur_iterator_next(ritr);
1042 if (!icaltime_is_null_time(t1end)) {
1043 const icaltimezone *hold_zone = t1end.zone;
1044 t1end = icaltime_add(t1start, dur);
1045 t1end.zone = hold_zone;
1050 } while ( (rrule) && (!icaltime_is_null_time(t1start)) && (num_recur < MAX_RECUR) );
1051 icalrecur_iterator_free(ritr);
1055 // Phase 3 of "hunt for conflicts"
1056 // Called by ical_hunt_for_conflicts()
1057 void ical_hunt_for_conflicts_backend(long msgnum, void *data) {
1058 icalcomponent *proposed_event;
1059 struct CtdlMessage *msg = NULL;
1060 struct ical_respond_data ird;
1062 proposed_event = (icalcomponent *)data;
1064 msg = CtdlFetchMessage(msgnum, 1);
1065 if (msg == NULL) return;
1066 memset(&ird, 0, sizeof ird);
1067 strcpy(ird.desired_partnum, "_HUNT_");
1068 mime_parser(CM_RANGE(msg, eMessageText),
1069 *ical_locate_part, // callback function
1072 (void *) &ird, // user data
1077 if (ird.cal == NULL) return;
1079 ical_conflicts_phase4(proposed_event, ird.cal, msgnum);
1080 icalcomponent_free(ird.cal);
1084 // Phase 2 of "hunt for conflicts" operation.
1085 // At this point we have a calendar object which represents the VEVENT that
1086 // is proposed for addition to the calendar. Now hunt through the user's
1087 // calendar room, and output zero or more existing VEVENTs which conflict
1089 void ical_hunt_for_conflicts(icalcomponent *cal) {
1090 char hold_rm[ROOMNAMELEN];
1092 strcpy(hold_rm, CC->room.QRname); // save current room
1094 if (CtdlGetRoom(&CC->room, USERCALENDARROOM) != 0) {
1095 CtdlGetRoom(&CC->room, hold_rm);
1096 cprintf("%d You do not have a calendar.\n", ERROR + ROOM_NOT_FOUND);
1100 cprintf("%d Conflicting events:\n", LISTING_FOLLOWS);
1102 CtdlForEachMessage(MSGS_ALL, 0, NULL,
1105 ical_hunt_for_conflicts_backend,
1110 CtdlGetRoom(&CC->room, hold_rm); // return to saved room
1115 // Hunt for conflicts (Phase 1 -- retrieve the object and call Phase 2)
1116 void ical_conflicts(long msgnum, char *partnum) {
1117 struct CtdlMessage *msg = NULL;
1118 struct ical_respond_data ird;
1120 msg = CtdlFetchMessage(msgnum, 1);
1122 cprintf("%d Message %ld not found\n",
1123 ERROR + ILLEGAL_VALUE,
1129 memset(&ird, 0, sizeof ird);
1130 strcpy(ird.desired_partnum, partnum);
1132 CM_RANGE(msg, eMessageText),
1133 *ical_locate_part, // callback function
1136 (void *) &ird, // user data
1142 if (ird.cal != NULL) {
1143 ical_hunt_for_conflicts(ird.cal);
1144 icalcomponent_free(ird.cal);
1148 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
1152 // Look for busy time in a VEVENT and add it to the supplied VFREEBUSY.
1154 // fb The VFREEBUSY component to which we are appending
1155 // top_level_cal The top-level VCALENDAR component which contains a VEVENT to be added
1156 void ical_add_to_freebusy(icalcomponent *fb, icalcomponent *top_level_cal) {
1160 struct icalperiodtype this_event_period = icalperiodtype_null_period();
1161 icaltimetype dtstart;
1165 icalproperty *rrule = NULL;
1166 struct icalrecurrencetype recur;
1167 icalrecur_iterator *ritr = NULL;
1168 struct icaldurationtype dur;
1171 if (!top_level_cal) return;
1173 // Find the VEVENT component containing an event
1174 cal = icalcomponent_get_first_component(top_level_cal, ICAL_VEVENT_COMPONENT);
1177 // If this event is not opaque, the user isn't publishing it as
1178 // busy time, so don't bother doing anything else.
1179 p = icalcomponent_get_first_property(cal, ICAL_TRANSP_PROPERTY);
1181 v = icalproperty_get_value(p);
1183 if (icalvalue_get_transp(v) != ICAL_TRANSP_OPAQUE) {
1189 // Now begin calculating the event start and end times.
1190 p = icalcomponent_get_first_property(cal, ICAL_DTSTART_PROPERTY);
1192 dtstart = icalproperty_get_dtstart(p);
1194 if (icaltime_is_utc(dtstart)) {
1195 dtstart.zone = icaltimezone_get_utc_timezone();
1198 dtstart.zone = icalcomponent_get_timezone(top_level_cal,
1199 icalparameter_get_tzid(
1200 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
1203 if (!dtstart.zone) {
1204 dtstart.zone = get_default_icaltimezone();
1208 dtend = icalcomponent_get_dtend(cal);
1209 if (!icaltime_is_null_time(dtend)) {
1210 dur = icaltime_subtract(dtend, dtstart);
1213 memset (&dur, 0, sizeof(struct icaldurationtype));
1216 // Is a recurrence specified? If so, get ready to process it...
1217 rrule = ical_ctdl_get_subprop(cal, ICAL_RRULE_PROPERTY);
1219 recur = icalproperty_get_rrule(rrule);
1220 ritr = icalrecur_iterator_new(recur, dtstart);
1224 // Convert the DTSTART and DTEND properties to an icalperiod.
1225 this_event_period.start = dtstart;
1227 if (!icaltime_is_null_time(dtend)) {
1228 this_event_period.end = dtend;
1231 // Convert the timestamps to UTC. It's ok to do this because we've already expanded
1232 // recurrences and this data is never going to get used again.
1233 this_event_period.start = icaltime_convert_to_zone(
1234 this_event_period.start,
1235 icaltimezone_get_utc_timezone()
1237 this_event_period.end = icaltime_convert_to_zone(
1238 this_event_period.end,
1239 icaltimezone_get_utc_timezone()
1243 icalcomponent_add_property(fb, icalproperty_new_freebusy(this_event_period));
1245 // Make sure the DTSTART property of the freebusy *list* is set to
1246 // the DTSTART property of the *earliest event*.
1247 p = icalcomponent_get_first_property(fb, ICAL_DTSTART_PROPERTY);
1249 icalcomponent_set_dtstart(fb, this_event_period.start);
1252 if (icaltime_compare(this_event_period.start, icalcomponent_get_dtstart(fb)) < 0) {
1253 icalcomponent_set_dtstart(fb, this_event_period.start);
1257 // Make sure the DTEND property of the freebusy *list* is set to
1258 // the DTEND property of the *latest event*.
1259 p = icalcomponent_get_first_property(fb, ICAL_DTEND_PROPERTY);
1261 icalcomponent_set_dtend(fb, this_event_period.end);
1264 if (icaltime_compare(this_event_period.end, icalcomponent_get_dtend(fb)) > 0) {
1265 icalcomponent_set_dtend(fb, this_event_period.end);
1270 dtstart = icalrecur_iterator_next(ritr);
1271 if (!icaltime_is_null_time(dtend)) {
1272 dtend = icaltime_add(dtstart, dur);
1273 dtend.zone = dtstart.zone;
1278 } while ( (rrule) && (!icaltime_is_null_time(dtstart)) && (num_recur < MAX_RECUR) ) ;
1279 icalrecur_iterator_free(ritr);
1283 // Backend for ical_freebusy()
1285 // This function simply loads the messages in the user's calendar room,
1286 // which contain VEVENTs, then strips them of all non-freebusy data, and
1287 // adds them to the supplied VCALENDAR.
1288 void ical_freebusy_backend(long msgnum, void *data) {
1290 struct CtdlMessage *msg = NULL;
1291 struct ical_respond_data ird;
1293 fb = (icalcomponent *)data; // User-supplied data will be the VFREEBUSY component
1295 msg = CtdlFetchMessage(msgnum, 1);
1296 if (msg == NULL) return;
1297 memset(&ird, 0, sizeof ird);
1298 strcpy(ird.desired_partnum, "_HUNT_");
1300 CM_RANGE(msg, eMessageText),
1301 *ical_locate_part, // callback function
1304 (void *) &ird, // user data
1310 ical_add_to_freebusy(fb, ird.cal); // Add VEVENT times to VFREEBUSY
1311 icalcomponent_free(ird.cal);
1316 // Grab another user's free/busy times
1317 void ical_freebusy(char *who) {
1318 struct ctdluser usbuf;
1319 char calendar_room_name[ROOMNAMELEN];
1320 char hold_rm[ROOMNAMELEN];
1321 char *serialized_request = NULL;
1322 icalcomponent *encaps = NULL;
1323 icalcomponent *fb = NULL;
1324 int found_user = (-1);
1325 struct recptypes *recp = NULL;
1330 int config_lines = 0;
1332 // First try an exact match.
1333 found_user = CtdlGetUser(&usbuf, who);
1335 // If not found, try it as an unqualified email address.
1336 if (found_user != 0) {
1338 recp = validate_recipients(buf, NULL, 0);
1339 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1341 if (recp->num_local == 1) {
1342 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1344 free_recipients(recp);
1348 // If still not found, try it as an address qualified with the primary FQDN of this Citadel node.
1349 if (found_user != 0) {
1350 snprintf(buf, sizeof buf, "%s@%s", who, CtdlGetConfigStr("c_fqdn"));
1351 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1352 recp = validate_recipients(buf, NULL, 0);
1354 if (recp->num_local == 1) {
1355 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1357 free_recipients(recp);
1361 // Still not found? Try qualifying it with every domain we might have addresses in.
1362 if (found_user != 0) {
1363 config_lines = num_tokens(inetcfg, '\n');
1364 for (i=0; ((i < config_lines) && (found_user != 0)); ++i) {
1365 extract_token(buf, inetcfg, i, '\n', sizeof buf);
1366 extract_token(host, buf, 0, '|', sizeof host);
1367 extract_token(type, buf, 1, '|', sizeof type);
1369 if ( (!strcasecmp(type, "localhost"))
1370 || (!strcasecmp(type, "directory"))
1372 snprintf(buf, sizeof buf, "%s@%s", who, host);
1373 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1374 recp = validate_recipients(buf, NULL, 0);
1376 if (recp->num_local == 1) {
1377 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1379 free_recipients(recp);
1385 if (found_user != 0) {
1386 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
1390 CtdlMailboxName(calendar_room_name, sizeof calendar_room_name, &usbuf, USERCALENDARROOM);
1392 strcpy(hold_rm, CC->room.QRname); // save current room
1394 if (CtdlGetRoom(&CC->room, calendar_room_name) != 0) {
1395 cprintf("%d Cannot open calendar\n", ERROR + ROOM_NOT_FOUND);
1396 CtdlGetRoom(&CC->room, hold_rm);
1400 // Create a VFREEBUSY subcomponent
1401 syslog(LOG_DEBUG, "calendar: creating VFREEBUSY component");
1402 fb = icalcomponent_new_vfreebusy();
1404 cprintf("%d Internal error: cannot allocate memory.\n", ERROR + INTERNAL_ERROR);
1405 CtdlGetRoom(&CC->room, hold_rm);
1409 // Set the method to PUBLISH
1410 icalcomponent_set_method(fb, ICAL_METHOD_PUBLISH);
1412 // Set the DTSTAMP to right now.
1413 icalcomponent_set_dtstamp(fb, icaltime_from_timet_with_zone(time(NULL), 0, icaltimezone_get_utc_timezone()));
1415 // Add the user's email address as ORGANIZER
1416 sprintf(buf, "MAILTO:%s", who);
1417 if (strchr(buf, '@') == NULL) {
1419 strcat(buf, CtdlGetConfigStr("c_fqdn"));
1421 for (i=0; buf[i]; ++i) {
1422 if (buf[i]==' ') buf[i] = '_';
1424 icalcomponent_add_property(fb, icalproperty_new_organizer(buf));
1426 // Add busy time from events
1427 syslog(LOG_DEBUG, "calendar: adding busy time from events");
1428 CtdlForEachMessage(MSGS_ALL, 0, NULL, NULL, NULL, ical_freebusy_backend, (void *)fb );
1430 // If values for DTSTART and DTEND are still not present, set them
1431 // to yesterday and tomorrow as default values.
1432 if (icalcomponent_get_first_property(fb, ICAL_DTSTART_PROPERTY) == NULL) {
1433 icalcomponent_set_dtstart(fb, icaltime_from_timet_with_zone(time(NULL)-86400L, 0, icaltimezone_get_utc_timezone()));
1435 if (icalcomponent_get_first_property(fb, ICAL_DTEND_PROPERTY) == NULL) {
1436 icalcomponent_set_dtend(fb, icaltime_from_timet_with_zone(time(NULL)+86400L, 0, icaltimezone_get_utc_timezone()));
1439 // Put the freebusy component into the calendar component
1440 syslog(LOG_DEBUG, "calendar: encapsulating");
1441 encaps = ical_encapsulate_subcomponent(fb);
1442 if (encaps == NULL) {
1443 icalcomponent_free(fb);
1444 cprintf("%d Internal error: cannot allocate memory.\n",
1445 ERROR + INTERNAL_ERROR);
1446 CtdlGetRoom(&CC->room, hold_rm);
1450 // Set the method to PUBLISH
1451 syslog(LOG_DEBUG, "calendar: setting method");
1452 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1455 syslog(LOG_DEBUG, "calendar: serializing");
1456 serialized_request = icalcomponent_as_ical_string_r(encaps);
1457 icalcomponent_free(encaps); // Don't need this anymore.
1459 cprintf("%d Free/busy for %s\n", LISTING_FOLLOWS, usbuf.fullname);
1460 if (serialized_request != NULL) {
1461 client_write(serialized_request, strlen(serialized_request));
1462 free(serialized_request);
1466 // Go back to the room from which we came...
1467 CtdlGetRoom(&CC->room, hold_rm);
1471 // Backend for ical_getics()
1473 // This is a ForEachMessage() callback function that searches the current room
1474 // for calendar events and adds them each into one big calendar component.
1475 void ical_getics_backend(long msgnum, void *data) {
1476 icalcomponent *encaps, *c;
1477 struct CtdlMessage *msg = NULL;
1478 struct ical_respond_data ird;
1480 encaps = (icalcomponent *)data;
1481 if (encaps == NULL) return;
1483 // Look for the calendar event...
1485 msg = CtdlFetchMessage(msgnum, 1);
1486 if (msg == NULL) return;
1487 memset(&ird, 0, sizeof ird);
1488 strcpy(ird.desired_partnum, "_HUNT_");
1490 CM_RANGE(msg, eMessageText),
1491 *ical_locate_part, // callback function
1494 (void *) &ird, // user data
1499 if (ird.cal == NULL) return;
1501 // Here we go: put the VEVENT into the VCALENDAR. We now no longer
1502 // are responsible for "the_request"'s memory -- it will be freed
1503 // when we free "encaps".
1505 // If the top-level component is *not* a VCALENDAR, we can drop it right in.
1506 // This will almost never happen.
1507 if (icalcomponent_isa(ird.cal) != ICAL_VCALENDAR_COMPONENT) {
1508 icalcomponent_add_component(encaps, ird.cal);
1511 // In the more likely event that we're looking at a VCALENDAR with the VEVENT
1512 // and other components encapsulated inside, we have to extract them.
1514 for (c = icalcomponent_get_first_component(ird.cal, ICAL_ANY_COMPONENT);
1516 c = icalcomponent_get_next_component(ird.cal, ICAL_ANY_COMPONENT)
1519 // For VTIMEZONE components, suppress duplicates of the same tzid
1521 if (icalcomponent_isa(c) == ICAL_VTIMEZONE_COMPONENT) {
1522 icalproperty *p = icalcomponent_get_first_property(c, ICAL_TZID_PROPERTY);
1524 const char *tzid = icalproperty_get_tzid(p);
1525 if (!icalcomponent_get_timezone(encaps, tzid)) {
1526 icalcomponent_add_component(encaps,
1527 icalcomponent_new_clone(c));
1532 // All other types of components can go in verbatim
1534 icalcomponent_add_component(encaps, icalcomponent_new_clone(c));
1537 icalcomponent_free(ird.cal);
1542 // Retrieve all of the calendar items in the current room, and output them
1543 // as a single icalendar object.
1544 void ical_getics(void) {
1545 icalcomponent *encaps = NULL;
1548 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
1549 &&(CC->room.QRdefaultview != VIEW_TASKS)
1551 cprintf("%d Not a calendar room\n", ERROR+NOT_HERE);
1552 return; // This room does not contain a calendar.
1555 encaps = icalcomponent_new_vcalendar();
1556 if (encaps == NULL) {
1557 syslog(LOG_ERR, "calendar: could not allocate component!");
1558 cprintf("%d Could not allocate memory\n", ERROR+INTERNAL_ERROR);
1562 cprintf("%d one big calendar\n", LISTING_FOLLOWS);
1564 // Set the Product ID
1565 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
1567 // Set the Version Number
1568 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
1570 // Set the method to PUBLISH
1571 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1573 // Now go through the room encapsulating all calendar items.
1574 CtdlForEachMessage(MSGS_ALL, 0, NULL,
1577 ical_getics_backend,
1581 ser = icalcomponent_as_ical_string_r(encaps);
1582 icalcomponent_free(encaps); // Don't need this anymore.
1583 client_write(ser, strlen(ser));
1589 // Helper callback function for ical_putics() to discover which TZID's we need.
1590 // Simply put the tzid name string into a hash table. After the callbacks are
1591 // done we'll go through them and attach the ones that we have.
1592 void ical_putics_grabtzids(icalparameter *param, void *data) {
1593 const char *tzid = icalparameter_get_tzid(param);
1594 HashList *keys = (HashList *) data;
1596 if ( (keys) && (tzid) && (!IsEmptyStr(tzid)) ) {
1597 Put(keys, tzid, strlen(tzid), strdup(tzid), NULL);
1602 // Delete all of the calendar items in the current room, and replace them
1603 // with calendar items from a client-supplied data stream.
1604 void ical_putics(void) {
1605 char *calstream = NULL;
1608 icalcomponent *encaps = NULL;
1609 HashList *tzidlist = NULL;
1615 // Only allow this operation if we're in a room containing a calendar or tasks view
1616 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
1617 && (CC->room.QRdefaultview != VIEW_TASKS)
1619 cprintf("%d Not a calendar room\n", ERROR+NOT_HERE);
1623 // Only allow this operation if we have permission to overwrite the existing calendar
1624 if (!CtdlDoIHavePermissionToDeleteMessagesFromThisRoom()) {
1625 cprintf("%d Permission denied.\n", ERROR+HIGHER_ACCESS_REQUIRED);
1629 cprintf("%d Transmit data now\n", SEND_LISTING);
1630 calstream = CtdlReadMessageBody(HKEY("000"), CtdlGetConfigLong("c_maxmsglen"), NULL, 0);
1631 if (calstream == NULL) {
1635 cal = icalcomponent_new_from_string(calstream);
1638 // We got our data stream -- now do something with it.
1640 // Delete the existing messages in the room, because we are overwriting
1641 // the entire calendar with an entire new (or updated) calendar.
1642 // (Careful: this opens an S_ROOMS critical section!)
1643 CtdlDeleteMessages(CC->room.QRname, NULL, 0, "");
1645 // If the top-level component is *not* a VCALENDAR, we can drop it right in.
1646 // This will almost never happen.
1647 if (icalcomponent_isa(cal) != ICAL_VCALENDAR_COMPONENT) {
1648 ical_write_to_cal(NULL, cal);
1651 // In the more likely event that we're looking at a VCALENDAR with the VEVENT
1652 // and other components encapsulated inside, we have to extract them.
1654 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
1656 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)
1659 // Non-VTIMEZONE components each get written as individual messages.
1660 // But we also need to attach the relevant VTIMEZONE components to them.
1661 if ( (icalcomponent_isa(c) != ICAL_VTIMEZONE_COMPONENT)
1662 && (encaps = icalcomponent_new_vcalendar())
1664 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
1665 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
1666 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1668 // Attach any needed timezones here
1669 tzidlist = NewHash(1, NULL);
1671 icalcomponent_foreach_tzid(c, ical_putics_grabtzids, tzidlist);
1673 HashPos = GetNewHashPos(tzidlist, 0);
1675 while (GetNextHashPos(tzidlist, HashPos, &len, &Key, &Value)) {
1676 syslog(LOG_DEBUG, "calendar: attaching timezone '%s'", (char*) Value);
1677 icaltimezone *t = NULL;
1679 // First look for a timezone attached to the original calendar
1680 t = icalcomponent_get_timezone(cal, Value);
1682 // Try built-in tzdata if the right one wasn't attached
1684 t = icaltimezone_get_builtin_timezone(Value);
1687 // I've got a valid timezone to attach.
1689 icalcomponent_add_component(encaps,
1690 icalcomponent_new_clone(
1691 icaltimezone_get_component(t)
1697 DeleteHashPos(&HashPos);
1698 DeleteHash(&tzidlist);
1700 // Now attach the component itself (usually a VEVENT or VTODO)
1701 icalcomponent_add_component(encaps, icalcomponent_new_clone(c));
1703 // Write it to the message store
1704 ical_write_to_cal(NULL, encaps);
1705 icalcomponent_free(encaps);
1710 icalcomponent_free(cal);
1714 // All Citadel calendar commands from the client come through here.
1715 void cmd_ical(char *argbuf) {
1722 extract_token(subcmd, argbuf, 0, '|', sizeof subcmd);
1724 // Allow "test" and "freebusy" subcommands without logging in.
1726 if (!strcasecmp(subcmd, "test")) {
1727 cprintf("%d This server supports calendaring\n", CIT_OK);
1731 if (!strcasecmp(subcmd, "freebusy")) {
1732 extract_token(who, argbuf, 1, '|', sizeof who);
1737 if (!strcasecmp(subcmd, "sgi")) {
1738 CIT_ICAL->server_generated_invitations = (extract_int(argbuf, 1) ? 1 : 0) ;
1739 cprintf("%d %d\n", CIT_OK, CIT_ICAL->server_generated_invitations);
1743 if (CtdlAccessCheck(ac_logged_in)) return;
1745 if (!strcasecmp(subcmd, "respond")) {
1746 msgnum = extract_long(argbuf, 1);
1747 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1748 extract_token(action, argbuf, 3, '|', sizeof action);
1749 ical_respond(msgnum, partnum, action);
1753 if (!strcasecmp(subcmd, "handle_rsvp")) {
1754 msgnum = extract_long(argbuf, 1);
1755 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1756 extract_token(action, argbuf, 3, '|', sizeof action);
1757 ical_handle_rsvp(msgnum, partnum, action);
1761 if (!strcasecmp(subcmd, "conflicts")) {
1762 msgnum = extract_long(argbuf, 1);
1763 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1764 ical_conflicts(msgnum, partnum);
1768 if (!strcasecmp(subcmd, "getics")) {
1773 if (!strcasecmp(subcmd, "putics")) {
1778 cprintf("%d Invalid subcommand\n", ERROR + CMD_NOT_SUPPORTED);
1782 // We don't know if the calendar room exists so we just create it at login
1783 void ical_CtdlCreateRoom(void) {
1787 // Create the calendar room if it doesn't already exist
1788 CtdlCreateRoom(USERCALENDARROOM, 4, "", 0, 1, 0, VIEW_CALENDAR);
1790 // Set expiration policy to manual; otherwise objects will be lost!
1791 if (CtdlGetRoomLock(&qr, USERCALENDARROOM)) {
1792 syslog(LOG_ERR, "calendar: couldn't get the user calendar room");
1795 qr.QRep.expire_mode = EXPIRE_MANUAL;
1796 qr.QRdefaultview = VIEW_CALENDAR; // 3 = calendar view
1797 CtdlPutRoomLock(&qr);
1799 // Set the view to a calendar view
1800 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1801 vbuf.v_view = VIEW_CALENDAR;
1802 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1804 // Create the tasks list room if it doesn't already exist
1805 CtdlCreateRoom(USERTASKSROOM, 4, "", 0, 1, 0, VIEW_TASKS);
1807 // Set expiration policy to manual; otherwise objects will be lost!
1808 if (CtdlGetRoomLock(&qr, USERTASKSROOM)) {
1809 syslog(LOG_ERR, "calendar: couldn't get the user calendar room!");
1812 qr.QRep.expire_mode = EXPIRE_MANUAL;
1813 qr.QRdefaultview = VIEW_TASKS;
1814 CtdlPutRoomLock(&qr);
1816 // Set the view to a task list view
1817 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1818 vbuf.v_view = VIEW_TASKS;
1819 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1821 // Create the notes room if it doesn't already exist
1822 CtdlCreateRoom(USERNOTESROOM, 4, "", 0, 1, 0, VIEW_NOTES);
1824 // Set expiration policy to manual; otherwise objects will be lost!
1825 if (CtdlGetRoomLock(&qr, USERNOTESROOM)) {
1826 syslog(LOG_ERR, "calendar: couldn't get the user calendar room!");
1829 qr.QRep.expire_mode = EXPIRE_MANUAL;
1830 qr.QRdefaultview = VIEW_NOTES;
1831 CtdlPutRoomLock(&qr);
1833 // Set the view to a notes view
1834 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1835 vbuf.v_view = VIEW_NOTES;
1836 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1842 // ical_send_out_invitations() is called by ical_saving_vevent() when it finds a VEVENT.
1844 // top_level_cal is the highest available level calendar object.
1845 // cal is the subcomponent containing the VEVENT.
1847 // Note: if you change the encapsulation code here, change it in WebCit's ical_encapsulate_subcomponent()
1848 void ical_send_out_invitations(icalcomponent *top_level_cal, icalcomponent *cal) {
1849 icalcomponent *the_request = NULL;
1850 char *serialized_request = NULL;
1851 icalcomponent *encaps = NULL;
1852 char *request_message_text = NULL;
1853 struct CtdlMessage *msg = NULL;
1854 struct recptypes *valid = NULL;
1855 char attendees_string[SIZ];
1856 int num_attendees = 0;
1857 char this_attendee[256];
1858 icalproperty *attendee = NULL;
1859 char summary_string[SIZ];
1860 icalproperty *summary = NULL;
1863 struct icaltimetype t;
1864 const icaltimezone *attached_zones[5] = { NULL, NULL, NULL, NULL, NULL };
1866 const icaltimezone *z;
1867 int num_zones_attached = 0;
1868 int zone_already_attached;
1869 icalparameter *tzidp = NULL;
1870 const char *tzidc = NULL;
1873 syslog(LOG_ERR, "calendar: trying to reply to NULL event?");
1877 // If this is a VCALENDAR component, look for a VEVENT subcomponent.
1878 if (icalcomponent_isa(cal) == ICAL_VCALENDAR_COMPONENT) {
1879 ical_send_out_invitations(top_level_cal, icalcomponent_get_first_component(cal, ICAL_VEVENT_COMPONENT));
1884 the_request = icalcomponent_new_clone(cal);
1885 if (the_request == NULL) {
1886 syslog(LOG_ERR, "calendar: cannot clone calendar object");
1890 // Extract the summary string -- we'll use it as the message subject for the request
1891 strcpy(summary_string, "Meeting request");
1892 summary = icalcomponent_get_first_property(the_request, ICAL_SUMMARY_PROPERTY);
1893 if (summary != NULL) {
1894 if (icalproperty_get_summary(summary)) {
1895 strcpy(summary_string,
1896 icalproperty_get_summary(summary) );
1900 // Determine who the recipients of this message are (the attendees)
1901 strcpy(attendees_string, "");
1902 for (attendee = icalcomponent_get_first_property(the_request, ICAL_ATTENDEE_PROPERTY); attendee != NULL; attendee = icalcomponent_get_next_property(the_request, ICAL_ATTENDEE_PROPERTY)) {
1903 const char *ch = icalproperty_get_attendee(attendee);
1904 if ((ch != NULL) && !strncasecmp(ch, "MAILTO:", 7)) {
1905 safestrncpy(this_attendee, ch + 7, sizeof(this_attendee));
1907 if (!CtdlIsMe(this_attendee, sizeof this_attendee)) { // don't send an invitation to myself!
1908 snprintf(&attendees_string[strlen(attendees_string)],
1909 sizeof(attendees_string) - strlen(attendees_string),
1918 syslog(LOG_DEBUG, "calendar: <%d> attendees: <%s>", num_attendees, attendees_string);
1920 // If there are no attendees, there are no invitations to send, so...
1921 // don't bother putting one together! Punch out, Maverick!
1922 if (num_attendees == 0) {
1923 icalcomponent_free(the_request);
1927 // Encapsulate the VEVENT component into a complete VCALENDAR
1928 encaps = icalcomponent_new_vcalendar();
1929 if (encaps == NULL) {
1930 syslog(LOG_ERR, "calendar: could not allocate component!");
1931 icalcomponent_free(the_request);
1935 // Set the Product ID
1936 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
1938 // Set the Version Number
1939 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
1941 // Set the method to REQUEST
1942 icalcomponent_set_method(encaps, ICAL_METHOD_REQUEST);
1944 // Look for properties containing timezone parameters, to see if we need to attach VTIMEZONEs
1945 for (p = icalcomponent_get_first_property(the_request, ICAL_ANY_PROPERTY);
1947 p = icalcomponent_get_next_property(the_request, ICAL_ANY_PROPERTY)
1949 if ( (icalproperty_isa(p) == ICAL_COMPLETED_PROPERTY)
1950 || (icalproperty_isa(p) == ICAL_CREATED_PROPERTY)
1951 || (icalproperty_isa(p) == ICAL_DATEMAX_PROPERTY)
1952 || (icalproperty_isa(p) == ICAL_DATEMIN_PROPERTY)
1953 || (icalproperty_isa(p) == ICAL_DTEND_PROPERTY)
1954 || (icalproperty_isa(p) == ICAL_DTSTAMP_PROPERTY)
1955 || (icalproperty_isa(p) == ICAL_DTSTART_PROPERTY)
1956 || (icalproperty_isa(p) == ICAL_DUE_PROPERTY)
1957 || (icalproperty_isa(p) == ICAL_EXDATE_PROPERTY)
1958 || (icalproperty_isa(p) == ICAL_LASTMODIFIED_PROPERTY)
1959 || (icalproperty_isa(p) == ICAL_MAXDATE_PROPERTY)
1960 || (icalproperty_isa(p) == ICAL_MINDATE_PROPERTY)
1961 || (icalproperty_isa(p) == ICAL_RECURRENCEID_PROPERTY)
1963 t = icalproperty_get_dtstart(p); // it's safe to use dtstart for all of them
1965 // Determine the tzid in order for some of the conditions below to work
1966 tzidp = icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER);
1968 tzidc = icalparameter_get_tzid(tzidp);
1974 // First see if there's a timezone attached to the data structure itself
1975 if (icaltime_is_utc(t)) {
1976 z = icaltimezone_get_utc_timezone();
1979 z = icaltime_get_timezone(t);
1982 // If not, try to determine the tzid from the parameter using attached zones
1983 if ((!z) && (tzidc)) {
1984 z = icalcomponent_get_timezone(top_level_cal, tzidc);
1987 // Still no good? Try our internal database
1988 if ((!z) && (tzidc)) {
1989 z = icaltimezone_get_builtin_timezone_from_tzid(tzidc);
1993 // We have a valid timezone. Good. Now we need to attach it.
1995 zone_already_attached = 0;
1996 for (i=0; i<5; ++i) {
1997 if (z == attached_zones[i]) {
1998 // We've already got this one, no need to attach another.
1999 ++zone_already_attached;
2002 if ((!zone_already_attached) && (num_zones_attached < 5)) {
2003 // This is a new one, so attach it.
2004 attached_zones[num_zones_attached++] = z;
2007 icalproperty_set_parameter(p, icalparameter_new_tzid(icaltimezone_get_tzid(z))
2013 // Encapsulate any timezones we need
2014 if (num_zones_attached > 0) for (i=0; i<num_zones_attached; ++i) {
2016 zc = icalcomponent_new_clone(icaltimezone_get_component(attached_zones[i]));
2017 icalcomponent_add_component(encaps, zc);
2020 // Here we go: encapsulate the VEVENT into the VCALENDAR. We now no longer
2021 // are responsible for "the_request"'s memory -- it will be freed
2022 // when we free "encaps".
2023 icalcomponent_add_component(encaps, the_request);
2026 serialized_request = icalcomponent_as_ical_string_r(encaps);
2027 icalcomponent_free(encaps); // Don't need this anymore.
2028 if (serialized_request == NULL) return;
2030 reqsize = strlen(serialized_request) + SIZ;
2031 request_message_text = malloc(reqsize);
2032 if (request_message_text != NULL) {
2033 snprintf(request_message_text, reqsize,
2034 "Content-type: text/calendar\r\n\r\n%s\r\n",
2038 msg = CtdlMakeMessage(
2040 NULL, // No single recipient here
2041 NULL, // No single recipient here
2047 summary_string, // Use summary for subject
2049 request_message_text,
2054 valid = validate_recipients(attendees_string, NULL, 0);
2055 CtdlSubmitMsg(msg, valid, "");
2057 free_recipients(valid);
2060 free(serialized_request);
2064 // When a calendar object is being saved, determine whether it's a VEVENT
2065 // and the user saving it is the organizer. If so, send out invitations
2066 // to any listed attendees.
2068 // This function is recursive. The caller can simply supply the same object
2069 // as both arguments. When it recurses it will alter the second argument
2070 // while holding on to the top level object. This allows us to go back and
2071 // grab things like time zones which might be attached.
2072 void ical_saving_vevent(icalcomponent *top_level_cal, icalcomponent *cal) {
2074 icalproperty *organizer = NULL;
2075 char organizer_string[SIZ];
2077 syslog(LOG_DEBUG, "calendar: ical_saving_vevent() has been called");
2079 // Don't send out invitations unless the client wants us to.
2080 if (CIT_ICAL->server_generated_invitations == 0) {
2084 // Don't send out invitations if we've been asked not to.
2085 if (CIT_ICAL->avoid_sending_invitations > 0) {
2089 strcpy(organizer_string, "");
2090 // The VEVENT subcomponent is the one we're interested in.
2091 // Send out invitations if, and only if, this user is the Organizer.
2092 if (icalcomponent_isa(cal) == ICAL_VEVENT_COMPONENT) {
2093 organizer = icalcomponent_get_first_property(cal, ICAL_ORGANIZER_PROPERTY);
2094 if (organizer != NULL) {
2095 if (icalproperty_get_organizer(organizer)) {
2096 strcpy(organizer_string,
2097 icalproperty_get_organizer(organizer));
2100 if (!strncasecmp(organizer_string, "MAILTO:", 7)) {
2101 strcpy(organizer_string, &organizer_string[7]);
2102 string_trim(organizer_string);
2103 // If the user saving the event is listed as the
2104 // organizer, then send out invitations.
2105 if (CtdlIsMe(organizer_string, sizeof organizer_string)) {
2106 ical_send_out_invitations(top_level_cal, cal);
2111 // If the component has subcomponents, recurse through them.
2112 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
2114 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)
2116 // Recursively process subcomponent
2117 ical_saving_vevent(top_level_cal, c);
2123 // Back end for ical_obj_beforesave()
2124 // This hunts for the UID of the calendar event (becomes Citadel msg EUID),
2125 // the summary of the event (becomes message subject),
2126 // and the start time (becomes message date/time).
2127 void ical_obj_beforesave_backend(char *name, char *filename, char *partnum,
2128 char *disp, void *content, char *cbtype, char *cbcharset, size_t length,
2129 char *encoding, char *cbid, void *cbuserdata)
2132 icalcomponent *cal, *nested_event, *nested_todo, *whole_cal;
2134 char new_uid[256] = "";
2135 struct CtdlMessage *msg = (struct CtdlMessage *) cbuserdata;
2139 // We're only interested in calendar data.
2140 if ( (strcasecmp(cbtype, "text/calendar"))
2141 && (strcasecmp(cbtype, "application/ics"))
2146 // Hunt for the UID and drop it in the "user data" pointer for the MIME parser.
2147 // When ical_obj_beforesave() sees it there, it'll set the Exclusive msgid to that string.
2148 whole_cal = icalcomponent_new_from_string(content);
2151 if (icalcomponent_isa(cal) == ICAL_VCALENDAR_COMPONENT) {
2152 nested_event = icalcomponent_get_first_component(cal, ICAL_VEVENT_COMPONENT);
2153 if (nested_event != NULL) {
2157 nested_todo = icalcomponent_get_first_component( cal, ICAL_VTODO_COMPONENT);
2158 if (nested_todo != NULL) {
2166 // Set the message EUID to the iCalendar UID
2168 p = ical_ctdl_get_subprop(cal, ICAL_UID_PROPERTY);
2170 // If there's no uid we must generate one
2171 generate_uuid(new_uid);
2172 icalcomponent_add_property(cal, icalproperty_new_uid(new_uid));
2173 p = ical_ctdl_get_subprop(cal, ICAL_UID_PROPERTY);
2176 pch = icalproperty_get_comment(p);
2177 if (!IsEmptyStr(pch)) {
2178 CM_SetField(msg, eExclusiveID, pch);
2179 syslog(LOG_DEBUG, "calendar: saving calendar UID <%s>", pch);
2183 // Set the message subject to the iCalendar summary
2185 p = ical_ctdl_get_subprop(cal, ICAL_SUMMARY_PROPERTY);
2187 pch = icalproperty_get_comment(p);
2188 if (!IsEmptyStr(pch)) {
2191 subj = rfc2047encode(pch, strlen(pch));
2192 CM_SetAsField(msg, eMsgSubject, &subj, strlen(subj));
2196 // Set the message date/time to the iCalendar start time
2198 p = ical_ctdl_get_subprop(cal, ICAL_DTSTART_PROPERTY);
2201 idtstart = icaltime_as_timet(icalproperty_get_dtstart(p));
2203 CM_SetFieldLONG(msg, eTimestamp, idtstart);
2208 icalcomponent_free(cal);
2209 if (whole_cal != cal) {
2210 icalcomponent_free(whole_cal);
2216 // See if we need to prevent the object from being saved (we don't allow
2217 // MIME types other than text/calendar in "calendar" or "tasks" rooms).
2219 // If the message is being saved, we also set various message header fields
2220 // using data found in the iCalendar object.
2221 int ical_obj_beforesave(struct CtdlMessage *msg, struct recptypes *recp) {
2222 // First determine if this is a calendar or tasks room
2223 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
2224 && (CC->room.QRdefaultview != VIEW_TASKS)
2226 return(0); // Not an iCalendar-centric room
2229 // It must be an RFC822 message!
2230 if (msg->cm_format_type != 4) {
2231 syslog(LOG_DEBUG, "calendar: rejecting non-RFC822 message");
2232 return(1); // You tried to save a non-RFC822 message!
2235 if (CM_IsEmpty(msg, eMessageText)) {
2236 return(1); // You tried to save a null message!
2239 // Do all of our lovely back-end parsing
2241 CM_RANGE(msg, eMessageText),
2242 *ical_obj_beforesave_backend,
2253 // Things we need to do after saving a calendar event.
2254 void ical_obj_aftersave_backend(char *name, char *filename, char *partnum,
2255 char *disp, void *content, char *cbtype, char *cbcharset, size_t length,
2256 char *encoding, char *cbid, void *cbuserdata)
2260 // We're only interested in calendar items here.
2261 if ( (strcasecmp(cbtype, "text/calendar"))
2262 && (strcasecmp(cbtype, "application/ics"))
2267 // Hunt for the UID and drop it in
2268 // the "user data" pointer for the MIME parser. When
2269 // ical_obj_beforesave() sees it there, it'll set the Exclusive msgid
2271 if ( (!strcasecmp(cbtype, "text/calendar"))
2272 || (!strcasecmp(cbtype, "application/ics"))
2274 cal = icalcomponent_new_from_string(content);
2276 ical_saving_vevent(cal, cal);
2277 icalcomponent_free(cal);
2283 // Things we need to do after saving a calendar event.
2284 // (This will start back end tasks such as automatic generation of invitations,
2285 // if such actions are appropriate.)
2286 int ical_obj_aftersave(struct CtdlMessage *msg, struct recptypes *recp) {
2287 char roomname[ROOMNAMELEN];
2289 // If this isn't the Calendar> room, no further action is necessary.
2291 // First determine if this is our room
2292 CtdlMailboxName(roomname, sizeof roomname, &CC->user, USERCALENDARROOM);
2293 if (strcasecmp(roomname, CC->room.QRname)) {
2294 return(0); // Not the Calendar room -- don't do anything.
2297 // It must be an RFC822 message!
2298 if (msg->cm_format_type != 4) return(1);
2300 // Reject null messages
2301 if (CM_IsEmpty(msg, eMessageText)) return(1);
2303 // Now recurse through it looking for our icalendar data
2305 CM_RANGE(msg, eMessageText),
2306 *ical_obj_aftersave_backend,
2317 void ical_session_startup(void) {
2318 CIT_ICAL = malloc(sizeof(struct cit_ical));
2319 memset(CIT_ICAL, 0, sizeof(struct cit_ical));
2323 void ical_session_shutdown(void) {
2328 // Back end for ical_fixed_output()
2329 void ical_fixed_output_backend(icalcomponent *cal, int recursion_level) {
2335 p = icalcomponent_get_first_property(cal, ICAL_SUMMARY_PROPERTY);
2337 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2340 p = icalcomponent_get_first_property(cal, ICAL_LOCATION_PROPERTY);
2342 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2345 p = icalcomponent_get_first_property(cal, ICAL_DESCRIPTION_PROPERTY);
2347 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2350 // If the component has attendees, iterate through them.
2351 for (p = icalcomponent_get_first_property(cal, ICAL_ATTENDEE_PROPERTY); (p != NULL); p = icalcomponent_get_next_property(cal, ICAL_ATTENDEE_PROPERTY)) {
2352 ch = icalproperty_get_attendee(p);
2353 if ((ch != NULL) && !strncasecmp(ch, "MAILTO:", 7)) {
2355 // screen name or email address
2356 safestrncpy(buf, ch + 7, sizeof(buf));
2358 cprintf("%s ", buf);
2363 // If the component has subcomponents, recurse through them.
2364 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
2366 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)
2368 // Recursively process subcomponent
2369 ical_fixed_output_backend(c, recursion_level+1);
2374 // Function to output iCalendar data as plain text. Nobody uses MSG0
2375 // anymore, so really this is just so we expose the vCard data to the full
2377 void ical_fixed_output(char *ptr, int len) {
2381 stringy_cal = malloc(len + 1);
2382 safestrncpy(stringy_cal, ptr, len + 1);
2383 cal = icalcomponent_new_from_string(stringy_cal);
2390 ical_fixed_output_backend(cal, 0);
2392 // Free the memory we obtained from libical's constructor
2393 icalcomponent_free(cal);
2397 // Initialization function, called from modules_init.c
2398 char *ctdl_module_init_calendar(void) {
2401 // Tell libical to return errors instead of aborting if it gets bad data.
2402 // If this library call is not found, you need to upgrade libical.
2403 icalerror_set_errors_are_fatal(0);
2405 // Use our own application prefix in tzid's generated from system tzdata
2406 icaltimezone_set_tzid_prefix("/citadel.org/");
2408 // Initialize our hook functions
2409 CtdlRegisterMessageHook(ical_obj_beforesave, EVT_BEFORESAVE);
2410 CtdlRegisterMessageHook(ical_obj_aftersave, EVT_AFTERSAVE);
2411 CtdlRegisterSessionHook(ical_CtdlCreateRoom, EVT_LOGIN, PRIO_LOGIN + 1);
2412 CtdlRegisterProtoHook(cmd_ical, "ICAL", "Citadel iCalendar commands");
2413 CtdlRegisterSessionHook(ical_session_startup, EVT_START, PRIO_START + 1);
2414 CtdlRegisterSessionHook(ical_session_shutdown, EVT_STOP, PRIO_STOP + 80);
2415 CtdlRegisterFixedOutputHook("text/calendar", ical_fixed_output);
2416 CtdlRegisterFixedOutputHook("application/ics", ical_fixed_output);
2419 // return our module name for the log