]> git.mxchange.org Git - friendica-addons.git/blob - jappixmini/README
make bosh proxy optional, add subscribe functionality and some more improvements...
[friendica-addons.git] / jappixmini / README
1 Jappix Mini Plugin
2 ==================
3
4 This quick-and-dirty addon allows you to add a Jabber-based, Facebook-like chat
5 to Friendica. It uses Jappix Mini.
6
7 It is necessary to use a BOSH host - so to use this plugin, each users need to
8 know the address of a BOSH host that works with his account. The BOSH server of
9 the Jappix project (https://bind.jappix.com/) is not locked to a specific XMPP
10 provider, but keep in mind that only personal usage is approved according to
11 http://codingteam.net/project/jappix/doc/BoshServer.
12 If you have a larger server, it is recommended that you install your own BOSH
13 server, add it to the <bosh> tag in jappix/store/conf/hosts.xml, and disable
14 the bosh proxy in jappix/store/conf/main.xml.
15
16 The addon has an experimental autosubscribe and autosuggest functionality which
17 tries to add your Friendica contacts to your roster automatically.
18
19 Limitations:
20  - Jabber passwords can only be encrypted if they are at most 39 characters
21    long.
22
23 Installation
24 ------------
25
26 Jappix Mini (AGPL license) is not distributed with this addon. You need to
27 install it manually:
28
29 * Download latest zip file named friendica-addon-* from
30   https://github.com/Leberwurscht/jappix/tags and place the zip file in the
31   addon folder. Make sure to name it 'jappix.zip' - the download link required
32   by the AGPL points there.
33 * Unpack the zip file, rename the folder to 'jappix'. Do not delete jappix.zip.