Both sides previous revisionPrevious revisionNext revision | Previous revision |
module:msglist [2020/03/02 22:47] – More modopts keys/default-values digital man | module: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 |
---|
====== 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''. |
==== 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> |
| |
... 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 ===== |
| |
^ 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 | |
| ''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 | |