Plugin Development¶
Writing plugins¶
Here are the steps for writing a plugin:
First decide the plugin types by choosing a CommandPlugin or a WindowedPlugin. CommandPlugins are those with one single action and don’t require a dialog display. WindowedPlugin allows for a more complex UI by spawning a dialog window.
Create a Python script with a single class that inherits from either CommandPlugin or WindowedPlugin.
In the plugin class, create a PluginMetadata object named metadata. This holds necessary information (e.g. name, author, description) about the plugin. See the sample plugin for an example.
If needed, create a constructor that also calls the “super” constructor.
Override the inherited methods:
If you inherited a CommandPlugin, simply override the “run()”method, which is called when the user clicks on the plugin item.
For WindowedPlugin, you need to override “create_window(dialog)”, which passes you the parent dialog in which you can create your widgets.
Also keep in mind the event handlers which are called when events occur (e.g. on node created, deleted, etc.). See the same file on plugins for info on these.
Plugin categories¶
The current plugin categories are: ANALYSIS, APPEARANCE, MATH, MODELS, UTILITIES, VISUALIZATION, MISC. Developers can assign the plugin category in the PluginMetadata object. The current sample plugins are categoried as below:
ANALYSIS: Structural Analysis;
APPEARANCE: Arrow Design;
MODELS: Export Antimony, Export SBML, Import SBML, Model Metrics, Random Network;
UTILITIES: Add Reaction;
VISUALIZATION: Align Circle, Auto Layout.
Users can see all the plugin categories in the Application Menu in SBcoyote.