This is a handler to use a plugin alias, created from profiles.

Sample

YAML

objects:
 -
  type: tracker
  ref: tracker
  data:
   name: Hello World
 -
  type: tracker_field
  ref: only
  data:
   name: Only Field
   tracker: $tracker
   type: text_field
   flags: [ searchable, public, list, mandatory, link]
 -
  type: plugin_alias
  ref: my_alias
  data:
   name: mytracker
   implementation: trackerlist
   description:
    name: My Tracker Plugin
    description: Does nothing meaningful, just testing profiles
    prefs: [ feature_trackers ]
    params:
     foo:
      name: Foo
      description: Bar
      required: true
   body:
    input: use
    default: Hello World
   params:
    trackerId: $tracker
    fields: $only

Plugin Alias Object

The plugin alias object is mapped directly to the internal structures. Because there are multiple nested structures, multiple tables are used to describe it.

Field Name	Mandatory	Value
name	y	The name of the plugin, must contain letters only.
implementation	y	The name of the underlying plugin.
description	y	Equivalent of a plugin info function return value. Used to generate the documentation.
body		Complex structure, described below
params		Complex structure, described below

Body

This section describes what to do with the body of the plugin. The body may be passed through to the implementation or a custom body can be sent instead. Parameters may be contained in the body, like %name% ".

Field Name	Mandatory	Value
input	y	use or ignore, what to do with the user input
default	y	Value to send if user input is empty.
params		List of replacement parameters, described below

Plugin parameters

Plugin parameters are identified by a key (the parameter that will be provided to the implementation plugin). The parameters can be provided in two forms:

name: default value

or

name: complex structure, where structure is described below

Field Name	Mandatory	Value
pattern	y	String to provide to the plugin with possible parameters
params	y	List of replacement parameters, described below

Replacement parameters

Each replacement parameter is identified by a key (used to replace with) and the containing values are as follow:

Field Name	Mandatory	Value
input		Name of the parameter to read from, if different from the token name
default		Default value to replace with if parameter not provided
encoding		none, html or url , the encoding type to use when replacing the value