Provide basic structure for keyboard shortcuts

Summary: Implements a simple infrastructure for keyboard shortcuts, see T184, and a "help" shortcut.

There's a lot of room for refinement here but I think it basically works. Each shortcut can also provide a "tooltip" handler which allows it to show help when the alt/option key is held down.

Test Plan: Pressed "?" and got help. Pressed "?" in various contexts where it should not activate (modifier keys, text input focused) and didn't get help.

Reviewers: aran, tuomaspelkonen, jungejason

CC: moskov

Differential Revision: 362

src/applications/help/controller/base/PhabricatorHelpController.php

@@ -0,0 +1,34 @@
+<?php
+
+/*
+ * Copyright 2011 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+abstract class PhabricatorHelpController extends PhabricatorController {
+
+  public function buildStandardPageResponse($view, array $data) {
+    $page = $this->buildStandardPageView();
+
+    $page->setApplicationName('Help');
+    $page->setBaseURI('/help/');
+    $page->setTitle(idx($data, 'title'));
+    $page->setGlyph('?');
+    $page->appendChild($view);
+
+    $response = new AphrontWebpageResponse();
+    return $response->setContent($page->render());
+  }
+
+}

src/applications/help/controller/base/__init__.php

@@ -0,0 +1,15 @@
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'aphront/response/webpage');
+phutil_require_module('phabricator', 'applications/base/controller/base');
+
+phutil_require_module('phutil', 'utils');
+
+
+phutil_require_source('PhabricatorHelpController.php');

src/applications/help/controller/keyboardshortcut/PhabricatorHelpKeyboardShortcutController.php

@@ -0,0 +1,61 @@
+<?php
+
+/*
+ * Copyright 2011 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+class PhabricatorHelpKeyboardShortcutController
+  extends PhabricatorHelpController {
+
+  public function processRequest() {
+    $request = $this->getRequest();
+    $user = $request->getUser();
+
+    $keys = $request->getStr('keys');
+    $keys = json_decode($keys, true);
+    if (!is_array($keys)) {
+      return new Aphront400Response();
+    }
+
+    $rows = array();
+    foreach ($keys as $shortcut) {
+      $keystrokes = array();
+      foreach ($shortcut['keys'] as $stroke) {
+        $keystrokes[] = '<kbd>'.phutil_escape_html($stroke).'</kbd>';
+      }
+      $keystrokes = implode(' or ', $keystrokes);
+      $rows[] =
+        '<tr>'.
+          '<th>'.$keystrokes.'</th>'.
+          '<td>'.phutil_escape_html($shortcut['description']).'</td>'.
+        '</tr>';
+    }
+
+    $table =
+      '<table class="keyboard-shortcut-help">'.
+        implode('', $rows).
+      '</table>';
+
+    $dialog = id(new AphrontDialogView())
+      ->setUser($user)
+      ->setTitle('Keyboard Shortcuts')
+      ->appendChild($table)
+      ->addCancelButton('#', 'Close');
+
+    return id(new AphrontDialogResponse())
+      ->setDialog($dialog);
+  }
+
+}

src/applications/help/controller/keyboardshortcut/__init__.php

@@ -0,0 +1,18 @@
+<?php
+/**
+ * This file is automatically generated. Lint this module to rebuild it.
+ * @generated
+ */
+
+
+
+phutil_require_module('phabricator', 'aphront/response/400');
+phutil_require_module('phabricator', 'aphront/response/dialog');
+phutil_require_module('phabricator', 'applications/help/controller/base');
+phutil_require_module('phabricator', 'view/dialog');
+
+phutil_require_module('phutil', 'markup');
+phutil_require_module('phutil', 'utils');
+
+
+phutil_require_source('PhabricatorHelpKeyboardShortcutController.php');