use the same way to display all banners and services contents
[citadel.git] / webcit / preferences.c
index 9414a1edaac4561989218cedcbaec55c4d2e6f21..079fd6a7a8be2875c4417eb2881502bb72c58d89 100644 (file)
@@ -1,16 +1,20 @@
 /*
  * $Id$
- *
- * Manage user preferences with a little help from the Citadel server.
+ */
+/**
+ * \defgroup ManagePrefs Manage user preferences with a little help from the Citadel server.
+ * \ingroup CitadelConfig
  *
  */
-
+/*@{*/
 #include "webcit.h"
 #include "webserver.h"
 #include "groupdav.h"
 
 
-
+/**
+ * \brief display preferences dialog
+ */
 void load_preferences(void) {
        char buf[SIZ];
        long msgnum = 0L;
@@ -56,14 +60,14 @@ void load_preferences(void) {
                }
        }
 
-       /* Go back to the room we're supposed to be in */
+       /** Go back to the room we're supposed to be in */
        serv_printf("GOTO %s", WC->wc_roomname);
        serv_getln(buf, sizeof buf);
 }
 
-/*
- * Goto the user's configuration room, creating it if necessary.
- * Returns 0 on success or nonzero upon failure.
+/**
+ * \brief Goto the user's configuration room, creating it if necessary.
+ * \return 0 on success or nonzero upon failure.
  */
 int goto_config_room(void) {
        char buf[SIZ];
@@ -80,7 +84,9 @@ int goto_config_room(void) {
        return(0);
 }
 
-
+/**
+ * \brief save the modifications
+ */
 void save_preferences(void) {
        char buf[SIZ];
        long msgnum = 0L;
@@ -109,11 +115,17 @@ void save_preferences(void) {
                serv_puts("000");
        }
 
-       /* Go back to the room we're supposed to be in */
+       /** Go back to the room we're supposed to be in */
        serv_printf("GOTO %s", WC->wc_roomname);
        serv_getln(buf, sizeof buf);
 }
 
+/**
+ * \brief query the actual setting of key in the citadel database
+ * \param key config key to query
+ * \param value value to the key to get
+ * \param value_len length of the value string
+ */
 void get_preference(char *key, char *value, size_t value_len) {
        int num_prefs;
        int i;
@@ -132,12 +144,26 @@ void get_preference(char *key, char *value, size_t value_len) {
        }
 }
 
+/**
+ * \brief      Write a key into the webcit preferences database for this user
+ *
+ * \params     key             key whichs value is to be modified
+ * \param      value           value to set
+ * \param      save_to_server  1 = flush all data to the server, 0 = cache it for now
+ */
 void set_preference(char *key, char *value, int save_to_server) {
        int num_prefs;
        int i;
        char buf[SIZ];
        char thiskey[SIZ];
        char *newprefs = NULL;
+       size_t newprefs_len = 0;
+
+       newprefs_len = strlen(key) + strlen(value) + 10;
+       if (WC->preferences != NULL) newprefs_len += strlen(WC->preferences);
+       newprefs = malloc(newprefs_len);
+       if (newprefs == NULL) return;
+       strcpy(newprefs, "");
 
        num_prefs = num_tokens(WC->preferences, '\n');
        for (i=0; i<num_prefs; ++i) {
@@ -145,20 +171,13 @@ void set_preference(char *key, char *value, int save_to_server) {
                if (num_tokens(buf, '|') == 2) {
                        extract_token(thiskey, buf, 0, '|', sizeof thiskey);
                        if (strcasecmp(thiskey, key)) {
-                               if (newprefs == NULL) newprefs = strdup("");
-                               newprefs = realloc(newprefs,
-                                       strlen(newprefs) + SIZ );
                                strcat(newprefs, buf);
                                strcat(newprefs, "\n");
                        }
                }
        }
 
-
-       if (newprefs == NULL) newprefs = strdup("");
-       newprefs = realloc(newprefs, strlen(newprefs) + SIZ);
        sprintf(&newprefs[strlen(newprefs)], "%s|%s\n", key, value);
-
        free(WC->preferences);
        WC->preferences = newprefs;
 
@@ -168,8 +187,8 @@ void set_preference(char *key, char *value, int save_to_server) {
 
 
 
-/* 
- * display form for changing your preferences and settings
+/** 
+ * \brief display form for changing your preferences and settings
  */
 void display_preferences(void)
 {
@@ -180,26 +199,28 @@ void display_preferences(void)
        int i;
 
        wprintf("<div id=\"banner\">\n");
-       wprintf("<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>");
-       wprintf("<img src=\"static/advanpage2_48x.gif\" ALT=\" \" ALIGN=MIDDLE>");
-       wprintf("<SPAN CLASS=\"titlebar\">&nbsp;");
+       wprintf("<img src=\"static/advanpage2_48x.gif\">");
+       wprintf("<h1>");
        wprintf(_("Preferences and settings"));
-       wprintf("</SPAN></TD><TD ALIGN=RIGHT>");
+       wprintf("</h1>");
+       wprintf("<ul><li>");
        offer_start_page();
-       wprintf("</TD></TR></TABLE>\n");
-       wprintf("</div>\n"
-               "<div id=\"content\">\n");
+       wprintf("</li></ul>\n");
+       wprintf("</div>\n");
+
+       wprintf("<div id=\"content\" class=\"service\">\n");
 
        wprintf("<div class=\"fix_scrollbar_bug\">"
-               "<table border=0 width=100%% bgcolor=\"#ffffff\"><tr><td>\n");
+               "<table class=\"preferences_background\"><tr><td>\n");
 
-       /* begin form */
+       /** begin form */
        wprintf("<center>\n"
                "<form name=\"prefform\" action=\"set_preferences\" "
                "method=\"post\">\n"
                "<table border=0 cellspacing=5 cellpadding=5>\n");
+       wprintf("<input type=\"hidden\" name=\"nonce\" value=\"%ld\">\n", WC->nonce);
 
-       /*
+       /**
         * Room list view
         */
        get_preference("roomlistview", buf, sizeof buf);
@@ -221,7 +242,7 @@ void display_preferences(void)
 
        wprintf("</td></tr>\n");
 
-       /*
+       /**
         * Calendar hour format
         */
        get_preference("calhourformat", calhourformat, sizeof calhourformat);
@@ -244,7 +265,7 @@ void display_preferences(void)
 
        wprintf("</td></tr>\n");
 
-       /*
+       /**
         * Calendar day view -- day start time
         */
        get_preference("daystart", buf, sizeof buf);
@@ -273,7 +294,7 @@ void display_preferences(void)
        wprintf("</SELECT>\n");
        wprintf("</td></tr>\n");
 
-       /*
+       /**
         * Calendar day view -- day end time
         */
        get_preference("dayend", buf, sizeof buf);
@@ -302,7 +323,7 @@ void display_preferences(void)
        wprintf("</SELECT>\n");
        wprintf("</td></tr>\n");
 
-       /*
+       /**
         * Signature
         */
        get_preference("use_sig", buf, sizeof buf);
@@ -352,7 +373,18 @@ void display_preferences(void)
                "       </script>                               "
        );
 
+       /** Character set to assume is in use for improperly encoded headers */
+       get_preference("default_header_charset", buf, sizeof buf);
+       if (buf[0] == 0) strcpy(buf, "UTF-8");
+       wprintf("<tr><td>");
+       wprintf(_("Default character set for email headers:"));
+       wprintf("</td><td>");
+       wprintf("<input type=\"text\" NAME=\"default_header_charset\" MAXLENGTH=\"32\" VALUE=\"");
+       escputs(buf);
+       wprintf("\">");
+       wprintf("</td></tr>");
 
+       /** submit buttons */
        wprintf("</table>\n"
                "<input type=\"submit\" name=\"change_button\" value=\"%s\">"
                "&nbsp;"
@@ -361,23 +393,20 @@ void display_preferences(void)
                _("Cancel")
        );
 
+       /** end form */
        wprintf("</form></center>\n");
-
-       /* end form */
-
-
        wprintf("</td></tr></table></div>\n");
        wDumpContent(1);
 }
 
-/*
- * Commit new preferences and settings
+/**
+ * \brief Commit new preferences and settings
  */
 void set_preferences(void)
 {
        char ebuf[300];
 
-       if (strlen(bstr("change_button")) == 0) {
+       if (IsEmptyStr(bstr("change_button"))) {
                safestrncpy(WC->ImportantMessage, 
                        _("Cancelled.  No settings were changed."),
                        sizeof WC->ImportantMessage);
@@ -385,7 +414,8 @@ void set_preferences(void)
                return;
        }
 
-       /* Set the last argument to 1 only for the final setting, so
+       /**
+        * Set the last argument to 1 only for the final setting, so
         * we don't send the prefs file to the server repeatedly
         */
        set_preference("roomlistview", bstr("roomlistview"), 0);
@@ -393,9 +423,13 @@ void set_preferences(void)
        set_preference("use_sig", bstr("use_sig"), 0);
        set_preference("daystart", bstr("daystart"), 0);
        set_preference("dayend", bstr("dayend"), 0);
+       set_preference("default_header_charset", bstr("default_header_charset"), 0);
 
        euid_escapize(ebuf, bstr("signature"));
        set_preference("signature", ebuf, 1);
 
        display_main_menu();
 }
+
+
+/*@}*/