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:
-
Go to: https://github.com/blindsidenetworks/mattermost-plugin-bigbluebutton/releases
-
Download
bigbluebutton.tar.gz
you do not need to extract the tar file once you download it. -
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
-
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 sureEnable
andEnable Uploads
are both set totrue
- Restart your Mattermost with
sudo systemctl restart mattermost
assuming you used systemd for Mattermost services
-
Go to System Console > Plugins > Management and upload your
bigbluebutton.tar.gz
. The BigBlueButton Plugin should appear under Installed Plugins. -
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
-
Afterwards, go back to System Console > Plugins > Management and
Activate
the plugin.
Alternative way to start a BigBlueButton meeting is through clicking on a user's name and getting their profile popover
For any direct or group message, popup alert will open anywhere inside Mattermost to notify that someone has requested a meeting with you.
- When changing configurations in System Console > Plugins > BigBlueButton, you must
deactivate
andactivate
the plugin for the new configuration to work. - 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 tosudo su
) andrm bigbluebutton_bundle.js
to remove the previous version of the webapp plugin. Restart Mattermost withsudo systemctl restart mattermost
.
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