Extension

Since Phabulous 3.0, it is possible to have additional integrations between Slack and Phabricator. This is done through a combination of a Phabricator extension, which provides additional Conduit API methods, and a Phabulous module called extension which makes use of these API methods. This allows Phabulous to:

• Mention users by the Slack username when the summon command is used.
• Lookup a Slack username by their Phabricator username.
• Lookup a Phabricator username by their Slack username.

NOTE: The extension is somewhat experimental. Use at your own risk.

Requirements

• A Phabricator version with the Slack authentication provider (2016 Week 38 or newer).
• The phabricator-phabulous extension: https://phabricator.chromabits.com/diffusion/PHPH/
• Phabulous 3.0 or newer, which the extension module enabled.

Setup

Step 1: Upgrade

• Begin by upgrading your Phabricator instance if it is older than 2016 Week 38.

Step 2: Install the extension

• SSH or login into your Phabricator server and navigate to the directory where your Phabricator install is located.

For example, if our installed was in a directory called websites, we want to cd websites, not cd websites/phabricator:

.
└── websites
    └── phabricator

• Clone the extension into this directory: git clone https://phabricator.chromabits.com/diffusion/PHPH/phabricator-phabulous.git:

.
└── websites
    ├── phabricator
    └── phabricator-phabulous

• Edit your phabricator/conf/local/local.json and add the Phabulous library:

{
  //... Other settings
  "load-libraries": {
     "phabulous": "/path/to/websites/phabricator-phabulous/src"
  }
}

Step 4: Load the extension module in Phabulous by adding a - extension entry to the server.modules key in config/main.yaml:

server:
  modules:
    - core
    - extension