WoodWing Help Center

Elvis 6 plug-ins introduction - management

Installing and managing plug-ins in Elvis 6

The functionality of Elvis 6 Server and its client applications can be extended through the use of plug-ins. This makes it possible to schedule regularly occurring tasks in Elvis Server, or add buttons, menus or panels to the Pro client and/or the Brand portal.

Using plug-ins in Elvis 6 involves installing them in Elvis Server and subsequently activating them. When they are temporarily not needed anymore, they can be deactivated. This article describes these processes.

Where to get Elvis plug-ins from

Plug-ins contain custom functionality and are typically created whenever the need for that functionality arises. To get you started, various sample plug-ins are available. For more information, see Elvis 6 sample plug-ins.

The plug-in structure

Plug-ins are managed in Elvis Server in the following location:

Elvis Server path > Config > plugins

Notes:

  • This folder and its contents are available after Elvis server is started for the first time after installation.
  • The path to the plug-in folder must be identical on each node in the cluster.

The following structure is used:

Folder Content
active All currently active plug-ins.
active/internal All default internal plug-ins.
disabled All plug-ins that should be (temporarily) disabled.
plugin_base1 The shared plug-in code base.
samples Samples for Scheduled and Active plug-ins. 2

1 Do not make modifications to the plugin_base folder; it is completely overwritten each time Elvis Server starts.

2 See Elvis 6 sample plug-ins. Sample Panel plug-ins for the Pro client are available in the Integrations & Samples section on the Help Center (log-in required).

Installation

To install a plug-in, simply place its folder in the following location:

Elvis Server path > Config > plugins > active

Tip: Create subfolders to group or categorize plug-ins.

Note: A valid plug-in folder is one that contains a plug-in configuration file. This configuration file defines the plug-in type. Elvis supports the following types:

  1. schedule. For Scheduled plug-ins. For information about the configuration file, see Elvis 6 Schedule plug-ins - configuration settings.
  2. action. For Action plug-ins. For information about the configuration file, see Elvis 6 Action plug-ins - configuration settings.
  3. panel. For Panel plug-ins. For Scheduled plug-ins. For information about the configuration file, see Adding custom functionality to the Pro client of Elvis 6 by using Panel plug-ins.

Activation

After installation, a plug-in needs to be activated.

Step 1. Access the Management console.

Step 2. From the menu, choose Plugins, followed by Scheduled plugins, Action plugins or Panel plugins.

The Action plug-ins page

Figure: The Action plug-ins page.

Step 3. In the top right corner of the page, click Scan Elvis Server for plugins.

Step 4. Verify that the added plug-in is listed. In case a warning or error icon is shown, click the plug-in for more details and resolve the issue.

Deactivation

When a plug-in is not needed anymore, it can be deactivated.

Step 1. Do one of the following:

  • Move the plug-in from the 'active' folder to the 'disabled' folder (this makes it possible to easily re-activate it later when needed)
  • Completely remove the plug-in from Elvis Server

Step 2. Access the Management console.

Step 3. From the menu, choose Plugins, followed by Scheduled plugins, Action plugins or Panel plugins.

Step 4. In the top right corner of the page, click Scan Elvis Server for plugins. and verify that the removed plug-in is not listed anymore.

Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.