From bb56b61b6b93b3fd69f2b3bfabf3fcb2e31e6ee7 Mon Sep 17 00:00:00 2001
From: Greg Burri <greg.burri@gmail.com>
Date: Thu, 5 Jun 2008 12:26:07 +0000
Subject: [PATCH] MOD maj TODO MOD cleanage de pageAdmin.js

---
 doc/TODO.txt    |  3 +++
 js/pageAdmin.js | 66 +++++++++++++++++++++++++++++++++----------------
 2 files changed, 48 insertions(+), 21 deletions(-)

diff --git a/doc/TODO.txt b/doc/TODO.txt
index a1d7b57..26de108 100755
--- a/doc/TODO.txt
+++ b/doc/TODO.txt
@@ -27,6 +27,9 @@
 * Création d'un script ruby dans /tool pour apposer  automatiquement une entête concernant la licence voir : http://www.gnu.org/licenses/gpl-howto.fr.html
    * Eventuellement mettre à jour automatiquement le Copyright (date) et les personnes responsables 
 * Système de censure par les admins (suppression d'un message)
+   * Ne supprime pas réellement le message mais le censure
+   * L'admin vois toujours le message (grisé, ou tracé)
+   * Les utilisateurs normaux voient à la place "<censuré, raison : blabla>"
 * Intégrer les totoz : http://www.totoz.eu/ (avec une limite de 3 par messages par exemple) 
    * avoir une option pour les cacher ou les voir
    * Masquer systématiquement ceux qui dépassent une certaine taille en pixel
diff --git a/js/pageAdmin.js b/js/pageAdmin.js
index 97c0243..ddde690 100644
--- a/js/pageAdmin.js
+++ b/js/pageAdmin.js
@@ -14,7 +14,9 @@
 // GNU General Public License for more details.
 //
 // You should have received a copy of the GNU General Public License
-// along with Euphorik.  If not, see <http://www.gnu.org/licenses/>.
+// along with Euphorik.  If not, see <http://www.gnu.org/licenses/>.
+// 
+// La page d'administation, ne peut être accédée que par les ekMaster (admins)
 
 function PageAdmin(client, formateur, util)
 {
@@ -25,13 +27,18 @@ function PageAdmin(client, formateur, util)
    this.util = util
    
    this.pageEvent = new PageEvent("admin", this.util)
-   
+   
+   // le timer qui rappelle periodiquement le rafraichissement des IP bannies
    this.timeoutIDmajIPs = null
 }
-
+
+/**
+  * Interface des pages.
+  */
 PageAdmin.prototype.contenu = function()
 {
-   return '<h1>Trolls</h1>\
+   return '\
+   <h1>Trolls</h1>\
    <p>Un troll est un sujet à débat, en général une question, affiché sur la page principale.</p>\
    <p>Chaque semaine un troll est choisi au hasard parmis les trolls proposés et devient le troll de la semaine.</p>\
    <form action="" id="nouveauTroll">\
@@ -44,14 +51,19 @@ PageAdmin.prototype.contenu = function()
    <h1>IPs bannies</h1>\
    <div id="ips"></div>'
 }
-
+
+/**
+  * Interface des pages.
+  */
 PageAdmin.prototype.charger = function()
 {      
    $("#page form#nouveauTroll").submit(function(){return false})
       
    var thisPage = this
+   
+   // la liste des trolls proposés par les ekMasters
+   this.trolls = new Trolls(this.client, this.util, this.formateur)
    
-   this.trolls = new Trolls(this.client, this.util, this.formateur)
    this.waitEvent()
    
    this.majIPs()
@@ -65,12 +77,22 @@ PageAdmin.prototype.charger = function()
       }
    )
 }
-
+
+/**
+  * Interface des pages.
+  */
 PageAdmin.prototype.decharger = function()
 {
-   this.pageEvent.stopAttenteCourante()
+   this.pageEvent.stopAttenteCourante()
+   
+   // supprime le rafraichissement période des ips
+   if (this.timeoutIDmajIPs)
+      clearTimeout(this.timeoutIDmajIPs)
 }
-
+
+/**
+  * Post un troll, le contenu est lu à partir de "input.troll".
+  */
 PageAdmin.prototype.posterTroll = function()
 {
    var thisPageAdmin = this
@@ -195,13 +217,16 @@ PageAdmin.prototype.majIPs = function()
                }
                
                // rafraichissement toutes les minutes (je sais c'est mal)
-               // le problème est le rafraichissement des temps restant de bannissement qui doit êtrew fait du coté client
+               // le problème est le rafraichissement des temps restant de bannissement qui doit être fait du coté client
                thisPageAdmin.timeoutIDmajIPs = setTimeout(function(){ thisPageAdmin.majIPs() }, 60 * 1000)
             }
       }
    )
 }
-
+
+/**
+  * Débannie une ip donnée.
+  */
 PageAdmin.prototype.deban = function(ip)
 {
    var thisPageAdmin = this
@@ -224,21 +249,18 @@ PageAdmin.prototype.deban = function(ip)
             function(data)
             {
                ;; dumpObj(data)
-               switch(data["reply"])
+               if(data["reply"] == "error")
                {
-                  case "error" :
-                     thisPageAdmin.util.messageDialogue(data["error_message"])
-                     break
-                  case "ok" :
-                     // obsolète : plus besoin
-                     /* thisPageAdmin.majIPs() */ 
-                     break 
+                  thisPageAdmin.util.messageDialogue(data["error_message"])
                }
             }
       }
    )
 }
-
+
+/**
+  * Attente d'événement de la part du serveur.
+  */
 PageAdmin.prototype.waitEvent = function()
 {
    var thisPageAdmin = this
@@ -271,7 +293,9 @@ PageAdmin.prototype.waitEvent = function()
 
 ///////////////////////////////////////////////////////////////////////////////////////////////////
 
-
+/**
+  * Représente un troll, pas grand chose finalement.
+  */
 function Troll(content, author)
 {
    this.content = content
-- 
2.43.0