Real-time web chat for RoundCube
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 7 commits behind jsxc:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css
img
lib
sound
.gitignore
LICENSE
README.md
composer.json
config.inc.php.dist
jsxc.js
jsxc.php

README.md

This is a plugin for RoundCube that enables real-time web chat based on JSXC.

JSXC is a JavaScript XMPP client, therefore it requires XMPP server. Before you begin, please check for JSXC prerequisites.

Installation

To install the plugin, follow the standard procedure for RoundCube plugin installation.

Here is the snippet for composer.json:

"require" : {
    ...,
    "jsxc/jsxc": ">=1.0"
}

Configuration

To configure the plugin, create config.in.php in the plugins/jsxc directory. You can use config.inc.php.dist as a reference.

JSXC Configuration

Here you can configure basic XMPP and WebRTC connectivity options, as well as many other parameters. The structure mirrors that of JSXC configuration; please refer to JSXC documentation for the full list of options.

Example:

$config['jsxc'] = [
    'xmpp' => [
        'url' => 'https://mydomain.foo/http-bind/',
        'domain' => 'mydomain.foo',
        'resource' => 'JSXC',
        'overwrite' => true,
        'onlogin' => false
    ],
    'RTCPeerConfig' => [
        'iceServers' => [
            [
                'urls' => 'stun:stun.l.google.com:19302'
            ]
        ]
    ]
];

TURN REST API Configuration

If you use a private/corporate TURN server, you probably won't want to expose TURN credentials. This is a well-known problem that has been addressed to some extent by this draft. The plugin supports generating the so-called ephemeral TURN credentials. For that, you'll need to configure shared cryptographic secret(s):

$config['turn'] = [
    'ttl' => 86400,
    'servers' => [
        [
            urls => 'turn:turn.myserver.foo',
            secret => 'secret'
        ]
    ]
];

If TURN REST API is configured, the whole RTCPeerConfig section from the JSXC config will be overridden.