Plugin Developer Documentation
Extend the functionality of Ango Hub with custom plugins.
Custom plugins allow you to extend what Ango Hub can do. With custom plugins you can automatically convert outputs, integrate your own models, and more.
This page will cover general information about creating plugins. Visit each plugin's page for more on how to create and run each plugin type.
- File Explorer. Link your cloud storage of choice to Ango Hub and navigate its file structure directly within Hub itself. Then, bulk import assets from a folder with a single click.
- Markdown Generator. Get a Markdown and a .csv file. Process them with a Python script, and upload the results to Hub as a markdown asset.
From Hub, click on Plugins on the top navbar, then enter the Development section and click on Create a Plugin.
A dialog will appear:
- Name. The name of your plugin.
- Description. A description for your plugin.
- Banner URL: A link to a square image which will be used to represent your plugin. Leave blank for default.
- Class Names (only appears if selecting "Model" as the plugin type.) Add your model's class names, which will then be mapped to Ango Hub category names when being run. More on the page for Model Plugins.
- Public: Makes this plugin accessible to the Plugin Directory.
- Status: Lists the plugin on the Directory. If the plugin is not public, it will be listed for the current organization. If public, it will be listed on the Directory for all Ango Hub users.
- Default Config: When running a plugin, users will have the option to input custom JSON in this field. The JSON will be passed to your callback function with other parameters. Here, you can input JSON that will be shown and pre-filled by default to users running the plugin. This is a good way to show users a sample of what you expect from the custom JSON config from users.
Click on OK to create the plugin and add it to your Development list.
Once you create a plugin, it will be visible in the Development section of the Plugins page.
: Whether the plugin has been added to the Directory.
: Appears when the plugin has been made public.
ID: The plugin's unique ID.
Secret: The Plugin Secret is what, when necessary, you will use to authenticate with Ango Hub's servers to run your custom script. More information below. Treat this secret as a password and do not share it with anyone else.
Live: When your plugin is running, this change will instantly turn green. When you stop execution of your plugin, the light will turn back to red in a couple of minutes.
To run the plugin, click on Open and follow the on-screen instructions.
As mentioned above, each plugin type has a different way of being set and run. Please check each plugin's page for more: