matrix-ui-plugin-boilerplate plugin

Matrix UI Plugins are implementations of the IPlugin interface. They can be registered in the plugin manager at startup and will be queried in different situations, for example to add new UI Controls or entries to the tree or pages in the adminConfig.

This example registers a new Dashboard, a control, an action in the action menu, a config page on the project level and a config page at the serverSetting level. You can use this project as template for other plugin.

It can be compiled using the standard Typescript build process into a single JS file and loaded into Matrix.

Installation

To simplify installation without requiring disk access to a Matrix instance you can use a special developer setup and a GitHub action to build the code.

• Use this project as template
• Go to the CI action and start the workflow rename the project from template
• Modify the code and check it into GitHub
• Make sure the build succeeds (look here)
• Login into the developer instance
• Create a new UI entry in the PLUGINS project
• Press the Install" button
• Reload the browser

This should install the script on the server and load it into the browser. The naming reflects the repository name, for example https://developer.matrixreq.net/static/js/GitHub-MatrixRequirements_boiler-plate.js

APIs

Matrix has a very large set of APIs, which are accessed through the matrixApi object installed on the global context. You can examine the api in the ./node_modules/matrix-requirements-api folder.

Local build

• Run this command to install required packages : npm install
• Edit the file webpack.config.js to give a unique name to your plugin (the current name is UIPluginBoilerplate.
• Run this command to build the package npm run build. This will compile and package the ts code to a UIPluginBoilerplate.js and UIPluginBoilerplate.js.map in the ./dist directory.