Skip to content

Plugin that opens a URL with a whiteboard.

License

Notifications You must be signed in to change notification settings

pexip/plugin-collaboard

Repository files navigation

Web App 3 Plugin: Collaboard

This plugin enables the user to share whiteboard during the meetings with the rest of the participants.

Requirements

In order to use this plugin, you need to comply with the following requirements:

Component Version
Pexip Infinity v36

How to use

This plugin will create a new button in the interface. That will allow us to share a whiteboard with the rest of the participants.

Once you click on the button, the first thing you will see is a button to log in:

Login button

After you click on log in, you will see a new pop up window with a panel to log in with username/password and other social login options:

Login pop up

Once you log in, you will see new buttons in the interface:

Buttons

We have two main options to share a whiteboard:

  • Create whiteboard: This button will create a new whiteboard and share it with the rest of participants.

Create whiteboard

  • Open whiteboard: This button will show a list of all available whiteboards and share the selected one with the rest of participants.

Open whiteboard

Once the user has created or open a whiteboard, the app will show a new window with the whiteboard:

Whiteboard

How to configure the branding

This plugin uses oAuth authentication and, to support this, we need to enable the redirections in the manifest.json file:

{
  "applicationConfig": {
    "handleOauthRedirects": true
    ...
  }
  ...
}

How to configure the plugin

This plugin uses the config.json file to store the configuration. You should create the file in the public folder in your are developing or in the root of folder of your plugin, if you are creating a package.

{
  "apiUrl": "<collaboard-api-url>",
  "webappUrl": "<collaboard-webapp-url>",
  "clientId": "<client_id-provisioned>",
  "redirectUri": "<redirect-uri-after-login>"
}

Run for development

  • Install all the dependencies:
$ npm i
  • Run the dev environment:
$ npm start

The plugin will be served from https://localhost:5173 (visit that page and accept the self-signed certificates), but you should access it thought the Web App 3 URL. You have more information about how to configure your environment in the Developer Portal: Setup guide for plugin developers.

Build for production

To create a package, you will need to first install all the dependencies:

$ npm i

And now to create the package itself:

$ npm run build

Congrats! Your package is ready and it will be available in the dist folder. The next step is to create a Web App3 branding and copy dist into that branding.

If you want to know more about how to deploy your plugin in Pexip Infinity, check our Developer Portal.