@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Document support for "limit" in tokenizer-based Custom Fields
Summary:
Fixes T13356. This option is supported and works fine, it just isn't documented.
Add documentation and fix the config option to actually link to it to make life a little easier.
Test Plan: Read documentation.
Maniphest Tasks: T13356
Differential Revision: https://secure.phabricator.com/D20691
+14
-5
+10
-5
src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
+10
-5
src/applications/maniphest/config/PhabricatorManiphestConfigOptions.php
···
451
451
EOTEXT
452
452
));
453
453
454
+
$fields_description = $this->deformat(pht(<<<EOTEXT
455
+
List of custom fields for Maniphest tasks.
456
+
457
+
For details on adding custom fields to Maniphest, see [[ %s | %s ]] in the
458
+
documentation.
459
+
EOTEXT
460
+
,
461
+
PhabricatorEnv::getDoclink('Configuring Custom Fields'),
462
+
pht('Configuring Custom Fields')));
454
463
455
464
return array(
456
465
$this->newOption('maniphest.custom-field-definitions', 'wild', array())
457
466
->setSummary(pht('Custom Maniphest fields.'))
458
-
->setDescription(
459
-
pht(
460
-
'Array of custom fields for Maniphest tasks. For details on '.
461
-
'adding custom fields to Maniphest, see "Configuring Custom '.
462
-
'Fields" in the documentation.'))
467
+
->setDescription($fields_description)
463
468
->addExample($fields_json, pht('Valid setting')),
464
469
$this->newOption('maniphest.fields', $custom_field_type, $default_fields)
465
470
->setCustomData(id(new ManiphestTask())->getCustomFieldBaseClass())
+4
src/docs/user/configuration/custom_fields.diviner
+4
src/docs/user/configuration/custom_fields.diviner
···
121
121
supported in text, int and remarkup fields (optional).
122
122
- **copy**: If true, this field's value will be copied when an object is
123
123
created using another object as a template.
124
+
- **limit**: For control types which use a tokenizer control to let the user
125
+
select a list of values, this limits how many values can be selected. For
126
+
example, a "users" field with a limit of "1" will behave like the "Owner"
127
+
field in Maniphest and only allow selection of a single user.
124
128
125
129
The `strings` value supports different strings per control type. They are:
126
130