Differential D19854 Diff 47435 src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
Changeset View
Changeset View
Standalone View
Standalone View
src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
| Show First 20 Lines • Show All 332 Lines • ▼ Show 20 Lines | dictionary with these keys: | ||||
| - `key` //Required string.// Internal identifier for the subtype, like | - `key` //Required string.// Internal identifier for the subtype, like | ||||
| "task", "feature", or "bug". | "task", "feature", or "bug". | ||||
| - `name` //Required string.// Human-readable name for this subtype, like | - `name` //Required string.// Human-readable name for this subtype, like | ||||
| "Task", "Feature Request" or "Bug Report". | "Task", "Feature Request" or "Bug Report". | ||||
| - `tag` //Optional string.// Tag text for this subtype. | - `tag` //Optional string.// Tag text for this subtype. | ||||
| - `color` //Optional string.// Display color for this subtype. | - `color` //Optional string.// Display color for this subtype. | ||||
| - `icon` //Optional string.// Icon for the subtype. | - `icon` //Optional string.// Icon for the subtype. | ||||
| - `children` //Optional map.// Configure options shown to the user when | |||||
| they "Create Subtask". See below. | |||||
| Each subtype must have a unique key, and you must define a subtype with | Each subtype must have a unique key, and you must define a subtype with | ||||
| the key "%s", which is used as a default subtype. | the key "%s", which is used as a default subtype. | ||||
| The tag text (`tag`) is used to set the text shown in the subtype tag on list | The tag text (`tag`) is used to set the text shown in the subtype tag on list | ||||
| views and workboards. If you do not configure it, the default subtype will have | views and workboards. If you do not configure it, the default subtype will have | ||||
| no subtype tag and other subtypes will use their name as tag text. | no subtype tag and other subtypes will use their name as tag text. | ||||
| The `children` key allows you to configure which options are presented to the | |||||
| user when they "Create Subtask" from a task of this subtype. You can specify | |||||
| these keys: | |||||
| - `subtypes`: //Optional list<string>.// Show users creation forms for these | |||||
| task subtypes. | |||||
| - `forms`: //Optional list<string|int>.// Show users these specific forms, | |||||
| in order. | |||||
| If you don't specify either constraint, users will be shown creation forms | |||||
| for the same subtype. | |||||
| For example, if you have a "quest" subtype and do not configure `children`, | |||||
| users who click "Create Subtask" will be presented with all create forms for | |||||
| "quest" tasks. | |||||
| If you want to present them with forms for a different task subtype or set of | |||||
| subtypes instead, use `subtypes`: | |||||
| ``` | |||||
| { | |||||
| ... | |||||
| "children": { | |||||
| "subtypes": ["objective", "boss", "reward"] | |||||
| } | |||||
| ... | |||||
| } | |||||
| ``` | |||||
| If you want to present them with specific forms, use `forms` and specify form | |||||
| IDs: | |||||
| ``` | |||||
| { | |||||
| ... | |||||
| "children": { | |||||
| "forms": [12, 16] | |||||
| } | |||||
| ... | |||||
| } | |||||
| ``` | |||||
| When specifying forms by ID explicitly, the order you specify the forms in will | |||||
| be used when presenting options to the user. | |||||
| If only one option would be presented, the user will be taken directly to the | |||||
| appropriate form instead of being prompted to choose a form. | |||||
| EOTEXT | EOTEXT | ||||
| , | , | ||||
| $subtype_default_key)); | $subtype_default_key)); | ||||
| $priorities_description = $this->deformat(pht(<<<EOTEXT | $priorities_description = $this->deformat(pht(<<<EOTEXT | ||||
| Allows you to edit or override the default priorities available in Maniphest, | Allows you to edit or override the default priorities available in Maniphest, | ||||
| like "High", "Normal" and "Low". The configuration should contain a map of | like "High", "Normal" and "Low". The configuration should contain a map of | ||||
| numeric priority values (where larger numbers correspond to higher priorities) | numeric priority values (where larger numbers correspond to higher priorities) | ||||
| ▲ Show 20 Lines • Show All 72 Lines • Show Last 20 Lines | |||||