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

Option	Typ	Standard	Beschreibung
color	hex	#5865F2	Embed-Farbe der Umfrage
default_duration	string	—	Standarddauer (z.B. "24h")
default_anonymous	boolean	false	Standardmäßig Abstimmende verbergen
default_multiple	boolean	false	Standardmäßig mehrere Stimmen erlauben
create_permission	string	"everyone"	Wer Umfragen erstellen darf
create_roles	Liste	[]	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.

Parameter	Erforderlich	Beschreibung
question	✅	Umfragefrage (max 256 Zeichen)
option1	✅	Erste Option
option2	✅	Zweite Option
option3–option10	❌	Zusätzliche Optionen (max 10 insgesamt)
duration	❌	Dauer (überschreibt Standard). Format: 30m, 1h, 7d, 2w
anonymous	❌	Abstimmende verbergen (überschreibt Standard)
multiple	❌	Mehrere 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

Ereignis	Aktion
on_interaction	Verarbeitung 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.