1786
|
1 |
#summary IRC to XMPP interface to allow IRC clients to connect to chatrooms |
|
2 |
#labels Stage-Alpha, Deprecated |
|
3 |
|
|
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!* |
|
5 |
|
|
6 |
= Introduction = |
|
7 |
|
|
8 |
Whether you like it or not, XMPP is the future, but that pesky IRC just won't go away :) |
|
9 |
|
|
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. |
|
11 |
|
|
12 |
= Usage = |
|
13 |
In your config file put something similar to the following: |
|
14 |
|
|
15 |
{{{ |
|
16 |
Component "irc2muc.example.com" "ircd" |
|
17 |
conference_server = "conference.example.com" -- required |
|
18 |
listener_port = 7000 |
|
19 |
}}} |
|
20 |
|
|
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 |
|
|
23 |
= Warning = |
|
24 |
|
|
25 |
The plugin stability, and/or serving compatibility with most of the IRC clients is yet to be determined. |
|
26 |
|
|
27 |
= Install = |
|
28 |
|
|
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. |
|
30 |
|
|
31 |
Instructions (temporarily changed): |
|
32 |
* Clone the Squish repo and/or download the latest tip from it (in that case you'll have to decompress the tip zip/tarball) |
|
33 |
* In your Squish directory type make install |
|
34 |
* Back into your mod_ircd directory call squish with --verse=./verse/verse.lua |
|
35 |
* Move the mod_ircd.lua file to your prosody's plugins directory |
|
36 |
|
|
37 |
= Compatibility = |
|
38 |
||0.8||Works|| |
|
39 |
||0.7||Uncertain|| |
|
40 |
||0.6||Doesn't work|| |
|
41 |
|
|
42 |
= Todo = |
|
43 |
* Authentication |
|
44 |
* SSL |
|
45 |
* Many improvements to handling of IRC and XMPP |