Elvis 4 action plug-ins setting - menuAssignments – Home

Controls from which menu(s) the plugin is available, this can be combination of the following:

application menu
main button toolbar
file context menu
folder context menu

Menu assignments are required in the action configuration, you will need to define at least one to make the plugin available in the user interface.

<action>
    <menuAssignments>
                <menuAssignment>...</menuAssignment> 
        </menuAssignments>
</action>

Menu assignment - <menuAssignment/>

One or more menuAssignment tags can be defined, where each menuAssignment "id" can only be defined once, so it's not allowed to assign menu items to the application menu multiple times.

Parameters

Menu id, defines to which menu the plugin will be added. Possible values:

applicationMenu - adds a sub item to the Plugin menu in the main application menu. Required when there are also keyBindings assigned to your plugin.
assetContextMenu - adds a sub item to the Plugin menu in the asset context menu. Add this menu assignment when the plugin requires an asset selection.
folderContextMenu - adds a sub item to the Plugin menu in the folder context menu. Add this menu assignment when the plugin requires a folder selection.
toolBar - adds a button in the application's main button toolbar.

Required.

order

The menu order, used to define the order of plugin items (1, 2, 3, etc) as they appear in the menu. The actual order is a a result of all active plugin order values combined.

Required.

Application menu - id="applicationMenu"

Asset context menu - id="assetContextMenu"

Folder context menu - id="folderContextMenu"

Main button toolbar - id="toolBar"

Examples

Typical menu assignments for a plugin that requires no selection

<menuAssignments>
    <menuAssignment id="applicationMenu" order="1"/>
    <menuAssignment id="toolBar" order="1"/>
<menuAssignments>

Typical menu assignments for a plugin that requires an asset selection

<menuAssignments>
    <menuAssignment id="applicationMenu" order="3"/>
    <menuAssignment id="assetContextMenu" order="3"/>
    <menuAssignment id="toolBar" order="3"/>
<menuAssignments>

Typical menu assignments for a plugin that requires a folder selection

<menuAssignments>
    <menuAssignment id="applicationMenu" order="1"/>
    <menuAssignment id="folderContextMenu" order="4"/>
    <menuAssignment id="toolBar" order="2"/>
<menuAssignments>

Elvis 4 action plug-ins setting - menuAssignments