Skip to content

Translate docs #63

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Apr 20, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -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)
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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.