summaryrefslogtreecommitdiff
path: root/plugins/Irc/README
diff options
context:
space:
mode:
Diffstat (limited to 'plugins/Irc/README')
-rw-r--r--plugins/Irc/README45
1 files changed, 45 insertions, 0 deletions
diff --git a/plugins/Irc/README b/plugins/Irc/README
new file mode 100644
index 000000000..0a5d9ea83
--- /dev/null
+++ b/plugins/Irc/README
@@ -0,0 +1,45 @@
+The IRC plugin allows users to send and receive notices over an IRC network.
+
+Installation
+============
+add "addPlugin('irc',
+ array('setting'=>'value', 'setting2'=>'value2', ...);"
+to the bottom of your config.php
+
+scripts/imdaemon.php included with StatusNet must be running. It will be started by
+the plugin along with their other daemons when you run scripts/startdaemons.sh.
+See the StatusNet README for more about queuing and daemons.
+
+Settings
+========
+host*: Hostname of IRC server
+port: Port of IRC server (defaults to 6667)
+username*: Username of bot
+realname*: Real name of bot
+nick*: Nickname of bot
+password: Password
+nickservpassword: NickServ password for identification
+nickservidentifyregexp: Override existing regexp matching request for identification from NickServ
+channels: Channels for bot to idle in
+transporttype: Set to 'ssl' to enable SSL
+encoding: Set to change encoding
+pinginterval: Set to change the number of seconds between pings (helps keep the connection open)
+ Defaults to 120 seconds
+regcheck: Check user's nicknames are registered, enabled by default, set to false to disable
+regregexp: Override existing regexp matching response from NickServ if nick checked is registered.
+ Must contain a capturing group catching the nick
+unregregexp: Override existing regexp matching response from NickServ if nick checked is unregistered
+ Must contain a capturing group catching the nick
+
+* required
+
+Example
+=======
+addPlugin('irc', array(
+ 'host' => '...',
+ 'username' => '...',
+ 'realname' => '...',
+ 'nick' => '...',
+ 'channels' => array('#channel1', '#channel2')
+));
+