Generate a plugin

OpenVeo Plugin Generator helps you creates a new OpenVeo plugin by generating the default plugin's structure. To generate a plugin, run the generator using:

cd /WORKSPACE_PATH
yo openveo-plugin

You will be prompted for information. Don't worry if you made a mistake, nothing is immutable.
At the end of the installation a new directory has been created containing the sources of your plugin.

Your workspace should look like this:

.
├── openveo-core
├── openveo-PLUGIN_NAME

Install project's dependencies

cd /WORKSPACE_PATH/openveo-PLUGIN_NAME
npm ci

Add @openveo/api and @openveo/test to your plugin

cd /WORKSPACE_PATH/openveo-PLUGIN_NAME
npm link @openveo/api @openveo/test

Build your plugin

Plugin has to be built.

cd /WORKSPACE_PATH/openveo-PLUGIN_NAME
npm run build

Link your plugin

To easily install your plugin into OpenVeo core you need to make it a global NPM package using NPM links:

cd /WORKSPACE_PATH/openveo-PLUGIN_NAME
npm link

Install your plugin

Once a link has been made on your plugin you can install it using:

cd /WORKSPACE_PATH/openveo-core
npm link openveo-PLUGIN_NAME

Start / Restart OpenVeo

Your plugin is now created. You can start / restart OpenVeo:

cd /WORKSPACE_PATH/openveo-core
node server.js

Verify that your plugin is working

You can now access OpenVeo back end. From back end menu you should see a new entry with the name of your plugin. It should lead you to a TODO page.

What's next?

Now that you have a full operational plugin, you probably want to know more about it. The next pages will lead you to all you have to know about plugin's development.