====== Chat Section ======

This module (''[[dir:exec]]/[[https://gitlab.synchro.net/main/sbbs/-/blob/master/exec/chat_sec.js|chat_sec.js]]'') displays the "Chat" [[https://gitlab.synchro.net/main/sbbs/-/blob/master/text/menu/chat.msg|menu]]/prompt from the [[server:Terminal]] Server accepts/acts upon user input (hot keys) to perform chat-related functions.
<file>
┌───────────┐
│ Chat Menu │
└───────────┘▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
█▀            Join a Chat            ▀█
█ J Join/initiate multinode chat      █
█ P Join/start private node/node chat █
█ C Chat with Sysop: Not Available    █
█ T Talk with The Guru (AI)           █
█ F Finger (query) remote user/system █
█ R Internet Relay Chat (IRC)         █
█ I InterBBS Instant Messaging        █
█               Toggles               █
█ D Chat availability      state: On  █
█ A Node activity alerts   state: On  █
█ S Split-screen chat      state: On  █
█                                     █
█ Q Quit chat menu                    █
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
Chat: 
</file>

===== Configure =====

This module supports the following configuration options in the ''[chat]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:

^ Option       ^ Default               ^ Description ^
| finger       | true                  | Allow finger client use |
| imsg         | true                  | Allow inter-BBS instant messenger use |
| irc          | true                  | Allow IRC client use                  |
| irc_server   | irc.synchro.net 6667  | Comma-separated list of IRC Server addresses and (optional) TCP port |
| irc_channel  | #Synchronet           | Comma-separated list of IRC Channels to auto-join |
| irc_seclevel | 90                    | Security level required to change IRC server/channel parameters |

==== Servers-specific Channel Lists ====

Do you have multiple IRC servers configured in ''modopts.ini'' and you want a different channel list per server? Just add more
keys to the ''modopts.ini [chat_sec]'' section of the form:
  <server>=<channel_list>

Where ''<server>'' is the IRC server's host name (e.g. ''irc.synchro.net'')
and ''<channel_list>'' is a comma-separated list of channels to override
the default list of channels (set with the ''irc_channel'' key).
===== Install =====

==== SBBS v3.20 ====

In Synchronet v3.20, [[util:SCFG]]->System->Loadable Modules->Chat Section is set by default to "chat_sec" and will be automatically invoked with the [[custom:JavaScript]] ''bbs.chat_sec()'' method or the Baja ''chat_section'' function call.

==== SBBS v3.19 and earlier ====
With older versions of Synchronet, this module should be installed in stock command shells by default (over-riding the hard-coded "Chat" menu logic). To install into additional command shells, replace the following line(s) in ''[[dir:exec]]/*.src'':
  chat_section
with:
  exec_bin chat_sec
  
And then recompile with [[util:Baja]] - or just run the [[module:update]] module.

===== See Also =====
  * [[:module:|Modules]]

{{tag>chat}}