* Merged Thierry's CSS changes
[citadel.git] / webcit / iconbar.c
index 8d325d988eee2cd60831b4bfed84f7a7225349f9..d0382c79e29648c6199eb3042b239bdf74295347 100644 (file)
@@ -1,18 +1,23 @@
 /*
  * $Id$
- *
- * Displays and customizes the iconbar.
  */
-
+/**
+ * \defgroup IconBar Displays and customizes the iconbar.
+ * \ingroup MenuInfrastructure
+ */
+/*@{*/
 #include "webcit.h"
 
 
-/* Values for ib_displayas */
-#define IB_PICTEXT     0
-#define IB_PICONLY     1
-#define IB_TEXTONLY    2
+/** Values for ib_displayas */
+#define IB_PICTEXT     0 /**< picture and text */
+#define IB_PICONLY     1 /**< just a picture */
+#define IB_TEXTONLY    2 /**< just text */
 
 
+/**
+ * \brief draw the icon bar?????
+ */
 void do_selected_iconbar(void) {
        if (WC->current_iconbar == current_iconbar_roomlist) {
                do_iconbar_roomlist();
@@ -22,7 +27,9 @@ void do_selected_iconbar(void) {
        }
 }
 
-
+/**
+ * \brief draw the icon bar???
+ */
 void do_iconbar(void) {
        char iconbar[SIZ];
        char buf[SIZ];
@@ -31,24 +38,25 @@ void do_iconbar(void) {
 
        WC->current_iconbar = current_iconbar_menu;
 
-       /* The initialized values of these variables also happen to
+       /**
+        * The initialized values of these variables also happen to
         * specify the default values for users who haven't customized
         * their iconbars.  These should probably be set in a master
         * configuration somewhere.
         */
-       int ib_displayas = 0;   /* pictures and text, pictures, text */
-       int ib_logo = 0;        /* Site logo */
-       int ib_summary = 1;     /* Summary page icon */
-       int ib_inbox = 1;       /* Inbox icon */
-       int ib_calendar = 1;    /* Calendar icon */
-       int ib_contacts = 1;    /* Contacts icon */
-       int ib_notes = 1;       /* Notes icon */
-       int ib_tasks = 1;       /* Tasks icon */
-       int ib_rooms = 1;       /* Rooms icon */
-       int ib_users = 1;       /* Users icon */
-       int ib_chat = 1;        /* Chat icon */
-       int ib_advanced = 1;    /* Advanced Options icon */
-       int ib_citadel = 1;     /* 'Powered by Citadel' logo */
+       int ib_displayas = 0;   /**< pictures and text, pictures, text */
+       int ib_logo = 0;        /**< Site logo */
+       int ib_summary = 1;     /**< Summary page icon */
+       int ib_inbox = 1;       /**< Inbox icon */
+       int ib_calendar = 1;    /**< Calendar icon */
+       int ib_contacts = 1;    /**< Contacts icon */
+       int ib_notes = 1;       /**< Notes icon */
+       int ib_tasks = 1;       /**< Tasks icon */
+       int ib_rooms = 1;       /**< Rooms icon */
+       int ib_users = 1;       /**< Users icon */
+       int ib_chat = 1;        /**< Chat icon */
+       int ib_advanced = 1;    /**< Advanced Options icon */
+       int ib_citadel = 1;     /**< 'Powered by Citadel' logo */
        /*
         */
 
@@ -80,8 +88,8 @@ void do_iconbar(void) {
        if (ib_logo) {
                wprintf("<li>");
                if (ib_displayas != IB_TEXTONLY) {
-                       wprintf("<IMG BORDER=\"0\" WIDTH=\"32\" "
-                               "HEIGHT=\"32\" src=\"image&name=hello\" ALT=\"&nbsp;\">\n"
+                       wprintf("<IMG BORDER=\"0\" WIDTH=\"120\" "
+                               "src=\"image&name=hello\" ALT=\"&nbsp;\">\n"
                        );
                }
                wprintf("</li>\n");
@@ -323,7 +331,8 @@ void do_iconbar(void) {
 }
 
 
-/*
+/**
+ * \brief roomtree view of the iconbar
  * If the user has toggled the icon bar over to a room list, here's where
  * we generate its innerHTML...
  */
@@ -335,7 +344,8 @@ void do_iconbar_roomlist(void) {
 
        WC->current_iconbar = current_iconbar_roomlist;
 
-       /* The initialized values of these variables also happen to
+       /**
+        * The initialized values of these variables also happen to
         * specify the default values for users who haven't customized
         * their iconbars.  These should probably be set in a master
         * configuration somewhere.
@@ -364,8 +374,8 @@ void do_iconbar_roomlist(void) {
        if (ib_logo) {
                wprintf("<li>");
                if (ib_displayas != IB_TEXTONLY) {
-                       wprintf("<IMG BORDER=\"0\" WIDTH=\"32\" "
-                               "HEIGHT=\"32\" src=\"image&name=hello\" ALT=\"&nbsp;\">\n"
+                       wprintf("<IMG BORDER=\"0\" WIDTH=\"120\" "
+                               "src=\"image&name=hello\" ALT=\"&nbsp;\">\n"
                        );
                }
                wprintf("</li>\n");
@@ -404,14 +414,16 @@ void do_iconbar_roomlist(void) {
 
        wprintf("</ul></div>\n");
 
-       /* embed the room list */
+       /** embed the room list */
        list_all_rooms_by_floor("iconbar");
 
        wprintf("</div>\n");
 }
 
 
-
+/**
+ * \brief display a customized version of the iconbar
+ */
 void display_customize_iconbar(void) {
        char iconbar[SIZ];
        char buf[SIZ];
@@ -419,24 +431,25 @@ void display_customize_iconbar(void) {
        int i;
        int bar = 0;
 
-       /* The initialized values of these variables also happen to
+       /**
+        * The initialized values of these variables also happen to
         * specify the default values for users who haven't customized
         * their iconbars.  These should probably be set in a master
         * configuration somewhere.
         */
-       int ib_displayas = IB_PICTEXT;  /* pictures and text, pictures, text */
-       int ib_logo = 0;        /* Site logo */
-       int ib_summary = 1;     /* Summary page icon */
-       int ib_inbox = 1;       /* Inbox icon */
-       int ib_calendar = 1;    /* Calendar icon */
-       int ib_contacts = 1;    /* Contacts icon */
-       int ib_notes = 1;       /* Notes icon */
-       int ib_tasks = 1;       /* Tasks icon */
-       int ib_rooms = 1;       /* Rooms icon */
-       int ib_users = 1;       /* Users icon */
-       int ib_chat = 1;        /* Chat icon */
-       int ib_advanced = 1;    /* Advanced Options icon */
-       int ib_citadel = 1;     /* 'Powered by Citadel' logo */
+       int ib_displayas = IB_PICTEXT;  /**< pictures and text, pictures, text */
+       int ib_logo = 0;        /**< Site logo */
+       int ib_summary = 1;     /**< Summary page icon */
+       int ib_inbox = 1;       /**< Inbox icon */
+       int ib_calendar = 1;    /**< Calendar icon */
+       int ib_contacts = 1;    /**< Contacts icon */
+       int ib_notes = 1;       /**< Notes icon */
+       int ib_tasks = 1;       /**< Tasks icon */
+       int ib_rooms = 1;       /**< Rooms icon */
+       int ib_users = 1;       /**< Users icon */
+       int ib_chat = 1;        /**< Chat icon */
+       int ib_advanced = 1;    /**< Advanced Options icon */
+       int ib_citadel = 1;     /**< 'Powered by Citadel' logo */
        /*
         */
 
@@ -463,7 +476,7 @@ void display_customize_iconbar(void) {
 
        output_headers(1, 1, 2, 0, 0, 0);
        wprintf("<div id=\"banner\">\n"
-               "<TABLE WIDTH=100%% BORDER=0 BGCOLOR=\"#444455\"><TR><TD>"
+               "<TABLE class=\"iconbar_banner\"><TR><TD>"
                "<SPAN CLASS=\"titlebar\">");
        wprintf(_("Customize the icon bar"));
        wprintf("</SPAN>"
@@ -471,8 +484,8 @@ void display_customize_iconbar(void) {
                "</div>\n<div id=\"content\">\n"
        );
 
-       wprintf("<div id=\"fix_scrollbar_bug\">"
-               "<table border=0 width=100%% bgcolor=\"#ffffff\"><tr><td>");
+       wprintf("<div class=\"fix_scrollbar_bug\">"
+               "<table class=\"iconbar_background\"><tr><td>");
 
        wprintf("<FORM METHOD=\"POST\" action=\"commit_iconbar\">\n");
 
@@ -500,7 +513,7 @@ void display_customize_iconbar(void) {
        wprintf("<TR BGCOLOR=%s><TD>"
                "<INPUT TYPE=\"checkbox\" NAME=\"ib_logo\" VALUE=\"yes\" %s>"
                "</TD><TD>"
-               "<IMG BORDER=\"0\" WIDTH=\"48\" HEIGHT=\"48\" "
+               "<IMG BORDER=\"0\" WIDTH=\"48\" "
                "src=\"image&name=hello\" ALT=\"&nbsp;\">"
                "</TD><TD>"
                "<B>%s</B><br />"
@@ -619,7 +632,7 @@ void display_customize_iconbar(void) {
                ((bar = 1 - bar), (bar ? "\"#CCCCCC\"" : "\"#FFFFFF\"")),
                (ib_rooms ? "CHECKED" : ""),
                _("Rooms"),
-               _("Clicking this icon displays a list of all accesible "
+               _("Clicking this icon displays a list of all accessible "
                "rooms (or folders) available.")
        );
 
@@ -703,7 +716,9 @@ void display_customize_iconbar(void) {
        wDumpContent(2);
 }
 
-
+/**
+ * \brief commit the changes of an edited iconbar ????
+ */
 void commit_iconbar(void) {
        char iconbar[SIZ];
        int i;
@@ -754,3 +769,6 @@ void commit_iconbar(void) {
        wDumpContent(2);
 }
 
+
+
+/*@}*/