Umfragen

Einfaches Modul zum Erstellen neuer Umfragen auf deinem Server!

Umfragen

ScootKit

Simple module to create fresh polls on your server!

Dieses Modul ist Open-Source.

Dieses Modul speichert Daten in der Datenbank deines Bots.

Dieses Modul erstellt einen Haupt-Slash-Befehl auf deinem Server.

Dieses Modul hat 2 Konfigurationsdateien.

Dieses Modul wird auf über 5300 Servern auf SCNX aktiv verwendet.

Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.

Modul auf SCNX aktivieren Spende an den Entwickler

Funktionen

• Erstelle anonyme und öffentliche Umfragen mit bis zu neun Optionen pro Umfrage.
• Nutzer können via ein Dropdown-Menü ihre Option auswählen.
• Umfragen können nach Ablauf einer festgelegten Zeit automatisch enden.
• Leicht verständliche Ergebnisanzeige, welche live aktualisiert wird.

Hier ist ein Beispiel einer beendeten Umfrage:

Einrichtung

• Um mit dem Modul Umfragen zu starten, stelle sicher, dass dein Bot in jedem Kanal, in dem du Umfragen verwenden willst, folgende Rechte hat: Nachrichten lesen, Nachrichten senden, Links einbetten.
• Stelle sicher, dass du die Rechte für /poll korrekt eingestellt hast.

Verwendung

Administratoren können Umfragen mit folgenden Befehlen verwalten:

• /poll create zum Erstellen neuer Umfragen.
• /poll end zum Beenden einer Umfrage (Umfragen enden automatisch, wenn du bei /poll create den zeitparameter gesetzt hast).

Benutzer können:

• Mit dem Dropdown-Menü unter Umfragen abstimmen.
• Sehen, für was sie gestimmt haben, indem sie den Knopf „Für was habe ich abgestimmt?“ unter der Abstimmung nutzen.
• Ihre Stimme entfernen, wenn sie zuerst „Für was habe ich abgestimmt?“ auswählen und danach auf „Meine Stimme entfernen“ unter der Antwort klicken.
• Liveergebnisse im Umfragen-Embed sehen.
• Sich anschauen, wer für welche Option gestimmt hat, indem sie auf den Knopf „Aktuelle Stimmen anzeigen“ unter dem Abstimmungs-Embed klicken (falls die Umfrage auf öffentlich gestellt ist).

Befehle

Dokumentation Verstehen

In dieser Dokumentation bezeichnen wir eine verpflichtende Slash-Befehl-Option mit dem Namen 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
/polls create description:<Text> channel:<TextKanal> option1:<Text> option2:<Text> [option{n}:<Text>] [duration:<ZeitDauer>] [public:<Boolean>]	Erstelle im gewünschten Kanal eine neue Umfrage. Gib die Umfragefrage als description Wert ein und füge mögliche Optionen mit dem Element option{n} hinzu. Optional kannst Du eine Umfrage mit der Option public öffentlich machen (das bedeutet, dass jeder sehen kann, wofür Benutzer gestimmt haben). Wenn diese Option aktiviert ist, wird unterhalb der Umfrage die Schaltfläche „Aktuelle Stimmen anzeigen“ hinzugefügt. Um eine Umfrage automatisch zu beenden, gibst du eine duration in einem unterstützten Zeitdauerwert an.
/polls end msg-id:<UmfragenNachrichtID>	Beendet sofort eine bereits bestehende Umfrage, die noch nicht beendet wurde. Die Option msg-id unterstützt die automatische Vervollständigung, sodass du problemlos nach der Umfragebeschreibung der Umfrage suchen kannst, die du beenden möchtest.

Konfiguration

Konfiguration

In dieser Datei kannst du die Emojis neben den Abstimmungsoptionen anpassen. Öffnen sie es in deinem Dashboard.

Feld	Beschreibung
Emojis	In diesen Feldern kannst du die Emojis anpassen, die neben jeder Abstimmungsoption im Dropdown-Menü und im Embed angezeigt werden. Stelle sicher, dass du Unicode-Werte für integrierte Emojis oder gültige Emoji-IDs (nicht nur den Namen) für benutzerdefinierte Emojis eingibst.

Nachrichten

In dieser Datei kannst du anpassen, wie das Umfrage-Embed in Discord angezeigt wird. Öffne sie in deinem Dashboard.

Feld	Beschreibung
Embed	Mit dieser Konfigurationsoption kannst Du anpassen, wie das Umfrage-Embed in Discord angezeigt wird. Die folgenden Werte können angepasst werden: title: Der Name des Embeds. color: Die Farbe des Embeds, muss ein unterstützter Farbwert sein. options: Die Überschrift des Optionsfelds im Embed. liveView: Die Überschrift der (Live-)Ergebnisanzeige im Embed. expiresOn: Die Überschrift des Embeds, wenn die Umfrage beendet wurde. endedPollTitle: Die Überschrift des Embeds, wenn die Umfrage beendet wurde. endedPollColor: Die Farbe des Embeds, wenn die Umfrage beendet ist. Muss ein unterstützter Farbwert sein. visibility: Die Überschrift des Öffentlichkeitsabschnitts des Embeds.

Fehlerbehebung

Wenn du Probleme mit dem Umfragemodul hast, stelle bitte sicher, dass

• du keine Umfrage in einem Ankündigungskanal gestartet hast (da Nachrichten in solchen Kanälen nicht so häufig aktualisiert werden können).
• deine Nachrichtenkonfiguration keine leeren Felder enthält und das Farbwerte gültig sind.
• deine Konfiguration nur gültige Emoji-Werte (Unicode für integrierte Emojis und Emoji-IDs für benutzerdefinierte Emojis) enthält.
• der Bot über die folgenden Berechtigungen in dem Kanal, in dem du eine Umfrage starten möchtest, verfügt: Nachrichten lesen, Nachrichten senden, Links einbetten.

Gespeicherte Daten

Die folgenden Daten werden über jede Umfrage gespeichert, die über Befehle erstellt wird:

• Die eindeutige Identifikationsnummer der Umfragenachricht, die nach der Erstellung gesendet wurde
• Die eindeutige Identifikationsnummer des Kanals, in dem die Umfrage erstellt wurde
• Die Frage der Umfrage (description-Wert im Befehl), inkludiert, ob die Umfrage öffentlich ist oder nicht
• Der Wert jeder Abstimmungsoption (option{n}-Wert im Befehl)
• Falls aktiviert: Genaue Uhrzeit, zu der die Umfrage abläuft (gesteuert durch den duration-Wert im Befehl) und ob die Umfrage beendet ist
• Metadaten über deinen Server anzeigen (z. B. Name, Symbol, Besitzer, ...)

Darüber hinaus werden die folgenden Daten über jeden Benutzer gespeichert, wenn er für eine Option abstimmt:

• Die eindeutige Identifikationsnummer des Benutzers
• Die Nummer der Option, für die abgestimmt wurde

Wenn die Umfrage noch nicht beendet ist, können Benutzer ihre Stimme entfernen. Nach Beendigung einer Umfrage ist diese Option nicht mehr verfügbar.

Es gibt keine Möglichkeit, Umfragen aus der Datenbank zu entfernen (du kannst die Umfrage trotzdem jederzeit löschen). Zum Löschen aller Umfragen, lösche die Moduldatenbank.