DiscordIntegrator — скрипт, интегрирующий Discord-виджет в содержимое страницы или в правую её часть.Discord-виджет может показывать всех онлайн-пользователей на сервере, активность пользователей, кто во что играет, посетителей голосового канала и т.д.
Если после прочтения документации вы все ещё не понимаете, как установить DiscordIntegrator на вашей вики, ознакомьтесь с пошаговым руководством.
Установка[]
Настройка[]
Подключение виджета[]
Виджет Дискорд-сервера его администраторы могут включить через Настройки сервера > Виджет. Чтобы виджет заработал, нажмите на кнопку-рычаг "Подключить виджет". Если Вы желаете, чтобы пользователи могли присоединяться к заданному каналу сервера, заполните опцию "Установить канал для приглашений". ID сервера используется в дальнейшем при настройке шаблона в вики, это самая важная деталь настроек.
Важно: ID сервера, который можно найти в настройках виджетов сервера, очень важен для настройки виджета, что объясняется ниже или на странице шаблона.
Содержимое[]
Когда скрипт установлен методом, описанным в разделе выше, в содержимое выбранной страницы можно вставить настройки виджета. Рекомендуется создать шаблон на Вашей вики, целиком скопировав код из здешнего шаблона {{DiscordIntegrator}}. Затем шаблон может быть использован следующим образом:
{{DiscordIntegrator
| id = 402223976375517194
| theme = light
| width = 300px
| 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.
Примечание: DiscordIntegrator не работает на мобильном скине и будет отображать сообщение об ошибке вместо виджета. Чтобы не допустить отображения виджета на мобильных устройствах, вы можете выбрать для него класс шаблона, который не отображается на мобильном скине (например навбокс).
Для более продвинутой настройки, см. документацию шаблона.
Правая сторона[]
В скрипте есть конфигурация, добавляющая виджет в правую сторону контента вики в скине Oasis. Это можно сделать через страницы MediaWiki. Любая страница, связанная с данным скриптом, начинается с названия MediaWiki:Custom-DiscordIntegrator-config-, после чего идёт название конфигурации. Например, чтобы настроить ID сервера, используется страница с названием MediaWiki:Custom-DiscordIntegrator-config-id.
Виджет появится в правой стороне страницы только в том случае, если ID сервера установлен в настройке конфигураций. Они носят такие же названия, как и настройки конфигураций при обычной вставке виджета в контент, однако с добавлением некоторых параметров:
| Настройка | Тип | Что меняется? | По умолчанию |
|---|---|---|---|
id
|
Число | ID вашего сервера Discord для встраивания | Нет |
title
|
Строка | Название модуля в правой стороне | Нет |
moduleHeight
|
Строка | Высота модуля в правой стороне | 500 |
text
|
Строка | Текст над виджетом | Нет |
footer
|
Строка | Текст под виджетом | Нет |
theme
|
dark или light
|
Тема виджета в правой части страницы | Наследует тему со скина FandomDesktop |
width
|
Количество пикселей (Xpx) или процентов (Y%)
|
Ширина Discord-виджета | 100%
|
height
|
Количество пикселей (Xpx) или процентов (Y%)
|
Высота Discord-виджета | 90%
|
logged-in
|
Логическое | Должен ли виджет отображаться только для зарегистрированных участников | Нет |
Пример виджета можно посмотреть на этой странице.
Часто задаваемые вопросы[]
- Могу ли я изменить цвета виджета?
- В настоящее время нет. Виджет — это iframe-элемент, поэтому его стиль не может быть изменён.
- Виджет бесконечно загружается
- Это означает, что вы не включили виджет в настройках вашего сервера.
- Включите виджет, как указано в разделе «Подключение виджета» и обновите страницу.
- Иногда для виджета может потребоваться минута или две, чтобы зарегистрировать его.
- Если виджет включён, то возможно вы скопировали весь код шаблона DiscordIntegrator на страницу MediaWiki:Custom-DiscordIntegrator-config-id. В этом случае, оставьте на той странице только ID сервера.
- Виджет всё ещё бесконечно загружается!
- Подождите немного, пока кеш Discord'а не очистится
- Пока вы ждёте, проверьте, написали ли вы ID сервера на странице MediaWiki:Custom-DiscordIntegrator-config-id.
- Если вы вставили весь код шаблона, то модуль не будет работать. Удостоверьтесь, что только ID сервера находится там.
- Я вижу ошибку "Template loop detected: Template:DiscordIntegrator"!
- Это значит, что вы скопировали шаблон некорректно.
- Вы должны скопировать шаблон на страницу шаблона с тем же именем на свою вики.
- Например, на Diep.io Wiki этот шаблон будет находится здесь.
- После того, как вы скопировали содежимое шаблона, вы дожны использовать этот шаблон, чтобы отобразить виджет Discord'а на страницах вики. Основную информацию об использовании этого шаблона можно найти здесь.