WebBlocks Polls

Erstellen Sie mehrsprachige Umfragen mit Einzel- oder Mehrfachauswahl, platzieren Sie sie über den nativen Poll-Block auf Ihrer Website und prüfen Sie aggregierte Ergebnisse. Diese Anleitung beschreibt Polls 0.1.4.

Verwenden Sie PHP ab 8.3 und WebBlocks CMS ^1.92.1. Laden Sie die passende ZIP-Datei von der Polls-Katalogseite herunter. Installieren und aktivieren Sie sie unter System → Plugins und prüfen Sie die erfolgreiche Datenbankeinrichtung. Öffnen Sie Umfragen und wählen Sie die Website, der die Umfrage gehören soll.

Wählen Sie Umfrage hinzufügen und vergeben Sie einen internen Namen und einen stabilen Bezeichner, etwa next-workshop. Blöcke speichern diesen Bezeichner; ändern Sie ihn nach der Platzierung möglichst nicht. Geben Sie die Frage und mindestens zwei nicht leere Antworten ein. Eine Umfrage unterstützt bis zu zwanzig Antwortzeilen.

Wählen Sie Einzelauswahl, wenn jede Person eine Antwort wählen soll, oder Mehrfachauswahl für mehrere Antworten. Pflegen Sie Frage, optionale Beschreibung und Antwortbeschriftungen für jede veröffentlichte Sprache. Das Plugin liefert Verwaltungs- und Abstimmungsoberflächen in den sechs CMS-Sprachen; die Frage und Antworten sind Ihre eigenen Inhalte.

Eine Workshop-Umfrage könnte beispielsweise „Welchen Workshop sollen wir als Nächstes anbieten?“ mit Fotografie, Keramik und Illustration fragen. Speichern Sie sie als Entwurf, während Sie Texte und Übersetzungen prüfen.

Die Umfrage hat drei Zustände: Entwurf, Veröffentlicht und Geschlossen. Optionale Werte für Beginn und Ende begrenzen den Abstimmungszeitraum. Veröffentlichen Sie die fertige Umfrage und prüfen Sie die Zeitplanung vor der Einladung von Teilnehmenden.

Fügen Sie im Page Builder den nativen Poll-Block des Plugins hinzu und wählen Sie die Umfrage dieser Website. Der Blocktyp-Bezeichner lautet webblocks-polls::poll; über die API erstellte Blöcke speichern den stabilen Umfragebezeichner in plugin_settings.poll. Prüfen Sie in der Seitenvorschau Frage und Antworten und folgen Sie anschließend dem normalen Veröffentlichungsablauf. Eine Umfrage zu veröffentlichen veröffentlicht nicht die Seite mit ihrem Block.

Wählen Sie unter Ergebnisse anzeigen das gewünschte Verhalten:

• Immer (always): zeigt aggregierte Ergebnisse anstelle des Abstimmungsformulars.
• Nach der Abstimmung (after_vote): zeigt Ergebnisse, nachdem der Besucher abgestimmt hat.
• Nach dem Schließen (after_close): zeigt Ergebnisse, wenn die Umfrage nicht offen ist.
• Nie (never): zeigt keine öffentlichen Ergebnisse.

Diese Einstellungen steuern die öffentliche Sichtbarkeit. Berechtigte Operatoren können Ergebnisse weiterhin prüfen und aggregierte CSV-Daten exportieren. Umfragen anzeigen, Umfragen verwalten und Umfrageergebnisse exportieren sind separate Plugin-Berechtigungen.

In 0.1.4 verwendet Nach dem Schließen die aktuelle Offen-/Geschlossen-Berechnung. Ergebnisse können daher auch bei einem Entwurf oder einer noch nicht gestarteten Umfrage erscheinen. Platzieren Sie Entwürfe nicht auf veröffentlichten Seiten. Verwenden Sie Nach der Abstimmung oder Nie, wenn Ergebnisse einer geplanten Umfrage vor dem Beginn verborgen bleiben müssen.

Die Abstimmung verwendet CSRF-Schutz, Routen-Ratenbegrenzungen und einen pseudonymen HMAC-Wählerfingerabdruck. Das Plugin speichert keine unveränderten Besucher-IP-Adressen. Der Schutz gegen Mehrfachabstimmungen ist eine praktische Hürde; ein Wechsel von Sitzung oder Netzwerk kann eine weitere Stimme ermöglichen. Verwenden Sie ein anderes Prüfverfahren, wenn genau eine bestätigte Stimme pro Person erforderlich ist.

Das aktivierte Plugin ergänzt seine Routen in CMS-Discovery und OpenAPI:

• GET /webadmin/api/polls und GET /webadmin/api/polls/{poll} benötigen polls.read.
• POST /webadmin/api/polls und PATCH /webadmin/api/polls/{poll} benötigen polls.write.
• GET /webadmin/api/polls/{poll}/results benötigt polls.read.

Übermitteln Sie autorisierten Websitekontext und Sprache zusammen mit Frage und übersetzten Antwortbeschriftungen. Die Discovery beschreibt den Datenvertrag der installierten Version. Verwaltungs-APIs verlangen Token-Authentifizierung und ersetzen den öffentlichen CSRF-geschützten Abstimmungsablauf nicht.

Zeigt der Block nicht die erwartete Umfrage, prüfen Sie ausgewählten Bezeichner, zugehörige Website, Plugin-Aktivierung, Veröffentlichungsstatus und Zeitplanung. Sind Ergebnisse verborgen, prüfen Sie vor Änderungen Ergebnisse anzeigen. Schlägt das Speichern fehl, müssen mindestens zwei Antworten beschriftet sein und das Ende nach dem Beginn liegen.

Kehren Sie zur Plugin-Übersicht zurück, prüfen Sie die Katalogversion oder verwenden Sie die Internal-Content-API-Referenz.