GNUsocial/gnu-social
4
0
Fork 1
Code Issues Releases Wiki Activity
Files
b7d45e176b4314850dfbae9c60ff7055d292ba08
gnu-social/plugins/Xmpp/README

44 lines
1.3 KiB
Plaintext
Raw Normal View History

Update translator documentation. Whitespace updates. Line break changes in README. i18n updates.
2011-06-15 13:20:23 +02:00
The XMPP plugin allows users to send and receive notices over the
XMPP/Jabber/GTalk network.
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
Installation
============
add "addPlugin('xmpp',
array('setting'=>'value', 'setting2'=>'value2', ...);"
to the bottom of your config.php
Update translator documentation. Whitespace updates. Line break changes in README. i18n updates.
2011-06-15 13:20:23 +02:00
The daemon included with this plugin must be running. It will be
started by the plugin along with their other daemons when you run
Improved plugins/Xmpp/README Added the relevant section in INSTALL about queues and daemons to get the plugin runnig. Made resource required, as otherwise XMPPHP will send invalid from JIDs in it's stanzas. For example when my configuration didn't had the resource part, outbound stanzas looked like this: <message from="gnusocial@example.de/" to="flow@example.de" type='chat'> <body> User &quot;flow&quot; on GNU Social has said that your XMPP/Jabber/GTalk screenname belongs to them. … </body> </message> Note the '/' at the end of the from attribute, without an actual XMPP resource. But according to RFC6122 2.1 "every allowable portion of a JID MUST NOT be zero bytes in length". Causing a jid-malformed response from the server. Also, it's nice to know that debug=true will print out all sent and received stanzas, which helped me to debug the problem. Furthermore I add a note that if the XMPP services uses DNS SRV records, 'host' has to be configured (in cases where service host != xmpp domain).
2013-10-19 12:19:00 +02:00
scripts/startdaemons.sh. See the section "Queues and daemons" in
INSTALL for more about queuing and daemons.
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
Settings
========
user*: user part of the jid
server*: server part of the jid
Improved plugins/Xmpp/README Added the relevant section in INSTALL about queues and daemons to get the plugin runnig. Made resource required, as otherwise XMPPHP will send invalid from JIDs in it's stanzas. For example when my configuration didn't had the resource part, outbound stanzas looked like this: <message from="gnusocial@example.de/" to="flow@example.de" type='chat'> <body> User &quot;flow&quot; on GNU Social has said that your XMPP/Jabber/GTalk screenname belongs to them. … </body> </message> Note the '/' at the end of the from attribute, without an actual XMPP resource. But according to RFC6122 2.1 "every allowable portion of a JID MUST NOT be zero bytes in length". Causing a jid-malformed response from the server. Also, it's nice to know that debug=true will print out all sent and received stanzas, which helped me to debug the problem. Furthermore I add a note that if the XMPP services uses DNS SRV records, 'host' has to be configured (in cases where service host != xmpp domain).
2013-10-19 12:19:00 +02:00
resource*: resource part of the jid
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
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.
Improved plugins/Xmpp/README Added the relevant section in INSTALL about queues and daemons to get the plugin runnig. Made resource required, as otherwise XMPPHP will send invalid from JIDs in it's stanzas. For example when my configuration didn't had the resource part, outbound stanzas looked like this: <message from="gnusocial@example.de/" to="flow@example.de" type='chat'> <body> User &quot;flow&quot; on GNU Social has said that your XMPP/Jabber/GTalk screenname belongs to them. … </body> </message> Note the '/' at the end of the from attribute, without an actual XMPP resource. But according to RFC6122 2.1 "every allowable portion of a JID MUST NOT be zero bytes in length". Causing a jid-malformed response from the server. Also, it's nice to know that debug=true will print out all sent and received stanzas, which helped me to debug the problem. Furthermore I add a note that if the XMPP services uses DNS SRV records, 'host' has to be configured (in cases where service host != xmpp domain).
2013-10-19 12:19:00 +02:00
debug (false): log extra debug info (e.g. sent/recv XMPP stanzas)
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
public: list of jid's that should get the public feed (firehose)
* required
default values are in (parenthesis)
Improved plugins/Xmpp/README Added the relevant section in INSTALL about queues and daemons to get the plugin runnig. Made resource required, as otherwise XMPPHP will send invalid from JIDs in it's stanzas. For example when my configuration didn't had the resource part, outbound stanzas looked like this: <message from="gnusocial@example.de/" to="flow@example.de" type='chat'> <body> User &quot;flow&quot; on GNU Social has said that your XMPP/Jabber/GTalk screenname belongs to them. … </body> </message> Note the '/' at the end of the from attribute, without an actual XMPP resource. But according to RFC6122 2.1 "every allowable portion of a JID MUST NOT be zero bytes in length". Causing a jid-malformed response from the server. Also, it's nice to know that debug=true will print out all sent and received stanzas, which helped me to debug the problem. Furthermore I add a note that if the XMPP services uses DNS SRV records, 'host' has to be configured (in cases where service host != xmpp domain).
2013-10-19 12:19:00 +02:00
Note that setting 'host' is required if the XMPP service is configured
with DNS SRV records, since the XMPPHP does currently not support SRV
lookups.
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
Example
=======
addPlugin('xmpp', array(
Syntax error in XMPP config example
2013-08-28 18:00:23 +02:00
'user'=>'update',
Improved plugins/Xmpp/README Added the relevant section in INSTALL about queues and daemons to get the plugin runnig. Made resource required, as otherwise XMPPHP will send invalid from JIDs in it's stanzas. For example when my configuration didn't had the resource part, outbound stanzas looked like this: <message from="gnusocial@example.de/" to="flow@example.de" type='chat'> <body> User &quot;flow&quot; on GNU Social has said that your XMPP/Jabber/GTalk screenname belongs to them. … </body> </message> Note the '/' at the end of the from attribute, without an actual XMPP resource. But according to RFC6122 2.1 "every allowable portion of a JID MUST NOT be zero bytes in length". Causing a jid-malformed response from the server. Also, it's nice to know that debug=true will print out all sent and received stanzas, which helped me to debug the problem. Furthermore I add a note that if the XMPP services uses DNS SRV records, 'host' has to be configured (in cases where service host != xmpp domain).
2013-10-19 12:19:00 +02:00
'resource'=>'social,
Syntax error in XMPP config example
2013-08-28 18:00:23 +02:00
'server'=>'identi.ca',
Create IM plugin, Pluginize XMPP, Create AIM plugin
2010-01-23 01:25:27 -05:00
'password'=>'...',
'public'=>array('bob@aol.com', 'sue@google.com')
));
Copy Permalink