@cern-vc/cern-paella-plugins

Cern Paella Plugins

This repository contains the plugins for the Paella Player used at CERN.

Available plugins

• ch.cern.paella.liveStreamIndicatorPlugin
• ch.cern.paella.liveStreamingProgressIndicator
• ch.cern.paella.matomoAnalyticsPlugin
• ch.cern.paella.matomoAnalyticsUserTrackingPlugin
• ch.cern.paella.nextTimeButtonPlugin
• ch.cern.paella.prevTimeButtonPlugin
• ch.cern.paella.vttManifestCaptionsPlugin
• ch.cern.paella.testButton

How to use

To use the plugins, you need to add the following lines to your config.json file:

{
  "plugins": {
    "ch.cern.paella.pluginName": {
      "enabled": true,
      "OTHER_CONFIG": "OTHER_CONFIG_VALUE"
    }
  }
}

To load the plugins in the Paella Player, you need to add the import :

import getCernCustomPluginsContext from "cern-paella-plugins";

And then, you need to add the following line to the init parameters of the Paella Player:

const initParams = {
    ...,
    customPluginContext: [
        getCernCustomPluginsContext(),
        ...
    ],
};

How to develop

To develop the plugins, you need to clone the repository and install the dependencies:

$ git clone https://github.com/cern-vc/cern-paella-plugins.git
$ cd cern-paella-plugins
$ npm install

To build the plugins, you need to run the following command:

$ npm run build

To test the plugins, you need to run the following command:

$ npm run dev

Go to http://localhost:8090/?id=test-video to test the plugins. You will maybe need to chnages parameters in the url to test the plugins.

For example to test the nextTimeButtonPlugin and the prevTimeButtonPlugin, you need to add the following parameters to the url: &time=3m,4m,5m.

You will need to modify the config/config.json file to add the plugins you want to test, and the repository_test/repository/test-video/data.json file to modify the video you want to test.