private function processMailCommands(PhabricatorMetaMTAReceivedMail $mail, array $command_list)
{
$viewer = $this->getActor();
$object = $this->getMailReceiver();
$list = MetaMTAEmailTransactionCommand::getAllCommandsForObject($object);
$map = MetaMTAEmailTransactionCommand::getCommandMap($list);
$xactions = array();
foreach ($command_list as $command_argv) {
$command = head($command_argv);
$argv = array_slice($command_argv, 1);
$handler = idx($map, phutil_utf8_strtolower($command));
if ($handler) {
$results = $handler->buildTransactions($viewer, $object, $mail, $command, $argv);
foreach ($results as $result) {
$xactions[] = $result;
}
} else {
$valid_commands = array();
foreach ($list as $valid_command) {
$aliases = $valid_command->getCommandAliases();
if ($aliases) {
foreach ($aliases as $key => $alias) {
$aliases[$key] = '!' . $alias;
}
$aliases = implode(', ', $aliases);
$valid_commands[] = pht('!%s (or %s)', $valid_command->getCommand(), $aliases);
} else {
$valid_commands[] = '!' . $valid_command->getCommand();
}
}
throw new Exception(pht('The command "!%s" is not a supported mail command. Valid ' . 'commands for this object are: %s.', $command, implode(', ', $valid_commands)));
}
}
return $xactions;
}
public function handleRequest(AphrontRequest $request)
{
$viewer = $this->getViewer();
$application = $request->getURIData('application');
$selected = id(new PhabricatorApplicationQuery())->setViewer($viewer)->withClasses(array($application))->executeOne();
if (!$selected) {
return new Aphront404Response();
}
$specs = $selected->getMailCommandObjects();
$type = $request->getURIData('type');
if (empty($specs[$type])) {
return new Aphront404Response();
}
$spec = $specs[$type];
$commands = MetaMTAEmailTransactionCommand::getAllCommandsForObject($spec['object']);
$commands = msort($commands, 'getCommand');
$content = array();
$content[] = '= ' . pht('Mail Commands Overview');
$content[] = pht('After configuring Phabricator to process inbound mail, you can ' . 'interact with objects (like tasks and revisions) over email. For ' . 'information on configuring Phabricator, see ' . '**[[ %s | Configuring Inbound Email ]]**.' . "\n\n" . 'In most cases, you can reply to email you receive from Phabricator ' . 'to leave comments. You can also use **mail commands** to take a ' . 'greater range of actions (like claiming a task or requesting changes ' . 'to a revision) without needing to log in to the web UI.' . "\n\n" . 'Mail commands are keywords which start with an exclamation point, ' . 'like `!claim`. Some commands may take parameters, like ' . "`!assign alincoln`.\n\n" . 'To use mail commands, write one command per line at the beginning ' . 'or end of your mail message. For example, you could write this in a ' . 'reply to task email to claim the task:' . "\n\n```\n!claim\n\nI'll take care of this.\n```\n\n\n" . "When Phabricator receives your mail, it will process any commands " . "first, then post the remaining message body as a comment. You can " . "execute multiple commands at once:" . "\n\n```\n!assign alincoln\n!close\n\nI just talked to @alincoln, " . "and he showed me that he fixed this.\n```\n", PhabricatorEnv::getDoclink('Configuring Inbound Email'));
$content[] = '= ' . $spec['header'];
$content[] = $spec['summary'];
$content[] = '= ' . pht('Quick Reference');
$content[] = pht('This table summarizes the available mail commands. For details on a ' . 'specific command, see the command section below.');
$table = array();
$table[] = '| ' . pht('Command') . ' | ' . pht('Summary') . ' |';
$table[] = '|---|---|';
foreach ($commands as $command) {
$summary = $command->getCommandSummary();
$table[] = '| ' . $command->getCommandSyntax() . ' | ' . $summary;
}
$table = implode("\n", $table);
$content[] = $table;
foreach ($commands as $command) {
$content[] = '== !' . $command->getCommand() . ' ==';
$content[] = $command->getCommandSummary();
$aliases = $command->getCommandAliases();
if ($aliases) {
foreach ($aliases as $key => $alias) {
$aliases[$key] = '!' . $alias;
}
$aliases = implode(', ', $aliases);
} else {
$aliases = '//None//';
}
$syntax = $command->getCommandSyntax();
$table = array();
$table[] = '| ' . pht('Property') . ' | ' . pht('Value');
$table[] = '|---|---|';
$table[] = '| **' . pht('Syntax') . '** | ' . $syntax;
$table[] = '| **' . pht('Aliases') . '** | ' . $aliases;
$table[] = '| **' . pht('Class') . '** | `' . get_class($command) . '`';
$table = implode("\n", $table);
$content[] = $table;
$description = $command->getCommandDescription();
if ($description) {
$content[] = $description;
}
}
$content = implode("\n\n", $content);
$title = $spec['name'];
$crumbs = $this->buildApplicationCrumbs();
$this->addApplicationCrumb($crumbs, $selected);
$crumbs->addTextCrumb($title);
$crumbs->setBorder(true);
$content_box = PhabricatorMarkupEngine::renderOneObject(id(new PhabricatorMarkupOneOff())->setContent($content), 'default', $viewer);
$info_view = null;
if (!PhabricatorEnv::getEnvConfig('metamta.reply-handler-domain')) {
$error = pht("Phabricator is not currently configured to accept inbound mail. " . "You won't be able to interact with objects over email until " . "inbound mail is set up.");
$info_view = id(new PHUIInfoView())->setErrors(array($error));
}
$header = id(new PHUIHeaderView())->setHeader($title);
$document = id(new PHUIDocumentViewPro())->setHeader($header)->appendChild($info_view)->appendChild($content_box);
return $this->buildApplicationPage(array($crumbs, $document), array('title' => $title));
}
public function testGetAllTypes()
{
MetaMTAEmailTransactionCommand::getAllCommands();
$this->assertTrue(true);
}
