||||\n-|-|-|\n:discourse2: | Zusammenfassung | Das Plugin Discourse Surveys ermöglicht es Ihnen, Umfragen direkt in Ihren Discourse-Forum-Beiträgen mithilfe einfacher Markdown-Syntax zu erstellen.\n:hammer_and_wrench: | Repository-Link | \u003chttps://github.com/discourse/discourse-surveys\u003e\n:open_book: | Installationsanleitung | So installieren Sie Plugins in Discourse\n\nDas Discourse Surveys Plugin ermöglicht es Ihnen, Umfragen direkt in Ihren Discourse-Forum-Beiträgen mithilfe einfacher Markdown-Syntax zu erstellen. Das Plugin unterstützt derzeit verschiedene Fragetypen wie Optionsfelder, Kontrollkästchen, Dropdown-Menüs, Zahleneingaben, Textbereiche, Sternebewertungen und Daumen hoch/runter-Bewertungen.\n\n## Funktionen\n\n- 7 verschiedene Feldtypen: Optionsfelder, Kontrollkästchen, Dropdown-Menüs, Textbereiche, Zahlenauswahl, Sternebewertungen und Daumen hoch/runter\n\n- Erforderliche/Optionale Felder: Markieren Sie Felder als erforderlich, um die Vervollständigung sicherzustellen\n\n- Emoji-Unterstützung: Verwenden Sie Emojis in Ihren Umfrageoptionen\n\n- HTML-Unterstützung: Rich-Text-Formatierung in Fragen und Optionen\n\n- Benutzerauthentifizierung: Automatische Anmeldeaufforderungen für anonyme Benutzer\n\n- Antwortverfolgung: Verhindert doppelte Einreichungen desselben Benutzers\n\n- Berechtigungsbewusst: Berücksichtigt Themen- und Kategorienberechtigungen\n\n- Mobilresponsiv: Funktioniert nahtlos auf allen Geräten\n\n## Verwendung\n\n### Grundlegende Umfragestruktur\n\nAlle Umfragen müssen in [survey]-Tags eingeschlossen sein:\n\nmarkdown\n\n[survey name=\"meine-umfrage\" title=\"Kundenfeedback-Umfrage\"]\n\n\u003c!-- Umfragefelder kommen hierher --\u003e\n\n[/survey]\n\n\n\n### Umfrageattribute\n\n- name: Eindeutige Kennung für die Umfrage (Standard ist "survey")\n\n- title: Optionaler Titel, der oben in der Umfrage angezeigt wird\n\n- public: Sichtbarkeit festlegen (zukünftige Funktion)\n\n- status: Umfragestatus (zukünftige Funktion)\n\n### Feldtypen\n\n#### 1. Optionsfelder (Einzelne Auswahl)\n\nmarkdown\n\n[radio question=\"Was ist Ihre Lieblingsfarbe?\"]\n\n- Rot\n\n- Blau\n\n- Grün\n\n- Gelb\n\n[/radio]\n\n\n\n#### 2. Kontrollkästchen (Mehrfachauswahl)\n\nmarkdown\n\n[checkbox question=\"Welche Funktionen nutzen Sie? (Alle zutreffenden auswählen)\"]\n\n- E-Mail-Benachrichtigungen\n\n- Mobile App\n\n- Desktop-Benachrichtigungen\n\n- API-Zugriff\n\n[/checkbox]\n\n\n\n#### 3. Dropdown-Auswahl\n\nmarkdown\n\n[dropdown question=\"Zu welcher Altersgruppe gehören Sie?\"]\n\n- Unter 18\n\n- 18-24\n\n- 25-34\n\n- 35-44\n\n- 45-54\n\n- 55+\n\n[/dropdown]\n\n\n\n#### 4. Textbereich (Langer Text)\n\nmarkdown\n\n[textarea question=\"Bitte geben Sie detailliertes Feedback an:\" required=\"false\"]\n\n[/textarea]\n\n\n\n#### 5. Zahlenauswahl\n\nmarkdown\n\n[number question=\"Bewerten Sie diese Funktion von 1-10:\" min=\"1\" max=\"10\"]\n\n[/number]\n\n\n\n#### 6. Sternebewertung\n\nmarkdown\n\n[star question=\"Wie bewerten Sie Ihr Gesamterlebnis?\"]\n\n[/star]\n\n\n\n#### 7. Daumen hoch/runter\n\nmarkdown\n\n[thumbs question=\"Würden Sie dies weiterempfehlen?\"]\n\n[/thumbs]\n\n\n\n### Feldattribute\n\nAlle Feldtypen unterstützen diese Attribute:\n\n- question: Der Fragetext (erforderlich)\n\n- required: Ob das Feld ausgefüllt werden muss (true/false, Standard ist true)\n\n- min: Minimalwert für Zahlenfelder\n\n- max: Maximalwert für Zahlenfelder\n\n### Vollständiges Beispiel\n\n### Markdown für einfache Umfrage\n\nHier ist ein einfaches Beispiel für Umfrage-Markdown, das alle verfügbaren Felder enthält:\n\n\n[survey name=\"tolle-umfrage-thumbs\" title=\"Tolle Umfrage\"]\n\n[radio question=\"Wählen Sie eine Option:\"]\n- Katze\n- Hund\n[/radio]\n\n[checkbox question=\"Wählen Sie mehrere Optionen:\"]\n- rot\n- blau\n- grün\n[/checkbox]\n\n[dropdown question=\"Geschlecht:\"]\n- Männlich\n- Weiblich\n[/dropdown]\n\n[number question=\"Bewerten Sie diese Umfrage von 1 bis 10:\"]\n[/number]\n\n[textarea question=\"Was ist Ihr Feedback zu xyz?\" required=\"false\"]\n[/textarea]\n\n[star question=\"Wie bewerten Sie das Gesamterlebnis?\"]\n[/star]\n\n[thumbs question=\"Waren Sie mit unseren Dienstleistungen zufrieden?\"]\n[/thumbs]\n\n[/survey]\n\n\n### Umfrage-Darstellung\n\nUnten sehen Sie ein Beispiel dafür, wie das obige Markdown in Discourse gerendert wird:\n\n
markdown\n\n[radio question=\"Wählen Sie Ihr Lieblingstier:\"]\n\n- 🐈 Katze\n\n- 🐶 Hund\n\n- 🐦 Vogel\n\n- 🐠 Fisch\n\n[/radio]\n\n\n\n### HTML-Formatierung in Fragen\n\nmarkdown\n\n[radio question=\"Welche \u003cstrong\u003eProgrammiersprache\u003c/strong\u003e bevorzugen Sie?\"]\n\n- JavaScript\n\n- Python\n\n- Ruby\n\n- Go\n\n[/radio]\n\n\n\n### Gemischte erforderliche und optionale Felder\n\nmarkdown\n\n[survey name=\"gemischte-umfrage\"]\n\n[radio question=\"Was ist Ihre Rolle?\" required=\"true\"]\n\n- Entwickler\n\n- Designer\n\n- Manager\n\n- Sonstiges\n\n[/radio]\n\n[textarea question=\"Haben Sie weitere Anmerkungen?\" required=\"false\"]\n\n[/textarea]\n\n[/survey]\n\n\n\n## Umfrageergebnisse\n\nDerzeit bietet dieses Plugin keine Backend-Benutzeroberfläche zur direkten Anzeige der Umfrageergebnisse. Stattdessen können Sie sich auf Data Explorer-Abfragen verlassen, um Umfrageantworten abzurufen und zu analysieren. Hier ist ein Beispiel für eine Abfrage:\n\nsql\n-- [params]\n-- text :survey_name = survey\n\nSELECT s.id, s.name, s.post_id, sf.question, COALESCE(sr.value, sfo.html) AS value, sr.user_id, sr.created_at as responded_at\nFROM surveys s\nJOIN survey_fields sf ON sf.survey_id = s.id\nJOIN survey_responses sr ON sr.survey_field_id = sf.id\nLEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id\nWHERE s.name = :survey_name\nORDER BY s.id DESC\n\n\n## Berechtigungen und Sicherheit\n\n- Anmeldung erforderlich: Anonyme Benutzer müssen sich anmelden, bevor sie Antworten einreichen können\n\n- Eine Antwort pro Benutzer: Jeder Benutzer kann nur eine Antwort pro Umfrage einreichen\n\n- Themenberechtigungen: Benutzer müssen Lesezugriff auf das Thema haben, um Umfragen anzuzeigen\n\n- Beitragsberechtigungen: Benutzer müssen Beitragsberechtigungen im Thema haben, um Antworten einzureichen\n\n- Archivierte Themen: Umfragen in archivierten Themen können keine neuen Antworten mehr annehmen\n\n- Gelöschte Beiträge: Umfragen in gelöschten Beiträgen sind nicht mehr zugänglich\n\n## Einschränkungen\n\n- Nur eine Umfrage pro Beitrag erlaubt\n\n- Die Umfragestruktur kann nach Erhalt von Antworten nicht mehr geändert werden\n\n- Alle Fragen der Umfragefelder müssen innerhalb einer einzigen Umfrage eindeutig sein\n\n- Fragen der Umfragefelder dürfen nicht leer sein\n\n## Technische Details\n\n### Datenbankschema\n\nDas Plugin erstellt vier Haupttabellen in der Datenbank:\n\n- surveys: Hauptumfragedatensätze\n\n- survey_fields: Einzelne Felder innerhalb von Umfragen\n\n- survey_field_options: Optionen für Auswahlfelder\n\n- survey_responses: Benutzerantworten auf Umfragefelder\n\n### Styling\n\nDas Plugin enthält responsives CSS, das sich an Ihr Theme anpasst. Benutzerdefinierte Stile können durch Anvisieren dieser CSS-Klassen hinzugefügt werden:\n\n- .survey - Hauptcontainer der Umfrage\n\n- .survey-field - Wrapper für einzelne Felder\n\n- .field-[type] - Container für spezifische Feldtypen\n\n- .submit-response - Senden-Button"