Mediawiki Integration for Slack.
- Sends notifications to a Slack channel whenever a page is added or edited on your MediaWiki installation.
- MediaWiki >= 1.21
Log in to your Slack Team and click "Integrations".
Select "Incoming WebHooks" as the type.
Choose the default channel you want to use and click "Add Integration".
Copy the Webhook URL shown on the left of the page. We'll need this in step 6.
If you use composer to manage your MediaWiki extensions, just add
"mediawiki/slack": ">1.0.1"to the require section. If you don't use composer, copy the contents of the repository into a folder called
Slackin your wiki's extensions folder.
Add the following lines to LocalSettings.php
# Enable the Slack extension require_once "$IP/extensions/Slack/Slack.php"; # Slack extension configuration options $wgSlackWebhookURL = "THE INTEGRATION URL FROM STEP 4"; $wgSlackUserName = "THE USERNAME YOU WANT YOUR BOT TO HAVE IN SLACK"; $wgSlackChannel = "#theChannelForBotMessagesToAppearIn";
Edit a wiki page, and see the message pop up in Slack.
The optional features that you can enable and configure are listed below.
User Name Linking
This feature links the wiki user name to the equivalent Slack user in Slack messages. Enable it by adding the following line to LocalSettings.php:
$wgSlackLinkUsers = true;
Note that wiki usernames are converted to Lower Case before being passed to Slack. However, Slack's user name linking feature is case sensitive, so if your Slack user name contains capitals, it won't find you.
If you don't want to receive notifications about minor edits, add the following line to LocalSettings.php:
$wgSlackIgnoreMinor = true;
Pull requests for new features are welcome. There's lots more I'd like to make this integration do, but I don't have the time, and it already covers my main requirement.