Propojení s Discordem

Discord je jedna z nejrozšířenějších komunikačních platforem, která umožňuje nejen posílání zpráv v reálném čase, ale i hlasovou komunikaci. Discord ovšem není součástí Miowebu, proto, pokud si přejete Discord využívat v rámci Miowebu, tak je nutné ho nejprve propojit.

Jak založit účet a vytvořit server na Discordu

Jako první krok je potřeba založit si účet u Discordu na stránce https://discord.com/register, kde vyplníte své údaje.

Discord má i svou vlastní aplikaci, ale není nutné ji stahovat, vše co si ukážeme v tomto návodu by mělo být možné udělat i prohlížečovém rozhraní Discordu.

Jakmile budete zaregistrováni, tak dalším krokem bude tvorba Vašeho Discord serveru.

1. Jakmile tedy budete přihlášeni, tak po levé straně Discordu uvidíte symbol "+" - přidat server (add a server pokud máte Discord v angličtině:

2. Na tento symbol kliknete a zobrazí se Vám tabulka, kde si budete moci vybrat z několika šablon pro Váš server, v tomto návodu si ukážeme, jak vytvořit server z prázdné šablony, tedy zvolíte první možnost:

3. Následně se Vás Discord zeptá, jestli chcete vytvořit server pro klub nebo komunitu, nebo jen pro přátelé, v tomto případě tedy doporučujeme zvolit opět zvolit první možnost, tedy klub nebo komunitu.
4. Poté už jen stačí vyplnit jméno serveru a kliknout na tlačítko "Vytvořit" (Create) a server budete mít založený.

Jak vytvořit Discord bota a propojit Mioweb s Discordem

Jakmile budete mít účet a server vytvořený, je nutné vytvořit i Discord bota, který bude sloužit k propojení Vašeho serveru s Miowebem a který bude Vaším klientům přiřazovat příslušné role podle toho, jaké členské sekce mají na Vašem webu.

1. Abychom mohli vytvořit bota, je potřeba se přihlásit do Discord developer portálu, přes tento odkaz https://discord.com/developers/applications.

• Přihlásíte se se svými údaji, které jste si nastavili při registraci do Discordu.

2. Jakmile budete přihlášeni, tak v pravém horním rohu kliknete na tlačítko Nová Aplikace (New Application):

3. Aplikaci si můžete pojmenovat jak chcete, název aplikace není podstatný, ale i tak doporučujeme nějaký rozumný název, abyste měli přehled v tom, jaká aplikace patří ke kterému webu, pokud máte v plánu propojovat Discord s více weby (pokaždé bude potřeba vytvářet nové aplikace).

4. Až budete mít aplikaci vytvořenou, tak půjdete do záložky Bot (1.) a zde si bota můžete přejmenovat v poli Uživatelské jméno (Username) (2.), pokud nechcete, aby se jmenoval stejně, jako Vaše aplikace a následně bude nutné resetovat Váš Token pro bota (3.):

5. Jako další krok přejdete do OAuth2 (1.) a zde si zkopírujete Vaše Client ID (2.) a opět bude nutné resetovat Client Secret (3.), abyste ho mohli zkopírovat, opět si obojí ihned někam uložte, abyste dané údaje neztratili, protože jsou nutné k tomu, aby bylo možné Discord s Miowebem propojit. Zároveň rovnou do přesměrování (Redirects), přidáte URL odkaz na Váš web a za něj přidáte /mwdiscord (4.) ,tedy celý odkaz bude např. vypadat jako https://mojedomena.cz/mwdiscord, tento odkaz je nutný k tomu, aby klienti na Vašem webu mohli jejich účet s discordem propojit a tedy byly jim následně po propojení přiřazovány správné členské sekce.

6. Až budete mít Bot Token, Client ID a Client Secret uložené, tak se vraťte zpět na Váš Discord a nyní bude potřeba u Vašeho účtu nastavit Developer Mode.

• V levém dolním rohu uvidíte svůj účet a u něj ozubené kolečko, na to kliknete:

• A zobrazí se Vám tabulka s nastavením.
• V této tabulce sjedete v levém panelu úplně dolů a jako druhou možnost odspoda uvidíte možnost Developer (1.).
• Na to kliknete a následně ho zapnete (2.).

7. Jakmile Developer Mode budete mít zapnutý vrátíte se k Vašemu Discord serveru a kliknete na něj pravým tlačítkem a jako poslední možnost odspoda se Vám zobrazí Kopírovat ID Serveru (Copy Server ID).

• Toto Server ID si také uložte, všechna ID co jste si doposud uložili budou potřeba k propojení Discordu s Miowebem.

8. Nyní je potřeba přidat Discord Bota na Váš server.

• To uděláte tak, že opět půjdete do Discord developer portálu na záložku OAuth2 a v sekci OAuth2 URL Generator zvolíte možnost bot:

• Pak na stránce sjedete ještě níže a zvolíte oprávnění, která bot může mít.
• Buď můžete zvolit oprávnění Administrator - v tomto případě bude Váš bot mít nejvyšší oprávnění, jako Vy.
• A nebo můžete zvolit oprávnění, která si přejete, ale aby vše fungovalo správně, tak jsou nutné minimálně oprávnění Manage Server, Manage Roles, Manage Channels a View Channels:

• Pak sjedete ještě níže na stránce, Intergration Type necháte nastavený na Guild Install a zkopírujete si odkaz úplně dole (Generated URL).

• Tento odkaz pak vložíte do Vašeho prohlížeče a pokud pracujete s aplikací Discordu, tak se Vám aplikace otevře a bude vyžadovat autorizaci a volbu serveru, kam chcete přidat bota. Zde tedy zvolíte Váš server a pak kliknete na "Authorise":

• Tímto se Váš bot přidá na Váš server a nyní již zbývá jen propojit Discord s Miowebem.

9. Propojení Discordu s Miowebem

• Jako poslední krok předtím než začne vše plně fungovat, je potřeba propojit Discord s Miowebem a k tomu budete potřebovat veškeré klíče, které jste si v předchozích krocích ukládali, tedy - Bot Token, Client ID, Server ID a Client Secret
• Nyní tedy již půjdete přímo do Miowebu, v prostředí editoru najedete v horním menu na "Nastavení" a v rozbalovacím menu, které se pod tím zobrazí, kliknete na "Propojení aplikací"

• Zde najdete Discord, kliknete na něj a zadáte vše, co jste si doposud uložili do příslušných polí:

• Jakmile vše budete mít vyplněno, tak kliknete na "Uložit" a Discord, který byl doposud zašedlý, by se Vám měl nyní zvýraznit a když na něj opět kliknete, tak by Vám v pravém horním rohu mělo zeleně svítit "Připojeno"

Tímto jste tedy úspěšně propojili Discord s Miowebem a můžete Vaše členské sekce začít "párovat" s rolemi na Discordu.

Jak na Discord serveru vytvořit role

Nyní, je potřeba se vrátit na Váš Discord server a vytvořit role, které si budete přát přiřazovat pomocí členských sekcí.

Jakmile se tedy vrátíte na Váš server, tak kliknete v levém horním rohu na jeho název a následně Nastavení serveru (Server settings):

Následně kliknete na záložku Role (Roles) a zde uvidíte všechny aktuální role, které na Vašem serveru existují, což by v tento moment měla být pouze role, která byla přiřazena automaticky Vašemu botovi.

Zde kliknete na tlačítko Vytvořit roli (Create Role):

a zde uvidíte různá nastavení dané role.

1. Zobrazení (Display)

• Zde nastavujete primárně název a barvu role, ale samozřejmě je na Vás, co vše se zde rozhodnete nastavit.

2. Oprávnění (Permissions)

• Zde nastavujete oprávnění dané role, tedy co budou moci daní uživatelé na Vašem serveru dělat.

• Standardně by uživatelům měla stačit tato oprávnění:
  • View Channels - slouží k zobrazení kanálů, které jim budou v rámci jejich rolí zpřístupněny
  • Send Messages and Create Posts - umožní uživatelům odesílat zprávy v textových kanálech do kterých mají přístup
  • Attach Files - pokud chcete, aby uživatelé mohli odesílat i obrázky, případně soubory, do textových kanálů
  • Add Reactions - slouží k tomu, aby uživatelé mohli reagovat na zprávy pomocí emotikonů
  • Connect - slouží k tomu, aby se uživatelé mohli připojit do hlasových kanálů, ke kterým mají přístup
  • Speak - slouží k tomu, aby uživatelé mohli mluvit v hlasových kanálech
  • Use Voice Activity - slouží k tomu, aby uživatelé nemuseli pokaždé mačkat tlačítko, když chtějí mluvit (tedy aby nemuseli využívat tzv. push to talk)
• Samozřejmě nemusíte daným rolím přiřazovat všechna tato oprávnění, stačí ta, která jste si jistí, že uživatelé doopravdy využijou.

3. Odkazy (Links)

• Toto nastavení slouží k tomu, že aby uživatelé mohli být přidáni do dané role, tak musí mít jejich Discord účet propojený s Vámi zvolenou aplikací.
• Nedoporučujeme toto nastavení využívat, mohlo by způsobit problém při automatizovaném přiřazování rolí z Miowebu.

4. Spravovat členy (Manage members)

• Zde uvidíte veškeré uživatelé, kteří mají tuto roli přiřazenou.

Jak na pomocí Miowebu přiřadit Discord role uživatelům příslušných členských sekcí

Nakonec se opět vrátíte do Miowebu a nyní bude potřeba u Vašich členských sekcí nastavit přiřazování příslušných rolí na Discordu.

1. Jako první krok tedy zvolíte členskou sekci, pro kterou jste na Discordu vytvořili odpovídající roli, v tomto případě jsem si pojmenoval členskou sekci "Discord", ale samozřejmě, toto je možné aplikovat na jakoukoliv členskou sekci, kterou si přejete, včetně těch, které na Vašem webu již existují.

2. Následně půjdete do záložky "Automatizace" a kliknete na "Přidat akci":

3. A u akcí Vás budou zajímat pouze možnosti:

• "Při přidání do členské sekce" - v tomto případě pak zvolíte možnost "Přidat na Discord"
• "Při odebrání z členské sekce" - v tomto případě naopak zvolíte možnost "Odebrat z Discordu"
• A v obou případech budete vždy volit roli, kterou si přejete uživateli na Discordu přidat, nebo odebrat v případě, že si Vaší členskou sekci zakoupil, nebo mu vypršela

Tímto je Váš web plně propojen s Discordem a každý uživatel, který si u Vás zakoupí členství, které je s Discordem propojeno, obdrží příslušnou roli na Vašem Discord serveru.

S tímto můžete dále pracovat tak, že určité kanály na Vašem Discord serveru zamknete pod příslušné role a tedy jen uživatelé, kteří mají do daných rolí přístup dané kanály uvidí. Discord umožňuje tvořit nejen textové kanály, ale i hlasové, které například můžou sloužit pro konzultace s Vašimi klienty, můžete tam tvořit i vlákna, případně informační kanály, do kterých uživatelé nebudou moci psát, jen uvidí novinky, které tam pošlete Vy a mnoho dalšího.

Pro detailnější informace k rozvíjení Vašeho Discord serveru doporučujeme již nahlédnout přímo do jejich oficiálních nápověd zde - https://support.discord.com/hc/en-us/sections/202857957-Server-Features