/*
* $Id$
- *
- * Miscellaneous functions which handle calendar components.
*/
-
+/**
+ * \defgroup MiscCal Miscellaneous functions which handle calendar components.
+ * \ingroup Calendaring
+ */
+/*@{*/
#include "webcit.h"
#include "webserver.h"
-/* FIXME ... this needs to be internationalized */
-char *months[] = {
- "January",
- "February",
- "March",
- "April",
- "May",
- "June",
- "July",
- "August",
- "September",
- "October",
- "November",
- "December"
-};
-
-char *days[] = {
- "Sunday",
- "Monday",
- "Tuesday",
- "Wednesday",
- "Thursday",
- "Friday",
- "Saturday"
-};
-
+/** Hour strings */
char *hourname[] = {
"12am", "1am", "2am", "3am", "4am", "5am", "6am",
"7am", "8am", "9am", "10am", "11am", "12pm",
#ifdef WEBCIT_WITH_CALENDAR_SERVICE
-/*
+/**
+ * \brief display and edit date/time
* The display_icaltimetype_as_webform() and icaltime_from_webform() functions
* handle the display and editing of date/time properties in web pages. The
* first one converts an icaltimetype into valid HTML markup -- a series of form
* property (for example, a start and end time) by ensuring the field names are
* unique within the form.
*
- * NOTE: These functions assume that the icaltimetype being edited is in UTC, and
+ * \todo NOTE: These functions assume that the icaltimetype being edited is in UTC, and
* will convert to/from local time for editing. "local" in this case is assumed
* to be the time zone in which the WebCit server is running. A future improvement
* might be to allow the user to specify his/her timezone.
+ * \param t the time we want to parse
+ * \param prefix ???? \todo
*/
struct tm tm;
const int span = 10;
int all_day_event = 0;
- char calhourformat[16];
-
- get_preference("calhourformat", calhourformat, sizeof calhourformat);
+ time_t monthselect_time;
+ struct tm monthselect_tm;
+ char monthselect_str[32];
+ int time_format;
+
+ time_format = get_time_format_cached ();
now = time(NULL);
localtime_r(&now, &tm_now);
wprintf(_("Month: "));
wprintf("<SELECT NAME=\"%s_month\" SIZE=\"1\">\n", prefix);
for (i=0; i<=11; ++i) {
+ monthselect_time = 1137997451 + (i * 2592000);
+ localtime_r(&monthselect_time, &monthselect_tm);
+ wc_strftime(monthselect_str, sizeof monthselect_str, "%B", &monthselect_tm);
wprintf("<OPTION %s VALUE=\"%d\">%s</OPTION>\n",
((tm.tm_mon == i) ? "SELECTED" : ""),
i+1,
- months[i]
+ monthselect_str
);
}
wprintf("</SELECT>\n");
wprintf("<SELECT NAME=\"%s_hour\" SIZE=\"1\">\n", prefix);
for (i=0; i<=23; ++i) {
- if (!strcasecmp(calhourformat, "24")) {
+ if (time_format == WC_TIMEFORMAT_24) {
wprintf("<OPTION %s VALUE=\"%d\">%d</OPTION>\n",
((tm.tm_hour == i) ? "SELECTED" : ""),
i, i
wprintf("</SELECT>\n");
}
-
+/**
+ *\brief Get time from form
+ * get the time back from the user and convert it into internal structs.
+ * \param t our time element
+ * \param prefix whats that\todo ????
+ */
void icaltime_from_webform(struct icaltimetype *t, char *prefix) {
char vname[32];
- time_t tt;
- struct tm tm;
struct icaltimetype t2;
+ char timestr[32];
+ int month, mday, year, hour, minute;
- tt = time(NULL);
- localtime_r(&tt, &tm);
-
- sprintf(vname, "%s_month", prefix); tm.tm_mon = atoi(bstr(vname)) - 1;
- sprintf(vname, "%s_day", prefix); tm.tm_mday = atoi(bstr(vname));
- sprintf(vname, "%s_year", prefix); tm.tm_year = atoi(bstr(vname)) - 1900;
- sprintf(vname, "%s_hour", prefix); tm.tm_hour = atoi(bstr(vname));
- sprintf(vname, "%s_minute", prefix); tm.tm_min = atoi(bstr(vname));
+ sprintf(vname, "%s_month", prefix); month = atoi(bstr(vname));
+ sprintf(vname, "%s_day", prefix); mday = atoi(bstr(vname));
+ sprintf(vname, "%s_year", prefix); year = atoi(bstr(vname));
+ sprintf(vname, "%s_hour", prefix); hour = atoi(bstr(vname));
+ sprintf(vname, "%s_minute", prefix); minute = atoi(bstr(vname));
- tt = mktime(&tm);
- t2 = icaltime_from_timet(tt, 0);
+ sprintf(timestr, "%04d%02d%02dT%02d%02d00", year, month, mday, hour, minute);
+ t2 = icaltime_from_string(timestr);
memcpy(t, &t2, sizeof(struct icaltimetype));
}
+/**
+ *\brief Get time from form
+ * get the time back from the user and convert it into internal structs.
+ * \param t our time element
+ * \param prefix whats that\todo ????
+ */
+
void icaltime_from_webform_dateonly(struct icaltimetype *t, char *prefix) {
char vname[32];
}
-/*
+/**
+ * \brief Render PAPSTAT
* Render a PARTSTAT parameter as a string (and put it in parentheses)
+ * \param buf the string to put it to
+ * \param attendee the attendee to textify
*/
void partstat_as_string(char *buf, icalproperty *attendee) {
icalparameter *partstat_param;
}
-/*
+/**
+ * \brief embedd
* Utility function to encapsulate a subcomponent into a full VCALENDAR
+ * \param subcomp the component to encapsulate
+ * \returns the meta object ???
*/
icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
icalcomponent *encaps;
return NULL;
}
- /* If we're already looking at a full VCALENDAR component,
+ /**
+ * If we're already looking at a full VCALENDAR component,
* don't bother ... just return itself.
*/
if (icalcomponent_isa(subcomp) == ICAL_VCALENDAR_COMPONENT) {
return subcomp;
}
- /* Encapsulate the VEVENT component into a complete VCALENDAR */
+ /** Encapsulate the VEVENT component into a complete VCALENDAR */
encaps = icalcomponent_new(ICAL_VCALENDAR_COMPONENT);
if (encaps == NULL) {
lprintf(3, "%s:%d: Error - could not allocate component!\n",
return NULL;
}
- /* Set the Product ID */
+ /** Set the Product ID */
icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
- /* Set the Version Number */
+ /** Set the Version Number */
icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
- /* Encapsulate the subcomponent inside */
+ /** Encapsulate the subcomponent inside */
/* lprintf(9, "Doing the encapsulation\n"); */
icalcomponent_add_component(encaps, subcomp);
- /* Convert all timestamps to UTC so we don't have to deal with
+ /** Convert all timestamps to UTC so we don't have to deal with
* stupid VTIMEZONE crap.
*/
ical_dezonify(encaps);
- /* Return the object we just created. */
+ /** Return the object we just created. */
return(encaps);
}
#endif
+/*@}*/