Allow configuration to have custom UI types

Summary:
Ref T1703. This sets the stage for (but does not yet implement) custom UI types for config. In particular, a draggable list for custom fields.

I might make all the builtin types go through this at some point too, but don't really want to bother for the moment. It would be very slightly cleaner but woudn't get us much of anything.

Test Plan:
UI now renders via custom code, although that code does nothing (produces an unadorned text field):

{F45693}

Reviewers: chad

Reviewed By: chad

CC: aran

Maniphest Tasks: T1703

Differential Revision: https://secure.phabricator.com/D6154

src/__phutil_library_map__.php

@@ -894,6 +894,7 @@ phutil_register_library_map(array(
     'PhabricatorConfigManagementSetWorkflow' => 'applications/config/management/PhabricatorConfigManagementSetWorkflow.php',
     'PhabricatorConfigManagementWorkflow' => 'applications/config/management/PhabricatorConfigManagementWorkflow.php',
     'PhabricatorConfigOption' => 'applications/config/option/PhabricatorConfigOption.php',
+    'PhabricatorConfigOptionType' => 'applications/config/custom/PhabricatorConfigOptionType.php',
     'PhabricatorConfigProxySource' => 'infrastructure/env/PhabricatorConfigProxySource.php',
     'PhabricatorConfigResponse' => 'applications/config/response/PhabricatorConfigResponse.php',
     'PhabricatorConfigSource' => 'infrastructure/env/PhabricatorConfigSource.php',
@@ -918,6 +919,7 @@ phutil_register_library_map(array(
     'PhabricatorCrumbsView' => 'view/layout/PhabricatorCrumbsView.php',
     'PhabricatorCursorPagedPolicyAwareQuery' => 'infrastructure/query/policy/PhabricatorCursorPagedPolicyAwareQuery.php',
     'PhabricatorCustomField' => 'infrastructure/customfield/field/PhabricatorCustomField.php',
+    'PhabricatorCustomFieldConfigOptionType' => 'infrastructure/customfield/config/PhabricatorCustomFieldConfigOptionType.php',
     'PhabricatorCustomFieldDataNotAvailableException' => 'infrastructure/customfield/exception/PhabricatorCustomFieldDataNotAvailableException.php',
     'PhabricatorCustomFieldImplementationIncompleteException' => 'infrastructure/customfield/exception/PhabricatorCustomFieldImplementationIncompleteException.php',
     'PhabricatorCustomFieldIndexStorage' => 'infrastructure/customfield/storage/PhabricatorCustomFieldIndexStorage.php',
@@ -2774,6 +2776,7 @@ phutil_register_library_map(array(
     'PhabricatorCrumbView' => 'AphrontView',
     'PhabricatorCrumbsView' => 'AphrontView',
     'PhabricatorCursorPagedPolicyAwareQuery' => 'PhabricatorPolicyAwareQuery',
+    'PhabricatorCustomFieldConfigOptionType' => 'PhabricatorConfigOptionType',
     'PhabricatorCustomFieldDataNotAvailableException' => 'Exception',
     'PhabricatorCustomFieldImplementationIncompleteException' => 'Exception',
     'PhabricatorCustomFieldIndexStorage' => 'PhabricatorLiskDAO',

src/applications/config/controller/PhabricatorConfigEditController.php

@@ -236,67 +236,72 @@ final class PhabricatorConfigEditController
       return array($e_value, $errors, $value, $xaction);
     }
 
-    $type = $option->getType();
-    $set_value = null;
+    if ($option->isCustomType()) {
+      $info = $option->getCustomObject()->readRequest($option, $request);
+      list($e_value, $errors, $set_value, $value) = $info;
+    } else {
+      $type = $option->getType();
+      $set_value = null;
 
-    switch ($type) {
-      case 'int':
-        if (preg_match('/^-?[0-9]+$/', trim($value))) {
-          $set_value = (int)$value;
-        } else {
-          $e_value = pht('Invalid');
-          $errors[] = pht('Value must be an integer.');
-        }
-        break;
-      case 'string':
-      case 'enum':
-        $set_value = (string)$value;
-        break;
-      case 'list<string>':
-        $set_value = $request->getStrList('value');
-        break;
-      case 'set':
-        $set_value = array_fill_keys($request->getStrList('value'), true);
-        break;
-      case 'bool':
-        switch ($value) {
-          case 'true':
-            $set_value = true;
-            break;
-          case 'false':
-            $set_value = false;
-            break;
-          default:
-            $e_value = pht('Invalid');
-            $errors[] = pht('Value must be boolean, "true" or "false".');
-            break;
-        }
-        break;
-      case 'class':
-        if (!class_exists($value)) {
-          $e_value = pht('Invalid');
-          $errors[] = pht('Class does not exist.');
-        } else {
-          $base = $option->getBaseClass();
-          if (!is_subclass_of($value, $base)) {
-            $e_value = pht('Invalid');
-            $errors[] = pht('Class is not of valid type.');
+      switch ($type) {
+        case 'int':
+          if (preg_match('/^-?[0-9]+$/', trim($value))) {
+            $set_value = (int)$value;
           } else {
-            $set_value = $value;
+            $e_value = pht('Invalid');
+            $errors[] = pht('Value must be an integer.');
           }
-        }
-        break;
-      default:
-        $json = json_decode($value, true);
-        if ($json === null && strtolower($value) != 'null') {
-          $e_value = pht('Invalid');
-          $errors[] = pht(
-            'The given value must be valid JSON. This means, among '.
-            'other things, that you must wrap strings in double-quotes.');
-        } else {
-          $set_value = $json;
-        }
-        break;
+          break;
+        case 'string':
+        case 'enum':
+          $set_value = (string)$value;
+          break;
+        case 'list<string>':
+          $set_value = $request->getStrList('value');
+          break;
+        case 'set':
+          $set_value = array_fill_keys($request->getStrList('value'), true);
+          break;
+        case 'bool':
+          switch ($value) {
+            case 'true':
+              $set_value = true;
+              break;
+            case 'false':
+              $set_value = false;
+              break;
+            default:
+              $e_value = pht('Invalid');
+              $errors[] = pht('Value must be boolean, "true" or "false".');
+              break;
+          }
+          break;
+        case 'class':
+          if (!class_exists($value)) {
+            $e_value = pht('Invalid');
+            $errors[] = pht('Class does not exist.');
+          } else {
+            $base = $option->getBaseClass();
+            if (!is_subclass_of($value, $base)) {
+              $e_value = pht('Invalid');
+              $errors[] = pht('Class is not of valid type.');
+            } else {
+              $set_value = $value;
+            }
+          }
+          break;
+        default:
+          $json = json_decode($value, true);
+          if ($json === null && strtolower($value) != 'null') {
+            $e_value = pht('Invalid');
+            $errors[] = pht(
+              'The given value must be valid JSON. This means, among '.
+              'other things, that you must wrap strings in double-quotes.');
+          } else {
+            $set_value = $json;
+          }
+          break;
+      }
     }
 
     if (!$errors) {
@@ -320,22 +325,26 @@ final class PhabricatorConfigEditController
       return null;
     }
 
-    $type = $option->getType();
-    $value = $entry->getValue();
-    switch ($type) {
-      case 'int':
-      case 'string':
-      case 'enum':
-      case 'class':
-        return $value;
-      case 'bool':
-        return $value ? 'true' : 'false';
-      case 'list<string>':
-        return implode("\n", nonempty($value, array()));
-      case 'set':
-        return implode("\n", nonempty(array_keys($value), array()));
-      default:
-        return PhabricatorConfigJSON::prettyPrintJSON($value);
+    if ($option->isCustomType()) {
+      return $option->getCustomObject()->getDisplayValue($option, $entry);
+    } else {
+      $type = $option->getType();
+      $value = $entry->getValue();
+      switch ($type) {
+        case 'int':
+        case 'string':
+        case 'enum':
+        case 'class':
+          return $value;
+        case 'bool':
+          return $value ? 'true' : 'false';
+        case 'list<string>':
+          return implode("\n", nonempty($value, array()));
+        case 'set':
+          return implode("\n", nonempty(array_keys($value), array()));
+        default:
+          return PhabricatorConfigJSON::prettyPrintJSON($value);
+      }
     }
   }
 
@@ -344,64 +353,71 @@ final class PhabricatorConfigEditController
     $display_value,
     $e_value) {
 
-    $type = $option->getType();
-    switch ($type) {
-      case 'int':
-      case 'string':
-        $control = id(new AphrontFormTextControl());
-        break;
-      case 'bool':
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions(
+    if ($option->isCustomType()) {
+      $control = $option->getCustomObject()->renderControl(
+        $option,
+        $display_value,
+        $e_value);
+    } else {
+      $type = $option->getType();
+      switch ($type) {
+        case 'int':
+        case 'string':
+          $control = id(new AphrontFormTextControl());
+          break;
+        case 'bool':
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions(
+              array(
+                ''      => pht('(Use Default)'),
+                'true'  => idx($option->getBoolOptions(), 0),
+                'false' => idx($option->getBoolOptions(), 1),
+              ));
+          break;
+        case 'enum':
+          $options = array_mergev(
             array(
-              ''      => pht('(Use Default)'),
-              'true'  => idx($option->getBoolOptions(), 0),
-              'false' => idx($option->getBoolOptions(), 1),
+              array('' => pht('(Use Default)')),
+              $option->getEnumOptions(),
             ));
-        break;
-      case 'enum':
-        $options = array_mergev(
-          array(
-            array('' => pht('(Use Default)')),
-            $option->getEnumOptions(),
-          ));
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions($options);
-        break;
-      case 'class':
-        $symbols = id(new PhutilSymbolLoader())
-          ->setType('class')
-          ->setAncestorClass($option->getBaseClass())
-          ->setConcreteOnly(true)
-          ->selectSymbolsWithoutLoading();
-        $names = ipull($symbols, 'name', 'name');
-        asort($names);
-        $names = array(
-          '' => pht('(Use Default)'),
-        ) + $names;
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions($options);
+          break;
+        case 'class':
+          $symbols = id(new PhutilSymbolLoader())
+            ->setType('class')
+            ->setAncestorClass($option->getBaseClass())
+            ->setConcreteOnly(true)
+            ->selectSymbolsWithoutLoading();
+          $names = ipull($symbols, 'name', 'name');
+          asort($names);
+          $names = array(
+            '' => pht('(Use Default)'),
+          ) + $names;
 
-        $control = id(new AphrontFormSelectControl())
-          ->setOptions($names);
-        break;
-      case 'list<string>':
-      case 'set':
-        $control = id(new AphrontFormTextAreaControl())
-          ->setCaption(pht('Separate values with newlines or commas.'));
-        break;
-      default:
-        $control = id(new AphrontFormTextAreaControl())
-          ->setHeight(AphrontFormTextAreaControl::HEIGHT_VERY_TALL)
-          ->setCustomClass('PhabricatorMonospaced')
-          ->setCaption(pht('Enter value in JSON.'));
-        break;
+          $control = id(new AphrontFormSelectControl())
+            ->setOptions($names);
+          break;
+        case 'list<string>':
+        case 'set':
+          $control = id(new AphrontFormTextAreaControl())
+            ->setCaption(pht('Separate values with newlines or commas.'));
+          break;
+        default:
+          $control = id(new AphrontFormTextAreaControl())
+            ->setHeight(AphrontFormTextAreaControl::HEIGHT_VERY_TALL)
+            ->setCustomClass('PhabricatorMonospaced')
+            ->setCaption(pht('Enter value in JSON.'));
+          break;
+      }
+
+      $control
+        ->setLabel(pht('Value'))
+        ->setError($e_value)
+        ->setValue($display_value)
+        ->setName('value');
     }
 
-    $control
-      ->setLabel(pht('Value'))
-      ->setError($e_value)
-      ->setValue($display_value)
-      ->setName('value');
-
     if ($option->getLocked()) {
       $control->setDisabled(true);
     }

src/applications/config/custom/PhabricatorConfigOptionType.php

@@ -0,0 +1,39 @@
+<?php
+
+abstract class PhabricatorConfigOptionType {
+
+  public function validateOption(PhabricatorConfigOption $option, $value) {
+    return;
+  }
+
+  public function readRequest(
+    PhabricatorConfigOption $option,
+    AphrontRequest $request) {
+
+    $e_value = null;
+    $errors = array();
+    $storage_value = $request->getStr('value');
+    $display_value = $request->getStr('value');
+
+    return array($e_value, $errors, $storage_value, $display_value);
+  }
+
+  public function getDisplayValue(
+    PhabricatorConfigOption $option,
+    PhabricatorConfigEntry $entry) {
+    return $entry->getValue();
+  }
+
+  public function renderControl(
+    PhabricatorConfigOption $option,
+    $display_value,
+    $e_value) {
+
+    return id(new AphrontFormTextControl())
+      ->setName('value')
+      ->setLabel(pht('Value'))
+      ->setValue($display_value)
+      ->setError($e_value);
+  }
+
+}

src/applications/config/option/PhabricatorApplicationConfigOptions.php

@@ -15,6 +15,10 @@ abstract class PhabricatorApplicationConfigOptions extends Phobject {
       return;
     }
 
+    if ($option->isCustomType()) {
+      return $option->getCustomObject()->validateOption($option, $value);
+    }
+
     switch ($option->getType()) {
       case 'bool':
         if ($value !== true &&

src/applications/config/option/PhabricatorConfigOption.php

@@ -17,6 +17,8 @@ final class PhabricatorConfigOption
   private $hidden;
   private $masked;
   private $baseClass;
+  private $customData;
+  private $customObject;
 
   public function setBaseClass($base_class) {
     $this->baseClass = $base_class;
@@ -178,6 +180,29 @@ final class PhabricatorConfigOption
     return $this->type;
   }
 
+  public function isCustomType() {
+    return !strncmp($this->getType(), 'custom:', 7);
+  }
+
+  public function getCustomObject() {
+    if (!$this->customObject) {
+      if (!$this->isCustomType()) {
+        throw new Exception("This option does not have a custom type!");
+      }
+      $this->customObject = newv(substr($this->getType(), 7), array());
+    }
+    return $this->customObject;
+  }
+
+  public function getCustomData() {
+    return $this->customData;
+  }
+
+  public function setCustomData($data) {
+    $this->customData = $data;
+    return $this;
+  }
+
 /* -(  PhabricatorMarkupInterface  )----------------------------------------- */
 
   public function getMarkupFieldKey($field) {

src/applications/people/config/PhabricatorUserConfigOptions.php

@@ -25,8 +25,11 @@ final class PhabricatorUserConfigOptions
       );
     }
 
+    $custom_field_type = 'custom:PhabricatorCustomFieldConfigOptionType';
+
     return array(
-      $this->newOption('user.fields', 'wild', $default)
+      $this->newOption('user.fields', $custom_field_type, $default)
+        ->setCustomData(id(new PhabricatorUser())->getCustomFieldBaseClass())
         ->setDescription(pht("Select and reorder user profile fields.")),
     );
   }

src/infrastructure/customfield/config/PhabricatorCustomFieldConfigOptionType.php

@@ -0,0 +1,6 @@
+<?php
+
+final class PhabricatorCustomFieldConfigOptionType
+  extends PhabricatorConfigOptionType {
+
+}