euphorik.Client = function(util, communication) {\r
this.util = util;\r
this.communication = communication;\r
- \r
+\r
this.cookie = null;\r
this.regexCookie = /cookie=([^;]*)/;\r
- \r
+\r
this.resetPersonalData();\r
- \r
+\r
this.setStatus(euphorik.Client.statusType.disconnected);\r
- \r
+\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
// 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
+ // Authentified and registered : The user can post messages and can modify his profile.\r
auth_registered : 0,\r
- // authentified but not registered : The user can only post messages\r
+ // Authentified but not registered : The user can only post messages.\r
auth_not_registered : 1,\r
- // disconnected (the initial state) : The user cannot post message\r
+ // Disconnected (the initial state) : The user cannot post message.\r
disconnected : 2\r
};\r
\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.nick = euphorik.conf.defaultNick;\r
this.viewTimes = true;\r
this.viewTooltips = true;\r
this.cookie = undefined;\r
- \r
+\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
this.css = 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
+/**\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
}\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.mainConversationPage += 1;\r
} else {\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
-{\r
+euphorik.Client.prototype.goFirstPage = function(numConv) {\r
if (numConv < 0) {\r
if (this.mainConversationPage === 1) {\r
return false;\r
* @return true si la conversation a été créée sinon false (par exemple si la conv existe déjà)\r
*/\r
euphorik.Client.prototype.ajouterConversation = function(racine) {\r
- // vérification s'il elle n'existe pas déjà \r
+ // vérification s'il elle n'existe pas déjà\r
var existe = false;\r
this.conversations.each(function(i, conv) {\r
if (conv.root === racine) {\r
if (existe) {\r
return false;\r
}\r
- \r
- this.conversations.push({root : racine, page : 1, reduit : false});\r
+\r
+ this.conversations.push({root : racine, page : 1, isCollapsed : false});\r
if (this.autoflush) {\r
this.flush(true);\r
}\r
- \r
+\r
return true;\r
};\r
\r
if (num < 0 || num >= this.conversations.length) {\r
return;\r
}\r
- \r
- // décalage TODO : supprimer le dernier élément \r
+\r
+ // décalage TODO : supprimer le dernier élément\r
for (var i = num; i < this.conversations.length - 1; i++) {\r
this.conversations[i] = this.conversations[i+1];\r
}\r
this.conversations.pop();\r
- \r
+\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
if (!this.cookie) {\r
return;\r
}\r
- \r
+\r
// doesn't work under IE....\r
/*document.cookie = "cookie=" + this.cookie + "; max-age=" + (60 * 60 * 24 * 365) */\r
- \r
- document.cookie = \r
+\r
+ document.cookie =\r
"cookie="+this.cookie+"; expires=" + new Date(new Date().getTime() + 1000 * 60 * 60 * 24 * 365).toUTCString();\r
};\r
\r
};\r
\r
euphorik.Client.prototype.setStatus = function(statut)\r
-{ \r
+{\r
// conversation en "enum" si en "string"\r
if (typeof(statut) === "string") {\r
statut =\r
euphorik.Client.statusType.auth_registered :\r
(statut === "auth_not_registered" ? euphorik.Client.statusType.auth_not_registered : euphorik.Client.statusType.disconnected);\r
}\r
- \r
+\r
if (statut === this.statut) {\r
return;\r
}\r
- \r
+\r
this.statut = statut;\r
- \r
+\r
this.majMenu();\r
this.majLogo();\r
};\r
-
-/**
- * Try to authentify the client with the cookie information.
- * Do nothing if there is no cookie.
+\r
+/**\r
+ * Try to authentify the client with the cookie information.\r
+ * Do nothing if there is no cookie.\r
*/\r
euphorik.Client.prototype.connectionCookie = function() {\r
this.getCookie();\r
return this.connexion("authentification", {"login" : login, "password" : password });\r
};\r
\r
-euphorik.Client.prototype.enregistrement = function(login, password) { \r
+euphorik.Client.prototype.enregistrement = function(login, password) {\r
if (this.authentifie()) {\r
this.login = login;\r
this.password = password;\r
*/\r
euphorik.Client.prototype.getJSONEnregistrement = function(login, password) {\r
var mess = {};\r
- \r
+\r
if (login && password) {\r
mess.login = login;\r
mess.password = password;\r
}\r
- \r
+\r
mess.profile = this.getJSONProfileInfos();\r
- \r
+\r
return mess;\r
};\r
\r
*/\r
euphorik.Client.prototype.connexion = function(action, messageJson) {\r
var thisClient = this;\r
- \r
+\r
this.communication.requete(\r
action,\r
messageJson,\r
// la modification du statut qui suit met à jour le menu, le menu dépend (page admin)\r
// de l'état ekMaster\r
this.ekMaster = data.ek_master ? data.ek_master : false;\r
- \r
+\r
this.setStatus(data.status);\r
- \r
+\r
if (this.authentifie()) {\r
this.cookie = data.cookie;\r
this.setCookie();\r
- \r
+\r
this.id = data.id;\r
this.login = data.login;\r
this.nick = data.profile.nick;\r
this.viewTimes = data.profile.view_times;\r
this.viewTooltips = data.profile.view_tooltips;\r
this.ostentatiousMaster = data.profile.ostentatious_master;\r
- \r
+\r
// la page de la conversation principale\r
this.mainConversationPage = 1;\r
- \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
+\r
this.majBulle();\r
this.majCssSelectionee();\r
}\r
*/\r
euphorik.Client.prototype.flush = function(async) {\r
async = async || false;\r
- \r
+\r
if (!this.authentifie()) {\r
return false;\r
}\r
- \r
+\r
var thisClient = this;\r
var ok = true;\r
- \r
+\r
this.communication.requete(\r
"set_profile",\r
this.getJSONProfile(),\r
function(data) {\r
- thisClient.majBulle(); \r
+ thisClient.majBulle();\r
},\r
function(data) {\r
thisClient.util.messageDialog(data.error_message);\r
},\r
async\r
);\r
- \r
+\r
return ok;\r
};\r
\r
var displayType = "block";\r
\r
$("#menu .admin").css("display", this.ekMaster ? displayType : "none");\r
- \r
- // met à jour le menu \r
+\r
+ // met à jour le menu\r
if (this.statut === euphorik.Client.statusType.auth_registered) {\r
$("#menu .profile").css("display", displayType).text("profile");\r
$("#menu .logout").css("display", displayType);\r