/*jslint laxbreak:true */\r
\r
/**\r
- * Représente l'utilisateur du site.\r
+ * Object that represents the user.\r
+ * It carries all the user data like\r
+ * - ID\r
+ * - Nick\r
+ * - E-Mail\r
+ * - etc..\r
+ * It can access directly to the DOM if needed. Some examples :\r
+ * - Changes the menu if the user is logged or not\r
+ * - Changes the logo if the user is an ek master\r
+ * - etc..\r
+ * @util See util.js.\r
+ * @communication See communication.js.\r
*/\r
euphorik.Client = function(util, communication) {\r
this.util = util;\r
- this.communication = communication\r
+ this.communication = communication;\r
\r
this.cookie = null;\r
- this.regexCookie = /^cookie=([^;]*)/;\r
+ this.regexCookie = /cookie=([^;]*)/;\r
\r
- // données personnels\r
- this.resetDonneesPersonnelles();\r
+ this.resetPersonalData();\r
\r
- this.setStatut(euphorik.Client.statutType.deconnected);\r
+ this.setStatus(euphorik.Client.statusType.disconnected);\r
\r
- // si true alors chaque modification du client est mémorisé sur le serveur\r
+ // If true then each data change is flushed to the server.\r
+ // Active only for opera which doesn't support the unload event.\r
this.autoflush = $.browser.opera;\r
};\r
\r
-// les statuts possibes du client\r
-euphorik.Client.statutType = {\r
- // mode enregistré, peut poster des messages et modifier son profile\r
+// The three status of a client.\r
+euphorik.Client.statusType = {\r
+ // authentified and registered : The user can post messages and can modify his profile\r
auth_registered : 0,\r
- // mode identifié, peut poster des messages mais n'a pas accès au profile\r
+ // authentified but not registered : The user can only post messages\r
auth_not_registered : 1,\r
- // mode déconnecté, ne peut pas poster de message\r
- deconnected : 2\r
+ // disconnected (the initial state) : The user cannot post message\r
+ disconnected : 2\r
};\r
\r
-euphorik.Client.prototype.resetDonneesPersonnelles = function() {\r
+/**\r
+ * Reset all the local personal data. Does not erase the remote data.\r
+ * This function is used during disconnecting.\r
+ */\r
+euphorik.Client.prototype.resetPersonalData = function() {\r
this.id = 0;\r
- this.pseudo = euphorik.conf.pseudoDefaut;\r
+ this.nick = euphorik.conf.defaultNick;\r
this.login = "";\r
this.password = "";\r
this.email = "";\r
- this.css = $("link#cssPrincipale").attr("href");\r
+ this.css = $("link#mainCss").attr("href");\r
this.chatOrder = "reverse";\r
this.nickFormat = "nick";\r
this.viewTimes = true;\r
this.viewTooltips = true;\r
this.cookie = undefined;\r
\r
- this.pagePrincipale = 1;\r
+ this.mainConversationPage = 1;\r
this.ekMaster = false;\r
this.ostentatiousMaster = "light";\r
- \r
- // les conversations, une conversation est un objet possédant les propriétés suivantes :\r
- // - root (entier)\r
- // - page (entier)\r
- // - reduit (bool)\r
+ \r
+ // The user opened conversations.\r
+ // Each conversation object owns theses properties :\r
+ // - root (integer)\r
+ // - page (integer)\r
+ // - isCollapsed (bool)\r
this.conversations = [];\r
};\r
\r
+/**\r
+ * Set the CSS. Dynamically change the href to the CSS in the DOM.\r
+ * @css The relative path to the CSS file, for example :\r
+ * "styles/1/euphorik.css".\r
+ */\r
euphorik.Client.prototype.setCss = function(css) {\r
if (this.css === css || !css) {\r
return;\r
}\r
\r
this.css = css;\r
- $("link#cssPrincipale").attr("href", this.css);\r
+ $("link#mainCss").attr("href", this.css);\r
+ \r
if (this.autoflush) {\r
this.flush(true);\r
}\r
};\r
\r
-euphorik.Client.prototype.pageSuivante = function(numConv) {\r
- if (numConv < 0 && this.pagePrincipale > 1) {\r
- this.pagePrincipale -= 1;\r
+/**\r
+ * Change the current page to the next one for the given conversation.\r
+ * @numConv The number of the conversation.\r
+ */\r
+euphorik.Client.prototype.nextPage = function(numConv) {\r
+ if (numConv < 0 && this.mainConversationPage > 1) {\r
+ this.mainConversationPage -= 1;\r
} else if (this.conversations[numConv].page > 1) {\r
this.conversations[numConv].page -= 1;\r
}\r
};\r
\r
-euphorik.Client.prototype.pagePrecedente = function(numConv) {\r
+/**\r
+ * Change the current page to the previous one for the given conversation.\r
+ * @numConv The number of the conversation.\r
+ */\r
+euphorik.Client.prototype.previousPage = function(numConv) {\r
if (numConv < 0) {\r
- this.pagePrincipale += 1;\r
+ this.mainConversationPage += 1;\r
} else {\r
this.conversations[numConv].page += 1;\r
}\r
* Définit la première page pour la conversation donnée.\r
* @return true si la page a changé sinon false\r
*/\r
-euphorik.Client.prototype.goPremierePage = function(numConv)\r
+euphorik.Client.prototype.goFirstPage = function(numConv)\r
{\r
if (numConv < 0) {\r
- if (this.pagePrincipale === 1) {\r
+ if (this.mainConversationPage === 1) {\r
return false;\r
}\r
- this.pagePrincipale = 1;\r
+ this.mainConversationPage = 1;\r
} else {\r
if (this.conversations[numConv].page === 1) {\r
return false;\r
return false;\r
}\r
\r
- this.conversations.push({root : racine, page : 1, reduit : false});\r
+ this.conversations.push({root : racine, page : 1, isCollapsed : false});\r
if (this.autoflush) {\r
this.flush(true);\r
}\r
euphorik.Client.prototype.getJSONConversations = function() {\r
var conversations = [];\r
this.conversations.each(function(i, conv) {\r
- conversations.push({ "root" : conv.root, "minimized" : conv.reduit });\r
+ conversations.push({ "root" : conv.root, "minimized" : conv.isCollapsed });\r
});\r
return conversations;\r
};\r
\r
euphorik.Client.prototype.getJSONProfileInfos = function() {\r
return {\r
- "nick" : this.pseudo,\r
+ "nick" : this.nick,\r
"email" : this.email,\r
"css" : this.css,\r
"chat_order" : this.chatOrder,\r
return;\r
}\r
\r
- // ne fonctionne pas sous IE....\r
+ // doesn't work under IE....\r
/*document.cookie = "cookie=" + this.cookie + "; max-age=" + (60 * 60 * 24 * 365) */\r
\r
document.cookie = \r
};\r
\r
euphorik.Client.prototype.authentifie = function() {\r
- return this.statut === euphorik.Client.statutType.auth_registered || this.statut === euphorik.Client.statutType.auth_not_registered;\r
+ return this.statut === euphorik.Client.statusType.auth_registered || this.statut === euphorik.Client.statusType.auth_not_registered;\r
};\r
\r
-euphorik.Client.prototype.setStatut = function(statut)\r
+euphorik.Client.prototype.setStatus = function(statut)\r
{ \r
// conversation en "enum" si en "string"\r
if (typeof(statut) === "string") {\r
statut =\r
statut === "auth_registered" ?\r
- euphorik.Client.statutType.auth_registered :\r
- (statut === "auth_not_registered" ? euphorik.Client.statutType.auth_not_registered : euphorik.Client.statutType.deconnected);\r
+ euphorik.Client.statusType.auth_registered :\r
+ (statut === "auth_not_registered" ? euphorik.Client.statusType.auth_not_registered : euphorik.Client.statusType.disconnected);\r
}\r
\r
if (statut === this.statut) {\r
this.majMenu();\r
this.majLogo();\r
};\r
-\r
-/**\r
- * Effectue la connexion vers le serveur.\r
- * Cette fonction est bloquante tant que la connexion n'a pas été établie.\r
- * S'il existe un cookie en local on s'authentifie directement avec lui.\r
- * Si il n'est pas possible de s'authentifier alors on affiche un captcha anti-bot.\r
+
+/**
+ * Try to authentify the client with the cookie information.
+ * Do nothing if there is no cookie.
*/\r
-euphorik.Client.prototype.connexionCookie = function() {\r
+euphorik.Client.prototype.connectionCookie = function() {\r
this.getCookie();\r
if (!this.cookie) {\r
return false;\r
this.login = login;\r
this.password = password;\r
if(this.flush()) {\r
- this.setStatut(euphorik.Client.statutType.auth_registered);\r
+ this.setStatus(euphorik.Client.statusType.auth_registered);\r
return true;\r
}\r
return false;\r
};\r
\r
/**\r
- * Connexion. Réalisée de manière synchrone.\r
+ * Connexion. Réalisé de manière synchrone.\r
*/\r
euphorik.Client.prototype.connexion = function(action, messageJson) {\r
var thisClient = this;\r
thisClient.chargerDonnees(data);\r
},\r
function(data) {\r
- thisClient.util.messageDialogue(data.error_message);\r
+ thisClient.util.messageDialog(data.error_message);\r
thisClient.delCookie(); // suppression du cookie actuel, cas où le cookie du client ne permet pas une authentification\r
},\r
false\r
return this.authentifie();\r
};\r
\r
-euphorik.Client.prototype.deconnexion = function() {\r
+euphorik.Client.prototype.disconnect = function() {\r
this.flush(true);\r
this.delCookie();\r
- this.resetDonneesPersonnelles();\r
- this.setStatut(euphorik.Client.statutType.deconnected); // deconnexion\r
+ this.resetPersonalData();\r
+ this.setStatus(euphorik.Client.statusType.disconnected);\r
};\r
\r
euphorik.Client.prototype.chargerDonnees = function(data) {\r
// de l'état ekMaster\r
this.ekMaster = data.ek_master ? data.ek_master : false;\r
\r
- this.setStatut(data.status);\r
+ this.setStatus(data.status);\r
\r
if (this.authentifie()) {\r
this.cookie = data.cookie;\r
\r
this.id = data.id;\r
this.login = data.login;\r
- this.pseudo = data.profile.nick;\r
+ this.nick = data.profile.nick;\r
this.email = data.profile.email;\r
this.setCss(data.profile.css);\r
this.chatOrder = data.profile.chat_order;\r
this.ostentatiousMaster = data.profile.ostentatious_master;\r
\r
// la page de la conversation principale\r
- this.pagePrincipale = 1;\r
+ this.mainConversationPage = 1;\r
\r
// les conversations\r
this.conversations = data.profile.conversations;\r
this.conversations.map(function(conv) {\r
- return { root : conv.root, page : 1, reduit : conv.minimized };\r
+ return { root : conv.root, page : 1, isCollapsed : conv.minimized };\r
});\r
\r
this.majBulle();\r
if (!this.authentifie()) {\r
return false;\r
}\r
-\r
+ \r
var thisClient = this;\r
var ok = true;\r
\r
thisClient.majBulle(); \r
},\r
function(data) {\r
- thisClient.util.messageDialogue(data.error_message);\r
+ thisClient.util.messageDialog(data.error_message);\r
ok = false;\r
},\r
async\r
$("#menu .admin").css("display", this.ekMaster ? displayType : "none");\r
\r
// met à jour le menu \r
- if (this.statut === euphorik.Client.statutType.auth_registered) {\r
+ if (this.statut === euphorik.Client.statusType.auth_registered) {\r
$("#menu .profile").css("display", displayType).text("profile");\r
$("#menu .logout").css("display", displayType);\r
$("#menu .register").css("display", "none");\r
- } else if (this.statut === euphorik.Client.statutType.auth_not_registered) {\r
+ } else if (this.statut === euphorik.Client.statusType.auth_not_registered) {\r
$("#menu .profile").css("display", "none");\r
$("#menu .logout").css("display", displayType);\r
$("#menu .register").css("display", displayType);\r