Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
module:msglist [2020/03/02 01:42] – [modopts.ini] clean-up digital manmodule:msglist [2023/07/20 12:20] (current) – [Menu Command] Clarify about v3.17 and earlier and v3.20 and later key mapping method digital man
Line 1: Line 1:
-====== Message Listing / Viewing ======+====== Message List ======
  
 This module (''msglist.js'') can be used as a full-screen scrolling user interface for listing messages (public posts and private email messages) and reading and replying to messages. This module (''msglist.js'') can be used as a full-screen scrolling user interface for listing messages (public posts and private email messages) and reading and replying to messages.
 +
 +{{:module:msglist_screenshot.png?600|}}
  
 This module was first demonstrated in this [[https://www.youtube.com/watch?v=5mwimlWJOko|video]]. This module was first demonstrated in this [[https://www.youtube.com/watch?v=5mwimlWJOko|video]].
 +
 +===== Dependencies =====
 +
 +For full/proper function of this module, you'll need a recent v3.17c dev-build (as of March, 2020) of Synchronet, or later.
 +
 +This module may require an update of your Synchronet ''exec/[[dir:load]]'' directory to get the latest ''.js'' load-libraries, including the newly added ''age.js''.
 +
 +The following menu files are used by this module:
 +  * ''[[dir:text]]/menu/msglist.asc''
 +  * ''[[dir:text]]/menu/msgview.asc''
  
 ===== Install ===== ===== Install =====
  
-==== Read Mail and List Msgs System Modules ====+==== System Modules ====
  
 Run ''[[util:jsexec]] msglist.js -install''. Run ''[[util:jsexec]] msglist.js -install''.
Line 15: Line 27:
 ==== Menu Command ==== ==== Menu Command ====
  
-If you wish to allow your BBS users to list sub-board messages directly from a command shell menu (e.g. using the 'L' command key from the main or message menu) add the following command key handler to the desired command shell source (''.src'') file(s):+If you wish to allow your BBS users to list sub-board messages directly from a Baja command shell menu (e.g. using the 'L' command key from the main or message menu) add the following command key handler to the desired command shell source (''.src'') file(s)
 + 
 +for Synchronet v3.18 or later: 
 + 
 +<code> 
 +cmdkey L 
 +    msg_list 
 +    end_cmd 
 + 
 +</code> 
 + 
 +for Synchronet v3.17 or older:
  
 <code> <code>
Line 24: Line 47:
  
 ... and then recompile the source file with [[util:baja]] (e.g. ''baja default.src''). ... and then recompile the source file with [[util:baja]] (e.g. ''baja default.src'').
 +
 +In Synchronet v3.20, the default command shell (''default.js'') already has main menu ''L'' command key mapped to the BBS message list function.
  
 ===== Configure ===== ===== Configure =====
Line 45: Line 70:
  
 ^ Option ^ Default ^ Description ^ ^ Option ^ Default ^ Description ^
 +| ''reverse_mail''   | true  | List mail messages in reverse chronological order (newest first) by default |
 +| ''reverse_msgs''   | true  | List sub-board messages in reverse chronological order (newest first) by default |
 | ''cache_msg_text'' | false | Cache message text in memory | | ''cache_msg_text'' | false | Cache message text in memory |
 | ''large_msg_threshold'' | 64 KBytes | Message text larger than this value will not be cached in memory | | ''large_msg_threshold'' | 64 KBytes | Message text larger than this value will not be cached in memory |
 +| ''preview_label'' | "\xd9 Preview" | Displayed string |
 +| ''preview_label_terminator'' | " \xc0" | Displayed string |
 +| ''preview_lines_fmt'' | " lines %u-%u" | Displayed string |
 +| ''preview_total_lines_fmt'' | " of %u" | Displayed string |
 | ''preview_separator'' | '\xC4' | Character for Preview Pane separator | | ''preview_separator'' | '\xC4' | Character for Preview Pane separator |
 | ''preview_properties'' | date,attributes,subject | Properties to display in the Preview Pane separator | | ''preview_properties'' | date,attributes,subject | Properties to display in the Preview Pane separator |
Line 55: Line 86:
 | ''date_fmt'' | %Y-%m-%d | Format of dates displayed in list | | ''date_fmt'' | %Y-%m-%d | Format of dates displayed in list |
 | ''date_time_fmt'' | system default | Format of date/time displayed in list | | ''date_time_fmt'' | system default | Format of date/time displayed in list |
 +| ''pause'' | true | Pause for a key-press after posting a message, or set to a duration (in seconds), or ''false'' |
 | ''beep'' | true | Console alerts/beeps are enabled | | ''beep'' | true | Console alerts/beeps are enabled |
 | ''view_lines_fmt'' | "%slines %u-%u" | Displayed string | | ''view_lines_fmt'' | "%slines %u-%u" | Displayed string |
Line 63: Line 95:
 | ''preparing_hex_dump'' | "\x01[Preparing hex-dump ..." | Displayed string | | ''preparing_hex_dump'' | "\x01[Preparing hex-dump ..." | Displayed string |
 | ''translating_charset'' | "\x01[Translating charset ..." | Displayed string | | ''translating_charset'' | "\x01[Translating charset ..." | Displayed string |
 +| ''wrapping_lines'' | "\x01[Wrapping lines ..." | Displayed string |
 +| ''splitting_lines'' | "\x01[Splitting lines ..." | Displayed string |
 +| ''area_name_fmt'' | "\x01n\x01k\x017%s / %s\x01h" | Displayed string |
 +| ''area_nums_fmt'' | "[message %u of %u]" | Displayed string |
 +| ''attr_spam'' | "Sp" | Displayed string |
 +| ''attr_attach'' | "Att" | Displayed string |
 +| ''attr_delete'' | "Del" | Displayed string |
 +| ''attr_new''    | "New" | Displayed string |
 +| ''attr_replied'' | "Re" | Displayed string |
 +| ''attr_read''    | "Rd" | Displayed string |
 +| ''attr_perm''    | "Perm" | Displayed string |
 +| ''attr_anon''    | "Anon" | Displayed string |
 +| ''attr_locked''  | "Lck" | Displayed string |
 +| ''attr_kill''    | "Kill" | Displayed string |
 +| ''attr_noreply'' | "NoRe" | Displayed string |
 +| ''attr_mod''     | "Mod" | Displayed string |
 +| ''attr_valid''   | "Valid" | Displayed string |
 +| ''attr_private'' | "Priv" | Displayed string |
 +| ''attr_poll''    | "Poll" | Displayed string |
 +| ''attr_sent''    | "Sent" | Displayed string |
 +| ''attr_intransit'' | "InTransit" | Displayed string |
 +| ''attr_sep''       | " " | Displayed string |
  
 ===== See Also ===== ===== See Also =====