js/pageMinichat/conversations.js

   1 // coding: utf-8
   2 // Copyright 2008 Grégory Burri
   3 //
   4 // This file is part of Euphorik.
   5 //
   6 // Euphorik is free software: you can redistribute it and/or modify
   7 // it under the terms of the GNU General Public License as published by
   8 // the Free Software Foundation, either version 3 of the License, or
   9 // (at your option) any later version.
  10 //
  11 // Euphorik is distributed in the hope that it will be useful,
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 // GNU General Public License for more details.
  15 //
  16 // You should have received a copy of the GNU General Public License
  17 // along with Euphorik.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 /**
  20   * Représente l'ensemble des conversations affichés.
  21   */
  22 function Conversations(client, formateur, util)
  23 {
  24    this.client = client
  25    this.formateur = formateur
  26    this.util = util
  27
  28    // un ensemble des messages (id) auquel l'utilisateur répond (vider après l'envoie du message courant)
  29    this.messagesRepond = {}
  30
  31    this.conversations = new Array() // les conversations, la première représente la conversation principale
  32
  33    this.nouvelleConversation(0)
  34
  35    this.trollIdCourant = 0
  36
  37    this.pageEvent = new euphorik.PageEvent("chat", this.util)
  38 }
  39
  40 // les messages insérés dans le document XHTML on leur id prefixé par cette valeur
  41 // cela permet de les distinguer des "vrais" messages
  42 Conversations.prototype.prefixIdMessage = "rep"
  43
  44 /**
  45   * Permet de définir un message comme étant ou n'étant plus un message auquel l'utilisateur
  46   * répond.
  47   */
  48 Conversations.prototype.toggleMessageRepond = function(mess)
  49 {
  50    // est-ce que l'on répond déjà à ce message ? si oui alors on l'enlève de la liste
  51    if (mess.id in this.messagesRepond)
  52    {
  53       this.enleverMessageRepond(mess)
  54       return
  55    }
  56
  57    this.ajouterMessageRepond(mess)
  58 }
  59
  60 /**
  61   * Enlève tous les messages auquel l'utilisateur souhaite répond.
  62   */
  63 Conversations.prototype.enleverMessagesRepond = function()
  64 {
  65    for (var messId in this.messagesRepond)
  66       this.enleverMessageRepond(this.messagesRepond[messId])
  67
  68    // on réinitialise pour être sur que tout est bien enlevé
  69    this.messagesRepond = {}
  70    $("#conversations .message").removeClass("repondEnEvidence")
  71    $("form#posterMessage #repondA .messages").empty()
  72 }
  73
  74 /**
  75   * Définit un message comme n'y répondant plus.
  76   */
  77 Conversations.prototype.enleverMessageRepond = function(mess)
  78 {
  79    $(this.exprIdsPotentiels(mess)).removeClass("repondEnEvidence")
  80    $("#" + mess.getId(this.prefixIdMessage)).remove()
  81    delete this.messagesRepond[mess.id]
  82    this.rafraichireNombreMessagesRepond()
  83 }
  84
  85 /**
  86   * Définit un message comme y répondant.
  87   */
  88 Conversations.prototype.ajouterMessageRepond = function(mess)
  89 {
  90    var thisMessages = this
  91
  92    // est-ce que le message fait partie de la même conversation que les autres messages ?
  93    // TODO : solution plus élégante pour prendre un mess parmis messagesRepond !?
  94    var mess2
  95    for(mess2 in this.messagesRepond){ break; }
  96    mess2 = this.messagesRepond[mess2]
  97
  98    if (mess2 != undefined && mess2.racineId != mess.racineId)
  99    {
 100       this.util.messageDialogue("Impossible de répondre à deux messages ne faisant pas partie de la même conversation")
 101       return
 102    }
 103
 104    $("form#posterMessage #repondA .messages").append(mess.XHTML(undefined, this.prefixIdMessage))
 105    this.messagesRepond[mess.id] = mess
 106
 107    // ajout la classe 'repondEnEvidence' au message. comme il peut se trouver potentiellement dans
 108    // chaque conversation on construit tous les id potentiels
 109    $(mess.getId(this.prefixIdMessage) + ", " + this.exprIdsPotentiels(mess)).addClass("repondEnEvidence")
 110
 111    $("#" + mess.getId(this.prefixIdMessage)).click(
 112       function()
 113       {
 114          $(this).fadeOut("normal", function(){
 115             thisMessages.enleverMessageRepond(mess)
 116             $("form#posterMessage #repondA .messages").hide()
 117          })
 118       }
 119    )
 120    this.rafraichireNombreMessagesRepond()
 121 }
 122
 123 /**
 124   * Construit tous les id potentiels d'un message, renvoie par exemple :
 125   * "conv9b28mess1h, conv9b2amess1h, conv9b32mess1h"
 126   */
 127 Conversations.prototype.exprIdsPotentiels = function(mess)
 128 {
 129    var exprMess = ""
 130    for(var i = 0; i < this.conversations.length; i++)
 131    {
 132       exprMess += (mess != "" ? ", " : "") + "#" + mess.getId(this.conversations[i].getId())
 133    }
 134    return exprMess
 135 }
 136
 137 /**
 138   * Met à jour le nombre qui indique à l'utilisateur à combien de messages il répond.
 139   */
 140 Conversations.prototype.rafraichireNombreMessagesRepond = function()
 141 {
 142    // TODO : ya pas mieux pour trouver le nombre d'objet ?
 143    var nb = 0
 144    for (var m in this.messagesRepond)
 145       nb += 1
 146    $("#posterMessage #repondA .nb").text(nb)
 147
 148    var boite = $("#posterMessage #repondA")
 149    if (nb > 0) boite.show()
 150    else boite.hide()
 151 }
 152
 153 /**
 154   * Affiche les messages auquel l'utilisateur souhaite répondre au sein des messages des conversations.
 155   * Utilisé lorsqu'une conversation est extraite.
 156   */
 157 Conversations.prototype.afficherMessagesRepondConversations = function()
 158 {
 159    var expr = ""
 160    for(var messId in this.messagesRepond)
 161       expr += "#" + this.messagesRepond[messId].getId() + ","
 162    $(expr).addClass("repondEnEvidence")
 163 }
 164
 165 /**
 166   * Crée un message JSON contenant le message demandant un rafraichissement.
 167   */
 168 Conversations.prototype.getJSONrafraichirMessages = function()
 169 {
 170    var mess =  {
 171       "message_count" : euphorik.conf.nbMessageAffiche,
 172       "main_page" : this.client.pagePrincipale,
 173       "conversations" : this.getJSONConversations(),
 174       "troll_id" : this.trollIdCourant
 175    }
 176
 177    if (this.client.cookie != null) mess["cookie"] = this.client.cookie
 178    mess["last_message_id"] = this.conversations[0].idDernierMessageAffiche
 179
 180    return mess
 181 }
 182
 183 Conversations.prototype.getJSONConversations = function()
 184 {
 185    var clientConv = []
 186
 187    for (var i = 0; i < this.client.conversations.length; i++)
 188    {
 189       clientConv.push(
 190          {
 191             root : this.client.conversations[i].root,
 192             page : this.client.conversations[i].page,
 193             last_message_id : this.conversations[i + 1] == undefined ? 0 : this.conversations[i + 1].idDernierMessageAffiche
 194          }
 195       )
 196    }
 197    return clientConv
 198 }
 199
 200 /**
 201   * Ajoute un ensemble de messages puis les affiches.
 202   * @param elements un tableau d'éléments JSON représentant les messages, voir protocole.txt
 203   * @param numConversation le numéro de la conversation auquel appartiennent les messages
 204   * @return true si les messages on été ajoutés, false si la conversation n'existe pas et qu'il n'y a pas de message
 205   */
 206 Conversations.prototype.ajouterMessages = function(elements, numConversation)
 207 {
 208    if (elements["messages"].length == 0)
 209       return this.conversations[numConversation] != undefined
 210
 211    for (var i = 0; i < elements["messages"].length; i++)
 212       // si une nouvelle conversation a été créée alors on lui donne la racine
 213       if(this.ajouterMessage(elements["messages"][i], numConversation))
 214          this.conversations[numConversation].setRacine(elements["first"])
 215
 216    this.flush(numConversation)
 217
 218    // renseigne la conversation sur la page courante et si c'est la dernière
 219    this.conversations[numConversation].setPage(
 220       numConversation == 0 ? this.client.pagePrincipale : this.client.conversations[numConversation - 1].page,
 221       elements["last_page"]
 222    )
 223
 224    return true
 225 }
 226
 227 /**
 228   * Création d'un nouveau message.
 229   * Les message sont données dans l'ordre de leur id.
 230   * @param element un element JSON représentant le message
 231   * @param numConversation le numéro de la conversation, 0 = principale
 232   * @return true si une nouvelle conversation a été créée sinon false
 233   */
 234 Conversations.prototype.ajouterMessage = function(element, numConversation)
 235 {
 236    var thisMessages = this
 237
 238    // pas d'utilisation de jquery pour des raisons de performance
 239    var message = new Message(
 240       this.client,
 241       this.formateur,
 242       element
 243    )
 244
 245    var nouvelleConversation = false
 246
 247    if (this.conversations[numConversation] == null)
 248    {
 249       nouvelleConversation = true
 250       this.nouvelleConversation(
 251          numConversation,
 252          function(num) // fermeture de la conversation
 253          {
 254             thisMessages.supprimerConversation(num)
 255          },
 256          function(num) // insertion du lien vers la conversation
 257          {
 258                thisPage.util.replaceSelection(
 259                   $("form#posterMessage input.message")[0],
 260                   "{" + thisMessages.client.conversations[num-1].root.toString(36) + "}"
 261                )
 262          }
 263       )
 264    }
 265
 266    this.conversations[numConversation].ajouterMessage(message)
 267    return nouvelleConversation
 268 }
 269
 270 Conversations.prototype.nouvelleConversation = function(num, funFermer, funLien)
 271 {
 272    var thisMessages = this
 273
 274    this.conversations[num] = new Conversation(this, num)
 275
 276    if (funFermer != undefined)
 277       this.conversations[num].eventFermer(funFermer)
 278    if (funLien != undefined)
 279       this.conversations[num].eventLien(funLien)
 280
 281    this.conversations[num].setFunPage(
 282       function(num) // page suivante
 283       {
 284          thisMessages.client.pageSuivante(num - 1)
 285          thisMessages.rafraichirMessages(true)
 286       },
 287       function(num) // page précédente
 288       {
 289          thisMessages.client.pagePrecedente(num - 1)
 290          thisMessages.rafraichirMessages(true)
 291       },
 292       function(num) // retour à la page une
 293       {
 294          if (thisMessages.client.goPremierePage(num - 1))
 295             thisMessages.rafraichirMessages(true)
 296       }
 297    )
 298
 299    this.ajusterLargeurConversations()
 300 }
 301
 302 /**
 303   * Enlève une conversation.
 304   */
 305 Conversations.prototype.supprimerConversation = function(num)
 306 {
 307    if (num <= 0 || num >= this.conversations.length) return // la numéro 0 ne peut être supprimé
 308    this.conversations[num].supprimer()
 309
 310    // décalage TODO : supprimer le dernier élément
 311    for (var i = num; i < this.conversations.length - 1; i++)
 312    {
 313       this.conversations[i] = this.conversations[i+1]
 314       this.conversations[i].num -= 1
 315    }
 316    this.conversations.pop()
 317    this.ajusterLargeurConversations()
 318
 319    this.client.supprimerConversation(num-1)
 320
 321    this.rafraichirMessages(true)
 322 }
 323
 324 /**
 325   * Ajuste la largeur des conversations en fonction de leur nombre. modifie l'attribut CSS 'width'.
 326   */
 327 Conversations.prototype.ajusterLargeurConversations = function()
 328 {
 329    // TODO : trouver mieux !
 330    var largeurPourcent = (100 / this.conversations.length)
 331    // obsolète !?
 332    // le "- 0.01" evite que IE se chie dessus lamentablement et affiche les conversations les unes au dessus des autres
 333    //if($.browser["msie"])
 334    //    largeurPourcent -= 0.05
 335    $("#conversations td").css("width", largeurPourcent + "%")
 336 }
 337
 338 /**
 339   * Demande à toutes les conversations de se flusher (afficher les messages non-affichés).
 340   */
 341 Conversations.prototype.flushAll = function()
 342 {
 343    for (var i = 0; i < this.conversations.length; i++)
 344       this.flush(i)
 345 }
 346
 347 /**
 348   * Demande à une conversation de se flusher.
 349   */
 350 Conversations.prototype.flush = function(numConv)
 351 {
 352    this.conversations[numConv].flush()
 353 }
 354
 355 Conversations.prototype.ouvrirConversation = function(racine)
 356 {
 357    if (this.client.ajouterConversation(racine))
 358       this.rafraichirMessages(true)
 359    else
 360       this.util.messageDialogue("Cette conversation est déjà ouverte")
 361 }
 362
 363 Conversations.prototype.viderMessages = function()
 364 {
 365    for (var i = 0; i < this.conversations.length; i++)
 366       this.conversations[i].viderMessages()
 367 }
 368
 369 /**
 370   * Met à jour les messages de manière continue.
 371   * (AJAX-Comet-style proof)
 372   * @param vider vide tous les messages avant d'afficher les nouveaux
 373   */
 374 Conversations.prototype.rafraichirMessages = function(vider)
 375 {
 376    var thisMessages = this
 377
 378    if (vider == undefined)
 379       vider = false
 380
 381    if (vider)
 382       for (var i = 0; i < this.conversations.length; i++)
 383          this.conversations[i].idDernierMessageAffiche = 0
 384
 385    this.pageEvent.waitEvent(
 386       function() { return thisMessages.getJSONrafraichirMessages() },
 387       {
 388          "new_troll" :
 389             function(data)
 390             {
 391                thisMessages.trollIdCourant = data["troll_id"]
 392                $("#trollCourant .troll").html(thisMessages.formateur.traitementComplet(data["content"])).unbind("click").click(
 393                   function()
 394                   {
 395                      thisMessages.ouvrirConversation(data["message_id"])
 396                   }
 397                )
 398
 399                $("#trollCourant .troll a[@rel*=lightbox]").lightBox()
 400             },
 401          "new_messages" :
 402             function(data)
 403             {
 404                if (vider)
 405                   thisMessages.viderMessages()
 406                // ajoute les messages reçus à leur conversation respective
 407                for (var numConv = 0; numConv < data["conversations"].length; numConv++)
 408                {
 409                   if (!thisMessages.ajouterMessages(data["conversations"][numConv], numConv))
 410                   {
 411                      thisMessages.util.messageDialogue("La conversation {" + thisMessages.client.conversations[numConv -1].root.toString(36) + "} n'existe pas")
 412                      thisMessages.client.supprimerConversation(numConv - 1)
 413                   }
 414                }
 415                if (vider)
 416                   thisMessages.afficherMessagesRepondConversations()
 417                vider = false
 418             }
 419       }
 420    )
 421 }