Extension:Discord

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg
Discord

Release status:Extension status experimental

Screenshot-extension-discord.png
ImplementationTemplate:Extension#type Tag
DescriptionTemplate:Extension#description Discord is a MediaWiki extension that registers a parser tag for embedding a Discord widget
Author(s)Template:Extension#username Samantha Nguyen
Latest versionTemplate:Extension#version 1.0.5 (2017-03-17)
MediaWikiTemplate:Extension#mediawiki 1.30+
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Download
Hooks usedTemplate:Extension#hook
ParserFirstCallInitManual:Hooks/ParserFirstCallInit

Translate the Discord extension if it is available at translatewiki.net

Check usage and version matrix.

Discord is a MediaWiki extension that registers <discord /> as a parser tag for embedding a Discord widget. Wiki administrators can add a default server ID by editing MediaWiki:Discord-server-id-default. This is useful for example when wikis have their own Discord channel and can simply write <discord /> to automatically show the users online from that specific server. Users can still override this by specifying a server ID.

It is currently in experimental status as Samantha Nguyen works on implementing changes such as proper error handling and a server blacklist that can be customized by wiki administrators.

Requirements[edit]

In order for the Discord extension to work, you need to configure your Discord server to allow embedding the widget. You can set this via Server Settings > Widget > Embed Widget (tick the checkbox).

Parameters[edit]

  • server-id - ID of a Discord server.
  • width - width of the Discord widget. Defaults to 350.
  • height - height of the Discord widget. Defaults to 500.
  • theme - theme of the Discord widget, which is either dark or light. Defaults to dark.

Installation[edit]

  • Download and place the file(s) in a directory called Discord in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'Discord' );
    
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.