This is an old revision of the document!
Table of Contents
Logon
The configured Logon Module is executed for every Terminal Server logon (excluding QWKnet logons).
The name of the logon module (by default, logon) is configured in SCFG->System->Loadable Modules->Logon.
The default logon module is exec/logon.js and supports the following configuration options in the [logon] section of the ctrl/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 ecWeb External Programs support) |
| rlogin_xtrn_menu | false | RLogin server acts as a door game server (displays the external program menu) only |
| last_few_callers | 4 | Number of most-recent logons displayed during logon |
| email_validation | false | Run the 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 string that specifies a subset of users which may use the fast-logon option |
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.
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 mods directory before modifying.
