Zum Hauptinhalt springen

Umfragen (Polls)

Das Polls-Modul ermöglicht die Erstellung von Umfragen mit Abstimmungsbuttons, automatischem Timer, anonymem Modus und Mehrfachabstimmung. Die Ergebnisse werden in Echtzeit aktualisiert.

Modul aktivieren

  1. Dashboard → Ihr Server → Toggle Polls
  2. Klicken Sie auf Edit, um Standardparameter für Umfragen festzulegen
  3. Speichern Sie die Änderungen

Konfiguration

OptionTypStandardBeschreibung
colorhex#5865F2Embed-Farbe der Umfrage
default_durationstringStandarddauer (z.B. "24h")
default_anonymousbooleanfalseStandardmäßig Abstimmende verbergen
default_multiplebooleanfalseStandardmäßig mehrere Stimmen erlauben
create_permissionstring"everyone"Wer Umfragen erstellen darf
create_rolesListe[]Rollen für die Erstellung (wenn permission = "custom")

Werte für create_permission

  • "everyone" — jeder kann Umfragen erstellen
  • "moderation_roles" — nur Rollen aus moderation_roles
  • "custom" — nur Rollen aus create_roles

Dashboard — Konfiguration

Das Bearbeitungspanel enthält:

  • Color — Color Picker
  • Default Duration — Textfeld (Format: 30m, 1h, 24h, 7d, 2w)
  • Default Anonymous — Checkbox
  • Default Multiple — Checkbox
  • Create Permission — Radio: Everyone / Moderation Roles / Custom
  • Custom Roles — Multi-Select (sichtbar bei Custom)

Befehle

/poll

Erstellt eine neue Umfrage.

ParameterErforderlichBeschreibung
questionUmfragefrage (max 256 Zeichen)
option1Erste Option
option2Zweite Option
option3option10Zusätzliche Optionen (max 10 insgesamt)
durationDauer (überschreibt Standard). Format: 30m, 1h, 7d, 2w
anonymousAbstimmende verbergen (überschreibt Standard)
multipleMehrere Stimmen erlauben (überschreibt Standard)

Unterstützte Zeitformate:

  • m — Minuten (z.B. 30m)
  • h — Stunden (z.B. 24h)
  • d — Tage (z.B. 7d)
  • w — Wochen (z.B. 2w)

/polls

Zeigt die Liste aktiver Umfragen auf dem Server an (max 10, ephemeral).

Abstimmung

Die Umfrage wird als Embed mit nummerierten Buttons angezeigt, die den Optionen entsprechen:

┌─────────────────────────────────────┐
│ Was ist Ihre Lieblingsfarbe? │
│ │
│ 1. Rot — 5 votes (50%) │
│ 2. Blau — 3 votes (30%) │
│ 3. Grün — 2 votes (20%) │
│ │
│ ⏰ Ends in 23 hours │
├─────────────────────────────────────┤
│ [1. Rot] [2. Blau] [3. Grün] │
└─────────────────────────────────────┘

Einzelabstimmungsmodus (multiple = false)

  • Klick auf eine Option gibt eine Stimme ab
  • Erneuter Klick auf dieselbe Option zieht die Stimme zurück
  • Klick auf eine andere Option ändert die Stimme (alte wird entfernt, neue hinzugefügt)

Mehrfachabstimmungsmodus (multiple = true)

  • Klick auf eine Option fügt hinzu/entfernt die Stimme (Toggle)
  • Der Benutzer kann für mehrere Optionen gleichzeitig stimmen

Echtzeit-Aktualisierung

Nach jeder Stimme wird das Embed mit den neuen Ergebnissen (% und Stimmenzahl) bearbeitet.

Auto-Schließung

Wenn eine Umfrage eine Dauer eingestellt hat:

  • Der Bot prüft abgelaufene Umfragen alle 60 Sekunden
  • Nach Ablauf: Embed ändert den Titel zu "📊 POLL CLOSED — [Frage]"
  • Ergebnisse als Fortschrittsbalken (Bar Chart) dargestellt
  • Buttons werden deaktiviert (disabled)
  • Farbe wechselt zu Grau (#6B7280)

Format einer geschlossenen Umfrage

1. Rot
█████░░░░░ 50% (5 votes)
2. Blau
███░░░░░░░ 30% (3 votes)
3. Grün
██░░░░░░░░ 20% (2 votes)

Überwachte Ereignisse

EreignisAktion
on_interactionVerarbeitung von Abstimmungs-Button-Klicks

Zyklische Aufgabe

  • _check_expired_polls — prüft und schließt alle 60 Sekunden abgelaufene Umfragen

Protokollierung

Aktionen werden durch Logs unter der Kategorie polls protokolliert:

  • 📊 Poll Created — Frage, Ersteller, Anzahl der Optionen, Ablaufzeit
  • 📊 Poll Closed — Frage, Gesamtzahl der Stimmen

Datenbank

Umfragedaten werden in folgenden Tabellen gespeichert:

  • polls — Umfrage-Metadaten (question, options, expires_at, closed, anonymous, multiple)
  • poll_votes — Einzelne Stimmen (poll_message_id, user_id, option_index)

Tipps

Best Practices
  • Setzen Sie default_duration auf 24h — die meisten Umfragen brauchen nicht mehr
  • Der Modus anonymous eignet sich für kontroverse Themen
  • Beschränken Sie create_permission auf Moderatoren, um Umfragen-Spam zu vermeiden
  • Umfragen ohne Dauer werden nie automatisch geschlossen — bedenken Sie das
info

Umfragen verwenden persistente custom_ids — sie funktionieren auch nach einem Bot-Neustart. Stimmen werden in der Datenbank gespeichert, sodass ein Neustart die Ergebnisse nicht beeinflusst.