ypgao1 / mattermost-plugin-bigbluebuttonOldFork

BigBlueButton plugin for Mattermost :electric_plug:

BigBlueButton Plugin for Mattermost

BigBlueButton is an open source web conferencing system for online learning. Teams can create, join and manage their BigBlueButton meetings from inside Mattermost.

Jump to:

• Installation and Setup
• Usage
• Known Issues
• Contributing

Installation and Setup

1. Go to: https://github.com/blindsidenetworks/mattermost-plugin-bigbluebutton/releases

2. Download bigbluebutton.tar.gz you do not need to extract the tar file once you download it.

3. Inside Mattermost, go to System Console > Integrations > Custom Integrations. Make sure the following are turned to true:

   • Enable Incoming Webhooks
   • Enable Outgoing Webhooks
   • Enable Custom Slash Commands
   • Enable integrations to override usernames
   • Enable integrations to override profile picture icons

4. Next we must enable Plugins. Go to System Console > Plugins > Configuration and set Enable Plugins to true. Depending on your Mattermost version, an additional step may be required to enable uploading plugins in your Mattermost config.json file:

   • vi /opt/mattermost/config/config.json
   • Under PluginSettings, make sure Enable and Enable Uploads are both set to true
   • Restart your Mattermost with sudo systemctl restart mattermost assuming you used systemd for Mattermost services

5. Go to System Console > Plugins > Management and upload your bigbluebutton.tar.gz. The BigBlueButton Plugin should appear under Installed Plugins.

6. Before activating the plugin, we must go configure the plugin settings in System Console > Plugins > BigBlueButton. By default, you are given a BigBlueButton test server to try it out. See BigBlueButton documentation to install your own BigBlueButton server. The secret key is to securely connect to BigBlueButton. To check your secret, in the command line, enter bbb-conf --secret. Alternatively contact Blindside Networks, the company behind BigBlueButton, for Setup & Support, Custom Development, and Premium Hosting.

   The Site URL is the site of your Mattermost without any paths. For example, if the location of your Mattermost Town Square is : https://mysite.mattermost.com/core/channels/town-square, enter: https://mysite.mattermost.com

7. Afterwards, go back to System Console > Plugins > Management and Activate the plugin.

Usage

Create a BigBlueButton meeting in any channel

Users can join BigBlueButton meetings through the post message

Plugin provides live meeting details during and after the meeting has ended

You can search for past BigBlueButton recordings

Alternative way to start a BigBlueButton meeting is through clicking on a user's name and getting their profile popover

Slash command /bbb can also be used to start a meeting

For any direct or group message, popup alert will open anywhere inside Mattermost to notify that someone has requested a meeting with you.

Known Issues

1. When changing configurations in System Console > Plugins > BigBlueButton, you must deactivate and activate the plugin for the new configuration to work.
2. For developers that wish to contribute, depending on the Mattermost version, you may experience Mattermost not removing your previous webapp plugin. To fix this, go into cd /opt/mattermost/client/plugins/ (note you might have to sudo su) and rm bigbluebutton_bundle.js to remove the previous version of the webapp plugin. Restart Mattermost with sudo systemctl restart mattermost.

Contributing

Plugin is written in Golang for server side and Javascript for client side. Use make build to build the plugin. The dependencies are managed with Glide for Go and NPM for javascript.

The plugin should be placed in a directory such as ~/go/src/github.com/blindsidenetworks/mattermost-plugin-bigbluebutton

To download a local version: mkdir -p ~/go/src/github.com/blindsidenetworks and git clone https://github.com/blindsidenetworks/mattermost-plugin-bigbluebutton.git

Mattermost plugin development guides available here: https://developers.mattermost.com/extend/plugins/

BigBlueButton API available here: http://docs.bigbluebutton.org/dev/api.html