enigma-bbs/docs/modding/last-callers.md

---
layout: page
title: Last Callers
---
## The Last Callers Module
The built in `last_callers` module provides flexible retro last callers mod.

## Configuration
### Config Block
Available `config` block entries:
* `dateTimeFormat`: [moment.js](https://momentjs.com) style format. Defaults to current theme → system `short` format.
* `user`: User options:
    * `collapse`: Collapse or roll up entries that fall within the period specified. May be a string in the form of `30 minutes`, `3 weeks`, `1 hour`, etc.
* `sysop`: Sysop options:
    * `collapse`: Collapse or roll up entries that fall within the period specified. May be a string in the form of `30 minutes`, `3 weeks`, `1 hour`, etc.
    * `hide`: Hide all +op logins
* `actionIndicators`: Maps user actions to indicators. For example: `userDownload` to "D". Available indicators:
    * `userDownload`
    * `userUpload`
    * `userPostMsg`
    * `userSendMail`
    * `userRunDoor`
* `actionIndicatorDefault`: Default indicator when an action is not set. Defaults to "-".

Remember that entries such as `actionIndicators` and `actionIndicatorDefault` may contain pipe color codes!

### Theming
The following `itemFormat` object is provided to MCI 1 (ie: `%VM1`):
* `userId`: User ID.
* `userName`: Login username.
* `realName`: User's real name.
* `ts`: Timestamp in `dateTimeFormat` format.
* `location`: User's location.
* `affiliation` or `affils`: Users affiliations.
* `actions`: A string built by concatenating action indicators for a users logged in session. For example, given a indincator of `userDownload` mapped to "D", the string may be "-D----". The format was made popular on Amiga style boards.
Major changes around events, event log, etc. * User event log is now functional & attached to various events * Add additional missing system events * Completely re-write last_callers to have new functionality, etc. * Events.addListenerMultipleEvents() * New 'moduleInitialize' export for module init vs Event specific registerEvents * Add docs on last_callers mod 2018-07-21 20:32:06 +00:00			`---`
			`layout: page`
			`title: Last Callers`
			`---`
			`## The Last Callers Module`
			The built in `last_callers` module provides flexible retro last callers mod.

			`## Configuration`
			`### Config Block`
			Available `config` block entries:
			* `dateTimeFormat`: [moment.js](https://momentjs.com) style format. Defaults to current theme → system `short` format.
			* `user`: User options:
			* `collapse`: Collapse or roll up entries that fall within the period specified. May be a string in the form of `30 minutes`, `3 weeks`, `1 hour`, etc.
			* `sysop`: Sysop options:
			* `collapse`: Collapse or roll up entries that fall within the period specified. May be a string in the form of `30 minutes`, `3 weeks`, `1 hour`, etc.
			* `hide`: Hide all +op logins
			* `actionIndicators`: Maps user actions to indicators. For example: `userDownload` to "D". Available indicators:
			* `userDownload`
			* `userUpload`
			* `userPostMsg`
			* `userSendMail`
			* `userRunDoor`
			* `actionIndicatorDefault`: Default indicator when an action is not set. Defaults to "-".

Minor doc update 2018-07-22 18:08:30 +00:00			Remember that entries such as `actionIndicators` and `actionIndicatorDefault` may contain pipe color codes!

Major changes around events, event log, etc. * User event log is now functional & attached to various events * Add additional missing system events * Completely re-write last_callers to have new functionality, etc. * Events.addListenerMultipleEvents() * New 'moduleInitialize' export for module init vs Event specific registerEvents * Add docs on last_callers mod 2018-07-21 20:32:06 +00:00			`### Theming`
Add Who's online docs, minor doc updates to last callers, and code cleanup 2018-07-22 16:55:39 +00:00			The following `itemFormat` object is provided to MCI 1 (ie: `%VM1`):
Major changes around events, event log, etc. * User event log is now functional & attached to various events * Add additional missing system events * Completely re-write last_callers to have new functionality, etc. * Events.addListenerMultipleEvents() * New 'moduleInitialize' export for module init vs Event specific registerEvents * Add docs on last_callers mod 2018-07-21 20:32:06 +00:00			* `userId`: User ID.
Standardization work on built in user list module plus docs & code cleanup * More docs, fix some info * Code cleanup 2018-07-22 18:56:56 +00:00			* `userName`: Login username.
			* `realName`: User's real name.
Major changes around events, event log, etc. * User event log is now functional & attached to various events * Add additional missing system events * Completely re-write last_callers to have new functionality, etc. * Events.addListenerMultipleEvents() * New 'moduleInitialize' export for module init vs Event specific registerEvents * Add docs on last_callers mod 2018-07-21 20:32:06 +00:00			* `ts`: Timestamp in `dateTimeFormat` format.
Standardization work on built in user list module plus docs & code cleanup * More docs, fix some info * Code cleanup 2018-07-22 18:56:56 +00:00			* `location`: User's location.
			* `affiliation` or `affils`: Users affiliations.
Major changes around events, event log, etc. * User event log is now functional & attached to various events * Add additional missing system events * Completely re-write last_callers to have new functionality, etc. * Events.addListenerMultipleEvents() * New 'moduleInitialize' export for module init vs Event specific registerEvents * Add docs on last_callers mod 2018-07-21 20:32:06 +00:00			* `actions`: A string built by concatenating action indicators for a users logged in session. For example, given a indincator of `userDownload` mapped to "D", the string may be "-D----". The format was made popular on Amiga style boards.