Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gdpelican/babble
Discourse Shoutbox plugin
https://github.com/gdpelican/babble
Last synced: about 1 month ago
JSON representation
Discourse Shoutbox plugin
- Host: GitHub
- URL: https://github.com/gdpelican/babble
- Owner: gdpelican
- License: mit
- Created: 2015-05-22T17:14:51.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-02-08T06:18:51.000Z (almost 4 years ago)
- Last Synced: 2024-05-22T19:30:13.711Z (7 months ago)
- Language: JavaScript
- Size: 1.03 MB
- Stars: 107
- Watchers: 14
- Forks: 64
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred - gdpelican/babble - Discourse Shoutbox plugin (others)
README
A Shoutbox style plugin for [Discourse](http://discourse.org).
[![Code Climate](https://codeclimate.com/github/gdpelican/babble/badges/gpa.svg)](https://codeclimate.com/github/gdpelican/babble)
You can view some ongoing discussion about this plugin on [Discourse Meta](https://meta.discourse.org/t/babble-a-chat-plugin/31753)
#### Demo
Check out a live instance of Discourse with Babble installed on it here: [http://discourse-babble.com](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](https://meta.discourse.org/t/install-a-plugin/19157) for more info.```
- git clone https://github.com/gdpelican/babble.git
```###### 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`
- Your users can disable babble for themselves by selecting the 'Disable Babble chat completely' option under the 'Interface' section in their User preferences
- Babble also offers an option to play a notification sound when new messages are received#### Contributing
###### Bug reports
Check out the [issues list](http://github.com/gdpelican/babble/issues) to take a look at known issues and report ones we don't know about yet.
###### Code
Pull requests welcome! See [CONTRIBUTING.md](./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](http://transifex.com/babble/babble), which should result in a better translation experience for all.###### Donations
Babble is free and open source and always will be. If you feel you've gotten value from using it and would like to support the developer behind it, please use the link below. <3 <3
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=james.kiesel%40gmail.com¤cy_code=USD&source=url)