curioussavage / babble

Discourse Shoutbox plugin

A Shoutbox style plugin for Discourse.

Demo

Check out a live instance of Discourse with Babble installed on it here: http://discourse-babble.com (You'll have to make an account to see the chat)

Installation

• Edit your web template and add the project clone url. (https://meta.discourse.org/t/install-a-plugin/19157)
• Rebuild your web container so that the plugin installs.
• You likely want to be on the master branch, which is the most stable:

- git clone https://github.com/gdpelican/babble.git

However, if you want the latest cutting edge features, feel free to track the beta branch:

- git clone -b https://github.com/gdpelican/babble.git

I'll keep the README updated with the differences between the two branches.

(Right now beta and master track the same commit)

Adding a chat channel

Experimental: Full page chat mode! There is now a site setting for 'full page' chat mode in Babble. This will allow you to tie chat channels to a particular category, and expose a 'chat' route within your category, like so:

To do this, visit the admin/chats route, select 'Make a New Channel', and create a chat with 'category' permissions.

NB that you can still create group-based chats, which will appear as normal in Shoutbox mode, by selecting 'group' permissions.

To switch between 'Shoutbox' mode (with the icon in the header), and 'Full page' mode (with chats linked to a category), use the 'Use full page chat mode' plugin setting.

• Check out the issues list for a more comprehensive list of what's not working great and what could be improved.

Translations

Babble is currently available in English, German, French, Spanish, Italian, Finnish, Russian, Polish, and Korean. If you'd like it translated into your language, let me know! Babble is now on Transifex, which should result in a better translation experience for all.

Pull requests welcome! See CONTRIBUTING.md

You can view some ongoing discussion about this plugin on Discourse Meta

Support

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]