Survey ce
Aus Contao Community Documentation
Umfragewerkzeug zum Erstellen und Durchführen von Umfragen.
Erweiterungs-Übersicht | |
---|---|
Name des Entwicklers | Helmut Schottmüller (hschottm) |
Entwickler Webseite | http://www.aurealis.de |
Version der Erweiterung | 1.1.0 |
Kompatibilität mit Contao Version | 2.9.0 - 2.9.1 |
Kompatibilität mit TYPOlight Version | 2.7.1 - 2.8.4 |
Link zum Extension Repository | http://www.contao.org/erweiterungsliste/view/survey_ce.de.html |
Den Entwickler unterstützen | http://aurealis.de/spenden.html |
Inhaltsverzeichnis
- 1 Survey (Community Edition) - Umfragewerkzeug
- 1.1 Erstellung von Umfragen
- 1.2 Generieren und Verwalten von TAN Codes
- 1.3 Verwalten der Teilnehmerdaten
- 1.4 Umfrage-Statistik
- 1.5 Einfügen einer Umfrage in das Frontend
- 1.6 Durchführen einer Umfrage
- 1.7 Fortschrittsanzeige
- 1.8 Hinweise für Entwickler
Survey (Community Edition) - Umfragewerkzeug
survey_ce ist eine Anwendung, um mit Contao Umfragen zu erstellen und durchzuführen. Nutzen Sie Ihre Contao-Erfahrung, um
- unkompliziert und schnell Online-Fragebögen zu erstellen
- Umfragen selbst kostengünstig und online durchzuführen, ohne weitere anfallende Kosten
- auf Umfrageergebnisse zuzugreifen und diese mit Microsoft Excel weiterzuverarbeiten
Erstellung von Umfragen
Um eine neue Umfrage zu erstellen, wählt man den Punkt Umfragen in der Liste der Backend-Module im Contao-Backend aus.
Im Umfragebereich des Hauptfensters kann man nun über die Anweisung Neue Umfrage eine Umfrage als Container für Ihren Fragebogen erstellen. Der Fragebogen wird natürlich erst dann als Umfrage online gestellt, wenn man die Umfrage in der Contao-Frontend integriert, dazu aber später mehr.
Elemente einer Umfrage
Titel und Beschreibung
In der Sektion Titel und Beschreibung gibt man den Titel der Umfrage an, wählt den Autor der Umfrage aus der Liste der Backend-Benutzer aus und gibt optional eine detaillierte Beschreibung der Umfrage und eine Sprache für die Umfrage an. Wenn man eine Sprache angibt, wird Contao alle vom Umfragewerkzeug erstellten Zeichenketten immer in der ausgewählten Sprache ausgeben (sofern eine Übersetzung für diese Sprache vorhanden ist), selbst wenn vom Frontend-Benutzer eine andere Sprache verwendet wird.
Aktivierung
In der Sektion Aktivierung legt man einen Aktivierungszeitraum für die Umfrage fest. Wenn man die Felder Aktiviert ab und Aktiviert bis leer lässt, steht die Umfrage, wenn sie in eine Seite des Frontends eingebunden ist, sofort zur Verfügung. In Aktiviert ab kann man ein Datum eingeben, ab dem die Umfrage aktiviert werden soll. Vor Erreichen dieses Datums wird das Inhaltselement der Umfrage nicht auf dem Bildschirm ausgegeben. In Aktiviert bis kann man ein Datum eingeben, bis zu dem die Umfrage aktiviert bleiben soll. Sobald dieses Datum verstrichen ist, wird das Inhaltselement der Umfrage nicht mehr auf dem Bildschirm ausgegeben.
Zugriff
Bei einer Umfrage hat man generell die Wahl zwischen drei unterschiedlichen Zugriffsverfahren:
- Anonymisierte Umfrage
- Anonymisierte Umfrage mit TAN
- personalisierte Umfrage
Den Status einer bereits begonnenen Umfrage kann man über das Kontrollkästchen Teilnehmer wiedererkennen in einem Browser-Cookie auf dem System der Teilnehmer ablegen, sofern diese die Speicherung eines Cookie zulassen.
Anonymisierte Umfrage
Eine anonymisierte Umfrage steht prinzipiell jedem zur Verfügung. Allerdings kann dort auch nicht festgestellt werden, ob ein Teilnehmer eine Umfrage bereits durchgeführt hat oder nicht. Eine solche Umfrage sollte also nicht verwendet werden, um einen repräsentativen Datensatz zu erhalten. Die Teilnehmerdatensätze können bei der Auswertung nicht mehr zu den eigentlichen Teilnehmern zugeordnet werden. Alle persönlichen Daten sind anonymisiert.
Anonymisierte Umfrage mit TAN
Eine anonymisierte Umfrage mit TAN kann nur mit einem speziellen Umfrage-Code (TAN-Code, Transaktionsnummer) durchgeführt werden. Die Teilnehmerdatensätze können bei der Auswertung nicht mehr zu den eigentlichen Teilnehmern zugeordnet werden, wohl aber zu den jeweiligen Transaktionsnummern. Alle persönlichen Daten sind anonymisiert. Durch den TAN-Code ist sichergestellt, dass die Umfrage für jede TAN nur genau ein Mal durchgeführt werden kann. Man erhält also einen repräsentativen Datensatz. Die TAN-Codes für eine Umfrage werden in einem zusätzlichen Bereich der Umfrage erstellt und verwaltet.
Personalisierte Umfrage
Eine personalisierte Umfrage ist nur für angemeldeten Benutzern des Contao-Frontends durchführbar. Die Teilnehmerdatensätze können in der Auswertung jederzeit mit dem Namen des Teilnehmers in Verbindung gebracht werden. Durch die Anmeldung im Frontend ist sichergestellt, dass die Umfrage für jedes Mitglied nur genau ein Mal durchgeführt werden kann. Man erhält also einen repräsentativen Datensatz. Über das Kontrollkästchen Limitieren auf Mitgliedergruppen kann man den Zugriff auf die Umfrage weiter einschränken, indem man die Umfrage nur für ausgewählte Mitgliedergruppen durchführbar macht. Hierfür muss man die gewünschten Mitgliedergruppen in der Liste Mitgliedergruppen auswählen.
Einleitende und abschließende Bemerkung
Im Textfeld Einleitender Text kann man eine Einleitung erstellen, die vor dem Start der Umfrage im Inhaltselement der Umfrage angezeigt wird. Im Textfeld Abschließender Text kann man einen abschließenden Text verfassen, der den Teilnehmern nach Beenden der Umfrage angezeigt wird.
Einstellungen für die Kopfzeile
Mit dem Kontrollkästchen Umfragetitel anzeigen wird der Titel der Umfrage während der gesamten Ausgabe der Umfrage in einer Kopfzeile über der Umfrage ausgegeben. Das Kontrollkästchen Diese Umfrage beenden erzeugt während der Ausgabe der Umfrage ein Kommando Diese Umfrage beenden in der Kopfzeile der Umfrage. Durch Anklicken dieses Kommandos können Teilnehmer die Umfrage jederzeit unterbrechen.
Allgemeine Einstellungen
- Zurückgehen erlauben: Hier legt man fest, ob den Teilnehmern die Möglichkeit gegeben werden soll, während der Umfrage eine Seite zurück zu navigieren. Dies ist natürlich nur möglich, wenn die Umfrage aus mehreren Seiten besteht.
- Weiterleitung zu Seite: Wenn man hier eine Seite der Contao-Installation auswählt, werden die Teilnehmer nach dem Abschließen der Umfrage auf die ausgewählte Seite weitergeleitet. Der abschließende Text entfällt damit, auch wenn er weiter oben definiert wurde.
Verwenden mehrerer Seiten in einer Umfrage
Die Strukturierung des Fragebogens ist freigestellt. Die survey_ce-Umfragen arbeiten mit einem Seitenprinzip, das es ermöglicht, mehrere Bildschirmseiten für die Umfrage zu verwenden. Sollte man die Umfrage nur auf einer einzigen Seite durchführen wollen, so muss man auch nur eine Seite anlegen. Anderenfalls legt man so viele Seiten an, wie man für die Umfrage benötigt.
Im Bearbeitungsmodus einer Umfrage fügt man eine neue Seite zur Umfrage hinzu, indem man den Befehl Neue Seite auswählt und die notwendigen Felder für die Erstellung einer neuen Seite ausfüllt.
Erstellen einer neuen Seite für eine Umfrage
Man füllt in der Sektion Titel und Beschreibung das Feld Titel aus, um eine neue Seite für Ihre Umfrage zu erstellen. Der Titel wird während der Umfrage im Kopf der Seite angezeigt. Optional kann man auch noch eine Beschreibung für diese Seite angeben.
In der Sektion Einleitender Text kann man im gleichnamigen Feld eine Einleitung eingeben, die unter dem Seitentitel während der Umfrage angezeigt wird.
In der Sektion Seitentemplate hat man die Möglichkeit eine Vorlagendatei für die Ausgabe der Fragen auf der Seite auszuwählen.
Man schliesst das Anlegen der neuen Seite mit Speichern und Bearbeiten ab, um nun endlich zum Anlegen der Fragen für die Umfrage zu kommen.
Erstellen von Fragen
Man legt eine neue Frage an, indem man im Seiteneditor den Befehl Neue Frage auswählt.
Für die Umfrage stehen die folgenden Fragentypen zur Verfügung:
Fragentyp | Untertyp | Beschreibung |
---|---|---|
Offene Frage | Einzeilig | Einzeiliges Textfeld für beliebige Texteingaben |
Offene Frage | Mehrzeilig | Mehrzeiliges Textfeld für beliebige Texteingaben |
Offene Frage | Ganzzahl | Einzeiliges Textfeld für ganze Zahlen |
Offene Frage | Kommazahl | Einzeiliges Textfeld für Kommazahlen |
Offene Frage | Datum | Einzeiliges Textfeld für Datumsangaben |
Offene Frage | Uhrzeit | Einzeiliges Textfeld für Uhrzeiten |
Multiple Choice Frage | Einfachauswahl | Multiple Choice Fragen mit Einfachauswahl (eine Auswahlmöglichkeit) |
Multiple Choice Frage | Mehrfachauswahl | Multiple Choice Fragen mit Mehrfachauswahl (mehrere Auswahlmöglichkeiten) |
Multiple Choice Frage | Dichotom (Ja/Nein) | Sonderfall der Multiple Choice Frage mit Einfachauswahl und den Antwortmöglichkeiten Ja und Nein |
Matrixfrage | Einfachauswahl | Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Eine Auswahl pro Zeile |
Matrixfrage | Mehrfachauswahl | Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Mehrere Auswahlmöglichkeiten pro Zeile |
Feste Summe | Textfrage mit mehreren Einzelzeilen zum Erfassen von Werten, die einen bestimmten Gesamtwert erreichen müssen oder nicht überschreiten dürfen |
Gemeinsamkeiten aller Fragentypen
Allen Fragen gemeinsam sind die Sektionen Titel und Fragentyp, Fragentext und Pflichteingabe.
- Titel definiert den Fragentitel der als Überschrift über jeder Frage in der Umfrage erscheint.
- Den Autor der Frage wählt man aus der Auswahlliste der verfügbaren Backend-Benutzer aus.
- Über Untertyp kann man bei den meisten Fragentypen die verfügbaren Untertypen auswählen.
- Das Feld Beschreibung kann eine ausführliche Beschreibung der Frage beinhalten. Da es durchsucht werden kann, ist es geeignet z.B. Metainformationen aufzunehmen, die nicht durch die angebotenen Felder abgedeckt werden.
- Mit dem Feld Fragentitel ausblenden kann der verpflichtende Fragentitel in der Umfrage ausgeblendet werden.
- Hilfetext zeigt den eingegebenen Text als zusätzliche Erläuterung zur Frage unter dem Fragentitel an. Dies kann bei etwas komplizierteren Fragestellungen als Hilfe genutzt werden.
- Über das Auswahlfeld Sprache legt man die Sprache der Frage fest.
In das Feld Fragentext trägt man den ausführlichen Fragentext ein, der den Teilnehmern die Fragenstellung verdeutlichen soll. Bei intuitiven Fragestellungen kann man dieses Feld natürlich auch leer lassen. Der Fragentext wird unterhalb des Fragentitels und über den angebotenen Antwortfeldern angezeigt.
Wenn man eine offene Frage zur Pflichteingabe macht, muss das Textfeld vom Teilnehmer ausgefüllt werden. Pflichtfragen werden mit einem kleinen Sternchen neben dem Fragentitel als Pflichtfragen gekennzeichnet, um die Frage als Pflichtfrage visuell zu kennzeichnen.
Offene Fragen
Bei offenen Fragen können die Teilnehmer frei ihre Antwort, Einstellung oder Überzeugung formulieren und werden nicht durch vorgegebene Antwortmöglichkeiten in ein Raster gezwungen. survey_ce unterscheidet zwischen verschiedenen Untertypen von offenen Fragen.
Untertyp: Einzeilig
Eine einzeilige offene Frage besteht aus einem einzeiligen Eingabefeld, in das die Teilnehmer ihre Antwort eintragen. Über die Felder Beschriftung vor Textfeld und Beschriftung nach Textfeld kann man auf Höhe des Eingabefeldes noch einen Text vor dem Eingabefeld (z.B. für eine kurze Beschriftung) bzw. einen Text nach dem Eingabefeld (z.B. für eine Einheit, Mengenangabe etc.) eintragen.
In das Feld Vorbelegung kann man einen Text eintragen, der beim ersten Aufrufen der Frage in dem Textfeld angezeigt wird. Mittels Breite und maximale Länge kann man die Breite des Eingabefeldes in Zeichen bzw. die maximale Anzahl von Zeichen, die das Eingabefeld zulassen soll steuern.
Untertyp: Mehrzeilig
Eine mehrzeilige offene Frage besteht aus einem mehrzeiligen Eingabefeld, einer sogenannten Textarea (= Textbereich), in das die Teilnehmer ihre Antwort eintragen. Im Unterschied zum einzeiligen Eingabefeld kann man hier statt der Breite des Eingabefeldes in Zeichen die Anzahl der Zeilen und Spalten des Eingabefeldes festlegen.
Untertyp: Ganzzahl
Ganzzahl ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine ganzzahlige Antwort eintragen müssen. Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder Wertebereich von und Wertebereich bis den Eingabebereich der Teilnehmer eingrenzen.
Das Ganzzahl-Eingabefeld wird natürlich auf die Eingabe von ganzen Zahlen überprüft.
Untertyp: Kommazahl
Kommazahl ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine Fließkommazahl als Antwort eintragen müssen. Die Einstellungen sind identisch zum Ganzzahl-Eingabefeld.
Das Kommazahl-Eingabefeld wird natürlich auf die Eingabe von Fließkommazahlen überprüft.
Untertyp: Datum
Datum ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer ein Datum eintragen müssen. Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder Wertebereich von und Wertebereich bis den Eingabebereich der Teilnehmer auf bestimmte Daten eingrenzen.
Das Datum-Eingabefeld wird natürlich auf die Eingabe eines gültigen Datums überprüft.
Untertyp: Uhrzeit
Datum ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine Uhrzeit eintragen müssen. Zusätzlich zu den Einstellungen für ein normales einzeiliges Eingabefeld kann man über die Felder Wertebereich von und Wertebereich bis den Eingabebereich der Teilnehmer auf bestimmte Uhrzeiten eingrenzen.
Das Uhrzeit-Eingabefeld wird natürlich auf die Eingabe einer gültigen Uhrzeit überprüft.
Multiple Choice Fragen
Bei Multiple Choice Fragen handelt es sich um Fragen mit vorgegebenen Antworten, aus denen die Teilnehmer eine oder mehrere Antworten auswählen sollen. survey_ce unterscheidet zwischen verschiedenen Untertypen von Multiple Choice Fragen.
Untertyp: Einfachauswahl
Bei Multiple Choice Fragen mit Einfachauswahl sollen die Teilnehmer aus den vorgegebenen Antworten nur genau eine auswählen. Über den Antworten Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben. Da sich bei Multiple Choice Fragen viele Antworten oftmals aus vorgegebenen Antwortskalen zusammensetzen, in denen häufig Informationen wie Einstellung oder Meinungen, Überzeugungen, Verhalten oder Eigenschaften abgefragt werden, bietet survey_ce die Möglichkeit, diese sogenannten Skalen aus einer Liste von vorgegebenen Skalen abzurufen, die man mit dem in survey_ce integrierten Skaleneditor erstellen kann. Weitere Details zum Thema Skalen entnehmen Sie bitte dem Abschnitt Hinzufügen von vordefinierten Skalen.
Mit dem Kontrollkästchen Andere Antwort erlauben wird den Antworten eine zusätzliche letzte Antwort in Form eines leeren Textfeldes hinzugefügt, das die Teilnehmer auswählen und beschriften können, wenn keine der vorgegebenen Antworten zutreffend ist. Man kann zusätzlich eine Beschreibung für dieses Textfeld erstellen, die vor dem Textfeld angezeigt wird, wenn man das Feld Titel der anderen Antwort ausfüllt.
Die Darstellung der Antworten kann man über das entsprechende Auswahlfeld steuern. Zur Auswahl stehen hier eine vertikale Ausrichtung, bei der die Antworten untereinander angeboten werden, eine horizontale Ausrichtung, bei der die Antworten nebeneinander angeboten werden (meist nur für wenige Antworten aus Platzgründen sinnvoll) und die Ausgabe als Dropdown-Feld, in dem immer nur eine Antwort sichtbar ist. Im Falle des Dropdown-Feldes hat die Auswahl einer anderen Antwort keine Auswirkung.
Untertyp: Mehrfachauswahl
Bei Multiple Choice Fragen mit Mehrfachauswahl dürfen die Teilnehmer aus den vorgegebenen Antworten eine beliebige Anzahl auswählen. Die Einstellungen für Fragen mit Mehrfachauswahl entsprechen denen für Fragen mit Einfachauswahl. Da Fragen mit Mehrfachauswahl keine fertigen Skalen verwenden, entfällt die Option der Skalenauswahl bei diesem Untertyp.
Untertyp: Dichotom (Ja/Nein)
Dichotome Fragen sind ein Spezialfall der Multiple Choice Frage mit Einfachauswahl. Sie verfügen über zwei feste Antwortvorgaben, nämlich Ja und Nein. Dementsprechend entfallen auch die Konfigurationsmöglichkeiten für diesen Fragentyp. Lediglich die Auswahl der Antwortdarstellung kann getroffen werden.
Matrixfragen
Bei Matrixfragen handelt es sich um einen Spezialfall der Multiple Choice Fragen. In einer Matrixfrage werden mehrere Fragen mit gleichen Antworten / Skalen in einer Matrix, also in Zeilen und Spalten angeordnet. Dabei werden die Antworten normalerweise in Spalten angeordnet, während die Fragen in Zeilen angeordnet werden. Die Vorteile einer Matrixfrage liegen auf der Hand: Die Darstellung ist sehr effizient, es lässt sich eine hohe Datenfülle bei gleichzeitiger guter Ausnutzung des Bildschirms erreichen. Allerdings können Matrixfragen auch sehr schnell unübersichtlich werden.
Ähnlich wie die Multiple Choice Fragen lassen sich auch die Matrixfragen in Untertypen einteilen.
Untertyp: Einfachauswahl
Bei einer Matrixfrage mit Einfachauswahl müssen die Teilnehmer genau eine Antwort pro Zeile auswählen. Über den Zeilen Eingabeassistenten kann man eine beliebige Anzahl von Fragen vorgeben. Über den Spalten Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben.
Mit dem Kontrollkästchen Neutrale Spalte erlauben wird den Antworten eine zusätzliche Spalte angefügt, die jedoch etwas abgesetzt dargestellt wird, da sie als neutrale Spalte dazu dient, für den Fall, dass keine der vorgegebenen Antworten zutreffend ist, eine Auswahl getroffen werden kann.
Mit dem Kontrollkästchen Entgegengesetzte Pole anzeigen kann man die Wirkung einer Antwortskala noch weiter verstärken, indem man jeweils für den äußeren "Pol", also die jeweils extremste Ausprägung eine Beschreibung in den Feldern Linker Pol und Rechter Pol definiert, die dann je nach Auswahl unter Position der Pole Links und Rechts der Spalten oder aber über den Spaltenbezeichnern angezeigt werden.
Untertyp: Mehrfachauswahl
Bei einer Matrixfrage mit Mehrfachauswahl dürfen die Teilnehmer eine beliebige Anzahl von Antworten pro Zeile auswählen. Die Einstellungen sind identisch zu den Einstellungen der Matrixfrage mit Einfachauswahl.
Feste Summe
Bei einer festen Summe dürfen die Teilnehmer eine bestimmte Anzahl von Punkten auf vorgegebene Antworten verteilen. Man kann festlegen, ob die Summe der vergebenen Punkte genau der Vorgabesumme entsprechen muss oder ob eine geringere Anzahl von Punkten verteilt werden darf. Über den Antworten Eingabeassistenten kann man eine beliebige Anzahl von Antworten vorgeben. Hinter jeder Antwort befindet sich in der Ausgabe ein Textfeld für die Eingabe der Punkte. Mit Hilfe der Option Eingabefelder vor den Antworten anzeigen kann man die Textfelder auch vor den Antworten ausgaben lassen.
In der Sektion Summenberechnung legt man die zu vergebende Gesamtpunktezahl im Feld Summe fest. Mit der Berechnungsoption legt man dann noch fest, ob die zu den Antworten eingetragenen Punktewerte exakt der Summenvorgabe entsprechen müssen, oder ob die Punktewerte auch niedriger als die Summenvorgabe sein dürfen.
Generieren und Verwalten von TAN Codes
Um TAN Codes für eine Umfrage zu erstellen oder zu verwalten, wählen Sie bitte den Punkt TAN-Erzeugung in den Bearbeitungsoptionen der Umfrage aus.
Erzeugen von TAN-Codes
Sie erzeugen neue TAN-Codes für eine Umfrage, indem Sie die Aktion TAN-Codes erzeugen auswählen.
In dem sich öffnenden Formular geben Sie lediglich die Anzahl der gewünschten TAN-Codes ein und bestätigen das Formular mit erzeugen. Die neu erstellten TAN-Codes werden dann in der TAN-Liste angezeigt.
Die TAN-Codes in der TAN-Liste werden mit einem Status-Symbol (grün = neue, nicht verwendete TAN, orange = bereits verwendete TAN), der TAN-Nummer und dem Datum der Erstellung in der TAN-Liste angezeigt.
Exportieren von TAN-Codes
Falls Sie die TAN-Codes exportieren müssen, weil Sie z.B einen Serienbrief mit einer Einladung zu einer Umfrage an eine größere Gruppe von Teilnehmern versenden wollen, müssen Sie die Aktion TAN-Codes exportieren auswählen.
Im folgenden Formular haben Sie die Möglichkeit, die Contao-Seite auszuwählen, auf der Sie die Umfrage durchführen werden. Wenn Sie eine Seite auswählen, wird Contao für Sie zusätzlich eine URL auf die Seite der Umfrage exportieren. Diese URL enthält bereits den TAN-Code, so dass ein Teilnehmer bei Eingabe der URL bereits die Startseite der Umfrage mit ausgefüllter TAN-Eingabe erhält.
Auf jeden Fall exportiert werden die TAN-Codes und die Information, ob ein TAN-Code bereits verwendet wurde oder nicht (0 = nicht verwendet, 1 = verwendet).
Bestätigen Sie die Export-Einstellungen mit der Schaltfläche Exportieren, wird Contao für Sie eine Excel-Datei generieren, welche die TAN-Liste enthält. Die Excel-Datei wird Ihnen direkt zum Download angeboten.
Verwalten der Teilnehmerdaten
Um die Teilnehmerdaten für eine Umfrage zu verwalten, wählen Sie bitte den Punkt Teilnehmerdaten in den Bearbeitungsoptionen der Umfrage aus.
Alle Teilnehmer, die an der Umfrage teilgenommen haben oder gerade an der Umfrage teilnehmen, werden in der Teilnehmerliste angezeigt. Bei anonymen Umfragen sehen Sie statt des Teilnehmernamens lediglich einen Zufallscode, der zur Anonymisierung der Daten generiert werden. In Klammern hinter dem Namen finden Sie den Status des Teilnehmers. Die folgenden Statusmeldungen sind möglich:
- begonnen: Der Teilnehmer hat die Umfrage begonnen aber noch nicht abgeschlossen
- beendet: Der Teilnehmer hat die Umfrage beendet
- in Klammern die Anzahl der bearbeiteten Seiten und die Gesamtzahl der Seiten der Umfrage
Sie können einzelne Teilnehmer oder alle Teilnehmer löschen. In diesem Fall werden auch die Umfragedaten (Eingaben) dieser Teilnehmer aus der Datenbank gelöscht. Mit der Option Detaillierter Export führen Sie einen detaillierten Export aller Teilnehmerdaten nach Microsoft Excel durch.
Umfrage-Statistik
Um die statistische Auswertung einer Umfrage zu erhalten, wählen Sie bitte den Punkt Statistik in den Bearbeitungsoptionen der Umfrage aus.
In der Statistikansicht werden alle Fragen in der Reihenfolge ihres Auftretens in der Umfrage angezeigt und durchnummeriert. Neben dem Fragentitel, dem Fragentext und dem Fragentyp wird angezeigt, wie oft eine Frage beantwortet wurde und wie oft sie übersprungen wurde.
Durch einen Klick auf die Details-Schaltfläche auf der rechten Seite eines jeden Eintrags gelangen Sie in die Statistik-Details für diese Frage. Die Statistik-Details listen neben den Fragendaten die detaillierte kumulierte Verteilung der Antworten auf.
Um die kumulierte Statistik mit allen Details mit einem externen System weiter zu verarbeiten, können Sie in der Statistikansicht über den Befehl Umfrageergebnisse in Excel exportieren die Statistik der Umfrage in eine Microsoft Excel-Datei exportieren.
Einfügen einer Umfrage in das Frontend
Um eine bestehende Umfrage in das Contao Frontend einzufügen, damit sie auf Ihrer Website angezeigt wird, wechseln Sie im Backend in den Artikelbaum und bearbeiten den Artikel der Seite, in die Sie die Umfrage einbetten möchten. Erstellen Sie hierzu ein neues Inhaltselement und wählen Sie den Elementtyp Umfrage aus.
Aus der Liste der verfügbaren Umfragen wählen Sie nun bitte die gewünschte Umfrage und speichern dann Ihre Eingabe.
Die Umfrage ist nun bereit für die Verwendung. Herzlichen Glückwunsch!
Durchführen einer Umfrage
Wenn eine Umfrage im Frontend verfügbar ist, wird auf der Seite, in der das Inhaltselement Umfrage eingebettet ist, der einleitende Text zur Umfrage und eine Schaltfläche zum Starten der Umfrage angezeigt. Handelt es sich um eine anonymisierte Umfrage mit Zugangscodes (TAN-Codes), dann erscheint zusätzlich vor der Umfrage starten Schaltfläche noch ein Textfeld zur Eingabe eines TAN-Codes.
In der Umfrage können die Teilnehmer am Ende einer Seite über die Weiter-Schaltfläche auf die nächste Seite gelangen. Wenn in den Umfrage-Einstellungen das Zurück gehen erlaubt wurde, wird zusätzlich eine Schaltfläche Zurück angeboten, um auf die vorige Seite zu gelangen.
Auf der letzten Seite kann die Umfrage mit der Schaltfläche Umfrage beenden abgeschlossen werden. In personalisierten Umfragen und Umfragen mit Zugangscode kann eine nicht beendete, abgebrochene Umfrage an der letzten bekannten Position wieder aufgenommen werden. survey_ce merkt sich die letzte Position und leitet die Teilnehmer beim erneuten Start direkt auf die letzte bekannte Seite der Umfrage weiter. Anonymisierte Umfragen ohne Zugangscode können nach einem Abbruch nur dann wieder neu aufgesetzt werden, wenn das Wiedererkennen der Teilnehmer über einen Browser Cookie erlaubt wurde. In allen anderen Fällen werden diese Umfragen sonst wieder mit einem neuen Teilnehmerdatensatz von vorne begonnen.
Beispiele für Fragen in einer Umfrage sind z.B.
Beispiel für eine offene Frage
Beispiel für Multiple Choice Fragen
Beispiel für eine Matrixfrage
Fortschrittsanzeige
Ab survey_ce Version 1.1.0 wird im Standard-Template der Umfrage ein Codeblock für eine Fortschrittsanzeige ausgegeben:
<div class="progressbar_container"> <div class="progressbar" style="width: 20.0%"> <span>Seite 1 von 5</span> </div> </div>
Dieser Codeblock kann wahlweise für die Ausgabe der jeweiligen Seite und der Anzahl der Gesamtseiten verwendet werden oder aber, wie im mitgelieferten Beispiel-CSS decent_blue.css als Fortschrittsbalken. Dabei gibt der Style-Parameter der CSS-Klasse progressbar den Fortschritt in Prozent an.
Hinweise für Entwickler
Der Aufbau des Umfragewerkzeugs survey_ce ist an den hierarchischen Aufbau der meisten Contao-Daten angelehnt. Eine Umfrage besteht aus den folgenden Komponenten:
- Umfrage (tl_survey)
- Seite (tl_survey_page)
- Frage (tl_survey_question)
- Umfrageteilnehmer (tl_survey_participant)
- Umfrageergebnisse (tl_survey_result)
- TAN-Listen (tl_survey_pin_tan)
- Skalen-Ordner (tl_survey_scale_folder)
- Skalen (tl_survey_scale)
- Seite (tl_survey_page)
Die Ausgabe einer Umfrage wird durch das Inhaltselement Umfrage (ContentSurvey.php) durchgeführt. Jeder Fragentyp ist ein eigenes Widget: Multiple Choice Frage = FormMultipleChoiceQuestion.php, Offene Frage = FormOpenEndedQuestion.php, MatrixFrage = FormMatrixQuestion.php, Konstante Summe = FormConstanSumQuestion.php. Die Fragen erben alle von einem gemeinsamen Basis-Widget (FormQuestionWidget.php).
Für die Berechnung der Umfrageergebnisse und den Export gibt es für jeden Fragentyp eine eigene Dienstklasse. Damit diese Dienstklassen korrekt eingebunden werden, müssen Sie Klassennamen besitzen, die einem festen Schema folgen: SurveyQuestion<Fragentyp>. <Fragentyp> ist dabei der Wert des Fragentyps (questiontype-Feld der tl_survey_question-Tabelle) der Frage, wobei der erste Buchstabe groß geschrieben wird und der Rest klein geschrieben wird. Für den Fragentyp Multiple Choice Frage mit dem Typ 'multiplechoice' lautet der Name der Dienstklasse dann SurveyQuestionMultiplechoice.
Mit dieser Kenntnis sollte es dann möglich sein, eigene Fragentypen zu entwickeln und zu integrieren.
Hooks
survey_ce bietet einige Hooks für Entwickler an, um ohne aufwändiges Überschreiben von bestehenden Klassen an bestimmte Umfragedaten zu gelangen. Ein Hook wird mit seinem Funktionsnamen in die zentrale Contao Hook-Struktur integriert und besteht aus einem Array mit dem Namen der Klasse der aufzurufenden Hookfunktion und dem Namen der aufzurufenden Hookfunktion:
<?php $GLOBALS['TL_HOOKS']['surveyFinished'][] = array('MySurveyExtension', 'surveyFinished'); ?>
Verfügbare Hooks sind:
surveyQuestionsValidated
Der surveyQuestionsValidated Hook wird aufgerufen, wenn die Fragen auf einer Umfrageseite von einem Teilnehmer abgeschickt und validiert wurden. Übergeben wird ein Array mit den instanziierten, validierten Widgets und ein assoziatives Array mit den Datenbankfeldern der aktuellen Umfrageseite.
<?php // config.php $GLOBALS['TL_HOOKS']['surveyQuestionsValidated'][] = array('MyClass', 'surveyQuestionsValidated'); // MyClass.php public function surveyQuestionsValidated($widgets, $pagedata) { // Do something } ?>
surveyQuestionsLoaded
Der surveyQuestionsLoaded Hook wird aufgerufen, wenn die Fragen auf einer Umfrageseite aus der Datenbank geladen und ggfs. mit Werten gefüllt wurden. Übergeben wird ein Array mit den instanziierten, validierten Widgets und ein assoziatives Array mit den Datenbankfeldern der aktuellen Umfrageseite.
<?php // config.php $GLOBALS['TL_HOOKS']['surveyQuestionsLoaded'][] = array('MyClass', 'surveyQuestionsLoaded'); // MyClass.php public function surveyQuestionsLoaded($widgets, $pagedata) { // Do something } ?>
surveyFinished
Der surveyFinished Hook wird aufgerufen, wenn ein Teilnehmer eine Umfrage beendet. Übergeben wird ein assoziatives Array mit den Datenbankfeldern der Umfrage.
<?php // config.php $GLOBALS['TL_HOOKS']['surveyFinished'][] = array('MyClass', 'surveyFinished'); // MyClass.php public function surveyQuestionsLoaded($surveydata) { // Do something, e.g. send confirmation mail to participant etc. } ?>
--Hschottm 10:30, 11. Sep. 2010 (CEST)