kacpersaw / babble

Discourse Shoutbox plugin

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

A Shoutbox style plugin for Discourse.

Code Climate Gitter OpenCollective OpenCollective

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

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. Then, rebuild your web container so that the plugin installs. Check out the official guide for more info.

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

If you're looking for the previous implementation of full page category chat, you can pull the full-page-chat branch.

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

(caveat emptor: This branch is unmaintained and will not receive updates going forward)

Adding a chat channel

To create a new channel, visit the admin/chats route, select 'Make a New Channel', and create a chat.

You can either create a channel available to a particular category, or one available to a set of groups.

Other usage notes
  • Babble is now configured to appear as a sidebar, which should result in a better experience overall. You may choose whether it occupies the left or right side of the screen in the settings (On small screens, it will automatically expand to take up the whole screen)
  • If you have a custom header, Babble may not play nicely with Discourse's somewhat complicated scrolling behaviour. To account for this, turn on the 'Babble Adaptive Height' setting under /admin/site_settings/category/plugins?filter=babble

Contributing

Bug reports

Check out the issues list to take a look at known issues and report ones we don't know about yet.

Code

Pull requests welcome! See CONTRIBUTING.md

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.

Support the project

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]

About

Discourse Shoutbox plugin

License:MIT License


Languages

Language:JavaScript 51.5%Language:Ruby 37.4%Language:CSS 8.3%Language:HTML 2.8%