Interface CogsPluginManifestJson

cogs-plugin-manifest.json is a JSON manifest file describing the content of a COGS plugin or COGS Media Master custom content.

It should be saved in the root of a folder in the plugins or client_content folder in your COGS project

The COGS plugins directory contains a number of plugins you can use out of the box

interface CogsPluginManifestJson {
    config?: PluginManifestConfigJson[];
    description?: string;
    events?: {
        fromCogs?: PluginManifestEventJson[];
        toCogs?: PluginManifestEventJson[];
    };
    icon?: string;
    indexPath?: string;
    media?: {
        audio?: true;
        images?: true;
        video?: true;
    };
    minCogsVersion?: `${number}.${number}.${number}`;
    name: string;
    state?: PluginManifestStateJson[];
    version: `${number}` | `${number}.${number}` | `${number}.${number}.${number}`;
    window?: {
        height: number;
        visible?: boolean;
        width: number;
    };
}

Properties

config? description? events? icon? indexPath? media? minCogsVersion? name state? version window?

Properties

Optional config

config?: PluginManifestConfigJson[]

Optional description

description?: string

A description that appears alongside name in the list of plugins, and in the COGS plugins directory

Optional events

events?: {
    fromCogs?: PluginManifestEventJson[];
    toCogs?: PluginManifestEventJson[];
}

Events that trigger COGS behaviors or can trigger actions in this plugin

Type declaration

Optional icon

icon?: string

An icon shown alongside name, in the COGS navigation bar, and in the COGS plugins directory

The icon can be either:

  • A FontAwesome 5 icon
  • The relative path to an image in your plugin folder (Requires COGS 4.13 or later)
    • Must start with ./
    • Alpha channel is used as a mask

Optional indexPath

indexPath?: string

The HTML entrypoint for the plugin

Defaults to / which includes /index.html

Optional media

media?: {
    audio?: true;
    images?: true;
    video?: true;
}

The types of COGS media actions supported

Type declaration

  • Optional audio?: true
  • Optional images?: true
  • Optional video?: true

Optional minCogsVersion

minCogsVersion?: `${number}.${number}.${number}`

The minimum COGS version required

Follows semantic versioning with semver e.g. `4.12.0

name

name: string

A short human-readable name

Optional state

state?: PluginManifestStateJson[]

State that can be set by COGS behaviors

version

version: `${number}` | `${number}.${number}` | `${number}.${number}.${number}`

e.g. 1.0.0

Optional window

window?: {
    height: number;
    visible?: boolean;
    width: number;
}

If set, shows a popup window to the user where you can show the HTML content of your plugin

By default a window is not shown to the user The window can later be opened/closed from the Javascript running in the plugin Only valid for plugins, not for Media Master custom content

Type declaration

  • height: number
  • Optional visible?: boolean

    Whether the window is initially visible

  • width: number

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc