DiscordIntegrator — скрипт, інтегруючий Discord-віджет у вміст сторінки або в праву її частину. Discord-віджет може показувати онлайн-користувачів на сервері, активність користувачів, хто в що грає, відвідувачів голосового каналу тощо.
Якщо після прочитання документації ви все ще не розумієте, як встановити DiscordIntegrator на вашій вікі, ознайомтеся з покроковим керівництвом.
Встановлення
Налаштування
Підключення віджета
Віджет для сервера можуть підключати його адміністратори через налаштування сервера, в секції "Віджет". Щоб вставити віджет, натисніть на кнопку "Підключити віджет". Якщо Ви бажаєте, щоб користувачі могли приєднуватися до сервера, виберіть опцію "Встановити канал для запрошень", яка показує, в який канал користувач приєднується при підключенні.
Увага: ID сервера може бути знайдено в секції віджета, і він дуже важливий для його установки, що пояснюється в тексті нижче.
Вміст
Коли скрипт встановлений методом, описаним в розділі вище, то у вміст сторінки можна вставити віджет. Рекомендується створити шаблон на Вашій вікі, скопіювавши код з шаблону {{DiscordIntegrator}}. Потім шаблон може бути використаний таким чином:
{{DiscordIntegrator
| id = 131913939549159424
| theme = light
| width = 500px
| height = 500px
}}
внаслідок чого виходить:
Для використання на просунутому рівні ви також можете перевірити документацію шаблону.
Права сторона
В скрипті є конфігурація, яка додає віджет в праву сторону вмісту вікі в скіні 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, необхідний для роботи модуля?
- Так, інакше нічого не відображатиметься.