No Description

JC Brand 01c2c5d93c Save groups on RosterItem. updates #83 11 years ago
builds 4f5534ed66 Finally fixed the non-AMD case to work with external templates. 11 years ago
css 6bded11304 Add connection feedback on the controlbox. 11 years ago
docs fe3e9f5294 Bugfix, xhr_user_search_url is not a global. Fixes #192 11 years ago
fonticons cc37d6a183 The xa chat state wasn't being handled properly 12 years ago
less 6bded11304 Add connection feedback on the controlbox. 11 years ago
locale 7ee25f716f add more pt_BR translations and some fixes 11 years ago
mockup 6bded11304 Add connection feedback on the controlbox. 11 years ago
spec 38b26784b6 trimmed views are minimized by default 11 years ago
src 6bded11304 Add connection feedback on the controlbox. 11 years ago
tests c25f33b181 Add proper separation between controlbox tests 11 years ago
.bowerrc 883c64cc16 Add bower as npm dependency 12 years ago
.gitignore 53a8f288bc Better phantomjs test runnning and reporting 11 years ago
.gitmodules 9abb9e36bf Add logging submodule (from Patternslib) 12 years ago
.travis.yml a68738b2fd Update .travis.yml 11 years ago
CONTRIBUTING.rst 8aa975c4a3 Formatting 11 years ago
Gruntfile.js 4f5534ed66 Finally fixed the non-AMD case to work with external templates. 11 years ago
Makefile 4f5534ed66 Finally fixed the non-AMD case to work with external templates. 11 years ago
README.rst 65508b26ed Add markup for offscreen chatboxes. updates #61 11 years ago
activate ada41a7250 Add bash file for creating a node virtualenv 11 years ago
bower.json 9d84ede2f9 Two website deps (jquery-easing & bootstrap) now managed by bower 11 years ago
converse.js 01c2c5d93c Save groups on RosterItem. updates #83 11 years ago
index.html 6bded11304 Add connection feedback on the controlbox. 11 years ago
main.js c5ae10d962 Make an extra build specifically for including the website deps 11 years ago
non_amd.html 4f5534ed66 Finally fixed the non-AMD case to work with external templates. 11 years ago
package.json 4f5534ed66 Finally fixed the non-AMD case to work with external templates. 11 years ago
tests.html 27cce2c229 Refactor to store number of unread messages 11 years ago

README.rst

===========
converse.js
===========

.. figure:: https://api.travis-ci.org/jcbrand/converse.js.png?branch=master
:alt: Build Status

`Converse.js `_ is a web based `XMPP/Jabber `_
instant messaging client.

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.

--------
Features
--------

It has the following features:

* Single-user chat
* Multi-user chat in chatrooms
* vCard support
* Service discovery
* Contact rosters
* Manually or automically subscribe to other contacts
* Accept or decline contact requests
* Roster item exchange
* Chat statuses (online, busy, away, offline)
* Custom status messages
* Typing notifications
* Third person messages (/me )
* Translated into multiple languages (af, de, en, es, fr, he, hu, id, it, ja, nl, pt_BR, ru)
* Off-the-record encryption support (via `OTR.js `_)

-----------
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.
* `Off-the-record encryption `_ in Converse 0.7.

Integration into other frameworks
---------------------------------

* `Plone `_:
`collective.xmpp.chat `_ is an add-on for Plone that uses *Converse.js*. Together with `collective.xmpp.core `_, it provides for single-signon-support (SSO) and also enables you to manually or automatically register your Plone users onto your XMPP server.
* `Django `_:
`django-conversejs `_ is an app that makes it easer to integrate *Converse.js* into Django.
* `Roundcube `_:
`roundcube-converse.js-xmpp-plugin `_ is a plugin for Roundcube Webmail.
* `Wordpress `_:
`ConverseJS `_
* `Patternslib `_:
`patterns.converse`_: `patterns.converse `_ provides a Patternslib pattern for Converse.js

----
Demo
----

A live demo is available at ``_

-----
Tests
-----

We use behavior-driven tests written with `jasmine.js `_.

Open `tests.html `_
in your browser, and the tests will run automatically.

-------------
Documentation
-------------

The developer/integrator documentation can be found at ``_.

-------
Licence
-------

``Converse.js`` is released under the `Mozilla Public License (MPL) `_.

-------
Support
-------

For support queries and discussions, please join the mailing list: conversejs@librelist.com

Also take a look at the `mailing list archives `_.

Issues can be logged on the `Github issue tracker `_.

----------------------------------
Donations and tips are appreciated
----------------------------------

* Bitcoin: 16FsPqE9DhFTryxrUenpsGX4LJ1TPu8GqS

.. _`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