Add methods to trust, distrust, or untrust Sones and update trust controls.
[Sone.git] / src / main / resources / static / javascript / sone.js
1 /* Sone JavaScript functions. */
2
3 /* jQuery overrides. */
4 oldGetJson = jQuery.prototype.getJSON;
5 jQuery.prototype.getJSON = function(url, data, successCallback, errorCallback) {
6         if (typeof errorCallback == "undefined") {
7                 return oldGetJson(url, data, successCallback);
8         }
9         if (jQuery.isFunction(data)) {
10                 errorCallback = successCallback;
11                 successCallback = data;
12                 data = null;
13         }
14         return jQuery.ajax({
15                 data: data,
16                 error: errorCallback,
17                 success: successCallback,
18                 url: url
19         });
20 }
21
22 function isOnline() {
23         return $("#sone").hasClass("online");
24 }
25
26 function registerInputTextareaSwap(inputElement, defaultText, inputFieldName, optional, dontUseTextarea) {
27         $(inputElement).each(function() {
28                 textarea = $(dontUseTextarea ? "<input type=\"text\" name=\"" + inputFieldName + "\">" : "<textarea name=\"" + inputFieldName + "\"></textarea>").blur(function() {
29                         if ($(this).val() == "") {
30                                 $(this).hide();
31                                 inputField = $(this).data("inputField");
32                                 inputField.show().removeAttr("disabled").addClass("default");
33                                 inputField.val(defaultText);
34                         }
35                 }).hide().data("inputField", $(this)).val($(this).val());
36                 $(this).after(textarea);
37                 (function(inputField, textarea) {
38                         inputField.focus(function() {
39                                 $(this).hide().attr("disabled", "disabled");
40                                 textarea.show().focus();
41                         });
42                         if (inputField.val() == "") {
43                                 inputField.addClass("default");
44                                 inputField.val(defaultText);
45                         } else {
46                                 inputField.hide().attr("disabled", "disabled");
47                                 textarea.show();
48                         }
49                         $(inputField.get(0).form).submit(function() {
50                                 if (!optional && (textarea.val() == "")) {
51                                         return false;
52                                 }
53                         });
54                 })($(this), textarea);
55         });
56 }
57
58 /**
59  * Adds a “comment” link to all status lines contained in the given element.
60  *
61  * @param postId
62  *            The ID of the post
63  * @param element
64  *            The element to add a “comment” link to
65  */
66 function addCommentLink(postId, element, insertAfterThisElement) {
67         if ($(element).find(".show-reply-form").length > 0) {
68                 return;
69         }
70         commentElement = (function(postId) {
71                 separator = $("<span> · </span>").addClass("separator");
72                 var commentElement = $("<div><span>Comment</span></div>").addClass("show-reply-form").click(function() {
73                         markPostAsKnown(getPostElement(this));
74                         replyElement = $("#sone .post#" + postId + " .create-reply");
75                         replyElement.removeClass("hidden");
76                         replyElement.removeClass("light");
77                         (function(replyElement) {
78                                 replyElement.find("input.reply-input").blur(function() {
79                                         if ($(this).hasClass("default")) {
80                                                 replyElement.addClass("light");
81                                         }
82                                 }).focus(function() {
83                                         replyElement.removeClass("light");
84                                 });
85                         })(replyElement);
86                         replyElement.find("input.reply-input").focus();
87                 });
88                 return commentElement;
89         })(postId);
90         $(insertAfterThisElement).after(commentElement.clone(true));
91         $(insertAfterThisElement).after(separator);
92 }
93
94 var translations = {};
95
96 /**
97  * Retrieves the translation for the given key and calls the callback function.
98  * The callback function takes a single parameter, the translated string.
99  *
100  * @param key
101  *            The key of the translation string
102  * @param callback
103  *            The callback function
104  */
105 function getTranslation(key, callback) {
106         if (key in translations) {
107                 callback(translations[key]);
108                 return;
109         }
110         $.getJSON("getTranslation.ajax", {"key": key}, function(data, textStatus) {
111                 if ((data != null) && data.success) {
112                         translations[key] = data.value;
113                         callback(data.value);
114                 }
115         }, function(xmlHttpRequest, textStatus, error) {
116                 /* ignore error. */
117         });
118 }
119
120 /**
121  * Filters the given Sone ID, replacing all “~” characters by an underscore.
122  *
123  * @param soneId
124  *            The Sone ID to filter
125  * @returns The filtered Sone ID
126  */
127 function filterSoneId(soneId) {
128         return soneId.replace(/[^a-zA-Z0-9-]/g, "_");
129 }
130
131 /**
132  * Updates the status of the given Sone.
133  *
134  * @param soneId
135  *            The ID of the Sone to update
136  * @param status
137  *            The status of the Sone (“idle”, “unknown”, “inserting”,
138  *            “downloading”)
139  * @param modified
140  *            Whether the Sone is modified
141  * @param locked
142  *            Whether the Sone is locked
143  * @param lastUpdated
144  *            The date and time of the last update (formatted for display)
145  */
146 function updateSoneStatus(soneId, name, status, modified, locked, lastUpdated) {
147         $("#sone .sone." + filterSoneId(soneId)).
148                 toggleClass("unknown", status == "unknown").
149                 toggleClass("idle", status == "idle").
150                 toggleClass("inserting", status == "inserting").
151                 toggleClass("downloading", status == "downloading").
152                 toggleClass("modified", modified);
153         $("#sone .sone." + filterSoneId(soneId) + " .lock").toggleClass("hidden", locked);
154         $("#sone .sone." + filterSoneId(soneId) + " .unlock").toggleClass("hidden", !locked);
155         $("#sone .sone." + filterSoneId(soneId) + " .last-update span.time").text(lastUpdated);
156         $("#sone .sone." + filterSoneId(soneId) + " .profile-link a").text(name);
157 }
158
159 /**
160  * Enhances a “delete” button so that the confirmation is done on the same page.
161  *
162  * @param button
163  *            The button element
164  * @param text
165  *            The text to show on the button
166  * @param deleteCallback
167  *            The callback that actually deletes something
168  */
169 function enhanceDeleteButton(button, text, deleteCallback) {
170         (function(button) {
171                 newButton = $("<button></button>").addClass("confirm").hide().text(text).click(function() {
172                         $(this).fadeOut("slow");
173                         deleteCallback();
174                         return false;
175                 }).insertAfter(button);
176                 (function(button, newButton) {
177                         button.click(function() {
178                                 button.fadeOut("slow", function() {
179                                         newButton.fadeIn("slow");
180                                         $(document).one("click", function() {
181                                                 if (this != newButton.get(0)) {
182                                                         newButton.fadeOut(function() {
183                                                                 button.fadeIn();
184                                                         });
185                                                 }
186                                         });
187                                 });
188                                 return false;
189                         });
190                 })(button, newButton);
191         })($(button));
192 }
193
194 /**
195  * Enhances a post’s “delete” button.
196  *
197  * @param button
198  *            The button element
199  * @param postId
200  *            The ID of the post to delete
201  * @param text
202  *            The text to replace the button with
203  */
204 function enhanceDeletePostButton(button, postId, text) {
205         enhanceDeleteButton(button, text, function() {
206                 $.getJSON("deletePost.ajax", { "post": postId, "formPassword": getFormPassword() }, function(data, textStatus) {
207                         if (data == null) {
208                                 return;
209                         }
210                         if (data.success) {
211                                 $("#sone .post#" + postId).slideUp();
212                         } else if (data.error == "invalid-post-id") {
213                                 alert("Invalid post ID given!");
214                         } else if (data.error == "auth-required") {
215                                 alert("You need to be logged in.");
216                         } else if (data.error == "not-authorized") {
217                                 alert("You are not allowed to delete this post.");
218                         }
219                 }, function(xmlHttpRequest, textStatus, error) {
220                         /* ignore error. */
221                 });
222         });
223 }
224
225 /**
226  * Enhances a reply’s “delete” button.
227  *
228  * @param button
229  *            The button element
230  * @param replyId
231  *            The ID of the reply to delete
232  * @param text
233  *            The text to replace the button with
234  */
235 function enhanceDeleteReplyButton(button, replyId, text) {
236         enhanceDeleteButton(button, text, function() {
237                 $.getJSON("deleteReply.ajax", { "reply": replyId, "formPassword": $("#sone #formPassword").text() }, function(data, textStatus) {
238                         if (data == null) {
239                                 return;
240                         }
241                         if (data.success) {
242                                 $("#sone .reply#" + replyId).slideUp();
243                         } else if (data.error == "invalid-reply-id") {
244                                 alert("Invalid reply ID given!");
245                         } else if (data.error == "auth-required") {
246                                 alert("You need to be logged in.");
247                         } else if (data.error == "not-authorized") {
248                                 alert("You are not allowed to delete this reply.");
249                         }
250                 }, function(xmlHttpRequest, textStatus, error) {
251                         /* ignore error. */
252                 });
253         });
254 }
255
256 function getFormPassword() {
257         return $("#sone #formPassword").text();
258 }
259
260 function getSoneElement(element) {
261         return $(element).closest(".sone");
262 }
263
264 /**
265  * Generates a list of Sones by concatening the names of the given sones with a
266  * new line character (“\n”).
267  *
268  * @param sones
269  *            The sones to format
270  * @returns {String} The created string
271  */
272 function generateSoneList(sones) {
273         var soneList = "";
274         $.each(sones, function() {
275                 if (soneList != "") {
276                         soneList += ", ";
277                 }
278                 soneList += this.name;
279         });
280         return soneList;
281 }
282
283 /**
284  * Returns the ID of the Sone that this element belongs to.
285  *
286  * @param element
287  *            The element to locate the matching Sone ID for
288  * @returns The ID of the Sone, or undefined
289  */
290 function getSoneId(element) {
291         return getSoneElement(element).find(".id").text();
292 }
293
294 function getPostElement(element) {
295         return $(element).closest(".post");
296 }
297
298 function getPostId(element) {
299         return getPostElement(element).attr("id");
300 }
301
302 function getPostTime(element) {
303         return getPostElement(element).find(".post-time").text();
304 }
305
306 /**
307  * Returns the author of the post the given element belongs to.
308  *
309  * @param element
310  *            The element whose post to get the author for
311  * @returns The ID of the authoring Sone
312  */
313 function getPostAuthor(element) {
314         return getPostElement(element).find(".post-author").text();
315 }
316
317 function getReplyElement(element) {
318         return $(element).closest(".reply");
319 }
320
321 function getReplyId(element) {
322         return getReplyElement(element).attr("id");
323 }
324
325 function getReplyTime(element) {
326         return getReplyElement(element).find(".reply-time").text();
327 }
328
329 /**
330  * Returns the author of the reply the given element belongs to.
331  *
332  * @param element
333  *            The element whose reply to get the author for
334  * @returns The ID of the authoring Sone
335  */
336 function getReplyAuthor(element) {
337         return getReplyElement(element).find(".reply-author").text();
338 }
339
340 function likePost(postId) {
341         $.getJSON("like.ajax", { "type": "post", "post" : postId, "formPassword": getFormPassword() }, function(data, textStatus) {
342                 if ((data == null) || !data.success) {
343                         return;
344                 }
345                 $("#sone .post#" + postId + " > .inner-part > .status-line .like").addClass("hidden");
346                 $("#sone .post#" + postId + " > .inner-part > .status-line .unlike").removeClass("hidden");
347                 updatePostLikes(postId);
348         }, function(xmlHttpRequest, textStatus, error) {
349                 /* ignore error. */
350         });
351 }
352
353 function unlikePost(postId) {
354         $.getJSON("unlike.ajax", { "type": "post", "post" : postId, "formPassword": getFormPassword() }, function(data, textStatus) {
355                 if ((data == null) || !data.success) {
356                         return;
357                 }
358                 $("#sone .post#" + postId + " > .inner-part > .status-line .unlike").addClass("hidden");
359                 $("#sone .post#" + postId + " > .inner-part > .status-line .like").removeClass("hidden");
360                 updatePostLikes(postId);
361         }, function(xmlHttpRequest, textStatus, error) {
362                 /* ignore error. */
363         });
364 }
365
366 function updatePostLikes(postId) {
367         $.getJSON("getLikes.ajax", { "type": "post", "post": postId }, function(data, textStatus) {
368                 if ((data != null) && data.success) {
369                         $("#sone .post#" + postId + " > .inner-part > .status-line .likes").toggleClass("hidden", data.likes == 0)
370                         $("#sone .post#" + postId + " > .inner-part > .status-line .likes span.like-count").text(data.likes);
371                         $("#sone .post#" + postId + " > .inner-part > .status-line .likes > span").attr("title", generateSoneList(data.sones));
372                 }
373         }, function(xmlHttpRequest, textStatus, error) {
374                 /* ignore error. */
375         });
376 }
377
378 function likeReply(replyId) {
379         $.getJSON("like.ajax", { "type": "reply", "reply" : replyId, "formPassword": getFormPassword() }, function(data, textStatus) {
380                 if ((data == null) || !data.success) {
381                         return;
382                 }
383                 $("#sone .reply#" + replyId + " .status-line .like").addClass("hidden");
384                 $("#sone .reply#" + replyId + " .status-line .unlike").removeClass("hidden");
385                 updateReplyLikes(replyId);
386         }, function(xmlHttpRequest, textStatus, error) {
387                 /* ignore error. */
388         });
389 }
390
391 function unlikeReply(replyId) {
392         $.getJSON("unlike.ajax", { "type": "reply", "reply" : replyId, "formPassword": getFormPassword() }, function(data, textStatus) {
393                 if ((data == null) || !data.success) {
394                         return;
395                 }
396                 $("#sone .reply#" + replyId + " .status-line .unlike").addClass("hidden");
397                 $("#sone .reply#" + replyId + " .status-line .like").removeClass("hidden");
398                 updateReplyLikes(replyId);
399         }, function(xmlHttpRequest, textStatus, error) {
400                 /* ignore error. */
401         });
402 }
403
404 /**
405  * Trusts the Sone with the given ID.
406  *
407  * @param soneId
408  *            The ID of the Sone to trust
409  */
410 function trustSone(soneId) {
411         $.getJSON("trustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
412                 if ((data != null) && data.success) {
413                         updateTrustControls(soneId, data.trustValue);
414                 }
415         });
416 }
417
418 /**
419  * Distrusts the Sone with the given ID, i.e. assigns a negative trust value.
420  *
421  * @param soneId
422  *            The ID of the Sone to distrust
423  */
424 function distrustSone(soneId) {
425         $.getJSON("distrustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
426                 if ((data != null) && data.success) {
427                         updateTrustControls(soneId, data.trustValue);
428                 }
429         });
430 }
431
432 /**
433  * Untrusts the Sone with the given ID, i.e. removes any trust assignment.
434  *
435  * @param soneId
436  *            The ID of the Sone to untrust
437  */
438 function untrustSone(soneId) {
439         $.getJSON("untrustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
440                 if ((data != null) && data.success) {
441                         updateTrustControls(soneId, data.trustValue);
442                 }
443         });
444 }
445
446 /**
447  * Updates the trust controls for all posts and replies of the given Sone,
448  * according to the given trust value.
449  *
450  * @param soneId
451  *            The ID of the Sone to update all trust controls for
452  * @param trustValue
453  *            The trust value for the Sone
454  */
455 function updateTrustControls(soneId, trustValue) {
456         $("#sone .post").each(function() {
457                 if (getPostAuthor(this) == soneId) {
458                         getPostElement(this).find(".post-trust").toggleClass("hidden", trustValue != null);
459                         getPostElement(this).find(".post-distrust").toggleClass("hidden", (trustValue != null) && (trustValue < 0));
460                         getPostElement(this).find(".post-untrust").toggleClass("hidden", trustValue == null);
461                 }
462         });
463 }
464
465 function updateReplyLikes(replyId) {
466         $.getJSON("getLikes.ajax", { "type": "reply", "reply": replyId }, function(data, textStatus) {
467                 if ((data != null) && data.success) {
468                         $("#sone .reply#" + replyId + " .status-line .likes").toggleClass("hidden", data.likes == 0)
469                         $("#sone .reply#" + replyId + " .status-line .likes span.like-count").text(data.likes);
470                         $("#sone .reply#" + replyId + " .status-line .likes > span").attr("title", generateSoneList(data.sones));
471                 }
472         }, function(xmlHttpRequest, textStatus, error) {
473                 /* ignore error. */
474         });
475 }
476
477 /**
478  * Posts a reply and calls the given callback when the request finishes.
479  *
480  * @param postId
481  *            The ID of the post the reply refers to
482  * @param text
483  *            The text to post
484  * @param callbackFunction
485  *            The callback function to call when the request finishes (takes 3
486  *            parameters: success, error, replyId)
487  */
488 function postReply(postId, text, callbackFunction) {
489         $.getJSON("createReply.ajax", { "formPassword" : getFormPassword(), "post" : postId, "text": text }, function(data, textStatus) {
490                 if (data == null) {
491                         /* TODO - show error */
492                         return;
493                 }
494                 if (data.success) {
495                         callbackFunction(true, null, data.reply);
496                 } else {
497                         callbackFunction(false, data.error);
498                 }
499         }, function(xmlHttpRequest, textStatus, error) {
500                 /* ignore error. */
501         });
502 }
503
504 /**
505  * Requests information about the reply with the given ID.
506  *
507  * @param replyId
508  *            The ID of the reply
509  * @param callbackFunction
510  *            A callback function (parameters soneId, soneName, replyTime,
511  *            replyDisplayTime, text, html)
512  */
513 function getReply(replyId, callbackFunction) {
514         $.getJSON("getReply.ajax", { "reply" : replyId }, function(data, textStatus) {
515                 if ((data != null) && data.success) {
516                         callbackFunction(data.soneId, data.soneName, data.time, data.displayTime, data.text, data.html);
517                 }
518         }, function(xmlHttpRequest, textStatus, error) {
519                 /* ignore error. */
520         });
521 }
522
523 /**
524  * Ajaxifies the given post by enhancing all eligible elements with AJAX.
525  *
526  * @param postElement
527  *            The post element to ajaxify
528  */
529 function ajaxifyPost(postElement) {
530         $(postElement).find("form").submit(function() {
531                 return false;
532         });
533         $(postElement).find(".create-reply button:submit").click(function() {
534                 inputField = $(this.form).find(":input:enabled").get(0);
535                 postId = getPostId(this);
536                 text = $(inputField).val();
537                 (function(postId, text, inputField) {
538                         postReply(postId, text, function(success, error, replyId) {
539                                 if (success) {
540                                         $(inputField).val("");
541                                         loadNewReply(replyId);
542                                         markPostAsKnown(getPostElement(inputField));
543                                         $("#sone .post#" + postId + " .create-reply").addClass("hidden");
544                                 } else {
545                                         alert(error);
546                                 }
547                         });
548                 })(postId, text, inputField);
549                 return false;
550         });
551
552         /* replace all “delete” buttons with javascript. */
553         (function(postElement) {
554                 getTranslation("WebInterface.Confirmation.DeletePostButton", function(deletePostText) {
555                         postId = getPostId(postElement);
556                         enhanceDeletePostButton($(postElement).find(".delete-post button"), postId, deletePostText);
557                 });
558         })(postElement);
559
560         /* convert all “like” buttons to javascript functions. */
561         $(postElement).find(".like-post").submit(function() {
562                 likePost(getPostId(this));
563                 markPostAsKnown(getPostElement(this));
564                 return false;
565         });
566         $(postElement).find(".unlike-post").submit(function() {
567                 unlikePost(getPostId(this));
568                 markPostAsKnown(getPostElement(this));
569                 return false;
570         });
571
572         /* add “comment” link. */
573         addCommentLink(getPostId(postElement), postElement, $(postElement).find(".post-status-line .time"));
574
575         /* process all replies. */
576         $(postElement).find(".reply").each(function() {
577                 ajaxifyReply(this);
578         });
579
580         /* process reply input fields. */
581         getTranslation("WebInterface.DefaultText.Reply", function(text) {
582                 $(postElement).find("input.reply-input").each(function() {
583                         registerInputTextareaSwap(this, text, "text", false, false);
584                 });
585         });
586
587         /* mark everything as known on click. */
588         $(postElement).click(function() {
589                 markPostAsKnown(this);
590         });
591
592         /* hide reply input field. */
593         $(postElement).find(".create-reply").addClass("hidden");
594 }
595
596 /**
597  * Ajaxifies the given reply element.
598  *
599  * @param replyElement
600  *            The reply element to ajaxify
601  */
602 function ajaxifyReply(replyElement) {
603         $(replyElement).find(".like-reply").submit(function() {
604                 likeReply(getReplyId(this));
605                 markPostAsKnown(getPostElement(this));
606                 return false;
607         });
608         $(replyElement).find(".unlike-reply").submit(function() {
609                 unlikeReply(getReplyId(this));
610                 markPostAsKnown(getPostElement(this));
611                 return false;
612         });
613         (function(replyElement) {
614                 getTranslation("WebInterface.Confirmation.DeleteReplyButton", function(deleteReplyText) {
615                         $(replyElement).find(".delete-reply button").each(function() {
616                                 enhanceDeleteReplyButton(this, getReplyId(replyElement), deleteReplyText);
617                         });
618                 });
619         })(replyElement);
620         addCommentLink(getPostId(replyElement), replyElement, $(replyElement).find(".reply-status-line .time"));
621
622         /* mark post and all replies as known on click. */
623         $(replyElement).click(function() {
624                 markPostAsKnown(getPostElement(this));
625         });
626 }
627
628 /**
629  * Ajaxifies the given notification by replacing the form with AJAX.
630  *
631  * @param notification
632  *            jQuery object representing the notification.
633  */
634 function ajaxifyNotification(notification) {
635         notification.find("form.dismiss").submit(function() {
636                 return false;
637         });
638         notification.find("form.dismiss button").click(function() {
639                 $.getJSON("dismissNotification.ajax", { "formPassword" : getFormPassword(), "notification" : notification.attr("id") }, function(data, textStatus) {
640                         /* dismiss in case of error, too. */
641                         notification.slideUp();
642                 }, function(xmlHttpRequest, textStatus, error) {
643                         /* ignore error. */
644                 });
645         });
646         return notification;
647 }
648
649 function getStatus() {
650         $.getJSON("getStatus.ajax", {"loadAllSones": isKnownSonesPage()}, function(data, textStatus) {
651                 if ((data != null) && data.success) {
652                         /* process Sone information. */
653                         $.each(data.sones, function(index, value) {
654                                 updateSoneStatus(value.id, value.name, value.status, value.modified, value.locked, value.lastUpdated);
655                         });
656                         /* process notifications. */
657                         $.each(data.notifications, function(index, value) {
658                                 oldNotification = $("#sone #notification-area .notification#" + value.id);
659                                 notification = ajaxifyNotification(createNotification(value.id, value.text, value.dismissable)).hide();
660                                 if (oldNotification.length != 0) {
661                                         oldNotification.replaceWith(notification.show());
662                                 } else {
663                                         $("#sone #notification-area").append(notification);
664                                         notification.slideDown();
665                                 }
666                                 setActivity();
667                         });
668                         $.each(data.removedNotifications, function(index, value) {
669                                 $("#sone #notification-area .notification#" + value.id).slideUp();
670                         });
671                         /* process new posts. */
672                         $.each(data.newPosts, function(index, value) {
673                                 loadNewPost(value);
674                         });
675                         /* process new replies. */
676                         $.each(data.newReplies, function(index, value) {
677                                 loadNewReply(value);
678                         });
679                         /* do it again in 5 seconds. */
680                         setTimeout(getStatus, 5000);
681                 } else {
682                         /* data.success was false, wait 30 seconds. */
683                         setTimeout(getStatus, 30000);
684                 }
685         }, function(xmlHttpRequest, textStatus, error) {
686                 /* something really bad happend, wait a minute. */
687                 setTimeout(getStatus, 60000);
688         })
689 }
690
691 /**
692  * Returns the content of the page-id attribute.
693  *
694  * @returns The page ID
695  */
696 function getPageId() {
697         return $("#sone .page-id").text();
698 }
699
700 /**
701  * Returns whether the current page is the index page.
702  *
703  * @returns {Boolean} <code>true</code> if the current page is the index page,
704  *          <code>false</code> otherwise
705  */
706 function isIndexPage() {
707         return getPageId() == "index";
708 }
709
710 /**
711  * Returns whether the current page is a “view Sone” page.
712  *
713  * @returns {Boolean} <code>true</code> if the current page is a “view Sone”
714  *          page, <code>false</code> otherwise
715  */
716 function isViewSonePage() {
717         return getPageId() == "view-sone";
718 }
719
720 /**
721  * Returns the ID of the currently shown Sone. This will only return a sensible
722  * value if isViewSonePage() returns <code>true</code>.
723  *
724  * @returns The ID of the currently shown Sone
725  */
726 function getShownSoneId() {
727         return $("#sone .sone-id").text();
728 }
729
730 /**
731  * Returns whether the current page is a “view post” page.
732  *
733  * @returns {Boolean} <code>true</code> if the current page is a “view post”
734  *          page, <code>false</code> otherwise
735  */
736 function isViewPostPage() {
737         return getPageId() == "view-post";
738 }
739
740 /**
741  * Returns the ID of the currently shown post. This will only return a sensible
742  * value if isViewPostPage() returns <code>true</code>.
743  *
744  * @returns The ID of the currently shown post
745  */
746 function getShownPostId() {
747         return $("#sone .post-id").text();
748 }
749
750 /**
751  * Returns whether the current page is the “known Sones” page.
752  *
753  * @returns {Boolean} <code>true</code> if the current page is the “known
754  *          Sones” page, <code>false</code> otherwise
755  */
756 function isKnownSonesPage() {
757         return getPageId() == "known-sones";
758 }
759
760 /**
761  * Returns whether a post with the given ID exists on the current page.
762  *
763  * @param postId
764  *            The post ID to check for
765  * @returns {Boolean} <code>true</code> if a post with the given ID already
766  *          exists on the page, <code>false</code> otherwise
767  */
768 function hasPost(postId) {
769         return $(".post#" + postId).length > 0;
770 }
771
772 /**
773  * Returns whether a reply with the given ID exists on the current page.
774  *
775  * @param replyId
776  *            The reply ID to check for
777  * @returns {Boolean} <code>true</code> if a reply with the given ID already
778  *          exists on the page, <code>false</code> otherwise
779  */
780 function hasReply(replyId) {
781         return $("#sone .reply#" + replyId).length > 0;
782 }
783
784 function loadNewPost(postId) {
785         if (hasPost(postId)) {
786                 return;
787         }
788         $.getJSON("getPost.ajax", { "post" : postId }, function(data, textStatus) {
789                 if ((data != null) && data.success) {
790                         if (hasPost(data.post.id)) {
791                                 return;
792                         }
793                         if (!isIndexPage() && !(isViewSonePage() && ((getShownSoneId() == data.post.sone) || (getShownSoneId() == data.post.recipient)))) {
794                                 return;
795                         }
796                         var firstOlderPost = null;
797                         $("#sone .post").each(function() {
798                                 if (getPostTime(this) < data.post.time) {
799                                         firstOlderPost = $(this);
800                                         return false;
801                                 }
802                         });
803                         newPost = $(data.post.html).addClass("hidden");
804                         if (firstOlderPost != null) {
805                                 newPost.insertBefore(firstOlderPost);
806                         } else {
807                                 $("#sone #posts").append(newPost);
808                         }
809                         ajaxifyPost(newPost);
810                         newPost.slideDown();
811                         setActivity();
812                 }
813         });
814 }
815
816 function loadNewReply(replyId) {
817         if (hasReply(replyId)) {
818                 return;
819         }
820         $.getJSON("getReply.ajax", { "reply": replyId }, function(data, textStatus) {
821                 /* find post. */
822                 if ((data != null) && data.success) {
823                         if (hasReply(data.reply.id)) {
824                                 return;
825                         }
826                         $("#sone .post#" + data.reply.postId).each(function() {
827                                 var firstNewerReply = null;
828                                 $(this).find(".replies .reply").each(function() {
829                                         if (getReplyTime(this) > data.reply.time) {
830                                                 firstNewerReply = $(this);
831                                                 return false;
832                                         }
833                                 });
834                                 newReply = $(data.reply.html).addClass("hidden");
835                                 if (firstNewerReply != null) {
836                                         newReply.insertBefore(firstNewerReply);
837                                 } else {
838                                         if ($(this).find(".replies .create-reply")) {
839                                                 $(this).find(".replies .create-reply").before(newReply);
840                                         } else {
841                                                 $(this).find(".replies").append(newReply);
842                                         }
843                                 }
844                                 ajaxifyReply(newReply);
845                                 newReply.slideDown();
846                                 setActivity();
847                                 return false;
848                         });
849                 }
850         });
851 }
852
853 function markPostAsKnown(postElements) {
854         $(postElements).each(function() {
855                 postElement = this;
856                 if ($(postElement).hasClass("new")) {
857                         (function(postElement) {
858                                 $.getJSON("markPostAsKnown.ajax", {"formPassword": getFormPassword(), "post": getPostId(postElement)}, function(data, textStatus) {
859                                         $(postElement).removeClass("new");
860                                 });
861                         })(postElement);
862                 }
863         });
864         markReplyAsKnown($(postElements).find(".reply"));
865 }
866
867 function markReplyAsKnown(replyElements) {
868         $(replyElements).each(function() {
869                 replyElement = this;
870                 if ($(replyElement).hasClass("new")) {
871                         (function(replyElement) {
872                                 $.getJSON("markReplyAsKnown.ajax", {"formPassword": getFormPassword(), "reply": getReplyId(replyElement)}, function(data, textStatus) {
873                                         $(replyElement).removeClass("new");
874                                 });
875                         })(replyElement);
876                 }
877         });
878 }
879
880 function resetActivity() {
881         title = document.title;
882         if (title.indexOf('(') == 0) {
883                 document.title = title.substr(title.indexOf(' ') + 1);
884         }
885 }
886
887 function setActivity() {
888         if (!focus) {
889                 title = document.title;
890                 if (title.indexOf('(') != 0) {
891                         document.title = "(!) " + title;
892                 }
893         }
894 }
895
896 /**
897  * Creates a new notification.
898  *
899  * @param id
900  *            The ID of the notificaiton
901  * @param text
902  *            The text of the notification
903  * @param dismissable
904  *            <code>true</code> if the notification can be dismissed by the
905  *            user
906  */
907 function createNotification(id, text, dismissable) {
908         notification = $("<div></div>").addClass("notification").attr("id", id);
909         if (dismissable) {
910                 dismissForm = $("#sone #notification-area #notification-dismiss-template").clone().removeClass("hidden").removeAttr("id")
911                 dismissForm.find("input[name=notification]").val(id);
912                 notification.append(dismissForm);
913         }
914         notification.append(text);
915         return notification;
916 }
917
918 /**
919  * Shows the details of the notification with the given ID.
920  *
921  * @param notificationId
922  *            The ID of the notification
923  */
924 function showNotificationDetails(notificationId) {
925         $("#sone .notification#" + notificationId + " .text").show();
926         $("#sone .notification#" + notificationId + " .short-text").hide();
927 }
928
929 //
930 // EVERYTHING BELOW HERE IS EXECUTED AFTER LOADING THE PAGE
931 //
932
933 var focus = true;
934
935 $(document).ready(function() {
936
937         /* this initializes the status update input field. */
938         getTranslation("WebInterface.DefaultText.StatusUpdate", function(defaultText) {
939                 registerInputTextareaSwap("#sone #update-status .status-input", defaultText, "text", false, false);
940                 $("#sone #update-status").submit(function() {
941                         if ($(this).find(":input.default:enabled").length > 0) {
942                                 return false;
943                         }
944                         text = $(this).find(":input:enabled").val();
945                         $.getJSON("createPost.ajax", { "formPassword": getFormPassword(), "text": text }, function(data, textStatus) {
946                                 if ((data != null) && data.success) {
947                                         loadNewPost(data.postId);
948                                 }
949                         });
950                         $(this).find(":input:enabled").val("").blur();
951                         return false;
952                 });
953         });
954
955         /* ajaxify input field on “view Sone” page. */
956         getTranslation("WebInterface.DefaultText.Message", function(defaultText) {
957                 registerInputTextareaSwap("#sone #post-message input[name=text]", defaultText, "text", false, false);
958                 $("#sone #post-message").submit(function() {
959                         text = $(this).find(":input:enabled").val();
960                         $.getJSON("createPost.ajax", { "formPassword": getFormPassword(), "recipient": getShownSoneId(), "text": text }, function(data, textStatus) {
961                                 if ((data != null) && data.success) {
962                                         loadNewPost(data.postId);
963                                 }
964                         });
965                         $(this).find(":input:enabled").val("").blur();
966                         return false;
967                 });
968         });
969
970         /* Ajaxifies all posts. */
971         /* calling getTranslation here will cache the necessary values. */
972         getTranslation("WebInterface.Confirmation.DeletePostButton", function(text) {
973                 getTranslation("WebInterface.Confirmation.DeleteReplyButton", function(text) {
974                         getTranslation("WebInterface.DefaultText.Reply", function(text) {
975                                 $("#sone .post").each(function() {
976                                         ajaxifyPost(this);
977                                 });
978                         });
979                 });
980         });
981
982         /* hides all replies but the latest two. */
983         if (!isViewPostPage()) {
984                 getTranslation("WebInterface.ClickToShow.Replies", function(text) {
985                         $("#sone .post .replies").each(function() {
986                                 allReplies = $(this).find(".reply");
987                                 if (allReplies.length > 2) {
988                                         newHidden = false;
989                                         for (replyIndex = 0; replyIndex < (allReplies.length - 2); ++replyIndex) {
990                                                 $(allReplies[replyIndex]).addClass("hidden");
991                                                 newHidden |= $(allReplies[replyIndex]).hasClass("new");
992                                         }
993                                         clickToShowElement = $("<div></div>").addClass("click-to-show");
994                                         if (newHidden) {
995                                                 clickToShowElement.addClass("new");
996                                         }
997                                         (function(clickToShowElement, allReplies, text) {
998                                                 clickToShowElement.text(text);
999                                                 clickToShowElement.click(function() {
1000                                                         allReplies.removeClass("hidden");
1001                                                         clickToShowElement.addClass("hidden");
1002                                                 });
1003                                         })(clickToShowElement, allReplies, text);
1004                                         $(allReplies[0]).before(clickToShowElement);
1005                                 }
1006                         });
1007                 });
1008         }
1009
1010         /*
1011          * convert all “follow”, “unfollow”, “lock”, and “unlock” links to something
1012          * nicer.
1013          */
1014         $("#sone .follow").submit(function() {
1015                 var followElement = this;
1016                 $.getJSON("followSone.ajax", { "sone": getSoneId(this), "formPassword": getFormPassword() }, function() {
1017                         $(followElement).addClass("hidden");
1018                         $(followElement).parent().find(".unfollow").removeClass("hidden");
1019                 });
1020                 return false;
1021         });
1022         $("#sone .unfollow").submit(function() {
1023                 var unfollowElement = this;
1024                 $.getJSON("unfollowSone.ajax", { "sone": getSoneId(this), "formPassword": getFormPassword() }, function() {
1025                         $(unfollowElement).addClass("hidden");
1026                         $(unfollowElement).parent().find(".follow").removeClass("hidden");
1027                 });
1028                 return false;
1029         });
1030         $("#sone .lock").submit(function() {
1031                 var lockElement = this;
1032                 $.getJSON("lockSone.ajax", { "sone" : getSoneId(this), "formPassword" : getFormPassword() }, function() {
1033                         $(lockElement).addClass("hidden");
1034                         $(lockElement).parent().find(".unlock").removeClass("hidden");
1035                 });
1036                 return false;
1037         });
1038         $("#sone .unlock").submit(function() {
1039                 var unlockElement = this;
1040                 $.getJSON("unlockSone.ajax", { "sone" : getSoneId(this), "formPassword" : getFormPassword() }, function() {
1041                         $(unlockElement).addClass("hidden");
1042                         $(unlockElement).parent().find(".lock").removeClass("hidden");
1043                 });
1044                 return false;
1045         });
1046
1047         /* process all existing notifications, ajaxify dismiss buttons. */
1048         $("#sone #notification-area .notification").each(function() {
1049                 ajaxifyNotification($(this));
1050         });
1051
1052         /* activate status polling. */
1053         setTimeout(getStatus, 5000);
1054
1055         /* reset activity counter when the page has focus. */
1056         $(window).focus(function() {
1057                 focus = true;
1058                 resetActivity();
1059         }).blur(function() {
1060                 focus = false;
1061         })
1062
1063 });