friendica-addons/jappixmini/README

37 lines
1.6 KiB
Text
Raw Normal View History

2012-04-13 17:05:16 +02:00
Jappix Mini Plugin
==================
This quick-and-dirty addon allows you to add a Jabber-based, Facebook-like chat
to Friendica. It uses Jappix Mini.
It is necessary to use a BOSH host - so to use this plugin, each users need to
know the address of a BOSH host that works with his account. The BOSH server of
2012-04-14 18:41:11 +02:00
the Jappix project (https://bind.jappix.com/) is not locked to a specific XMPP
provider, but keep in mind that only personal usage is approved according to
http://codingteam.net/project/jappix/doc/BoshServer.
If you have a larger server, it is recommended that you install your own BOSH
2012-04-16 21:16:24 +02:00
server and recommend it using the configuration help field. If it is on the
same server, you can also deactivate the BOSH proxy. This should improve the
performance.
2012-04-13 17:05:16 +02:00
2012-04-14 18:41:11 +02:00
The addon has an experimental autosubscribe and autosuggest functionality which
tries to add your Friendica contacts to your roster automatically.
2012-04-13 17:05:16 +02:00
2012-04-14 18:23:42 +02:00
Limitations:
- Jabber passwords can only be encrypted if they are at most 39 characters
2012-04-14 18:41:11 +02:00
long.
2012-04-14 18:23:42 +02:00
2012-04-13 17:05:16 +02:00
Installation
------------
Jappix Mini (AGPL license) is not distributed with this addon. You need to
install it manually:
* Download latest jappix version from https://github.com/jappix/jappix/tags to
addon/jappixmini/jappix.zip. Really make sure you name it 'jappix.zip' - the
download link required by the AGPL points there.
* Unpack the zip file to addon/jappixmini/jappix/. Do not delete jappix.zip.
* Delete the file addon/jappixmini/jappix/index.php. This is important, because
2012-04-16 23:38:21 +02:00
otherwise the installer of Jappix would be publicly accessible. If you are
lucky, the file is deleted automatically by the addon.