Next revision | Previous revisionLast revisionBoth sides next revision |
module:logon [2010/02/24 15:49] – created digitalman | module:logon [2021/07/31 18:18] – Document the new guest prompt disable options digital man |
---|
====== Logon ====== | ====== Logon ====== |
FIXME | The configured Logon Module is executed for every [[server:Terminal]] Server logon (excluding QWKnet logons). |
| |
| The name of the logon module (by default, ''logon'') is configured in [[util:SCFG]]->System->Loadable Modules->Logon. |
| |
| The [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/exec/logon.js|default logon module]] is ''[[dir:exec]]/logon.js'' and supports the following configuration options in the ''[logon]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file: |
| |
| ^ Option ^ Default ^ Description ^ |
| | show_avatar | true | Show the user's avatar during logon | |
| | draw_avatar_above | false | Draw the avatar above the current cursor position (requires ''show_avatar=true'') | |
| | draw_avatar_right | true | Draw the avatar on right edge of the screen (requires ''show_avatar=true'') | |
| | set_avatar | false | Prompt the user to choose their avatar if they don't have one | |
| | rlogin_auto_xtrn | false | Auto-execute an external program when the RLogin 'terminal-type' includes ''xtrn=//<code>//'' (e.g. for use with [[howto:ecWeb]] External Programs support)| |
| | rlogin_xtrn_menu | false | RLogin server acts as a door game server (displays the external program menu) //only// | |
| | show_logon_list | true | Set to ''false'' to disable the display of the logon list ("last few callers") during logon | |
| | email_validation | false | Run the [[module:emailval]] (user e-mail address validation) module during logon | |
| | fast_logon | false | When ''true'', allows users to choose a fast-logon by adding ''!'' in front of their login name/number | |
| | fast_logon_requirements | //none// | An [[access:requirements|access requirements string]] that specifies a subset of users which may use the fast-logon option | |
| | eval_first | //none// | JavaScript expression to evaluate (execute) very early in the module | |
| | eval_last | //none// | JavaScript expression to evaluate (execute) last thing in the module | |
| | sysop_available | ''text.dat'' LiSysopAvailable string | Comma-separated list of random sysop-is-available-for-chat status strings (displayed during logon) | |
| | sysop_unavailable | ''text.dat'' LiSysopNotAvailable string | Comma-separated list of random sysop-is-not-available-for-chat status strings (displayed during logon) | |
| | guest_name | true | Prompt for the real/full name of //Guests// during logon | |
| | guest_email | true | Prompt for the email address of //Guests// (recommended to leave enabled) | |
| | guest_location | true | Prompt for the location of //Guests// | |
| | guest_referral | true | Prompt //Guests// to provide an answer to question: "Where did you hear about this BBS?" | |
| |
| ===== Fast Logon ===== |
| |
| The logon module supports a //fast-logon// mode which bypasses the display of logon menus and the execution of interactive user logon events. |
| |
| The JavaScript variable ''bbs.sys_status'' has a bit-flag, ''SS_FASTLOGON'', which is used by the logon module to determine whether a fast-logon was requested by the user. |
| |
| The default [[module:login]] module recognizes a prepended ''!'' character on the user's login ID (name, alias, or number) as an indicator that fast logon mode was requested by the user. |
| |
| ===== Customize ===== |
| |
| If you choose to use a customized or entirely different logon module, it is recommended that you use a different module name (not "logon") and/or copy the stock logon module to your ''[[dir:mods]]'' directory before modifying. |
===== See Also ===== | ===== See Also ===== |
* [[:module:|module index]] | * [[:module:|Modules]] |
| * [[:module:Login]] Module |
| * [[:dir:exec]] Directory |
| * [[:dir:mods]] Directory |
| |