1 // This module handles the view for "forum" (message board) rooms.
3 // Copyright (c) 2016-2023 by the citadel.org team
5 // This program is open source software. Use, duplication, or
6 // disclosure is subject to the GNU General Public License v3.
10 function forum_readmessages(target_div_name, gt_msg, lt_msg) {
11 target_div = document.getElementById(target_div_name);
12 original_text = target_div.innerHTML; // in case we need to replace it after an error
13 target_div.innerHTML = ""
15 if (lt_msg < 9999999999) {
16 url = "/ctdl/r/" + escapeHTMLURI(current_room) + "/msgs.lt|" + lt_msg;
19 url = "/ctdl/r/" + escapeHTMLURI(current_room) + "/msgs.gt|" + gt_msg;
22 fetch_msg_list = async() => {
23 response = await fetch(url);
24 msgs = await(response.json());
26 target_div.innerHTML = "" ;
28 // If we were given an explicit starting point, by all means start there.
29 // Note that we don't have to remove them from the array because we did a 'msgs gt|xxx' command to Citadel.
31 msgs = msgs.slice(0, messages_per_page);
34 // Otherwise, show us the last 20 messages
36 if (msgs.length > messages_per_page) {
37 msgs = msgs.slice(msgs.length - messages_per_page);
39 new_old_div_name = randomString();
40 if (msgs.length < 1) {
46 target_div.innerHTML +=
47 "<div id=\"" + new_old_div_name + "\">" +
48 "<div class=\"ctdl-forum-nav\" " +
49 "onclick=\"javascript:forum_readmessages('" + new_old_div_name + "', 0, " + newlt + ");\">" +
50 "<i class=\"fa fa-arrow-circle-up\"></i> " +
51 _("Older posts") + " <i class=\"fa fa-arrow-circle-up\"></div></div></a></div></div>" ;
54 // The messages will go here.
55 let msgs_div_name = randomString();
56 target_div.innerHTML += "<div id=\"" + msgs_div_name + "\"> </div>" ;
58 if (lt_msg == 9999999999) {
59 new_new_div_name = randomString();
60 if (msgs.length <= 0) {
64 newgt = msgs[msgs.length-1];
66 target_div.innerHTML +=
67 "<div id=\"" + new_new_div_name + "\">" +
68 "<div id=\"ctdl-newmsg-here\"></div>" +
69 "<div class=\"ctdl-forum-nav\" " +
70 "onClick=\"javascript:forum_readmessages('" + new_new_div_name + "', " + newgt + ", 9999999999);\">" +
71 "<i class=\"fa fa-arrow-circle-down\"></i> " +
72 _("Newer posts") + " <i class=\"fa fa-arrow-circle-down\"></div></div>" ;
75 // Now figure out where to scroll to after rendering.
79 else if (lt_msg < 9999999999) {
80 scroll_to = msgs[msgs.length-1];
82 else if ( (logged_in) && (gt_msg == 0) && (lt_msg == 9999999999) ) {
83 scroll_to = msgs[msgs.length-1];
86 scroll_to = msgs[0]; // FIXME this is too naive
89 // Render the individual messages in the divs
90 forum_render_messages(msgs, msgs_div_name, scroll_to)
93 // if xhr fails, this will make the link reappear so the user can try again
94 target_div.innerHTML = original_text;
99 // make the nav buttons appear (post a new message, skip this room, goto next room)
101 document.getElementById("ctdl-newmsg-button").innerHTML = `<i class="fa fa-edit"></i> ` + _("Post message");
102 document.getElementById("ctdl-newmsg-button").style.display = "block";
104 document.getElementById("ctdl-skip-button").innerHTML = _("Skip this room") + ` <i class="fa fa-arrow-alt-circle-right"></i>`;
105 document.getElementById("ctdl-skip-button").style.display = "block";
107 document.getElementById("ctdl-goto-button").innerHTML = _("Goto next room") + ` <i class="fa fa-arrow-circle-right"></i>`;
108 document.getElementById("ctdl-goto-button").style.display = "block";
112 // Render a range of messages into the specified target div
113 function forum_render_messages(message_numbers, msgs_div_name, scroll_to) {
115 // Build an array of Promises and then wait for them all to resolve.
116 let num_msgs = message_numbers.length;
117 let msg_promises = Array.apply(null, Array(num_msgs));
118 for (i=0; i<num_msgs; ++i) {
119 msg_promises[i] = fetch("/ctdl/r/" + escapeHTMLURI(current_room) + "/" + message_numbers[i] + "/json")
120 .then(response => response.json())
127 // Here is the async function that waits for all the messages to be loaded, and then renders them.
128 fetch_msg_list = async() => {
129 document.body.style.cursor = "wait";
130 activate_loading_modal();
131 await Promise.all(msg_promises);
132 deactivate_loading_modal();
133 document.body.style.cursor = "default";
135 // At this point all of the Promises are resolved and we can render.
136 // Note: "let" keeps "i" in scope even through the .then scope
137 let scroll_to_div = null;
138 for (let i=0; i<num_msgs; ++i) {
139 msg_promises[i].then((one_message) => {
140 let new_msg_div = forum_render_one(one_message, null);
141 document.getElementById(msgs_div_name).append(new_msg_div);
142 if (message_numbers[i] == scroll_to) {
143 scroll_to_div = new_msg_div;
145 if (i == num_msgs - 1) {
146 scroll_to_div.scrollIntoView({behavior: "smooth", block: "start", inline: "nearest"});
154 // Make a note of the highest message number we saw, so we can mark it when we "Goto next room"
155 // (Compared to the text client, this is actually more like <A>bandon than <G>oto)
156 if ((num_msgs > 0) && (message_numbers[num_msgs-1] > last_seen)) {
157 last_seen = message_numbers[num_msgs-1];
162 // Render a message. Returns a div object.
163 function forum_render_one(msg, existing_div) {
165 if (existing_div != null) { // If an existing div was supplied, render into it
168 else { // Otherwise, create a new one
169 div = document.createElement("div");
172 mdiv = randomString(); // Give the div a new name
177 "<div class=\"ctdl-fmsg-wrapper\">" // begin message wrapper
178 + render_userpic(msg.from) // user avatar
179 + "<div class=\"ctdl-fmsg-content\">" // begin content
180 + "<div class=\"ctdl-msg-header\">" // begin header
181 + "<span class=\"ctdl-msg-header-info\">" // begin header info on left side
182 + render_msg_author(msg, views.VIEW_BBS) // author
183 + "<span class=\"ctdl-msgdate\">"
184 + string_timestamp(msg.time,0)
185 + "</span>" // end msgdate
186 + "</span>" // end header info on left side
187 + "<span class=\"ctdl-msg-header-buttons\">" // begin buttons on right side
189 + "<span class=\"ctdl-msg-button\">" // Reply
190 + "<a href=\"javascript:open_reply_box('"+mdiv+"',false,'"+msg.wefw+"','"+msg.msgn+"');\">"
191 + "<i class=\"fa fa-reply\"></i> "
195 + "<span class=\"ctdl-msg-button\">" // ReplyQuoted
196 + "<a href=\"javascript:open_reply_box('"+mdiv+"',true,'"+msg.wefw+"','"+msg.msgn+"');\">"
197 + "<i class=\"fa fa-comment\"></i> "
201 if (can_delete_messages) {
203 "<span class=\"ctdl-msg-button\">"
204 + "<a href=\"javascript:forum_delete_message('"+mdiv+"','"+msg.msgnum+"');\">"
205 + "<i class=\"fa fa-trash\"></i> "
211 "</span>"; // end buttons on right side
214 "<br><span class=\"ctdl-msgsubject\">" + msg.subj + "</span>";
217 "</div>" // end header
218 + "<div class=\"ctdl-msg-body\" id=\"" + mdiv + "_body\">" // begin body
220 + "</div>" // end body
221 + "</div>" // end content
222 + "</div>" // end wrapper
226 outmsg = "<div class=\"ctdl-fmsg-wrapper\">" + err.message + "</div>";
229 div.innerHTML = outmsg;
234 // Compose a references string using existing references plus the message being replied to
235 function compose_references(references, msgid) {
236 if (references.includes("@")) {
237 refs = references + "|";
244 // If the resulting string is too big, we can trim it here
245 while (refs.length > 900) {
247 r.splice(1,1); // remove the second element so we keep the root
254 // We don't bother checking for permission because the button only appears if we have permission,
255 // and even if someone hacks the client, the server will deny any unauthorized deletes.
256 function forum_delete_message(message_div, message_number) {
257 if (confirm(_("Delete this message?")) == true) {
258 async_forum_delete_message = async() => {
259 response = await fetch(
260 "/ctdl/r/" + escapeHTMLURI(current_room) + "/" + message_number,
263 if (response.ok) { // If the server accepted the delete, blank out the message div.
264 document.getElementById(message_div).outerHTML = "";
267 async_forum_delete_message();
272 // Open a reply box directly below a specific message
273 function open_reply_box(parent_div, is_quoted, references, msgid) {
274 let new_div = document.createElement("div");
275 let new_div_name = randomString();
276 new_div.id = new_div_name;
278 document.getElementById(parent_div).append(new_div);
281 "<div class=\"ctdl-fmsg-wrapper ctdl-msg-reply\">" // begin message wrapper
282 + "<div class=\"ctdl-avatar\">" // begin avatar
283 + "<img src=\"/ctdl/u/" + current_user + "/userpic\" width=\"32\" "
284 + "onerror=\"this.parentNode.innerHTML='<i class="fa fa-user-circle fa-2x"></i> '\">"
285 + "</div>" // end avatar
286 + "<div class=\"ctdl-fmsg-content\">" // begin content
287 + "<div class=\"ctdl-msg-header\">" // begin header
288 + "<span class=\"ctdl-msg-header-info\">" // begin header info on left side
289 + "<span class=\"ctdl-username\">"
290 + current_user // user = me !
292 + "<span class=\"ctdl-msgdate\">"
293 + string_timestamp((Date.now() / 1000),0) // the current date/time (temporary for display)
295 + "</span>" // end header info on left side
296 + "<span class=\"ctdl-msg-header-buttons\">" // begin buttons on right side
298 + "<span class=\"ctdl-msg-button\">" // bold button
299 + "<a href=\"javascript:void(0)\" onclick=\"forum_format('bold')\">"
300 + "<i class=\"fa fa-bold fa-fw\"></i>"
303 + "<span class=\"ctdl-msg-button\">" // italic button
304 + "<a href=\"javascript:void(0)\" onclick=\"forum_format('italic')\">"
305 + "<i class=\"fa fa-italic fa-fw\"></i>"
308 + "<span class=\"ctdl-msg-button\">" // list button
309 + "<a href=\"javascript:void(0)\" onclick=\"forum_format('insertunorderedlist')\">"
310 + "<i class=\"fa fa-list fa-fw\"></i>"
313 + "<span class=\"ctdl-msg-button\">" // link button
314 + "<a href=\"javascript:void(0)\" onclick=\"forum_display_urlbox()\">"
315 + "<i class=\"fa fa-link fa-fw\"></i>"
318 + "</span>"; // end buttons on right side
321 //"<br><span id=\"ctdl-subject\" class=\"ctdl-msgsubject\">" + "FIXME subject" + "</span>";
323 //else { // hidden filed for empty subject
324 replybox += "<span id=\"ctdl-subject\" style=\"display:none\"></span>";
327 "</div><br>" // end header
329 + "<span id=\"ctdl-replyreferences\" style=\"display:none\">" // hidden field for references
330 + compose_references(references,msgid) + "</span>"
332 + "<div class=\"ctdl-msg-body ctdl-forum-editor-body\" id=\"ctdl-editor-body\" contenteditable=\"true\">"
333 + "\n"; // empty initial content
336 replybox += "<br><blockquote>"
337 + document.getElementById(parent_div+"_body").innerHTML
344 + "<div class=\"ctdl-msg-header\">" // begin footer
345 + "<span class=\"ctdl-msg-header-info\">" // begin footer info on left side
346 + " " // (nothing here for now)
347 + "</span>" // end footer info on left side
348 + "<span class=\"ctdl-msg-header-buttons\">" // begin buttons on right side
350 + "<span class=\"ctdl-msg-button\"><a href=\"javascript:forum_save_message('" + new_div_name + "');\">"
351 + "<i class=\"fa fa-check\" style=\"color:green\"></i> " // save button
355 + "<span class=\"ctdl-msg-button\"><a href=\"javascript:forum_cancel_post('" + new_div_name + "');\">"
356 + "<i class=\"fa fa-trash\" style=\"color:red\"></i> " // cancel button
360 + "</span>" // end buttons on right side
361 + "</div><br>" // end footer
364 + "</div>" // end content
365 + "</div>" // end wrapper
367 + "<div id=\"forum_url_entry_box\" class=\"ctdl-modal ctdl-forum-urlmodal\">" // begin URL entry modal
368 + " <div class=\"ctdl-modal-header\">"
371 + " <div class=\"ctdl-modal-main\">"
372 + " <input id=\"ctdl-forum-urlbox\" placeholder=\"http://\" style=\"width:100%\">"
374 + " <div class=\"ctdl-modal-footer\">"
375 + " <p><span class=\"ctdl-msg-button\"><a href=\"javascript:forum_close_urlbox(true);\">"
376 + " <i class=\"fa fa-check\" style=\"color:green\"></i> "
379 + " <span class=\"ctdl-msg-button\"><a href=\"javascript:forum_close_urlbox(false);\">"
380 + " <i class=\"fa fa-trash\" style=\"color:red\"></i> "
384 + " <input id=\"forum_selection_start\" style=\"display:none\"></input>" // hidden fields
385 + " <input id=\"forum_selection_end\" style=\"display:none\"></input>" // to store selection range
386 + "</div>" // end URL entry modal
389 document.getElementById(new_div_name).innerHTML = replybox;
390 document.getElementById(new_div_name).scrollIntoView({behavior: "smooth", block: "end", inline: "nearest"});
392 // These actions must happen *after* the initial render loop completes.
393 setTimeout(function() {
394 var tag = document.getElementById("ctdl-editor-body");
395 tag.focus(); // sets the focus
396 window.getSelection().collapse(tag.firstChild, 0); // positions the cursor
401 // Abort a message post (it simply destroys the div)
402 function forum_cancel_post(div_name) {
403 document.getElementById(div_name).outerHTML = ""; // make it cease to exist
407 // Save the posted message to the server
408 function forum_save_message(editor_div_name) {
410 document.body.style.cursor = "wait";
411 wefw = (document.getElementById("ctdl-replyreferences").innerHTML).replaceAll("|","!"); // references (if present)
412 subj = document.getElementById("ctdl-subject").innerHTML; // subject (if present)
414 url = "/ctdl/r/" + escapeHTMLURI(current_room)
415 + "/dummy_name_for_new_message"
418 body_text = "<html><body>" + document.getElementById("ctdl-editor-body").innerHTML + "</body></html>\r\n";
420 var request = new XMLHttpRequest();
421 request.open("PUT", url, true);
422 request.setRequestHeader("Content-type", "text/html");
423 request.onreadystatechange = function() {
424 if (request.readyState == 4) {
425 document.body.style.cursor = "default";
426 if (Math.trunc(request.status / 100) == 2) {
427 headers = request.getAllResponseHeaders().split("\n");
428 for (var i in headers) {
429 if (headers[i].startsWith("etag: ")) {
430 new_msg_num = headers[i].split(" ")[1];
434 // After saving the message, load it back from the server and replace the editor div with it.
435 replace_editor_with_final_message = async() => {
436 response = await fetch("/ctdl/r/" + escapeHTMLURI(current_room) + "/" + new_msg_num + "/json");
438 newly_posted_message = await(response.json());
439 forum_render_one(newly_posted_message, document.getElementById(editor_div_name));
442 replace_editor_with_final_message();
446 error_message = request.responseText;
447 if (error_message.length == 0) {
448 error_message = _("An error has occurred.");
450 alert(error_message); // editor remains open
454 request.send(body_text);
458 // Bold, italics, etc.
459 function forum_format(command, value) {
460 document.execCommand(command, false, value);
464 // Make the URL entry box appear.
465 // When the user clicks into the URL box it will make the previous focus disappear, so we have to save it.
466 function forum_display_urlbox() {
467 document.getElementById("forum_selection_start").value = window.getSelection().anchorOffset;
468 document.getElementById("forum_selection_end").value = window.getSelection().focusOffset;
469 document.getElementById("forum_url_entry_box").style.display = "block";
473 // When the URL box is closed, this gets called. do_save is true for Save, false for Cancel.
474 function forum_close_urlbox(do_save) {
476 var tag = document.getElementById("ctdl-editor-body");
477 var start_replace = document.getElementById("forum_selection_start").value; // use saved selection range
478 var end_replace = document.getElementById("forum_selection_end").value;
479 new_text = tag.innerHTML.substring(0, start_replace)
480 + "<a href=\"" + document.getElementById("ctdl-forum-urlbox").value + "\">"
481 + tag.innerHTML.substring(start_replace, end_replace)
483 + tag.innerHTML.substring(end_replace);
484 tag.innerHTML = new_text;
486 document.getElementById("ctdl-forum-urlbox").value = ""; // clear url box for next time
487 document.getElementById("forum_url_entry_box").style.display = "none";
491 // User has clicked the "Post message" button. This is roughly the same as "reply" except there is no parent message.
492 function forum_entmsg() {
493 open_reply_box("ctdl-newmsg-here", false, "", "");
497 // RENDERER FOR THIS VIEW
498 function view_render_forums() {
499 document.getElementById("ctdl-main").innerHTML = `<div id="ctdl-mrp" class="ctdl-forum-reading-pane"></div>`;
500 forum_readmessages("ctdl-mrp", 0, 9999999999);