![[Show/Hide Left Column]](pics/icons/oleftcol.png "[Show/Hide Left Column]"){kind=icon}
![[Show/Hide Right Column]](pics/icons/orightcol.png "[Show/Hide Right Column]"){kind=icon}
Plugin Alias Handler
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: $onlyPlugin 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 |