2012-10-23 21:01:24 +02:00
|
|
|
===========
|
2012-07-21 11:14:22 +02:00
|
|
|
converse.js
|
|
|
|
===========
|
|
|
|
|
2013-04-21 00:06:18 +02:00
|
|
|
Converse.js_ is a web based `XMPP/Jabber`_ instant messaging client.
|
2012-10-23 21:01:24 +02:00
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
It enables you to add chat functionality to your website, independent of any
|
|
|
|
specific backend. You will however need an XMPP server to connect to, either
|
|
|
|
your own, or a public one.
|
2013-03-01 09:55:54 +01:00
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
It is used by collective.xmpp.chat_, which is a Plone_ instant messaging add-on.
|
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:
|
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
* Single-user chat
|
|
|
|
* Multi-user chat in chatrooms
|
|
|
|
* vCard support
|
|
|
|
* Service discovery
|
|
|
|
* Contact rosters
|
|
|
|
* Manually or automically subscribe to other contacts
|
2013-04-12 16:16:17 +02:00
|
|
|
* Accept or decline contact requests
|
2013-07-28 23:39:11 +02:00
|
|
|
* Roster item exchange
|
|
|
|
* Chat statuses (online, busy, away, offline)
|
2013-04-12 16:16:17 +02:00
|
|
|
* Custom status messages
|
|
|
|
* Typing notifications
|
2012-10-23 21:54:32 +02:00
|
|
|
* Third person messages (/me )
|
2013-07-28 23:39:11 +02:00
|
|
|
* Translated into multiple languages (af, de, es, it, pt_BR)
|
2013-04-12 16:16:17 +02:00
|
|
|
|
|
|
|
-----------
|
|
|
|
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.
|
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
----
|
|
|
|
Demo
|
|
|
|
----
|
|
|
|
|
|
|
|
A live demo is available at `conversejs.org`_
|
|
|
|
|
|
|
|
-----
|
|
|
|
Tests
|
|
|
|
-----
|
|
|
|
|
|
|
|
We use behavior-driven tests written with jasmine.js_. They can run in your
|
|
|
|
browser (`see here`_) or in the command line via phantom.js_.
|
|
|
|
|
|
|
|
We use `Travis-CI`_ for continuous integration.
|
2013-07-28 23:47:12 +02:00
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
.. image:: https://api.travis-ci.org/jcbrand/converse.js.png?branch=master
|
|
|
|
|
2013-07-28 23:47:12 +02:00
|
|
|
-------------
|
|
|
|
Documentation
|
|
|
|
-------------
|
|
|
|
|
|
|
|
The developer/integrator documentation can be found at `<http://conversejs.org/docs/html>`_.
|
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
|
2013-04-12 16:16:17 +02:00
|
|
|
------------
|
|
|
|
Dependencies
|
|
|
|
------------
|
2012-10-23 21:50:12 +02:00
|
|
|
|
2013-04-12 16:16:17 +02:00
|
|
|
It depends on quite a few third party libraries, including:
|
2012-10-23 22:38:56 +02:00
|
|
|
|
2013-07-28 23:39:11 +02:00
|
|
|
* jquery_
|
2013-04-12 16:16:17 +02:00
|
|
|
* strophe.js_
|
|
|
|
* backbone.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
|
|
|
|
2013-04-12 16:16:17 +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
|
2013-04-21 00:06:18 +02:00
|
|
|
.. _`XMPP/Jabber`: http://xmpp.org
|
2012-10-23 21:01:24 +02:00
|
|
|
.. _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
|
2013-04-12 16:16:17 +02:00
|
|
|
.. _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
|
2013-07-28 23:47:12 +02:00
|
|
|
.. _`conversejs.org`: http://conversejs.org
|
2013-07-28 23:39:11 +02:00
|
|
|
.. _jquery: http://jquery.com
|
|
|
|
.. _jasmine.js: http://pivotal.github.io/jasmine
|
|
|
|
.. _`see here`: http://conversejs.org/tests.html
|
|
|
|
.. _phantom.js: http://phantomjs.org
|
|
|
|
.. _`Travis-CI`: https://travis-ci.org
|