Tour Plugin

Description

This plugins adds a button in the options dropdown menu to start a Tour to guide user to some of the features of Bigbluebutton. It uses the sheperd.js library.

You can configure some "Learn More" links that are shown in some steps (screenshare, whiteboard, general) in the settings of the plugin, see example below.

Running the Plugin From Source Code

1. Start the development server:

npm install
npm start

2. Add this to the settings.yml of the BBB HTML5-client:

public:
  plugins:
    - name: TourPlugin
      url: <<PLUGIN_URL>>
      settings:
        url:
          screenshare: "https://some.url.with.more.information"
          whiteboard: "https://some.url.with.more.information"
          general: "https://some.url.with.more.information"

Building the Plugin

To build the plugin for production use, follow these steps:

npm install
npm run build-bundle

The above command will generate the dist folder, containing the bundled JavaScript file named TourPlugin.js. This file can be hosted on any HTTPS server.

Alternatively, you can host the bundled file on the BigBlueButton server by copying dist/TourPlugin.js to the folder /var/www/bigbluebutton-default/assets/plugins. In this case, the <<PLUGIN_URL>> will be https:///plugins/TourPlugin.js.

Background

BigBlueButton added supports for plugins in 2024 with BBB 3.0. Check the official documentation website for more information.

This plugin repository was created using the plugin template repository for BigBlueButton hosted on GitHub.