This chapter covers how to configure your Wollabot.
The configuration of Wollabot takes place using a simple configuration file. The file is called wollabot.ini and is placed in the root-directory of your Wollabot installation. Here's a sample configuration file:
[main] ; IRC preferences server = "irc.quakenet.org" port = "6667" nickname = "wollabot" username = "w0114" [modules] ; Base module - DO NOT remove those unless you know what you're doing loadmodule = "Wollabot_Base.php" ; User modules - Put your own modules here loadmodule = "google.php" loadmodule = "phpfunctions.php" loadmodule = "nickometer.php"; [channel] name = "#wollabot" on_join = "PRIVMSG #wollabot :Hello, I'm a Wollabot\PRIVMSG #wollabot :Visit my website at http://wollabot.sourceforge.net" key = "" [channel] name = "#quux" on_join = "" key = "foobar"
The main philosophy behind the configuration file is for it to be mostly self-explanatory. However we will provide you with an overview here. It consists of configuration categories defined using square brackets ([category]). Each configuration category has it's own different configuration properties. These i will go through here:
server - This is the IRC server the bot should connect to. For QuakeNet it could be 'irc.quakenet.org'.
port - The port to connect to. Usually '6667'.
nickname - The nickname of the bot. The name other users on IRC would recognize it as.
username - If not running some sort of ident server on your connection, this will be the username (eg. the part before the '@' in your 'user@host' string.
loadmodule - This setting indicates which modules should be loaded. Supply one module for each directive.
name - This is a channel name, which Wollabot will join when connected (eg. '#wollabot').
on_join - A raw IRC message sent after the join. Multiple messages can be specified using '\' (backslash) as a seperator.
key - This is the password (key) for a given channel. Used if the channel has '+k' channel mode.