diff --git a/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/claim-roles.md b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/claim-roles.md new file mode 100644 index 0000000..2ec992a --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/claim-roles.md @@ -0,0 +1,66 @@ +--- +sidebar_position: 3 +description: Folge dieser Anleitung, um eine verknüpfte Rolle zu beanspruchen, die dir zugewiesen wurde. +--- + +# So beanspruchst du eine verknüpfte Rolle + +Sobald dir eine Rolle zugewiesen wurde, ist das Beanspruchen in Discord einfach! Folge dieser Anleitung, um deine verknüpfte Rolle zu beanspruchen. + +:::success Teile mich! +Du kannst diese Anleitung mit deinen Mitgliedern teilen, damit sie wissen, wie sie ihre Rollen erhalten!\ +Hier ist die URL zum Teilen: [`https://scootk.it/claim-linked-roles`](https://scootk.it/claim-linked-roles). +::: + +## Voraussetzungen {#requirements} + +Bevor du deine verknüpfte Rolle beanspruchen kannst, muss ein Administrator die +[verknüpfte Rolle auf SCNX erstellt](./role-managment#create-linked-scnx-role), [sie auf Discord konfiguriert](./role-managment#linked-role-on-discord) +und dir dann die [Rolle zugewiesen](./user-managment#add-role) haben. Wenn diese Schritte nicht abgeschlossen sind, kannst du deine Rolle nicht beanspruchen. + +Wenn du beim Befolgen dieser Anleitung auf Probleme stößt, wende dich bitte an deinen Serveradministrator und verlinke ihn mit +unserer [Seite zur Fehlerbehebung](./troubleshooting), wo wir detailliert auf die Behebung von Problemen eingehen. + +## Beanspruche deine Rolle auf Discord {#claim-role} + +:::info Das funktioniert auch auf deinem Handy! +Obwohl diese Anleitung die Schritte auf einem Desktop-Gerät zeigt, kannst du die gleichen Anweisungen auf deinem Handy befolgen, um deine +verknüpfte Rolle zu beanspruchen. +::: + +Klicke zunächst auf den Namen des Servers in Discord. Dort kannst du die Option „Verknüpfte Rollen“ auswählen. Ein Fenster mit allen verfügbaren Rollen wird nun angezeigt. Wähle die Rolle aus, die du beanspruchen möchtest. Als Nächstes werden dir die Voraussetzungen angezeigt, die du erfüllen musst, um die Rolle zu beanspruchen. Wenn du die Voraussetzung bereits erfüllst, kannst du auf „Abschließen“ klicken, andernfalls klicke auf das Anforderungsfeld, um deine Rolle zu beanspruchen. + +![So öffnest du die Seite zum Beanspruchen verknüpfter Rollen auf Discord](@site/docs/assets/linked-roles/claim/1.png) + +Nun öffnet sich die [Autorisierungsseite](./settings#authorization-page) des Servers. Klicke dort auf „Mit Discord anmelden“. Du wirst zu Discord weitergeleitet, um dein Konto zu autorisieren. Stelle sicher, dass du dich mit dem richtigen Konto angemeldet bist, und klicke dann auf „Autorisieren“, um die Anfrage abzuschließen. Danach wird dir eine Erfolgsmeldung angezeigt, die bestätigt, dass die Rollen erfolgreich angewendet wurden. Du kannst dieses Fenster nun schließen. + +![So autorisierst du dein Konto](@site/docs/assets/linked-roles/claim/2.png) + +Sobald dies erledigt ist, gehe zurück zu Discord. Dort wirst du aufgefordert, die Verbindung zu bestätigen, indem du auf „Fertig“ klickst. Danach kannst du die verknüpfte Rolle endgültig beanspruchen, indem du auf „Abschließen“ klickst. Discord wird dir nun die verknüpfte Rolle zuweisen, die auch in deinem Mitgliederprofil angezeigt wird. + +![Letzter Schritt, um die Rolle zu beanspruchen](@site/docs/assets/linked-roles/claim/3.png) + +Wenn du auch andere Rollen beanspruchen möchtest, kannst du dies einfach tun, indem du die gleichen Anweisungen befolgst – du musst dich jedoch nicht erneut authentifizieren, sondern kannst die Rolle einfach in Discord beanspruchen. + +## Probleme beim Beanspruchen von Rollen? {#issues} + +Wenn du Probleme beim Beanspruchen einer Rolle hast, überprüfe bitte +unsere [Anleitung zur Fehlerbehebung](./troubleshooting). Insbesondere die folgenden Probleme könnten auftreten: + +* [Fehlermeldung: „Ungültige OAuth2 redirect_url“](./troubleshooting#oauth2-redirect-url). +* [Fehlermeldung: „Dir wurden keine Rollen zugewiesen“](./troubleshooting#roles-missing) +* [Fehlermeldung: „Sieht so aus, als wäre die Konfiguration durch den Serverbesitzer falsch.“](./troubleshooting#generic-api-error). + +Wenn du auf andere Probleme stößt oder Fragen hast, lies unsere [Anleitung zur Fehlerbehebung](./troubleshooting) oder kontaktiere uns +unter [scnx.app/help](https://scnx.app/help) – wir helfen dir gerne weiter! + +## Eine beanspruchte Rolle entfernen {#remove-claimed-role} + +Genervt von deiner verknüpften Rolle? Du kannst entweder einen Administrator bitten, die +[verknüpfte Rolle zu entfernen](./user-managment#remove-role) oder du kannst die Rolle selbst entfernen. + +Öffne dazu Discord und öffne dein Profil auf deinem Server. Bewege dort den Mauszeiger über die verknüpfte Rolle, die du entfernen möchtest. Du +siehst ein „X“ auf der linken Seite. Klicke darauf, um deine verknüpfte Rolle zu entfernen. Wenn du es dir jemals anders überlegst, kannst du +deine [verknüpfte Rolle jederzeit erneut beanspruchen](#claim-role), es sei denn, ein Administrator entfernt sie von dir. + +![So entfernst du eine beanspruchte Rolle](@site/docs/assets/linked-roles/claim/remove-role.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/role-management.md b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/role-management.md new file mode 100644 index 0000000..c4d0e5a --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/role-management.md @@ -0,0 +1,77 @@ +--- +sidebar_position: 2 +description: Erfahre, wie du verknüpfte Rollen erstellen, löschen und konfigurieren kannst. +--- + +# Verknüpfte Rollen verwalten + +Im Gegensatz zu traditionellen Rollen auf Discord erfordern verknüpfte Rollen mehr Schritte, um korrekt eingerichtet und konfiguriert zu werden. + +## Verknüpfte Rolle auf SCNX erstellen {#create-linked-scnx-role} + +:::info Discord-Limit +Discord erzwingt ein striktes Limit von fünf verknüpften Rollen pro Bot. Das bedeutet, dass du nicht mehr als fünf verknüpfte +Rollen auf SCNX haben kannst. +::: + +Öffne die [Rollenseite deines Dashboards für verknüpfte Rollen](https://scnx.app/de/glink?page=linked-roles/roles) und klicke auf +„Neue verknüpfte Rolle hinzufügen“. Wenn dies deine erste verknüpfte Rolle ist, leitet dich die Seite automatisch zum +Erstellungsprozess weiter, ohne dass du etwas anklicken musst. + +Gib dort einen Namen für deine Rolle ein und wähle eine Beschreibung. Klicke anschließend auf „Verknüpfte Rolle erstellen“. Nach dem Klick +fordert dich SCNX auf, die [neue verknüpfte Rolle auf Discord zu konfigurieren](#linked-role-on-discord). + +![Dieser Screenshot zeigt das Modal zur Rollenerstellung](@site/docs/assets/linked-roles/role-managment/add-new-role.png) + +## Verknüpfte Rolle auf Discord einrichten {#linked-role-on-discord} + +Um eine verknüpfte Rolle auf Discord einzurichten, befolge bitte diese Schritte: + +1. Erstelle eine neue Rolle auf deinem Discord-Server. Du kannst ihre Rolleneinstellungen, das Rollensymbol, die Berechtigungen und die Farbe konfigurieren. Weise diese Rolle keinem Benutzer zu. +2. Gehe in deinen Rolleneinstellungen zum Tab „Verknüpfungen“. +3. Klicke dort auf „Anforderung hinzufügen“. +4. Wähle deinen Bot im Abschnitt „Apps“ aus. +5. Wähle die gewünschte verknüpfte Rolle aus. Die Rolle, die du auswählst, muss + [Benutzern auf SCNX zugewiesen werden](./user-managment#add-role), damit diese die neu erstellte Discord-Rolle beanspruchen können. + +Sobald du diese Schritte abgeschlossen hast, können deine Mitglieder die Rolle [beanspruchen](./claim-roles.md), wenn sie +die [verknüpfte Rolle zugewiesen bekommen haben](./user-managment#add-role). +Um die Rolle tatsächlich neben dem Benutzernamen eines Benutzers anzuzeigen, musst du +die [Berechtigungen korrekt einrichten](#display-in-chat). + +![Dieser Screenshot zeigt, wie die Rollenanforderung auf Discord hinzugefügt wird](@site/docs/assets/linked-roles/role-managment/role-discord-settings.png) + +## Verknüpfte Rolle im Chat anzeigen {#display-in-chat} + +Standardmäßig werden verknüpfte Rollen nicht neben Benutzernamen im Chat angezeigt. Um die verknüpfte Rolle anzuzeigen, musst du +eine Kanalüberschreibung auf **jedem Kanal** erstellen. Dies kannst du tun, indem du in die Kanaleinstellungen eines beliebigen Kanals gehst, +zu den Berechtigungen navigierst, deine verknüpfte Rolle auswählst (oder hinzufügst) und ihr die Berechtigung „Kanal anzeigen“ gibst. Diese Überschreibung +ist für jeden Kanal erforderlich, in dem die Rolle angezeigt werden soll. + +![So richtest du Berechtigungen für eine verknüpfte Rolle ein](@site/docs/assets/linked-roles/role-managment/display-role-in-chat.png) + +## Öffentliche Rollen {#public-roles} + +:::info +Nachdem du eine Rolle öffentlich gemacht hast, kannst du diese Entscheidung nicht rückgängig machen. Wenn du eine öffentliche Rolle wieder privat machen möchtest, musst du +die [Rolle löschen](#delete-role). +::: + +Standardmäßig müssen Rollen manuell [Mitgliedern zugewiesen werden](./user-managment). Das Aktivieren der Option „Öffentliche Rolle“ ermöglicht es +jedem Benutzer auf deinem Discord, die Rolle zu beanspruchen, und entfernt deine Möglichkeit, die Rolle manuell zuzuweisen oder zu entfernen. Dies +kann hilfreich sein, wenn du möchtest, dass eine „Mitglied“-Rolle neben Benutzern im Chat angezeigt wird. + +Nachdem du eine Rolle erstellt hast, kannst du sie +in deinem [Dashboard für verknüpfte Rollen](https://scnx.app/glink?page=linked-roles/roles) verwalten, wo du die Option „Öffentliche Rolle“ +für deine Rolle aktivieren kannst. Sobald du die Option „Öffentliche Rolle“ aktiviert hast, können alle Benutzer die Rolle +auf deinem Discord ohne weitere Überprüfungen [beanspruchen](./claim-roles). Obwohl du Benutzer im Dashboard manuell [entfernen](./user-managment#delete-user) kannst, +werden sie die Rolle erneut beanspruchen können, da die Rolle öffentlich ist. + +![Dieser Screenshot zeigt, wo die Option „Öffentliche Rolle“ zu finden ist](@site/docs/assets/linked-roles/role-managment/public-role.png) + +## Verknüpfte Rollen löschen {#delete-role} + +Das Löschen einer verknüpften Rolle entfernt die verknüpfte Rolle auch von allen Benutzern auf deinem Discord, löscht aber nicht die von dir erstellte Discord-Rolle. Diese Aktion kann nicht rückgängig gemacht werden. + +Um eine Rolle zu löschen, öffne dein [Dashboard für verknüpfte Rollen](https://scnx.app/glink?page=linked-roles/roles), wähle deine Rolle aus +und klicke auf „Rolle löschen“. Die Rolle wird nun gelöscht. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/user-management.md b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/user-management.md new file mode 100644 index 0000000..eeb02b9 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/linked-roles/user-management.md @@ -0,0 +1,62 @@ +--- +sidebar_position: 4 +description: Verknüpfte Rollen müssen deinen Nutzern manuell zugewiesen werden. +--- + +# Verknüpfte Rollen von Mitgliedern verwalten + +Im Gegensatz zu nativen Rollen auf Discord müssen verknüpfte Rollen manuell über das SCNX-Dashboard zugewiesen werden. +Zusätzlich müssen Rollen von den [Nutzern beansprucht werden](./claim-roles), bevor die Rolle dem Nutzer gegeben wird. + +:::success Gib deinen Admins Zugriff! +Deine Admins können auch die verknüpften Rollen von Nutzern verwalten! Füge sie als [Trusted Admins](./../scnx/guilds/trusted-admins) hinzu und +gib ihnen diese Anleitung, damit sie Nutzer bearbeiten können! +::: + +## Verknüpfte Rolle hinzufügen {#add-role} + +Bevor du einem Nutzer eine Rolle zuweist, stelle sicher, dass du die [verknüpfte Rolle erstellt hast](./role-managment#create-linked-scnx-role). +Du benötigst außerdem die Nutzer-ID des Nutzers, den du hinzufügen möchtest. Um diese Nutzer-ID zu erhalten, +folge [dieser Anleitung von Discord](https://support.discord.com/hc/de/articles/206346498-Wo-kann-ich-meine-Benutzer-Server-Nachrichten-ID-finden). + +Sobald du die Nutzer-ID kopiert hast, öffne die [Nutzerseite für verknüpfte Rollen](https://scnx.app/de/glink?page=linked-roles/users). +Klicke auf +„Nutzer hinzufügen“, um einen weiteren Nutzer hinzuzufügen. + +Gib als Nächstes die zuvor kopierte Nutzer-ID ein, gib optional eine Tagline ein und wähle aus, welche Rollen der Nutzer erhalten soll. +Bitte beachte, dass [öffentliche Rollen](./role-managment#public-roles) nicht zugewiesen oder entfernt werden können, da diese Rollen von +jedem Nutzer beansprucht werden können. + +![Screenshot der Nutzeroberfläche für die Nutzerverwaltung](@site/docs/assets/linked-roles/add-role.png) + +Sobald du die Änderungen gespeichert hast, kann der Nutzer die [Rolle beanspruchen](./claim-roles). Du kannst dem Nutzer einen Link +zu unserer Anleitung senden, damit er weiß, was zu tun ist: +[`https://scootk.it/claim-linked-roles`](https://scootk.it/claim-linked-roles). + +## Nutzerrollen verwalten {#remove-role} + +:::info Öffentliche Rollen können nicht entfernt werden +Alle [öffentlichen Rollen](./role-managment#public-roles) können nicht von Nutzern entfernt werden, da sie von jedem Nutzer beansprucht werden können. +::: + +Um die verknüpften Rollen eines Nutzers zu verwalten, öffne die [Nutzerseite für verknüpfte Rollen](https://scnx.app/de/glink?page=linked-roles/users) +deines Dashboards. Dort kannst du nach dem Nutzer suchen, den du bearbeiten möchtest, indem du seinen Nutzernamen oder seine ID eingibst. Alternativ kannst du +nach Rollen filtern, um den gewünschten Nutzer zu finden. + +Sobald du den Nutzer gefunden hast, klicke auf seinen Dashboard-Eintrag, um die Nutzeroberfläche für die Nutzerverwaltung anzuzeigen. Dort kannst du +seine Rollen und seine Tagline bearbeiten. + +Während entfernte Rollen innerhalb weniger Minuten vom Nutzer entfernt werden, müssen neue Rollen +[manuell beansprucht werden](./claim-roles). Du kannst dem Nutzer einen Link zu unserer Anleitung senden, damit er weiß, was zu tun ist: +[`https://scootk.it/claim-linked-roles`](https://scootk.it/claim-linked-roles). + +## Nutzer verknüpfter Rollen entfernen {#delete-user} + +Um einen Nutzer verknüpfter Rollen zu entfernen, öffne die [Nutzerseite für verknüpfte Rollen](https://scnx.app/de/glink?page=-roles/users) +deines Dashboards. Dort kannst du nach dem Nutzer suchen, den du entfernen möchtest, indem du seinen Nutzernamen oder seine ID eingibst. Alternativ kannst du +nach Rollen filtern, um den gewünschten Nutzer zu finden. + +Sobald du den Nutzer gefunden hast, klicke auf seinen Dashboard-Eintrag, um die Nutzeroberfläche für die Nutzerverwaltung anzuzeigen. Dort kannst du +auf „Nutzer entfernen“ klicken, um die Nutzerdaten zu löschen. Das Entfernen des Nutzers führt dazu, dass alle seine Rollen entfernt werden und +er sich erneut autorisieren muss, wenn er plant, Rollen erneut zu beanspruchen. Bitte beachte, dass dies Nutzer nicht daran hindert, +[öffentliche Rollen](./role-managment#public-roles) jederzeit erneut zu beanspruchen.