1 /* Sone JavaScript functions. */
3 function ajaxGet(url, data, successCallback, errorCallback) {
4 (function(url, data, successCallback, errorCallback) {
5 $.ajax({"type": "GET", "url": url, "data": data, "dataType": "json", "success": function(data, textStatus, xmlHttpRequest) {
7 if (typeof successCallback != "undefined") {
8 successCallback(data, textStatus);
10 }, "error": function(xmlHttpRequest, textStatus, errorThrown) {
11 if (xmlHttpRequest.status == 403) {
14 if (typeof errorCallback != "undefined") {
20 })(url, data, successCallback, errorCallback);
23 function registerInputTextareaSwap(inputElement, defaultText, inputFieldName, optional, dontUseTextarea) {
24 $(inputElement).each(function() {
25 textarea = $(dontUseTextarea ? "<input type=\"text\" name=\"" + inputFieldName + "\">" : "<textarea name=\"" + inputFieldName + "\"></textarea>").blur(function() {
26 if ($(this).val() == "") {
28 inputField = $(this).data("inputField");
29 inputField.show().removeAttr("disabled").addClass("default");
30 inputField.val(defaultText);
32 }).hide().data("inputField", $(this)).val($(this).val());
33 $(this).data("textarea", textarea).after(textarea);
34 (function(inputField, textarea) {
35 inputField.focus(function() {
36 $(this).hide().attr("disabled", "disabled");
37 /* no, show(), “display: block” is not what I need. */
38 textarea.attr("style", "display: inline").focus();
40 if (inputField.val() == "") {
41 inputField.addClass("default");
42 inputField.val(defaultText);
44 inputField.hide().attr("disabled", "disabled");
47 $(inputField.get(0).form).submit(function() {
48 inputField.attr("disabled", "disabled");
49 if (!optional && (textarea.val() == "")) {
50 inputField.removeAttr("disabled").focus();
54 })($(this), textarea);
59 * Adds a “comment” link to all status lines contained in the given element.
64 * The element to add a “comment” link to
66 function addCommentLink(postId, author, element, insertAfterThisElement) {
67 if (($(element).find(".show-reply-form").length > 0) || (getPostElement(element).find(".create-reply").length == 0)) {
70 commentElement = (function(postId, author) {
71 separator = $("<span> · </span>").addClass("separator");
72 var commentElement = $("<div><span>Comment</span></div>").addClass("show-reply-form").click(function() {
73 replyElement = $("#sone .post#" + postId + " .create-reply");
74 replyElement.removeClass("hidden");
75 replyElement.removeClass("light");
76 (function(replyElement) {
77 replyElement.find("input.reply-input").blur(function() {
78 if ($(this).hasClass("default")) {
79 replyElement.addClass("light");
82 replyElement.removeClass("light");
85 textArea = replyElement.find("input.reply-input").focus().data("textarea");
86 if (author != getCurrentSoneId()) {
87 textArea.val(textArea.val() + "@sone://" + author + " ");
90 return commentElement;
92 $(insertAfterThisElement).after(commentElement.clone(true));
93 $(insertAfterThisElement).after(separator);
96 var translations = {};
99 * Retrieves the translation for the given key and calls the callback function.
100 * The callback function takes a single parameter, the translated string.
103 * The key of the translation string
105 * The callback function
107 function getTranslation(key, callback) {
108 if (key in translations) {
109 callback(translations[key]);
112 ajaxGet("getTranslation.ajax", {"key": key}, function(data, textStatus) {
113 if ((data != null) && data.success) {
114 translations[key] = data.value;
115 callback(data.value);
121 * Filters the given Sone ID, replacing all “~” characters by an underscore.
124 * The Sone ID to filter
125 * @returns The filtered Sone ID
127 function filterSoneId(soneId) {
128 return soneId.replace(/[^a-zA-Z0-9-]/g, "_");
132 * Updates the status of the given Sone.
135 * The ID of the Sone to update
137 * The status of the Sone (“idle”, “unknown”, “inserting”,
140 * Whether the Sone is modified
142 * Whether the Sone is locked
144 * The date and time of the last update (formatted for display)
146 function updateSoneStatus(soneId, name, status, modified, locked, lastUpdated, lastUpdatedText) {
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 if (lastUpdated != null) {
156 $("#sone .sone." + filterSoneId(soneId) + " .last-update span.time").attr("title", lastUpdated).text(lastUpdatedText);
158 getTranslation("View.Sone.Text.UnknownDate", function(unknown) {
159 $("#sone .sone." + filterSoneId(soneId) + " .last-update span.time").text(unknown);
162 $("#sone .sone." + filterSoneId(soneId) + " .profile-link a").text(name);
166 * Enhances a “delete” button so that the confirmation is done on the same page.
171 * The text to show on the button
172 * @param deleteCallback
173 * The callback that actually deletes something
175 function enhanceDeleteButton(button, text, deleteCallback) {
177 newButton = $("<button></button>").addClass("confirm").hide().text(text).click(function() {
178 $(this).fadeOut("slow");
181 }).insertAfter(button);
182 (function(button, newButton) {
183 button.click(function() {
184 button.fadeOut("slow", function() {
185 newButton.fadeIn("slow");
186 $(document).one("click", function() {
187 if (this != newButton.get(0)) {
188 newButton.fadeOut(function() {
196 })(button, newButton);
201 * Enhances a post’s “delete” button.
206 * The ID of the post to delete
208 * The text to replace the button with
210 function enhanceDeletePostButton(button, postId, text) {
211 enhanceDeleteButton(button, text, function() {
212 ajaxGet("deletePost.ajax", { "post": postId, "formPassword": getFormPassword() }, function(data, textStatus) {
217 $("#sone .post#" + postId).slideUp();
218 } else if (data.error == "invalid-post-id") {
219 /* pretend the post is already gone. */
220 getPost(postId).slideUp();
221 } else if (data.error == "auth-required") {
222 alert("You need to be logged in.");
223 } else if (data.error == "not-authorized") {
224 alert("You are not allowed to delete this post.");
226 }, function(xmlHttpRequest, textStatus, error) {
233 * Enhances a reply’s “delete” button.
238 * The ID of the reply to delete
240 * The text to replace the button with
242 function enhanceDeleteReplyButton(button, replyId, text) {
243 enhanceDeleteButton(button, text, function() {
244 ajaxGet("deleteReply.ajax", { "reply": replyId, "formPassword": $("#sone #formPassword").text() }, function(data, textStatus) {
249 $("#sone .reply#" + replyId).slideUp();
250 } else if (data.error == "invalid-reply-id") {
251 /* pretend the reply is already gone. */
252 getReply(replyId).slideUp();
253 } else if (data.error == "auth-required") {
254 alert("You need to be logged in.");
255 } else if (data.error == "not-authorized") {
256 alert("You are not allowed to delete this reply.");
258 }, function(xmlHttpRequest, textStatus, error) {
264 function getFormPassword() {
265 return $("#sone #formPassword").text();
269 * Returns the element of the Sone with the given ID.
273 * @returns All Sone elements with the given ID
275 function getSone(soneId) {
276 return $("#sone .sone").filter(function(index) {
277 return $(".id", this).text() == soneId;
281 function getSoneElement(element) {
282 return $(element).closest(".sone");
286 * Generates a list of Sones by concatening the names of the given sones with a
287 * new line character (“\n”).
290 * The sones to format
291 * @returns {String} The created string
293 function generateSoneList(sones) {
295 $.each(sones, function() {
296 if (soneList != "") {
299 soneList += this.name;
305 * Returns the ID of the Sone that this element belongs to.
308 * The element to locate the matching Sone ID for
309 * @returns The ID of the Sone, or undefined
311 function getSoneId(element) {
312 return getSoneElement(element).find(".id").text();
316 * Returns the element of the post with the given ID.
320 * @returns The element of the post
322 function getPost(postId) {
323 return $("#sone .post#" + postId);
326 function getPostElement(element) {
327 return $(element).closest(".post");
330 function getPostId(element) {
331 return getPostElement(element).attr("id");
334 function getPostTime(element) {
335 return getPostElement(element).find(".post-time").text();
339 * Returns the author of the post the given element belongs to.
342 * The element whose post to get the author for
343 * @returns The ID of the authoring Sone
345 function getPostAuthor(element) {
346 return getPostElement(element).find(".post-author").text();
350 * Returns the element of the reply with the given ID.
353 * The ID of the reply
354 * @returns The element of the reply
356 function getReply(replyId) {
357 return $("#sone .reply#" + replyId);
360 function getReplyElement(element) {
361 return $(element).closest(".reply");
364 function getReplyId(element) {
365 return getReplyElement(element).attr("id");
368 function getReplyTime(element) {
369 return getReplyElement(element).find(".reply-time").text();
373 * Returns the author of the reply the given element belongs to.
376 * The element whose reply to get the author for
377 * @returns The ID of the authoring Sone
379 function getReplyAuthor(element) {
380 return getReplyElement(element).find(".reply-author").text();
384 * Returns the notification with the given ID.
386 * @param notificationId
387 * The ID of the notification
388 * @returns The notification element
390 function getNotification(notificationId) {
391 return $("#sone #notification-area .notification#" + notificationId);
395 * Returns the notification element closest to the given element.
398 * The element to get the closest notification of
399 * @return The closest notification element
401 function getNotificationElement(element) {
402 return $(element).closest(".notification");
406 * Returns the ID of the notification element.
408 * @param notificationElement
409 * The notification element
410 * @returns The ID of the notification
412 function getNotificationId(notificationElement) {
413 return $(notificationElement).attr("id");
417 * Returns the time the notification was last updated.
419 * @param notificationElement
420 * The notification element
421 * @returns The last update time of the notification
423 function getNotificationLastUpdatedTime(notificationElement) {
424 return $(notificationElement).attr("lastUpdatedTime");
427 function likePost(postId) {
428 ajaxGet("like.ajax", { "type": "post", "post" : postId, "formPassword": getFormPassword() }, function(data, textStatus) {
429 if ((data == null) || !data.success) {
432 $("#sone .post#" + postId + " > .inner-part > .status-line .like").addClass("hidden");
433 $("#sone .post#" + postId + " > .inner-part > .status-line .unlike").removeClass("hidden");
434 updatePostLikes(postId);
435 }, function(xmlHttpRequest, textStatus, error) {
440 function unlikePost(postId) {
441 ajaxGet("unlike.ajax", { "type": "post", "post" : postId, "formPassword": getFormPassword() }, function(data, textStatus) {
442 if ((data == null) || !data.success) {
445 $("#sone .post#" + postId + " > .inner-part > .status-line .unlike").addClass("hidden");
446 $("#sone .post#" + postId + " > .inner-part > .status-line .like").removeClass("hidden");
447 updatePostLikes(postId);
448 }, function(xmlHttpRequest, textStatus, error) {
453 function updatePostLikes(postId) {
454 ajaxGet("getLikes.ajax", { "type": "post", "post": postId }, function(data, textStatus) {
455 if ((data != null) && data.success) {
456 $("#sone .post#" + postId + " > .inner-part > .status-line .likes").toggleClass("hidden", data.likes == 0);
457 $("#sone .post#" + postId + " > .inner-part > .status-line .likes span.like-count").text(data.likes);
458 $("#sone .post#" + postId + " > .inner-part > .status-line .likes > span").attr("title", generateSoneList(data.sones));
460 }, function(xmlHttpRequest, textStatus, error) {
465 function likeReply(replyId) {
466 ajaxGet("like.ajax", { "type": "reply", "reply" : replyId, "formPassword": getFormPassword() }, function(data, textStatus) {
467 if ((data == null) || !data.success) {
470 $("#sone .reply#" + replyId + " .status-line .like").addClass("hidden");
471 $("#sone .reply#" + replyId + " .status-line .unlike").removeClass("hidden");
472 updateReplyLikes(replyId);
473 }, function(xmlHttpRequest, textStatus, error) {
478 function unlikeReply(replyId) {
479 ajaxGet("unlike.ajax", { "type": "reply", "reply" : replyId, "formPassword": getFormPassword() }, function(data, textStatus) {
480 if ((data == null) || !data.success) {
483 $("#sone .reply#" + replyId + " .status-line .unlike").addClass("hidden");
484 $("#sone .reply#" + replyId + " .status-line .like").removeClass("hidden");
485 updateReplyLikes(replyId);
486 }, function(xmlHttpRequest, textStatus, error) {
492 * Trusts the Sone with the given ID.
495 * The ID of the Sone to trust
497 function trustSone(soneId) {
498 ajaxGet("trustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
499 if ((data != null) && data.success) {
500 updateTrustControls(soneId, data.trustValue);
506 * Distrusts the Sone with the given ID, i.e. assigns a negative trust value.
509 * The ID of the Sone to distrust
511 function distrustSone(soneId) {
512 ajaxGet("distrustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
513 if ((data != null) && data.success) {
514 updateTrustControls(soneId, data.trustValue);
520 * Untrusts the Sone with the given ID, i.e. removes any trust assignment.
523 * The ID of the Sone to untrust
525 function untrustSone(soneId) {
526 ajaxGet("untrustSone.ajax", { "formPassword" : getFormPassword(), "sone" : soneId }, function(data, textStatus) {
527 if ((data != null) && data.success) {
528 updateTrustControls(soneId, data.trustValue);
534 * Updates the trust controls for all posts and replies of the given Sone,
535 * according to the given trust value.
538 * The ID of the Sone to update all trust controls for
540 * The trust value for the Sone
542 function updateTrustControls(soneId, trustValue) {
543 $("#sone .post").each(function() {
544 if (getPostAuthor(this) == soneId) {
545 getPostElement(this).find(".post-trust").toggleClass("hidden", trustValue != null);
546 getPostElement(this).find(".post-distrust").toggleClass("hidden", trustValue != null);
547 getPostElement(this).find(".post-untrust").toggleClass("hidden", trustValue == null);
550 $("#sone .reply").each(function() {
551 if (getReplyAuthor(this) == soneId) {
552 getReplyElement(this).find(".reply-trust").toggleClass("hidden", trustValue != null);
553 getReplyElement(this).find(".reply-distrust").toggleClass("hidden", trustValue != null);
554 getReplyElement(this).find(".reply-untrust").toggleClass("hidden", trustValue == null);
560 * Bookmarks the post with the given ID.
563 * The ID of the post to bookmark
565 function bookmarkPost(postId) {
567 ajaxGet("bookmark.ajax", {"formPassword": getFormPassword(), "type": "post", "post": postId}, function(data, textStatus) {
568 if ((data != null) && data.success) {
569 getPost(postId).find(".bookmark").toggleClass("hidden", true);
570 getPost(postId).find(".unbookmark").toggleClass("hidden", false);
577 * Unbookmarks the post with the given ID.
580 * The ID of the post to unbookmark
582 function unbookmarkPost(postId) {
583 ajaxGet("unbookmark.ajax", {"formPassword": getFormPassword(), "type": "post", "post": postId}, function(data, textStatus) {
584 if ((data != null) && data.success) {
585 getPost(postId).find(".bookmark").toggleClass("hidden", false);
586 getPost(postId).find(".unbookmark").toggleClass("hidden", true);
591 function updateReplyLikes(replyId) {
592 ajaxGet("getLikes.ajax", { "type": "reply", "reply": replyId }, function(data, textStatus) {
593 if ((data != null) && data.success) {
594 $("#sone .reply#" + replyId + " .status-line .likes").toggleClass("hidden", data.likes == 0);
595 $("#sone .reply#" + replyId + " .status-line .likes span.like-count").text(data.likes);
596 $("#sone .reply#" + replyId + " .status-line .likes > span").attr("title", generateSoneList(data.sones));
598 }, function(xmlHttpRequest, textStatus, error) {
604 * Posts a reply and calls the given callback when the request finishes.
607 * The ID of the sender
609 * The ID of the post the reply refers to
612 * @param callbackFunction
613 * The callback function to call when the request finishes (takes 3
614 * parameters: success, error, replyId)
616 function postReply(sender, postId, text, callbackFunction) {
617 ajaxGet("createReply.ajax", { "formPassword" : getFormPassword(), "sender": sender, "post" : postId, "text": text }, function(data, textStatus) {
619 /* TODO - show error */
623 callbackFunction(true, null, data.reply, data.sone);
625 callbackFunction(false, data.error);
627 }, function(xmlHttpRequest, textStatus, error) {
633 * Ajaxifies the given Sone by enhancing all eligible elements with AJAX.
636 * The Sone to ajaxify
638 function ajaxifySone(soneElement) {
640 * convert all “follow”, “unfollow”, “lock”, and “unlock” links to something
643 $(".follow", soneElement).submit(function() {
644 var followElement = this;
645 ajaxGet("followSone.ajax", { "sone": getSoneId(this), "formPassword": getFormPassword() }, function() {
646 $(followElement).addClass("hidden");
647 $(followElement).parent().find(".unfollow").removeClass("hidden");
651 $(".unfollow", soneElement).submit(function() {
652 var unfollowElement = this;
653 ajaxGet("unfollowSone.ajax", { "sone": getSoneId(this), "formPassword": getFormPassword() }, function() {
654 $(unfollowElement).addClass("hidden");
655 $(unfollowElement).parent().find(".follow").removeClass("hidden");
659 $(".lock", soneElement).submit(function() {
660 var lockElement = this;
661 ajaxGet("lockSone.ajax", { "sone" : getSoneId(this), "formPassword" : getFormPassword() }, function() {
662 $(lockElement).addClass("hidden");
663 $(lockElement).parent().find(".unlock").removeClass("hidden");
667 $(".unlock", soneElement).submit(function() {
668 var unlockElement = this;
669 ajaxGet("unlockSone.ajax", { "sone" : getSoneId(this), "formPassword" : getFormPassword() }, function() {
670 $(unlockElement).addClass("hidden");
671 $(unlockElement).parent().find(".lock").removeClass("hidden");
676 /* mark Sone as known when clicking it. */
677 $(soneElement).click(function() {
678 markSoneAsKnown(this);
683 * Ajaxifies the given post by enhancing all eligible elements with AJAX.
686 * The post element to ajaxify
688 function ajaxifyPost(postElement) {
689 $(postElement).find("form").submit(function() {
692 $(postElement).find(".create-reply button:submit").click(function() {
694 button.attr("disabled", "disabled");
695 sender = $(this.form).find(":input[name=sender]").val();
696 inputField = $(this.form).find(":input[name=text]:enabled").get(0);
697 postId = getPostId(this);
698 text = $(inputField).val();
699 (function(sender, postId, text, inputField) {
700 postReply(sender, postId, text, function(success, error, replyId, soneId) {
702 $(inputField).val("");
703 loadNewReply(replyId, soneId, postId);
704 $("#sone .post#" + postId + " .create-reply").addClass("hidden");
705 $("#sone .post#" + postId + " .create-reply .sender").hide();
706 $("#sone .post#" + postId + " .create-reply .select-sender").show();
707 $("#sone .post#" + postId + " .create-reply :input[name=sender]").val(getCurrentSoneId());
711 button.removeAttr("disabled");
713 })(sender, postId, text, inputField);
717 /* replace all “delete” buttons with javascript. */
718 (function(postElement) {
719 getTranslation("WebInterface.Confirmation.DeletePostButton", function(deletePostText) {
720 postId = getPostId(postElement);
721 enhanceDeletePostButton($(postElement).find(".delete-post button"), postId, deletePostText);
725 /* convert all “like” buttons to javascript functions. */
726 $(postElement).find(".like-post").submit(function() {
727 likePost(getPostId(this));
730 $(postElement).find(".unlike-post").submit(function() {
731 unlikePost(getPostId(this));
735 /* convert trust control buttons to javascript functions. */
736 $(postElement).find(".post-trust").submit(function() {
737 trustSone(getPostAuthor(this));
740 $(postElement).find(".post-distrust").submit(function() {
741 distrustSone(getPostAuthor(this));
744 $(postElement).find(".post-untrust").submit(function() {
745 untrustSone(getPostAuthor(this));
749 /* convert bookmark/unbookmark buttons to javascript functions. */
750 $(postElement).find(".bookmark").submit(function() {
751 bookmarkPost(getPostId(this));
754 $(postElement).find(".unbookmark").submit(function() {
755 unbookmarkPost(getPostId(this));
759 /* convert “show source” link into javascript function. */
760 $(postElement).find(".show-source").each(function() {
761 $("a", this).click(function() {
762 $(".post-text.text", getPostElement(this)).toggleClass("hidden");
763 $(".post-text.raw-text", getPostElement(this)).toggleClass("hidden");
768 /* add “comment” link. */
769 addCommentLink(getPostId(postElement), getPostAuthor(postElement), postElement, $(postElement).find(".post-status-line .permalink-author"));
771 /* process all replies. */
773 $(postElement).find(".reply").each(function() {
774 replyIds.push(getReplyId(this));
777 updateReplyTimes(replyIds.join(","));
779 /* process reply input fields. */
780 getTranslation("WebInterface.DefaultText.Reply", function(text) {
781 $(postElement).find("input.reply-input").each(function() {
782 registerInputTextareaSwap(this, text, "text", false, false);
786 /* process sender selection. */
787 $(".select-sender", postElement).css("display", "inline");
788 $(".sender", postElement).hide();
789 $(".select-sender button", postElement).click(function() {
790 $(".sender", postElement).show();
791 $(".select-sender", postElement).hide();
795 /* mark everything as known on click. */
796 $(postElement).click(function(event) {
797 if ($(event.target).hasClass("click-to-show")) {
800 markPostAsKnown(this);
803 /* hide reply input field. */
804 $(postElement).find(".create-reply").addClass("hidden");
808 * Ajaxifies the given reply element.
810 * @param replyElement
811 * The reply element to ajaxify
813 function ajaxifyReply(replyElement) {
814 $(replyElement).find(".like-reply").submit(function() {
815 likeReply(getReplyId(this));
818 $(replyElement).find(".unlike-reply").submit(function() {
819 unlikeReply(getReplyId(this));
822 (function(replyElement) {
823 getTranslation("WebInterface.Confirmation.DeleteReplyButton", function(deleteReplyText) {
824 $(replyElement).find(".delete-reply button").each(function() {
825 enhanceDeleteReplyButton(this, getReplyId(replyElement), deleteReplyText);
829 addCommentLink(getPostId(replyElement), getReplyAuthor(replyElement), replyElement, $(replyElement).find(".reply-status-line .permalink-author"));
831 /* convert “show source” link into javascript function. */
832 $(replyElement).find(".show-reply-source").each(function() {
833 $("a", this).click(function() {
834 $(".reply-text.text", getReplyElement(this)).toggleClass("hidden");
835 $(".reply-text.raw-text", getReplyElement(this)).toggleClass("hidden");
840 /* convert trust control buttons to javascript functions. */
841 $(replyElement).find(".reply-trust").submit(function() {
842 trustSone(getReplyAuthor(this));
845 $(replyElement).find(".reply-distrust").submit(function() {
846 distrustSone(getReplyAuthor(this));
849 $(replyElement).find(".reply-untrust").submit(function() {
850 untrustSone(getReplyAuthor(this));
856 * Ajaxifies the given notification by replacing the form with AJAX.
858 * @param notification
859 * jQuery object representing the notification.
861 function ajaxifyNotification(notification) {
862 notification.find("form").submit(function() {
865 notification.find("input[name=returnPage]").val($.url.attr("relative"));
866 if (notification.find(".short-text").length > 0) {
867 notification.find(".short-text").removeClass("hidden");
868 notification.find(".text").addClass("hidden");
870 notification.find("form.mark-as-read button").click(function() {
871 ajaxGet("markAsKnown.ajax", {"formPassword": getFormPassword(), "type": $(":input[name=type]", this.form).val(), "id": $(":input[name=id]", this.form).val()});
873 notification.find("a[class^='link-']").each(function() {
874 linkElement = $(this);
875 if (linkElement.is("[href^='viewPost']")) {
876 id = linkElement.attr("class").substr(5);
878 linkElement.attr("href", "#post-" + id).addClass("in-page-link");
882 notification.find("form.dismiss button").click(function() {
883 ajaxGet("dismissNotification.ajax", { "formPassword" : getFormPassword(), "notification" : notification.attr("id") }, function(data, textStatus) {
884 /* dismiss in case of error, too. */
885 notification.slideUp();
886 }, function(xmlHttpRequest, textStatus, error) {
894 * Retrieves element IDs from notification elements.
896 * @param notification
897 * The notification element
899 * The selector of the element containing the ID as text
900 * @returns All extracted IDs
902 function getElementIds(notification, selector) {
904 $(selector, notification).each(function() {
905 elementIds.push($(this).text());
911 * Compares the given notification elements and calls {@link #markSoneAsKnown()}
912 * for every ID that is contained in the old notification but not in the new.
914 * @param oldNotification
915 * The old notification element
916 * @param newNotification
917 * The new notification element
919 function checkForRemovedSones(oldNotification, newNotification) {
920 if (getNotificationId(oldNotification) != "new-sone-notification") {
923 oldIds = getElementIds(oldNotification, ".new-sone-id");
924 newIds = getElementIds(newNotification, ".new-sone-id");
925 $.each(oldIds, function(index, value) {
926 if ($.inArray(value, newIds) == -1) {
927 markSoneAsKnown(getSone(value), true);
933 * Compares the given notification elements and calls {@link #markPostAsKnown()}
934 * for every ID that is contained in the old notification but not in the new.
936 * @param oldNotification
937 * The old notification element
938 * @param newNotification
939 * The new notification element
941 function checkForRemovedPosts(oldNotification, newNotification) {
942 if (getNotificationId(oldNotification) != "new-post-notification") {
945 oldIds = getElementIds(oldNotification, ".post-id");
946 newIds = getElementIds(newNotification, ".post-id");
947 $.each(oldIds, function(index, value) {
948 if ($.inArray(value, newIds) == -1) {
949 markPostAsKnown(getPost(value), true);
955 * Compares the given notification elements and calls
956 * {@link #markReplyAsKnown()} for every ID that is contained in the old
957 * notification but not in the new.
959 * @param oldNotification
960 * The old notification element
961 * @param newNotification
962 * The new notification element
964 function checkForRemovedReplies(oldNotification, newNotification) {
965 if (getNotificationId(oldNotification) != "new-replies-notification") {
968 oldIds = getElementIds(oldNotification, ".reply-id");
969 newIds = getElementIds(newNotification, ".reply-id");
970 $.each(oldIds, function(index, value) {
971 if ($.inArray(value, newIds) == -1) {
972 markReplyAsKnown(getReply(value), true);
977 function getStatus() {
978 ajaxGet("getStatus.ajax", isViewSonePage() ? {"soneIds": getShownSoneId() } : {"loadAllSones": isKnownSonesPage()}, function(data, textStatus) {
979 if ((data != null) && data.success) {
980 /* process Sone information. */
981 $.each(data.sones, function(index, value) {
982 updateSoneStatus(value.id, value.name, value.status, value.modified, value.locked, value.lastUpdatedUnknown ? null : value.lastUpdated, value.lastUpdatedText);
984 notLoggedIn = !data.loggedIn;
986 showOfflineMarker(!online);
988 /* search for removed notifications. */
989 $("#sone #notification-area .notification").each(function() {
990 notificationId = $(this).attr("id");
991 foundNotification = false;
992 $.each(data.notifications, function(index, value) {
993 if (value.id == notificationId) {
994 foundNotification = true;
998 if (!foundNotification) {
999 if (notificationId == "new-sone-notification") {
1000 $(".new-sone-id", this).each(function(index, element) {
1001 soneId = $(this).text();
1002 markSoneAsKnown(getSone(soneId), true);
1004 } else if (notificationId == "new-post-notification") {
1005 $(".post-id", this).each(function(index, element) {
1006 postId = $(this).text();
1007 markPostAsKnown(getPost(postId), true);
1009 } else if (notificationId == "new-replies-notification") {
1010 $(".reply-id", this).each(function(index, element) {
1011 replyId = $(this).text();
1012 markReplyAsKnown(getReply(replyId), true);
1015 $(this).slideUp("normal", function() {
1017 /* remove activity when no notifications are visible. */
1018 if ($("#sone #notification-area .notification").length == 0) {
1024 /* process notifications. */
1025 notificationIds = [];
1026 $.each(data.notifications, function(index, value) {
1027 oldNotification = getNotification(value.id);
1028 if ((oldNotification.length == 0) || (value.lastUpdatedTime > getNotificationLastUpdatedTime(oldNotification))) {
1029 notificationIds.push(value.id);
1032 if (notificationIds.length > 0) {
1033 loadNotifications(notificationIds);
1035 /* process new posts. */
1036 $.each(data.newPosts, function(index, value) {
1037 loadNewPost(value.id, value.sone, value.recipient, value.time);
1039 /* process new replies. */
1040 $.each(data.newReplies, function(index, value) {
1041 loadNewReply(value.id, value.sone, value.post, value.postSone);
1043 /* do it again in 5 seconds. */
1044 setTimeout(getStatus, 5000);
1046 /* data.success was false, wait 30 seconds. */
1047 setTimeout(getStatus, 30000);
1050 statusRequestQueued = false;
1056 * Requests multiple notifications from Sone and displays them.
1058 * @param notificationIds
1059 * Array of IDs of the notifications to load
1061 function loadNotifications(notificationIds) {
1062 ajaxGet("getNotification.ajax", {"notifications": notificationIds.join(",")}, function(data, textStatus) {
1063 if (!data || !data.success) {
1064 // TODO - show error
1067 $.each(data.notifications, function(index, value) {
1068 oldNotification = getNotification(value.id);
1069 notification = ajaxifyNotification(createNotification(value.id, value.lastUpdatedTime, value.text, value.dismissable)).hide();
1070 if (oldNotification.length != 0) {
1071 if ((oldNotification.find(".short-text").length > 0) && (notification.find(".short-text").length > 0)) {
1072 opened = oldNotification.is(":visible") && oldNotification.find(".short-text").hasClass("hidden");
1073 notification.find(".short-text").toggleClass("hidden", opened);
1074 notification.find(".text").toggleClass("hidden", !opened);
1076 checkForRemovedSones(oldNotification, notification);
1077 checkForRemovedPosts(oldNotification, notification);
1078 checkForRemovedReplies(oldNotification, notification);
1079 oldNotification.replaceWith(notification.show());
1081 $("#sone #notification-area").append(notification);
1082 notification.slideDown();
1090 * Returns the ID of the currently logged in Sone.
1092 * @return The ID of the current Sone, or an empty string if no Sone is logged
1095 function getCurrentSoneId() {
1096 return $("#currentSoneId").text();
1100 * Returns the content of the page-id attribute.
1102 * @returns The page ID
1104 function getPageId() {
1105 return $("#sone .page-id").text();
1109 * Returns whether the current page is the index page.
1111 * @returns {Boolean} <code>true</code> if the current page is the index page,
1112 * <code>false</code> otherwise
1114 function isIndexPage() {
1115 return getPageId() == "index";
1119 * Returns the current page of the selected pagination. If no pagination can be
1120 * found with the given selector, {@code 1} is returned.
1122 * @param paginationSelector
1123 * The pagination selector
1124 * @returns The current page of the pagination
1126 function getPage(paginationSelector) {
1127 pagination = $(paginationSelector);
1128 if (pagination.length > 0) {
1129 return $(".current-page", paginationSelector).text();
1135 * Returns whether the current page is a “view Sone” page.
1137 * @returns {Boolean} <code>true</code> if the current page is a “view Sone”
1138 * page, <code>false</code> otherwise
1140 function isViewSonePage() {
1141 return getPageId() == "view-sone";
1145 * Returns the ID of the currently shown Sone. This will only return a sensible
1146 * value if isViewSonePage() returns <code>true</code>.
1148 * @returns The ID of the currently shown Sone
1150 function getShownSoneId() {
1151 return $("#sone .sone-id").text();
1155 * Returns whether the current page is a “view post” page.
1157 * @returns {Boolean} <code>true</code> if the current page is a “view post”
1158 * page, <code>false</code> otherwise
1160 function isViewPostPage() {
1161 return getPageId() == "view-post";
1165 * Returns the ID of the currently shown post. This will only return a sensible
1166 * value if isViewPostPage() returns <code>true</code>.
1168 * @returns The ID of the currently shown post
1170 function getShownPostId() {
1171 return $("#sone .post-id").text();
1175 * Returns whether the current page is the “known Sones” page.
1177 * @returns {Boolean} <code>true</code> if the current page is the “known
1178 * Sones” page, <code>false</code> otherwise
1180 function isKnownSonesPage() {
1181 return getPageId() == "known-sones";
1185 * Returns whether a post with the given ID exists on the current page.
1188 * The post ID to check for
1189 * @returns {Boolean} <code>true</code> if a post with the given ID already
1190 * exists on the page, <code>false</code> otherwise
1192 function hasPost(postId) {
1193 return $(".post#" + postId).length > 0;
1197 * Returns whether a reply with the given ID exists on the current page.
1200 * The reply ID to check for
1201 * @returns {Boolean} <code>true</code> if a reply with the given ID already
1202 * exists on the page, <code>false</code> otherwise
1204 function hasReply(replyId) {
1205 return $("#sone .reply#" + replyId).length > 0;
1208 function loadNewPost(postId, soneId, recipientId, time) {
1209 if (hasPost(postId)) {
1212 if (!isIndexPage() || (getPage(".pagination-index") > 1)) {
1213 if (!isViewPostPage() || (getShownPostId() != postId)) {
1214 if (!isViewSonePage() || ((getShownSoneId() != soneId) && (getShownSoneId() != recipientId)) || (getPage(".post-navigation") > 1)) {
1219 if (getPostTime($("#sone .post").last()) > time) {
1222 ajaxGet("getPost.ajax", { "post" : postId }, function(data, textStatus) {
1223 if ((data != null) && data.success) {
1224 if (hasPost(data.post.id)) {
1227 if ((!isIndexPage() || (getPage(".pagination-index") > 1)) && !(isViewSonePage() && ((getShownSoneId() == data.post.sone) || (getShownSoneId() == data.post.recipient) || (getPage(".post-navigation") > 1)))) {
1230 var firstOlderPost = null;
1231 $("#sone .post").each(function() {
1232 if (getPostTime(this) < data.post.time) {
1233 firstOlderPost = $(this);
1237 newPost = $(data.post.html).addClass("hidden");
1238 if (firstOlderPost != null) {
1239 newPost.insertBefore(firstOlderPost);
1241 ajaxifyPost(newPost);
1242 updatePostTimes(data.post.id);
1243 newPost.slideDown();
1249 function loadNewReply(replyId, soneId, postId, postSoneId) {
1250 if (hasReply(replyId)) {
1253 if (!hasPost(postId)) {
1256 ajaxGet("getReply.ajax", { "reply": replyId }, function(data, textStatus) {
1258 if ((data != null) && data.success) {
1259 if (hasReply(data.reply.id)) {
1262 $("#sone .post#" + data.reply.postId).each(function() {
1263 var firstNewerReply = null;
1264 $(this).find(".replies .reply").each(function() {
1265 if (getReplyTime(this) > data.reply.time) {
1266 firstNewerReply = $(this);
1270 newReply = $(data.reply.html).addClass("hidden");
1271 if (firstNewerReply != null) {
1272 newReply.insertBefore(firstNewerReply);
1274 if ($(this).find(".replies .create-reply")) {
1275 $(this).find(".replies .create-reply").before(newReply);
1277 $(this).find(".replies").append(newReply);
1280 ajaxifyReply(newReply);
1281 updateReplyTimes(data.reply.id);
1282 newReply.slideDown();
1291 * Marks the given Sone as known if it is still new.
1293 * @param soneElement
1294 * The Sone to mark as known
1295 * @param skipRequest
1296 * true to skip the JSON request, false or omit to perform the JSON
1299 function markSoneAsKnown(soneElement, skipRequest) {
1300 if ($(soneElement).is(".new")) {
1301 $(soneElement).removeClass("new");
1302 if ((typeof skipRequest == "undefined") || !skipRequest) {
1303 ajaxGet("markAsKnown.ajax", {"formPassword": getFormPassword(), "type": "sone", "id": getSoneId(soneElement)});
1308 function markPostAsKnown(postElements, skipRequest) {
1309 $(postElements).each(function() {
1311 if ($(postElement).hasClass("new")) {
1312 (function(postElement) {
1313 $(postElement).removeClass("new");
1314 if ((typeof skipRequest == "undefined") || !skipRequest) {
1315 ajaxGet("markAsKnown.ajax", {"formPassword": getFormPassword(), "type": "post", "id": getPostId(postElement)});
1319 $(".click-to-show", postElement).removeClass("new");
1321 markReplyAsKnown($(postElements).find(".reply"));
1324 function markReplyAsKnown(replyElements, skipRequest) {
1325 $(replyElements).each(function() {
1326 replyElement = this;
1327 if ($(replyElement).hasClass("new")) {
1328 (function(replyElement) {
1329 $(replyElement).removeClass("new");
1330 if ((typeof skipRequest == "undefined") || !skipRequest) {
1331 ajaxGet("markAsKnown.ajax", {"formPassword": getFormPassword(), "type": "reply", "id": getReplyId(replyElement)});
1339 * Updates the time of the post with the given ID.
1342 * The ID of the post to update
1344 * The text of the time to show
1345 * @param refreshTime
1346 * The refresh time after which to request a new time (in seconds)
1348 * The tooltip to show
1350 function updatePostTime(postId, timeText, refreshTime, tooltip) {
1351 if (!getPost(postId).is(":visible")) {
1354 getPost(postId).find(".post-status-line > .time a").html(timeText).attr("title", tooltip);
1355 (function(postId, refreshTime) {
1356 setTimeout(function() {
1357 updatePostTimes(postId);
1358 }, refreshTime * 1000);
1359 })(postId, refreshTime);
1363 * Requests new rendered times for the posts with the given IDs.
1366 * Comma-separated post IDs
1368 function updatePostTimes(postIds) {
1369 ajaxGet("getTimes.ajax", { "posts" : postIds }, function(data, textStatus) {
1370 if ((data != null) && data.success) {
1371 $.each(data.postTimes, function(index, value) {
1372 updatePostTime(index, value.timeText, value.refreshTime, value.tooltip);
1379 * Updates the time of the reply with the given ID.
1382 * The ID of the reply to update
1384 * The text of the time to show
1385 * @param refreshTime
1386 * The refresh time after which to request a new time (in seconds)
1388 * The tooltip to show
1390 function updateReplyTime(replyId, timeText, refreshTime, tooltip) {
1391 getReply(replyId).find(".reply-status-line > .time").html(timeText).attr("title", tooltip);
1392 (function(replyId, refreshTime) {
1393 setTimeout(function() {
1394 updateReplyTimes(replyId);
1395 }, refreshTime * 1000);
1396 })(replyId, refreshTime);
1400 * Requests new rendered times for the posts with the given IDs.
1403 * Comma-separated post IDs
1405 function updateReplyTimes(replyIds) {
1406 ajaxGet("getTimes.ajax", { "replies" : replyIds }, function(data, textStatus) {
1407 if ((data != null) && data.success) {
1408 $.each(data.replyTimes, function(index, value) {
1409 updateReplyTime(index, value.timeText, value.refreshTime, value.tooltip);
1415 function resetActivity() {
1416 title = document.title;
1417 if (title.indexOf('(') == 0) {
1418 setTitle(title.substr(title.indexOf(' ') + 1));
1420 iconBlinking = false;
1423 function setActivity() {
1425 title = document.title;
1426 if (title.indexOf('(') != 0) {
1427 setTitle("(!) " + title);
1429 if (!iconBlinking) {
1430 setTimeout(toggleIcon, 1500);
1431 iconBlinking = true;
1437 * Sets the window title after a small delay to prevent race-condition issues.
1442 function setTitle(title) {
1443 setTimeout(function() {
1444 document.title = title;
1448 /** Whether the icon is currently showing activity. */
1449 var iconActive = false;
1451 /** Whether the icon is currently supposed to blink. */
1452 var iconBlinking = false;
1455 * Toggles the icon. If the window has gained focus and the icon is still
1456 * showing the activity state, it is returned to normal.
1458 function toggleIcon() {
1459 if (focus || !iconBlinking) {
1461 changeIcon("images/icon.png");
1464 iconBlinking = false;
1466 iconActive = !iconActive;
1467 changeIcon(iconActive ? "images/icon-activity.png" : "images/icon.png");
1468 setTimeout(toggleIcon, 1500);
1473 * Changes the icon of the page.
1476 * The new URL of the icon
1478 function changeIcon(iconUrl) {
1479 $("link[rel=icon]").remove();
1480 $("head").append($("<link>").attr("rel", "icon").attr("type", "image/png").attr("href", iconUrl));
1481 $("iframe[id=icon-update]")[0].src += "";
1485 * Creates a new notification.
1488 * The ID of the notificaiton
1490 * The text of the notification
1491 * @param dismissable
1492 * <code>true</code> if the notification can be dismissed by the
1495 function createNotification(id, lastUpdatedTime, text, dismissable) {
1496 notification = $("<div></div>").addClass("notification").attr("id", id).attr("lastUpdatedTime", lastUpdatedTime);
1498 dismissForm = $("#sone #notification-area #notification-dismiss-template").clone().removeClass("hidden").removeAttr("id");
1499 dismissForm.find("input[name=notification]").val(id);
1500 notification.append(dismissForm);
1502 notification.append(text);
1503 return notification;
1507 * Shows the details of the notification with the given ID.
1509 * @param notificationId
1510 * The ID of the notification
1512 function showNotificationDetails(notificationId) {
1513 $("#sone .notification#" + notificationId + " .text").removeClass("hidden");
1514 $("#sone .notification#" + notificationId + " .short-text").addClass("hidden");
1518 * Deletes the field with the given ID from the profile.
1521 * The ID of the field to delete
1523 function deleteProfileField(fieldId) {
1524 ajaxGet("deleteProfileField.ajax", {"formPassword": getFormPassword(), "field": fieldId}, function(data, textStatus) {
1525 if (data && data.success) {
1526 $("#sone .profile-field#" + data.field.id).slideUp();
1532 * Renames a profile field.
1535 * The ID of the field to rename
1537 * The new name of the field
1538 * @param successFunction
1539 * Called when the renaming was successful
1541 function editProfileField(fieldId, newName, successFunction) {
1542 ajaxGet("editProfileField.ajax", {"formPassword": getFormPassword(), "field": fieldId, "name": newName}, function(data, textStatus) {
1543 if (data && data.success) {
1550 * Moves the profile field with the given ID one slot in the given direction.
1553 * The ID of the field to move
1555 * The direction to move in (“up” or “down”)
1556 * @param successFunction
1557 * Function to call on success
1559 function moveProfileField(fieldId, direction, successFunction) {
1560 ajaxGet("moveProfileField.ajax", {"formPassword": getFormPassword(), "field": fieldId, "direction": direction}, function(data, textStatus) {
1561 if (data && data.success) {
1568 * Moves the profile field with the given ID up one slot.
1571 * The ID of the field to move
1572 * @param successFunction
1573 * Function to call on success
1575 function moveProfileFieldUp(fieldId, successFunction) {
1576 moveProfileField(fieldId, "up", successFunction);
1580 * Moves the profile field with the given ID down one slot.
1583 * The ID of the field to move
1584 * @param successFunction
1585 * Function to call on success
1587 function moveProfileFieldDown(fieldId, successFunction) {
1588 moveProfileField(fieldId, "down", successFunction);
1591 var statusRequestQueued = true;
1594 * Sets the status of the web interface as offline.
1596 function ajaxError() {
1598 showOfflineMarker(true);
1599 if (!statusRequestQueued) {
1600 setTimeout(getStatus, 5000);
1601 statusRequestQueued = true;
1606 * Sets the status of the web interface as online.
1608 function ajaxSuccess() {
1610 showOfflineMarker(!online || (initiallyLoggedIn && notLoggedIn));
1614 * Shows or hides the offline marker.
1617 * {@code true} to display the offline marker, {@code false} to hide
1620 function showOfflineMarker(visible) {
1621 /* jQuery documentation says toggle() works the other way around?! */
1622 $("#sone #offline-marker").toggle(visible);
1624 $("#sone #main").addClass("offline");
1626 $("#sone #main").removeClass("offline");
1631 // EVERYTHING BELOW HERE IS EXECUTED AFTER LOADING THE PAGE
1636 var initiallyLoggedIn = $("#sone #loggedIn").text() == "true";
1637 var notLoggedIn = !initiallyLoggedIn;
1639 $(document).ready(function() {
1641 /* this initializes the status update input field. */
1642 getTranslation("WebInterface.DefaultText.StatusUpdate", function(defaultText) {
1643 registerInputTextareaSwap("#sone #update-status .status-input", defaultText, "text", false, false);
1644 $("#sone #update-status .select-sender").css("display", "inline");
1645 $("#sone #update-status .sender").hide();
1646 $("#sone #update-status .select-sender button").click(function() {
1647 $("#sone #update-status .sender").show();
1648 $("#sone #update-status .select-sender").hide();
1651 $("#sone #update-status").submit(function() {
1652 button = $("button:submit", this);
1653 button.attr("disabled", "disabled");
1654 if ($(this).find(":input.default:enabled").length > 0) {
1657 sender = $(this).find(":input[name=sender]").val();
1658 text = $(this).find(":input[name=text]:enabled").val();
1659 ajaxGet("createPost.ajax", { "formPassword": getFormPassword(), "sender": sender, "text": text }, function(data, textStatus) {
1660 button.removeAttr("disabled");
1662 $(this).find(":input[name=sender]").val(getCurrentSoneId());
1663 $(this).find(":input[name=text]:enabled").val("").blur();
1664 $(this).find(".sender").hide();
1665 $(this).find(".select-sender").show();
1670 /* ajaxify the search input field. */
1671 getTranslation("WebInterface.DefaultText.Search", function(defaultText) {
1672 registerInputTextareaSwap("#sone #search input[name=query]", defaultText, "query", false, true);
1675 /* ajaxify input field on “view Sone” page. */
1676 getTranslation("WebInterface.DefaultText.Message", function(defaultText) {
1677 registerInputTextareaSwap("#sone #post-message input[name=text]", defaultText, "text", false, false);
1678 $("#sone #post-message .select-sender").css("display", "inline");
1679 $("#sone #post-message .sender").hide();
1680 $("#sone #post-message .select-sender button").click(function() {
1681 $("#sone #post-message .sender").show();
1682 $("#sone #post-message .select-sender").hide();
1685 $("#sone #post-message").submit(function() {
1686 sender = $(this).find(":input[name=sender]").val();
1687 text = $(this).find(":input[name=text]:enabled").val();
1688 ajaxGet("createPost.ajax", { "formPassword": getFormPassword(), "recipient": getShownSoneId(), "sender": sender, "text": text });
1689 $(this).find(":input[name=sender]").val(getCurrentSoneId());
1690 $(this).find(":input[name=text]:enabled").val("").blur();
1691 $(this).find(".sender").hide();
1692 $(this).find(".select-sender").show();
1697 /* Ajaxifies all posts. */
1698 /* calling getTranslation here will cache the necessary values. */
1699 getTranslation("WebInterface.Confirmation.DeletePostButton", function(text) {
1700 getTranslation("WebInterface.Confirmation.DeleteReplyButton", function(text) {
1701 getTranslation("WebInterface.DefaultText.Reply", function(text) {
1702 $("#sone .post").each(function() {
1709 /* update post times. */
1711 $("#sone .post").each(function() {
1712 postIds.push(getPostId(this));
1714 updatePostTimes(postIds.join(","));
1716 /* hides all replies but the latest two. */
1717 if (!isViewPostPage()) {
1718 getTranslation("WebInterface.ClickToShow.Replies", function(text) {
1719 $("#sone .post .replies").each(function() {
1720 allReplies = $(this).find(".reply");
1721 if (allReplies.length > 2) {
1723 for (replyIndex = 0; !newHidden && (replyIndex < (allReplies.length - 2)); ++replyIndex) {
1724 $(allReplies[replyIndex]).addClass("hidden");
1725 newHidden |= $(allReplies[replyIndex]).hasClass("new");
1727 clickToShowElement = $("<div></div>").addClass("click-to-show");
1729 clickToShowElement.addClass("new");
1731 (function(clickToShowElement, allReplies, text) {
1732 clickToShowElement.text(text);
1733 clickToShowElement.click(function() {
1734 allReplies.removeClass("hidden");
1735 clickToShowElement.addClass("hidden");
1737 })(clickToShowElement, allReplies, text);
1738 $(allReplies[0]).before(clickToShowElement);
1744 $("#sone .sone").each(function() {
1745 ajaxifySone($(this));
1748 /* process all existing notifications, ajaxify dismiss buttons. */
1749 $("#sone #notification-area .notification").each(function() {
1750 ajaxifyNotification($(this));
1753 /* disable all permalinks. */
1754 $(".permalink").click(function() {
1758 /* activate status polling. */
1759 setTimeout(getStatus, 5000);
1761 /* reset activity counter when the page has focus. */
1762 $(window).focus(function() {
1765 }).blur(function() {