FANDOM


DiscordIntegrator plugin allows integrating a Discord widget into your sidebar or content.

Installation

To install this script, you need to have JavaScript enabled on the wiki. If you don't, use this contact form to request from FANDOM Staff to enable it.

After your JavaScript is enabled, insert the following line in your wiki's MediaWiki:ImportJS page:

dev:DiscordIntegrator/code.js

Note: DiscordIntegrator configuration and importing does not require any JavaScript review in order to function normally.

Configuration

Enabling the widget

The widget can be enabled by server administrators through the settings screen of their Discord server, under the "Widget" section. To enable embedding a widget to your server, tick the "Enable Widget" box. If you wish for users to be able to connect to your server through the widget, you should also select something in the "Instant invite channel" option.

Important: The server ID that can be found in the widget section is very important for setting up the widget, which is explained in sections below and in the template.

Content

After the script is installed through the methods explained above, it is possible to make the widget show up in the page content. It is advised to create a template on your wiki and copy the contents of {{DiscordIntegrator}} to it. After that, the template can be used as:

{{DiscordIntegrator
| id = 246075715714416641
| theme = light
| width = 500px
| height = 500px
}}

which gives:

If you see this, your JavaScript might be disabled or DiscordIntegrator plugin isn't working. If the latter, please contact a wiki administrator.

For more complicated usage you can check the template documentation itself.

Sidebar

The script can be configured to add the widget to the sidebar of the wiki on Oasis through editing several MediaWiki pages. Any MediaWiki page relating to the configuration of DiscordIntegrator starts with MediaWiki:Custom-DiscordIntegrator-config- and after it goes the name of the configuration option. For example, to configure the ID of the server, you'd need to go to MediaWiki:Custom-DiscordIntegrator-config-id.

The widget will appear in the siderail, only if the ID of the server is set in configuration options. Configuration options have same names as configuration options when adding the widget to content, except with the addition of a few parameters:

Option Type What it changes Default
title String Title of the module on the siderail None
moduleHeight String Height of the module in the siderail 500px
text String Text above the widget None

An example of the widget can be seen in the sidebar on this page.

Frequently Asked Questions

Can I change the colors on the widget?
Currently, no. The widget is an iframe, therefore its style cannot be changed.
The widget is loading infinitely
That means you didn't enable the widget in your server settings.
Enable the widget as said in Enabling the widget section and refresh the page.
Sometimes it might take a minute or two for the widget to register it's enabled.
Is the ID required for the module to function?
Yes, or nothing will display

Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.