xmpp.chapril.org-conversejs/README.rst

64 lines
2.0 KiB
ReStructuredText
Raw Normal View History

2012-10-23 21:01:24 +02:00
===========
2012-07-21 11:14:22 +02:00
converse.js
===========
Converse.js_ implements an XMPP_ based instant messaging client in the browser.
2012-10-23 21:01:24 +02:00
2013-03-01 09:55:54 +01:00
It is used by collective.xmpp.chat_, which is a Plone_ instant messaging add-on.
The ultimate goal is to enable anyone to add chat functionality to their websites, regardless of the backend.
2013-04-12 23:28:27 +02:00
This is currently possible, except for adding new contacts, which still makes an XHR call to the (Plone) backend to fetch user info.
2012-10-23 21:01:24 +02:00
2012-10-23 21:55:58 +02:00
--------
Features
--------
2012-10-23 21:01:24 +02:00
It has the following features:
* Manually or automically subscribe to other users.
* Accept or decline contact requests
* Chat status (online, busy, away, offline)
* Custom status messages
* Typing notifications
2012-10-23 21:54:32 +02:00
* Third person messages (/me )
* Multi-user chat in chatrooms
* Chatroom Topics
* vCard support
-----------
Screencasts
-----------
* `In a static HTML page`_. Here we chat to external XMPP accounts on Jabber.org and Gmail.
* `Integrated into a Plone site`_ via collective.xmpp.chat.
------------
Dependencies
------------
2012-10-23 21:50:12 +02:00
It depends on quite a few third party libraries, including:
2012-10-23 22:38:56 +02:00
* strophe.js_
* backbone.js_
* require.js_
2012-10-23 21:01:24 +02:00
-------
Licence
-------
2012-10-23 21:54:32 +02:00
``Converse.js`` is released under both the MIT_ and GPL_ licenses.
2012-10-23 21:01:24 +02:00
.. _Converse.js: http://conversejs.org
2012-10-23 21:01:24 +02:00
.. _strophe.js: http://strophe.im/strophejs
.. _backbone.js: http:/backbonejs.org
.. _require.js: http:/requirejs.org
.. _collective.xmpp.chat: http://github.com/collective/collective.xmpp.chat
.. _Plone: http://plone.org
.. _XMPP: http://xmpp.org
.. _MIT: http://opensource.org/licenses/mit-license.php
.. _GPL: http://opensource.org/licenses/gpl-license.php
2012-10-23 22:38:56 +02:00
.. _here: http://opkode.com/media/blog/instant-messaging-for-plone-with-javascript-and-xmpp
.. _Screencast2: http://opkode.com/media/blog/2013/04/02/converse.js-xmpp-instant-messaging-with-javascript
.. _`Integrated into a Plone site`: http://opkode.com/media/blog/instant-messaging-for-plone-with-javascript-and-xmpp
.. _`In a static HTML page`: http://opkode.com/media/blog/2013/04/02/converse.js-xmpp-instant-messaging-with-javascript