dbot/modules/admin
Douglas Gardner a53eb5e0d2 begin transition from English to ISO-639 with #234
This patch converts all English language strings used within
depressionbot's localisation interface (that is, strings.json) to their
ISO-639-1 equivalents.

The purpose of this patch is to make the strings.json file less
English-dependent.

All languages with an ISO-639-1 code have been converted; that is,
English, Spanish and Welsh, to ``en``, ``es`` and ``cy`` respectively.

This patch does not attempt to force a solution to the issue of Na'vi:
the language does not have a large enough corpus to warrant its own ISO
639-3 code, and as such there is no perfect solution. For the time
being, this patch keeps the Na'vi language as its English language
string ("Na'vi"). A possible solution to this discrepancy includes using
the ISO 639-3 code ``art``, used for artificial languages that do not
qualify for an official code, or by using local use codes specified
in ISO 639-3 (qaa to qtz).

This patch requires collaboration with upstream repositories that also
use strings.json, such as the Github and Stats modules.
2013-02-12 18:39:15 +00:00
..
admin.js remove useless crap from modules [#136] 2013-01-15 16:54:51 +00:00
commands.js Restrict version command to admin 2013-02-11 16:36:01 +00:00
config.json Add dependency info [#187] 2013-01-21 20:50:23 +00:00
README.md Module documentation for Admin module [#75] 2012-12-30 17:26:04 +00:00
strings.json begin transition from English to ISO-639 with #234 2013-02-12 18:39:15 +00:00

Admin

Administrator functionality.

Description

Various administration functionality such as banning users, hot-reloading the code and ordering him to talk. Note that commands added here are handled with their own listener, rather than being part of the command logic which is handled by the Command module. Functionality in this module can be slightly unsafe as not everything is thoroughly sanity checked.

Commands

join [#channel]

Join the given channel.

part [#channel]

Leave the given channel.

opme [#channel]

Gives the caller ops in a given channel if possible. If called without a channel, it will attempt to give the caller ops in the current channel.

greload

Perform a git pull, and then execute the reload command. Saves a lot of time updating!

reload

Reload all of the modules currently in use by DBot. By using this, all module functionality should be reloadable and replaceable without having to restart the bot or interrupt the connection to the server.

say [#channel] [message]

Have DBot post the given message in the given channel (uses the server from which you are sending the message). You may replace channel with @ to have him post the message in the current channel. Channel may also be replaced with a nick on the server.

load [module]

Load a new module. This works by adding a module name to the roster and then triggering a reload of all modules, at which point the new module is actually loaded by the standard DBot process.

unload [module]

Unload a currently loaded module. This removes the module, and then triggers a reload of all modules.

ban [user] [command]

Ban a user from using a command. Command may be replaced with *, which will ban a user from use of all commands. Users banned from all commands will still be subject to module listeners.

unban [user] [command]

Unban a user from using a given command. If a user was previously banned using the * wildcard, they may also be unbanned from such by replacing command with an asterisk here as well.