MediaWiki extension for sending notifications to a Discord webhook from MediaWiki. When a certain event occurs on your MediaWiki wiki, including new edits, they can be sent as a message to a channel on a Discord server using a webhook.

Multiple webhook URLs are supported and messages will be sent to all of them.

Live demo: https://runescape.wiki (https://discord.gg/runescapewiki)

• Discord webhook URL: This can be obtained by editing a channel on a server with the correct permissions.
• MediaWiki 1.31+

• cURL: By default, this extension sends requests using cURL. If you don't have cURL, you could try setting $wgDiscordUseFileGetContents to true instead, but this is not recommended.

1. Clone this repository to your MediaWiki installation's extensions folder using git clone https://github.com/jaydenkieran/mw-discord.git -b REL1_35 Discord (or change REL1_35 to the branch that corresponds with or is the closest version under your MediaWiki version, e.g REL1_31 will work for 1.32, 1.33, and 1.34)
2. Modify your LocalSettings.php file and add:

// Load the extension
wfLoadExtension( 'Discord' );
// Set the webhook URL(s) (string or array)
$wgDiscordWebhookURL = [ '' ];

For further configuration variables, see below.

To get a webhook URL for use with this extension, open the Discord client and go to a server where you have the Manage Webhooks permission. Click the cog icon when hovering over a text channel, switch to the Webhooks tab on the left of the interface, and click 'Create webhook'. The webhook URL can then be copied from that interface.

This extension can be configured using the LocalSettings.php file in your MediaWiki installation.

• PageContentSaveComplete - New edits to pages and page creations
• ArticleDeleteComplete - Page deletions
• ArticleUndelete - Page restorations
• ArticleRevisionVisibilitySet - Revision visibility changes
• ArticleProtectComplete - Page protections
• TitleMoveComplete - Page moves
• LocalUserCreated - User registrations
• BlockIpComplete - User blocked
• UnblockUserComplete - User unblocked
• UserGroupsChanged - User rights changed
• UploadComplete - File was uploaded
• FileDeleteComplete - File revision was deleted
• FileUndeleteComplete - File revision was restored
• AfterImportPage - Page was imported
• ArticleMergeComplete - Article histories was merged

• ApprovedRevsRevisionApproved - Revision was approved
• ApprovedRevsRevisionUnapproved - Revision was unapproved
• ApprovedRevsFileRevisionApproved - File revision was approved
• ApprovedRevsFileRevisionUnapproved - File revision was unapproved

This extension can be translated through the messages in the ì18n folder if you're a developer. As a wiki administrator, you may find it a better option to edit the messages on-site in the MediaWiki namespace.

Any excess whitespace in text that is translated will be stripped (e.g double spaces, etc).

This extension is licensed under the MIT License, see here for more information. This project is originally inspired by Szmyk's mediawiki-discord project, but has been rewritten completely to be more suitable for my needs.