FANDOM


DiscordIntegrator — скрипт, интегрирующий Discord-виджет в содержимое страницы или в правую её часть.Discord-виджет может показывать всех онлайн-пользователей на сервере, активность пользователей, кто во что играет, посетителей голосового канала и т.д.

Если после прочтения документации вы все ещё не понимаете, как установить DiscordIntegrator на вашей вики, ознакомьтесь с пошаговым руководством.

Установка

Настройки

Подключение виджета

Виджет Дискорд-сервера его администраторы могут включить через Настройки сервера > Виджет. Чтобы виджет заработал, нажмите на кнопку-рычаг "Подключить виджет". Если Вы желаете, чтобы пользователи могли присоединяться к заданному каналу сервера, заполните опцию "Установить канал для приглашений". ID сервера используется в дальнейшем при настройке шаблона в вики, это самая важная деталь настроек.

Содержимое

Когда скрипт установлен методом, описанным в разделе выше, в содержимое выбранной страницы можно вставить настройки виджета. Рекомендуется создать шаблон на Вашей вики, целиком скопировав код из здешнего шаблона {{DiscordIntegrator}}. Затем шаблон может быть использован следующим образом:

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

вследствие чего получается:

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

ID следует поменять на свой. Ширину следует отрегулировать под возможности дизайн-шаблона, если речь идёт о боковой панели. Высота не должна быть слишком большой - обычно виджет соседствует с опросами и рекомендациями и заставлять читателя много листать не следует.

Для использования на продвинутом уровне можно более пристально почитать документацию шаблона.

Правая сторона

В скрипте есть конфигурация, добавляющая виджет в правую сторону контента вики в скине Oasis. Это можно сделать через страницы MediaWiki. Любая страница, связанная с данным скриптом, начинается с названия MediaWiki:Custom-DiscordIntegrator-config-, после чего идёт название конфигурации. Например, чтобы настроить ID сервера, используется страница с названием "MediaWiki:Custom-DiscordIntegrator-config-id".

Виджет появится в правой стороне страницы только в том случае, если ID сервера установлен в настройке конфигураций. Они носят такие же названия, как и настройки конфигураций при обычной вставке виджета в контент, однако с добавлением некоторых параметров:

Настройка Тип Что меняется? По умолчанию
id Число ID вашего сервера Discord для встраивания Нет
title Строка Название модуля в правой стороне Нет
moduleHeight Строка Высота модуля в правой стороне 500px
text Строка Текст над виджетом Нет
footer Строка Текст под виджетом Нет
theme dark или light Тема виджета в правой части страницы dark
width Количество пикселей (Xpx) или процентов (Y%) Ширина Discord-виджета 100%
height Количество пикселей (Xpx) или процентов (Y%) Высота Discord-виджета 90%
logged-in Логическое Должен ли виджет отображаться только для зарегистрированных участников Нет

Пример виджета может быть увиден в правой части этой страницы.

Часто задаваемые вопросы

Могу ли я изменить цвета виджета?
В настоящее время нет. Виджет — это iframe-элемент, поэтому его стиль не может быть изменён.
Виджет бесконечно загружается
Это означает, что вы не включили виджет в настройках вашего сервера.
Включите виджет, как указано в разделе «Подключение виджета» и обновите страницу.
Иногда для виджета может потребоваться минута или две, чтобы зарегистрировать его.
Требуется ли ID, необходимый для работы модуля?
Да, иначе ничего не будет отображаться.