4 * Miscellaneous functions which handle calendar components.
13 "12am", "1am", "2am", "3am", "4am", "5am", "6am",
14 "7am", "8am", "9am", "10am", "11am", "12pm",
15 "1pm", "2pm", "3pm", "4pm", "5pm", "6pm",
16 "7pm", "8pm", "9pm", "10pm", "11pm"
20 * The display_icaltimetype_as_webform() and icaltime_from_webform() functions
21 * handle the display and editing of date/time properties in web pages. The
22 * first one converts an icaltimetype into valid HTML markup -- a series of form
23 * fields for editing the date and time. When the user submits the form, the
24 * results can be fed back into the second function, which turns it back into
25 * an icaltimetype. The "prefix" string required by both functions is prepended
26 * to all field names. This allows a form to contain more than one date/time
27 * property (for example, a start and end time) by ensuring the field names are
28 * unique within the form.
30 * NOTE: These functions assume that the icaltimetype being edited is in UTC, and
31 * will convert to/from local time for editing. "local" in this case is assumed
32 * to be the time zone in which the WebCit server is running. A future improvement
33 * might be to allow the user to specify his/her timezone.
36 void display_icaltimetype_as_webform(struct icaltimetype *t, char *prefix, int date_only) {
44 int all_day_event = 0;
48 time_format = get_time_format_cached ();
51 localtime_r(&now, &tm_now);
52 this_year = tm_now.tm_year + 1900;
54 if (t == NULL) return;
55 if (t->is_date) all_day_event = 1;
56 tt = icaltime_as_timet(*t);
61 localtime_r(&tt, &tm);
64 wc_printf("<input type=\"text\" name=\"");
65 StrBufAppendBufPlain(WCC->WBuf, prefix, -1, 0);
66 wc_printf("\" id=\"");
67 StrBufAppendBufPlain(WCC->WBuf, prefix, -1, 0);
68 wc_printf("\" size=\"10\" maxlength=\"10\" value=\"");
69 wc_strftime(timebuf, 32, "%Y-%m-%d", &tm);
70 StrBufAppendBufPlain(WCC->WBuf, timebuf, -1, 0);
73 StrBufAppendPrintf(WC->trailing_javascript, "attachDatePicker('");
74 StrBufAppendPrintf(WC->trailing_javascript, prefix);
75 StrBufAppendPrintf(WC->trailing_javascript, "', '%s');\n", get_selected_language());
77 /* If we're editing a date only, we still generate the time boxes, but we hide them.
78 * This keeps the data model consistent.
81 wc_printf("<div style=\"display:none\">");
84 wc_printf("<span ID=\"");
85 StrBufAppendBufPlain(WCC->WBuf, prefix, -1, 0);
86 wc_printf("_time\">");
87 wc_printf(_("Hour: "));
88 wc_printf("<SELECT NAME=\"%s_hour\" SIZE=\"1\">\n", prefix);
89 for (i=0; i<=23; ++i) {
91 if (time_format == WC_TIMEFORMAT_24) {
92 wc_printf("<OPTION %s VALUE=\"%d\">%d</OPTION>\n",
93 ((tm.tm_hour == i) ? "SELECTED" : ""),
98 wc_printf("<OPTION %s VALUE=\"%d\">%s</OPTION>\n",
99 ((tm.tm_hour == i) ? "SELECTED" : ""),
105 wc_printf("</SELECT>\n");
107 wc_printf(_("Minute: "));
108 wc_printf("<SELECT NAME=\"%s_minute\" SIZE=\"1\">\n", prefix);
109 for (i=0; i<=59; ++i) {
110 if ( (i % 5 == 0) || (tm.tm_min == i) ) {
111 wc_printf("<OPTION %s VALUE=\"%d\">:%02d</OPTION>\n",
112 ((tm.tm_min == i) ? "SELECTED" : ""),
117 wc_printf("</SELECT></span>\n");
125 * Get date/time from a web form and convert it into an icaltimetype struct.
127 void icaltime_from_webform(struct icaltimetype *t, char *prefix) {
132 /* Stuff with zero values */
133 memset(t, 0, sizeof(struct icaltimetype));
135 /* Get the year/month/date all in one shot -- it will be in ISO YYYY-MM-DD format */
136 sscanf((char*)BSTR(prefix), "%04d-%02d-%02d", &t->year, &t->month, &t->day);
139 sprintf(vname, "%s_hour", prefix);
140 t->hour = IBSTR(vname);
143 sprintf(vname, "%s_minute", prefix);
144 t->minute = IBSTR(vname);
146 /* time zone is set to the default zone for this server */
149 t->zone = get_default_icaltimezone();
154 * Get date (no time) from a web form and convert it into an icaltimetype struct.
156 void icaltime_from_webform_dateonly(struct icaltimetype *t, char *prefix) {
159 /* Stuff with zero values */
160 memset(t, 0, sizeof(struct icaltimetype));
162 /* Get the year/month/date all in one shot -- it will be in ISO YYYY-MM-DD format */
163 sscanf((char*)BSTR(prefix), "%04d-%02d-%02d", &t->year, &t->month, &t->day);
165 /* time zone is set to the default zone for this server */
172 * Render a PARTSTAT parameter as a string (and put it in parentheses)
174 void partstat_as_string(char *buf, icalproperty *attendee) {
175 icalparameter *partstat_param;
176 icalparameter_partstat partstat;
178 strcpy(buf, _("(status unknown)"));
180 partstat_param = icalproperty_get_first_parameter(
182 ICAL_PARTSTAT_PARAMETER
184 if (partstat_param == NULL) {
188 partstat = icalparameter_get_partstat(partstat_param);
190 case ICAL_PARTSTAT_X:
193 case ICAL_PARTSTAT_NEEDSACTION:
194 strcpy(buf, _("(needs action)"));
196 case ICAL_PARTSTAT_ACCEPTED:
197 strcpy(buf, _("(accepted)"));
199 case ICAL_PARTSTAT_DECLINED:
200 strcpy(buf, _("(declined)"));
202 case ICAL_PARTSTAT_TENTATIVE:
203 strcpy(buf, _("(tenative)"));
205 case ICAL_PARTSTAT_DELEGATED:
206 strcpy(buf, _("(delegated)"));
208 case ICAL_PARTSTAT_COMPLETED:
209 strcpy(buf, _("(completed)"));
211 case ICAL_PARTSTAT_INPROCESS:
212 strcpy(buf, _("(in process)"));
214 case ICAL_PARTSTAT_NONE:
215 strcpy(buf, _("(none)"));
221 * Utility function to encapsulate a subcomponent into a full VCALENDAR.
223 * We also scan for any date/time properties that reference timezones, and attach
224 * those timezones along with the supplied subcomponent. (Increase the size of the array if you need to.)
226 * Note: if you change anything here, change it in Citadel server's ical_send_out_invitations() too.
228 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
229 icalcomponent *encaps;
231 struct icaltimetype t;
232 const icaltimezone *attached_zones[5] = { NULL, NULL, NULL, NULL, NULL };
234 const icaltimezone *z;
235 int num_zones_attached = 0;
236 int zone_already_attached;
238 if (subcomp == NULL) {
239 lprintf(3, "ERROR: ical_encapsulate_subcomponent() called with NULL argument\n");
244 * If we're already looking at a full VCALENDAR component, this is probably an error.
246 if (icalcomponent_isa(subcomp) == ICAL_VCALENDAR_COMPONENT) {
247 lprintf(3, "ERROR: component sent to ical_encapsulate_subcomponent() already top level\n");
252 for (p = icalcomponent_get_first_property(subcomp, ICAL_ANY_PROPERTY);
254 p = icalcomponent_get_next_property(subcomp, ICAL_ANY_PROPERTY))
256 if ( (icalproperty_isa(p) == ICAL_COMPLETED_PROPERTY)
257 || (icalproperty_isa(p) == ICAL_CREATED_PROPERTY)
258 || (icalproperty_isa(p) == ICAL_DATEMAX_PROPERTY)
259 || (icalproperty_isa(p) == ICAL_DATEMIN_PROPERTY)
260 || (icalproperty_isa(p) == ICAL_DTEND_PROPERTY)
261 || (icalproperty_isa(p) == ICAL_DTSTAMP_PROPERTY)
262 || (icalproperty_isa(p) == ICAL_DTSTART_PROPERTY)
263 || (icalproperty_isa(p) == ICAL_DUE_PROPERTY)
264 || (icalproperty_isa(p) == ICAL_EXDATE_PROPERTY)
265 || (icalproperty_isa(p) == ICAL_LASTMODIFIED_PROPERTY)
266 || (icalproperty_isa(p) == ICAL_MAXDATE_PROPERTY)
267 || (icalproperty_isa(p) == ICAL_MINDATE_PROPERTY)
268 || (icalproperty_isa(p) == ICAL_RECURRENCEID_PROPERTY)
270 t = icalproperty_get_dtstart(p); /*/ it's safe to use dtstart for all of them */
271 if ((icaltime_is_valid_time(t)) && (z=icaltime_get_timezone(t), z)) {
273 zone_already_attached = 0;
274 for (i=0; i<5; ++i) {
275 if (z == attached_zones[i]) {
276 ++zone_already_attached;
277 lprintf(9, "zone already attached!!\n");
280 if ((!zone_already_attached) && (num_zones_attached < 5)) {
281 lprintf(9, "attaching zone %d!\n", num_zones_attached);
282 attached_zones[num_zones_attached++] = z;
285 icalproperty_set_parameter(p,
286 icalparameter_new_tzid(icaltimezone_get_tzid((icaltimezone *)z))
292 /* Encapsulate the VEVENT component into a complete VCALENDAR */
293 encaps = icalcomponent_new(ICAL_VCALENDAR_COMPONENT);
294 if (encaps == NULL) {
295 lprintf(3, "ERROR: ical_encapsulate_subcomponent() could not allocate component\n");
299 /* Set the Product ID */
300 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
302 /* Set the Version Number */
303 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
305 /* Attach any timezones we need */
306 if (num_zones_attached > 0) for (i=0; i<num_zones_attached; ++i) {
308 zc = icalcomponent_new_clone(icaltimezone_get_component((icaltimezone *)attached_zones[i]));
309 icalcomponent_add_component(encaps, zc);
312 /* Encapsulate the subcomponent inside */
313 icalcomponent_add_component(encaps, subcomp);
315 /* Return the object we just created. */