XMPP backend configuration
==========================

This backend lets you connect to any Jabber/XMPP server.
To select this backend,
set `BACKEND = 'XMPP'`.

Extra Dependencies
------------------

You need to install this dependency before using Errbot with XMPP::

      pip install slixmpp pyasn1 pyasn1-modules

Account setup
-------------

You must manually register an XMPP account for the bot
on the server you wish to use.
Errbot does not support XMPP registration itself.

Configure the account by setting up `BOT_IDENTITY` as follows::

    BOT_IDENTITY = {
        'username': 'err@server.tld',  # The JID of the user you have created for the bot
        'password': 'changeme',        # The corresponding password for this user
        # 'server': ('host.domain.tld',5222), # server override
    }

By default errbot will query SRV records for the correct XMPP server and port,
which should work with a properly configured server.

If your chosen XMPP server does not have correct SRV records setup,
you can also set the `server` key to override this.

A random resource ID is assigned when errbot starts up.
You may fix the resource by appending it to the user name::

    BOT_IDENTITY = {
        'username': 'err@server.tld/resource',
    ...


Bot admins
----------

You can set `BOT_ADMINS` to configure which XMPP users are bot administrators.
For example: `BOT_ADMINS = ('gbin@someplace.com', 'zoni@somewhere.else.com')`


MUC rooms
---------

If you want the bot to join a certain chatroom when it starts up
then set `CHATROOM_PRESENCE` with a list of MUCs to join.
For example: `CHATROOM_PRESENCE = ('err@conference.server.tld',)`

*Note: don't omit the comma under any circumstance!*

You can configure the username errbot should use in chatrooms
by setting `CHATROOM_FN`.