Mercurial > prosody-wiki
annotate mod_ircd.wiki @ 235:678b7b96f890
Edited wiki page mod_ircd through web user interface.
author | MWild1@gmail.com |
---|---|
date | Wed, 30 Nov 2011 23:16:07 +0000 |
parents | b5e76dc1ac2f |
children | aa80afcf1282 |
rev | line source |
---|---|
102 | 1 #summary IRC to XMPP interface to allow IRC clients to connect to chatrooms |
2 #labels Stage-Alpha | |
3 | |
235
678b7b96f890
Edited wiki page mod_ircd through web user interface.
MWild1@gmail.com
parents:
234
diff
changeset
|
4 *NOTE: Consider this module currently more of a fun experiment than a serious project for use in production. Note the 'alpha' tag and have fun!* |
234
b5e76dc1ac2f
Edited wiki page mod_ircd through web user interface.
MWild1@gmail.com
parents:
233
diff
changeset
|
5 |
102 | 6 = Introduction = |
7 | |
103 | 8 Whether you like it or not, XMPP is the future, but that pesky IRC just won't go away :) |
102 | 9 |
103 | 10 With this module you can set up a special host on your server to allow connections from IRC clients and bots. They are able to join XMPP chatrooms on a specified conference server. |
102 | 11 |
12 = Usage = | |
103 | 13 In your config file put something similar to the following: |
102 | 14 |
15 {{{ | |
233
4824ae8b1f1a
mod_ircd wiki: updated to reflect changes.
Marco Cirillo <maranda@lightwitch.org>
parents:
226
diff
changeset
|
16 Component "irc2muc.example.com" "ircd" |
102 | 17 conference_server = "conference.example.com" |
233
4824ae8b1f1a
mod_ircd wiki: updated to reflect changes.
Marco Cirillo <maranda@lightwitch.org>
parents:
226
diff
changeset
|
18 listener_port = 7000 |
102 | 19 }}} |
20 | |
103 | 21 If you don't want your IRC users to have connectivity outside your server then there is no need for the hostnames you specify to be valid DNS entries. |
22 | |
223 | 23 = Warning = |
24 | |
233
4824ae8b1f1a
mod_ircd wiki: updated to reflect changes.
Marco Cirillo <maranda@lightwitch.org>
parents:
226
diff
changeset
|
25 The plugin stability, and/or serving compatibility with most of the IRC clients is yet to be determined. |
223 | 26 |
224 | 27 = Install = |
28 | |
226 | 29 This release requires the [http://code.matthewwild.co.uk/verse/ Verse client library] as dependancy and [http://code.matthewwild.co.uk/squish/ Squish] to meld it with the plugin. |
224 | 30 |
31 Instructions: | |
32 * Clone both the Verse/Squish repo and/or download the latest tips from 'em (in that case you'll have to decompress the tip zips/tarballs) | |
33 * Edit Verse's squish file so that all plugins cept the presence and groupchat ones will be commented | |
34 * In your Squish directory type make install | |
35 * Run squish.lua --use-http into your Verse's directory, and move verse.lua into where mod_ircd files from google code's HG are stored | |
36 * Run squish.lua again | |
225
cef6ddd139aa
dusted bad character code.
Marco Cirillo <maranda@lightwitch.org>
parents:
224
diff
changeset
|
37 * Move the mod_ircd.out.lua to your prosody's plugin directory renaming it back to mod_ircd.lua |
224 | 38 |
102 | 39 = Compatibility = |
223 | 40 ||0.8||Works|| |
41 ||0.7||Uncertain|| | |
42 ||0.6||Uncertain|| | |
102 | 43 |
44 = Todo = | |
45 * Authentication | |
46 * SSL | |
234
b5e76dc1ac2f
Edited wiki page mod_ircd through web user interface.
MWild1@gmail.com
parents:
233
diff
changeset
|
47 * Many improvements to handling of IRC and XMPP |