Teammitglieder-Ziele
Setze wöchentliche Nachrichtenziele und Sprachaktivitätsziele für deine Teammitglieder.
Funktionen
- Setze ein Nachrichtenziel für deine Teammitglieder.
- Optional: Setze ein Sprachaktivitätsziel, um die in Sprachkanälen verbrachte Zeit zu verfolgen.
- Der Bot überprüft jede Woche, ob die Teammitglieder ihre Ziele erreicht haben.
- Mit Befehlen kannst du deinen aktuellen Fortschritt und deinen Zielverlauf in der Vergangenheit überprüfen.
- Sende Nutzern ihr Ergebnis jede Woche per PN oder in einen konfigurierten Kanal.
- Lasse Kanäle optional von Nachrichten- oder Sprachzielen ignorieren.
Einrichtung
- Wähle (oder erstelle) eine Rolle. Die Aktivität von Nutzern mit dieser Rolle wird gewertet.
- Konfiguriere das Modul.
- Setze bitte Berechtigungen für Slash-Befehle, um unerlaubte Nutzung zu unterbinden.
- Gebe Mitgliedern, deren Aktivität ausgewertet werden soll, die Rolle.
Nutzung
- Die Anforderungen werden automatisch einmal pro Woche am eingestellten "Wöchentlicher Zusammenfassungstag" und der "Wöchentliche Zusammenfassungsuhrzeit" ausgewertet.
- Du kannst immer den Nachrichtenfortschritt von dir oder einem anderen Nutzer mit
/team-goals progressund den früheren Zielverlauf mit/team-goals historyeinsehen. - Wenn das Sprachziel aktiviert ist, kannst du den Sprachaktivitätsfortschritt mit
/team-goals voice-progresseinsehen.
Befehle
name und dem Typen Typ als name:<Typ>. Optionen, die nicht Pflichtfelder sind, werden als [name:<Typ>] angegeben. Wenn sich die Aktionen eines Befehls zwischen Pflichtfeldern und Nicht-Pflichtfeldern sehr unterscheiden, listen wir sie eventuell separat.Beispiele
/moderate ban user:<Mitglied>: Dieser Befehl (/moderate ban) hat nur eine verpflichtende Option mit dem Namen "user", die nur ein Mitglied akzeptiert./moderate ban victim:<Mitglied> reason:<Text>: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert./moderate ban victim:<Mitglied> reason:<Text> [proof:<Anhang>]: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert. Zusätzlich gibt es eine optionale Option mit dem Namen "proof", die einen Anhang als Wert akzeptiert.
| Befehl | Beschreibung |
|---|---|
/team-goals progress [user:<Nutzer>] | Zeigt deinen Fortschritt zum Ziel des aktuellen Bewertungszeitraums an (wenn leer, wird dein Fortschritt angezeigt). Ist das Sprachziel deaktiviert, ist dies ein Absatz mit den noch fehlenden Nachrichten bis zum Ziel, einem Fortschrittsbalken und der Frist. Ist das Sprachziel aktiviert, werden stattdessen drei Statuszeilen angezeigt - gesendete Nachrichten/Ziel, gesendete Sprachminuten/Ziel und das Datum der nächsten Zusammenfassung - jede mit eigenem Haken oder Kreuz, wobei Titel und Farbe des Embeds das Gesamtergebnis gemäß dem eingestellten "Zielmodus" widerspiegeln. |
/team-goals voice-progress [user:<Nutzer>] | Zeigt den Sprachaktivitätsfortschritt (Minuten in Sprachkanälen, Ziel, verbleibende Zeit) für das Sprachziel des aktuellen Bewertungszeitraums an. Nur verfügbar, wenn das Sprachziel aktiviert ist. |
/team-goals history [user:<Nutzer>] | Zeigt den früheren Zielverlauf (Anzahl der Nachrichten, Sprachminuten, wenn das Sprachziel aktiviert ist, Ziel erreicht oder nicht gemäß dem eingestellten "Zielmodus", Prozentsatz der erreichten Ziele) der letzten 10 Wochen des angegebenen Benutzers an (wenn leer, wird dein Verlauf angezeigt). |
Definition von modulspezifischen Begriffen
- Eine Auswertung ist der Zeitpunkt, zu dem ein Nutzer ausgewertet wird. Dies geschieht einmal pro Woche, am konfigurierten Wöchentlichen Zusammenfassungstag zur Wöchentlichen Zusammenfassungsuhrzeit, in der eingestellten Zeitzone des Bots. Bei der Auswertung vergleicht der Bot die Anzahl der im aktuellen Bewertungszeitraum gesendeten Nachrichten mit dem konfigurierten Ziel und löst die konfigurierten Nachrichten für Fehlgeschlagen / Erreicht aus. Sobald alle Benutzer ausgewertet wurden, beginnt der nächste Bewertungszeitraum.
- Ein Bewertungszeitraum ist die Zeit zwischen der letzten und der nächsten Auswertung und ist genau eine Woche lang.
Konfiguration
Diese Konfigurationsdatei ermöglicht es dir, die Funktionsweise des Moduls und das Ziel selbst zu konfigurieren. Öffne sie in deinem Dashboard.
Die wöchentliche Zusammenfassung wird jetzt an dem eingestellten "Wöchentlicher Zusammenfassungstag" und der "Wöchentliche Zusammenfassungsuhrzeit" gesendet, in der eingestellten Zeitzone des Bots, statt zu dem festen Zeitpunkt, an dem das Modul ursprünglich aktiviert wurde. Bei der ersten Auswertung nach dem Update wechseln bestehende Server von ihrem bisherigen, willkürlichen Zeitpunkt zum neuen - dadurch wird genau eine Woche um bis zu sieben Tage kürzer oder länger.
Wenn das Sprachziel aktiviert ist, erhalten Teammitglieder jetzt standardmäßig eine einzige kombinierte wöchentliche Nachricht statt getrennter Nachrichten für das Nachrichten- und das Sprachziel (siehe "Kombinierte Ziel erfüllt-Nachricht" und "Kombinierte Ziel fehlgeschlagen-Nachricht" weiter unten). Um das bisherige Verhalten beizubehalten, deaktiviere "Eine kombinierte Nachricht pro Teammitglied senden" - deine bestehenden Vorlagen für Ziel erfüllt-Nachricht, Ziel fehlgeschlagen-Nachricht, Sprachziel erreicht-Nachricht und Sprachziel fehlgeschlagen-Nachricht bleiben unverändert und greifen sofort wieder.
| Feld | Beschreibung |
|---|---|
| Team-Rollen | Diese Rollen werden jede Woche hinsichtlich ihres Fortschritts zum Ziel ausgewertet. Es werden nur die Nachrichten von Nutzern mit dieser Rolle gezählt. |
| Wöchentliche Nachrichten Ziele | Die Anzahl der Nachrichten, die Teammitglieder in jedem Bewertungszeitraum senden müssen, um das Ziel zu erreichen. |
| Ziel erfüllt-Nachricht | Das ist die Nachricht, die jede Auswertung für jeden Nutzer, der ausgewertet wird (jeder mit einer konfigurierten Team-Rolle) per PN oder in den konfigurierten Kanal gesendet wird, wenn das Ziel erreicht wurde. Unterstützt %voiceMinutes% und %voiceGoal%, die auch bei deaktiviertem Sprachziel befüllt werden (mit 0). |
| Ziel fehlgeschlagen-Nachricht | Das ist die Nachricht, die jede Auswertung für jeden Nutzer, der ausgewertet wird (jeder mit einer konfigurierten Team-Rolle) per PN oder in den konfigurierten Kanal gesendet wird, wenn das Ziel nicht erreicht wurde. Unterstützt %voiceMinutes% und %voiceGoal%, die auch bei deaktiviertem Sprachziel befüllt werden (mit 0). |
| Nachrichten in Kanal statt per PN schicken | Wenn aktiviert, werden Teammitglieder ihre Auswertung in einem Kanal statt per PN erhalten. |
| Kanal, in welchen die Nachrichten gesendet werden sollen | Nur sichtbar, wenn "Nachrichten in Kanal statt per PN schicken" aktiviert ist. Die Auswertung wird in diesen Kanal statt per PN gesendet. |
| Ignorierte Kanäle | Nachrichten von Nutzern mit mindestens einer der Teammitglieder-Rollen werden in diesen Kanälen nicht zu ihrem Ziel hinzugerechnet. |
| Nachrichtenziel-Überschreibungen | Optional kannst du das wöchentliche Nachrichtenziel für bestimmte Rollen überschreiben. Erstes Feld: Rollen-ID. Zweites Feld: Benutzerdefiniertes Ziel für diese Rolle. |
| Sprachziel aktivieren | Wenn aktiviert, werden Teammitglieder auch anhand ihrer Sprachkanal-Aktivität ausgewertet. Sprachminuten werden erfasst, wenn ein Nutzer mit einer Team-Rolle in einem Sprachkanal verbunden ist. |
| Wöchentliches Sprachziel (Minuten) | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Die Anzahl der Minuten, die Teammitglieder in jedem Bewertungszeitraum in Sprachkanälen verbringen müssen, um das Sprachziel zu erreichen. Standard: 60. |
| Ignorierte Sprachkanäle | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. In diesen Sprachkanälen verbrachte Zeit wird nicht zum Sprachziel gezählt. |
| Sprachziel erreicht-Nachricht | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Die Nachricht, die jede Auswertung an Teammitglieder gesendet wird, die ihr Sprachziel erreicht haben. Leer lassen, um keine separate Sprachziel-Nachricht zu senden. Unterstützt %voiceMinutes%, %voiceGoal% und alle Nachrichtenziel-Parameter. |
| Sprachziel fehlgeschlagen-Nachricht | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Die Nachricht, die jede Auswertung an Teammitglieder gesendet wird, die ihr Sprachziel nicht erreicht haben. Leer lassen, um keine separate Sprachziel-Nachricht zu senden. Unterstützt %voiceMinutes%, %voiceGoal% und alle Nachrichtenziel-Parameter. |
| Sprachziel-Überschreibungen | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Optional kannst du das wöchentliche Sprachziel für bestimmte Rollen überschreiben. Erstes Feld: Rollen-ID. Zweites Feld: Benutzerdefiniertes Sprachziel in Minuten. |
| Wöchentlicher Zusammenfassungstag | Der Wochentag, an dem die wöchentliche Zusammenfassung gesendet wird und der Bewertungszeitraum zurückgesetzt wird, in der eingestellten Zeitzone des Bots. Standard: Montag. |
| Wöchentliche Zusammenfassungsuhrzeit | Die volle Stunde, zu der die wöchentliche Zusammenfassung gesendet wird, in der eingestellten Zeitzone des Bots. Standard: 09:00. |
| Eine kombinierte Nachricht pro Teammitglied senden | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Wenn aktiviert, werden das Nachrichtenziel und das Sprachziel in einer einzigen wöchentlichen Nachricht statt in zwei getrennten Nachrichten gemeldet. Standardmäßig aktiviert. |
| Zielmodus | Nur sichtbar, wenn "Sprachziel aktivieren" aktiviert ist. Ob ein Teammitglied sowohl das Nachrichtenziel als auch das Sprachziel erreichen muss, oder ob die Erfüllung eines der beiden Ziele ausreicht, um die Auswertung zu bestehen. |
| Kombinierte Ziel erfüllt-Nachricht | Nur sichtbar, wenn "Eine kombinierte Nachricht pro Teammitglied senden" aktiviert ist. Die Nachricht, die einmal pro Woche an Teammitglieder gesendet wird, die ihr wöchentliches Ziel erreicht haben, wenn kombinierte Nachrichten aktiviert sind. Unterstützt %messageStatus%, %voiceStatus% und alle Parameter des Nachrichten- und Sprachziels. |
| Kombinierte Ziel fehlgeschlagen-Nachricht | Nur sichtbar, wenn "Eine kombinierte Nachricht pro Teammitglied senden" aktiviert ist. Die Nachricht, die einmal pro Woche an Teammitglieder gesendet wird, die ihr wöchentliches Ziel nicht erreicht haben, wenn kombinierte Nachrichten aktiviert sind. Unterstützt %messageStatus%, %voiceStatus% und alle Parameter des Nachrichten- und Sprachziels. |
Fehlerbehebung
Von meinem Team gesendete Nachrichten werden nicht richtig gezählt
Bitte stelle sicher, dass
- der Bot Zugriff auf jeden Kanal hat, in welchem Nachrichten gezählt werden sollen, und dass der Kanal kein ignorierter Kanal ist.
- der Nutzer mindestens eine der konfigurierten Teammitglieder-Rollen hat. Es werden nur Nachrichten gezählt, die von Nutzern gesendet wurden, welche während dem Senden mindestens eine Teammitglieder-Rolle besessen haben - Nachrichten, die gesendet werden, bevor ein Nutzer die Teammitglieder-Rolle hat, werden nicht gezählt.
Wie kann ich die Zeit verändern, wann Nutzer ausgewertet werden?
Öffne die Modulkonfiguration und ändere "Wöchentlicher Zusammenfassungstag" und/oder "Wöchentliche Zusammenfassungsuhrzeit" auf den Wochentag und die Uhrzeit (in der eingestellten Zeitzone des Bots), zu der die Auswertung stattfinden soll. Die Änderung wird beim nächsten Neuladen der Modulkonfiguration wirksam - du musst das Modul dafür weder deaktivieren noch seine Datenbank löschen.
Beachte, dass der aktuelle Bewertungszeitraum immer beim nächsten Eintreten des neu eingestellten Zeitpunkts endet - eine Änderung während eines laufenden Zeitraums macht diesen daher einmalig kürzer oder länger, genau wie eine Verschiebung des Zusammenfassungstages von Montag auf Dienstag an einem Montagnachmittag. Das gilt auch direkt nach der Aktivierung des Moduls: Aktivierst du es beispielsweise an einem Sonntag um 20:00 Uhr mit den Standardwerten (Montag, 09:00 Uhr), findet die erste Auswertung schon etwa 13 Stunden später statt, wodurch ein Ziel von 100 Nachrichten mit 0 gesendeten Nachrichten als nicht erreicht angezeigt wird. Stelle Tag und Uhrzeit daher am besten direkt nach der Installation ein, bevor deine Teammitglieder mit dem Sammeln von Nachrichten beginnen, um einen unerwartet kurzen ersten Zeitraum zu vermeiden.
Die Auswertung funktioniert nicht richtig (z.B. werden Auswertungsnachrichten nicht gesendet)
Bitte stelle sicher, dass
- der Bot die Berechtigung hat, Nachrichten in den konfigurierten Kanal zu senden, wenn aktiviert.
- deine Teammitglieder mindestens eine der konfigurierten Team-Rollen besitzen.
- die konfigurierte Nachricht nicht inkorrekt ist.
Selbst wenn keine Auswertung gesendet wurde, kannst du immer den früheren Zielverlauf mit dem Slash-Befehl /team-goals history einsehen.
Kann ich das Modul nutzen, um die Aktivität meiner Nutzer auszuwerten? / SCNX fügt einen "Missbrauch melden"-Knopf an meine Nachrichten an
Eine solche Nutzung verstößt gegen unsere Nutzungsbedingungen, da du unsere Software nutzt, um deine Nutzer mit Spam zu belästigen. Du darfst das Modul nur zum Auswerten der Aktivität deiner Teammitglieder und nur mit deren Einverständnis nutzen. Wenn du die PN-Funktion von diesem Modul nutzt und eine ungewöhnlich hohe Anzahl an Mitgliedern auf deinem Server auswertest, wird SCNX eventuell automatisch einen "Missbrauch melden"-Knopf an deine Nachrichten anhängen. Du kannst auf scootk.it/report-mass-dm mehr darüber erfahren (das ist auch der im Knopf verlinkte Link). Die meisten unserer Nutzer sind nie davon betroffen, und du musst dir normalerweise keine Gedanken machen, wenn du das Modul wie beschrieben benutzt.
Gespeicherte Daten
Die folgenden Daten werden über jeden Nutzer mit einer konfigurierten Team-Rolle gespeichert, sobald sie eine Nachricht gesendet haben ("Nutzer-Eintrag"):
- Die eindeutige Discord-Nutzer-ID
- Die Anzahl der Nachrichten, die in dem aktuellen Bewertungszeitraum gesendet wurden
- Die Anzahl der Sprachminuten im aktuellen Bewertungszeitraum (wenn das Sprachziel aktiviert ist)
- Metadaten zum Eintrag (Datum der Erstellung und der letzten Aktualisierung)
Das folgende wird bei jeder Auswertung für jeden Nutzer gespeichert, der eine der konfigurierten Team-Rollen hat ("Zielverlauf-Eintrag"):
- Eine eindeutige Nummer zur Identifizierung des Datenbankeintrags
- Die eindeutige Discord-Nutzer-ID
- Die Anzahl der Nachrichten, die der Nutzer im Bewertungszeitraum gesendet hat
- Das konfigurierte Nachrichtenziel des aktuellen Bewertungszeitraums
- Die Anzahl der Sprachminuten im Bewertungszeitraum (wenn das Sprachziel aktiviert ist)
- Das konfigurierte Sprachziel des aktuellen Bewertungszeitraums (wenn das Sprachziel aktiviert ist)
- Metadaten zum Eintrag (Datum der Erstellung und der letzten Aktualisierung)
Es gibt keine Möglichkeit, den Nutzer-Eintrag oder den Zielverlauf-Eintrag aus der Datenbank zu entfernen. Nachrichten, die von Nutzern ohne eine konfigurierte Team-Rolle gesendet werden, werden niemals gezählt und erstellen keinen Nutzer-Eintrag.
Um alle Daten zu löschen, lösche die Modul-Datenbank.