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.

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

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

В скрипте есть конфигурация, добавляющая виджет в правую сторону контента вики в скине 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, необходимый для работы модуля?
Да, иначе ничего не будет отображаться.