gnu-social/plugins/Xmpp
Mikael Nordfeldth 09ef1fff69 NoticeListItem attentions showed double for User_group
...because they each have their own Profile now! Whiie!
2013-10-30 12:56:17 +01:00
..
extlib/XMPPHP Move XMPPHP from core extlibs to Xmpp plugin extlibs 2010-05-05 16:52:31 -07:00
lib Plugin onAutoload replaces _ with / in lib paths, this renames some classes. 2013-10-02 14:07:53 +02:00
locale Localisation updates from http://translatewiki.net. 2012-06-30 11:10:38 +00:00
README NoticeListItem attentions showed double for User_group 2013-10-30 12:56:17 +01:00
XmppPlugin.php Use addPlugin! (esp. XMPP folks should do this) 2013-10-30 12:28:39 +01:00

README

The XMPP plugin allows users to send and receive notices over the
XMPP/Jabber/GTalk network.

Installation
============
add "addPlugin('xmpp',
    array('setting'=>'value', 'setting2'=>'value2', ...);"
to the bottom of your config.php

The daemon included with this plugin must be running. It will be
started by the plugin along with their other daemons when you run
scripts/startdaemons.sh. See the section "Queues and daemons" in
INSTALL for more about queuing and daemons.


Settings
========
user*: user part of the jid
server*: server part of the jid
resource (gnusocial): resource part of the jid
port (5222): port on which to connect to the server
encryption (true): use encryption on the connection
host (same as server): host to connect to. Usually, you won't set this.
debug (false): log extra debug info (e.g. sent/recv XMPP stanzas)
public: list of jid's that should get the public feed (firehose)

* required
default values are in (parenthesis)

Note that setting 'host' is required if the XMPP service is configured
with DNS SRV records, since XMPPHP does currently not support SRV
lookups.


Example
=======
addPlugin('xmpp', array(
    'user'=>'update',
    'resource'=>'social',
    'server'=>'identi.ca',
    'password'=>'...',
    'public'=>array('bob@aol.com', 'sue@google.com')
));