The plugin configuration file (".plugin" extension) is used by both channel and application plugins.
It is optional for channel plugins and is only used if the plugin wants to define parameters. This file must reside in the same directory as the plugin script itself and have the same name (except for the extension).
It is mandatory for application plugins and must reside in the $/AppPlugins directory or sub-directory where it will be read by Awasu when it starts. It must contain at least the name of the plugin script which must reside in the same directory. It can also contain definitions of any global or per-channel parameters.
The format of this file is as follows:
[Config] Plugin= // Plugin script file. Must be in the same directory. AppPluginId= // Application plugin ID. Must be unique within Awasu and contain only // letters, digits and underscores. AppPluginDisplayName= // Application plugin display name that the user will see. AuthorName= // Plugin author's name (optional). AuthorEmailAddress= // Plugin author's email address (optional). PluginNotes= // User notes (optional).
Plugins can also define user-configurable parameters. Global plugin parameters apply to all channels being serviced by the plugin and are defined as follows:
[PluginParameterDefinition-1] Name= // Parameter name. Must be unique. Type= // Parameter type. Must be one of "int", "bool", "string", "double" or "file". DefaultValue= // Default value (optional). Description= // Description of the parameter (optional).This information can be repeated for as many parameters as the plugin wishes to define, just keep incrementing the number in the section name.
Per-channel parameters are defined in a similar way. They differ in that each channel will get its own copy of the parameters, allowing the user to configure them independently of any other channel:
[ChannelParameterDefinition-1] Name= // Parameter name. Must be unique. Type= // Parameter type. Must be one of "int", "bool", "string", "double" or "file". DefaultValue= // Default value (optional). Description= // Description of the parameter (optional).
There is one special parameter that can be defined: DownloadUrl. If this is defined, it should contain the URL of a file that Awasu will download on behalf of the plugin. This is useful since the plugin will not have to worry about proxies or cookies which will be taken care of by Awasu. Authentication details can be set in the optional DownloadUrl_UserName and DownloadUrl_Password parameters.
When the plugin is run, the path to the downloaded file will be passed to the plugin in the DownloadUrlFile parameter in the [System] section of the INI file.