Survey ce: Unterschied zwischen den Versionen
Aus Contao Community Documentation
(→Hinweise für Entwickler) |
K (→surveyFinished: Fehler korrigiert) |
||
(21 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 7: | Zeile 7: | ||
| DevSite=http://www.aurealis.de | | DevSite=http://www.aurealis.de | ||
| ExtVersion=1.1.0 | | ExtVersion=1.1.0 | ||
− | | Version= | + | | Version=2.9.0 - 2.9.1 |
+ | | TLVersion=2.7.1 - 2.8.4 | ||
| ERLink=http://www.contao.org/erweiterungsliste/view/survey_ce.de.html | | ERLink=http://www.contao.org/erweiterungsliste/view/survey_ce.de.html | ||
| DonateLink=http://aurealis.de/spenden.html | | DonateLink=http://aurealis.de/spenden.html | ||
Zeile 22: | Zeile 23: | ||
=== Erstellung von Umfragen === | === Erstellung von Umfragen === | ||
− | Um eine neue Umfrage zu erstellen, | + | Um eine neue Umfrage zu erstellen, wählt man den Punkt '''Umfragen''' in der Liste der Backend-Module im Contao-Backend aus. |
[[Datei:umfrage_backend_module.png |Umfrage-Elemente in der Liste der Backend-Module|center|frame]] | [[Datei:umfrage_backend_module.png |Umfrage-Elemente in der Liste der Backend-Module|center|frame]] | ||
− | Im Umfragebereich des Hauptfensters | + | 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 ==== | ==== Elemente einer Umfrage ==== | ||
===== Titel und Beschreibung ===== | ===== Titel und Beschreibung ===== | ||
− | In der Sektion 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. |
[[Datei:umfrage_titel_beschreibung.png |Titel und Beschreibung einer Umfrage|center|frame]] | [[Datei:umfrage_titel_beschreibung.png |Titel und Beschreibung einer Umfrage|center|frame]] | ||
Zeile 37: | Zeile 38: | ||
===== Aktivierung ===== | ===== Aktivierung ===== | ||
− | In der Sektion 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. |
[[Datei:umfrage_aktivierung.png |Aktivierung einer Umfrage|center|frame]] | [[Datei:umfrage_aktivierung.png |Aktivierung einer Umfrage|center|frame]] | ||
Zeile 43: | Zeile 44: | ||
===== Zugriff ===== | ===== Zugriff ===== | ||
− | Bei einer Umfrage | + | Bei einer Umfrage hat man generell die Wahl zwischen drei unterschiedlichen Zugriffsverfahren: |
* Anonymisierte Umfrage | * Anonymisierte Umfrage | ||
Zeile 49: | Zeile 50: | ||
* personalisierte Umfrage | * personalisierte Umfrage | ||
− | Den Status einer bereits begonnenen 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 ====== | ====== Anonymisierte Umfrage ====== | ||
Zeile 59: | Zeile 60: | ||
====== Anonymisierte Umfrage mit TAN ====== | ====== 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. | + | 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. |
[[Datei:umfrage_anonymisiert_tan.png |Einstellungen für eine anonymisierte Umfrage mit TAN-Code|center|frame]] | [[Datei:umfrage_anonymisiert_tan.png |Einstellungen für eine anonymisierte Umfrage mit TAN-Code|center|frame]] | ||
Zeile 65: | Zeile 66: | ||
====== Personalisierte Umfrage ====== | ====== Personalisierte Umfrage ====== | ||
− | Eine personalisierte Umfrage ist nur für angemeldeten Benutzern des Contao-Frontends durchführbar. Die Teilnehmerdatensätze können in | + | 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. |
[[Datei:umfrage_personalisiert.png |Einstellungen für eine personalisierte Umfrage|center|frame]] | [[Datei:umfrage_personalisiert.png |Einstellungen für eine personalisierte Umfrage|center|frame]] | ||
− | + | {{msgImportant|Wenn eine Umfrage verwendet wurde, d.h. wenn Teilnehmerdatensätze existieren, wird aus Sicherheitsgründen die Bearbeitung des Zugriffs deaktiviert, damit das Zugriffsverfahren für alle Teilnehmer gleich ist. Um die Bearbeitung wieder zu ermöglichen, müssen die Teilnehmerdatensätze gelöscht werden.}} | |
===== Einleitende und abschließende Bemerkung ===== | ===== Einleitende und abschließende Bemerkung ===== | ||
− | Im Textfeld '''Einleitender Text''' | + | 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. |
[[Datei:umfrage_intro_outro.png |Einleitende und abschließende Bemerkung einer Umfrage|center|frame]] | [[Datei:umfrage_intro_outro.png |Einleitende und abschließende Bemerkung einer Umfrage|center|frame]] | ||
Zeile 79: | Zeile 80: | ||
===== Einstellungen für die Kopfzeile ===== | ===== 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 | + | 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. |
[[Datei:umfrage_head_settings.png |Einstellungen für die Kopfzeile: Umfragetitel, "Diese Umfrage beenden"|center|frame]] | [[Datei:umfrage_head_settings.png |Einstellungen für die Kopfzeile: Umfragetitel, "Diese Umfrage beenden"|center|frame]] | ||
Zeile 85: | Zeile 86: | ||
===== Allgemeine Einstellungen ===== | ===== Allgemeine Einstellungen ===== | ||
− | * '''Zurückgehen erlauben''': Hier | + | * '''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 | + | * '''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. |
[[Datei:umfrage_allgemeine_einstellungen.png |Allgemeine Einstellungen einer Umfrage|center|frame]] | [[Datei:umfrage_allgemeine_einstellungen.png |Allgemeine Einstellungen einer Umfrage|center|frame]] | ||
Zeile 92: | Zeile 93: | ||
==== Verwenden mehrerer Seiten in einer Umfrage ==== | ==== Verwenden mehrerer Seiten in einer Umfrage ==== | ||
− | Die Strukturierung | + | 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 | + | 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. |
[[Datei:umfrage_neue_seite.png |Erstellen einer neuen Seite in einer Umfrage|center|frame]] | [[Datei:umfrage_neue_seite.png |Erstellen einer neuen Seite in einer Umfrage|center|frame]] | ||
Zeile 100: | Zeile 101: | ||
===== Erstellen einer neuen Seite für eine Umfrage ===== | ===== 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. | |
[[Datei:umfrage_neue_seite_titel.png |Titel und Beschreibung einer neuen Seite|center|frame]] | [[Datei:umfrage_neue_seite_titel.png |Titel und Beschreibung einer neuen Seite|center|frame]] | ||
− | In der Sektion Einleitender Text | + | In der Sektion Einleitender Text kann man im gleichnamigen Feld eine Einleitung eingeben, die unter dem Seitentitel während der Umfrage angezeigt wird. |
[[Datei:umfrage_neue_seite_einleitung.png |Einleitender Text einer neuen Seite|center|frame]] | [[Datei:umfrage_neue_seite_einleitung.png |Einleitender Text einer neuen Seite|center|frame]] | ||
− | In der Sektion Seitentemplate | + | In der Sektion Seitentemplate hat man die Möglichkeit eine Vorlagendatei für die Ausgabe der Fragen auf der Seite auszuwählen. |
[[Datei:umfrage_seite_template.png |Auswahl eines Seitentemplates für die Darstellung der Fragen auf einer Umfrage-Seite|center|frame]] | [[Datei:umfrage_seite_template.png |Auswahl eines Seitentemplates für die Darstellung der Fragen auf einer Umfrage-Seite|center|frame]] | ||
− | + | 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. | |
− | + | {{msgImportant|Wenn eine Umfrage verwendet wurde, d.h. wenn Teilnehmerdatensätze existieren, wird aus Sicherheitsgründen die Erstellung und Bearbeitung der Seiten und die Erstellung und Bearbeitung von Fragen für diese Umfrage deaktiviert, damit die Umfrage nicht verändert werden kann. Um die Bearbeitung wieder zu ermöglichen, müssen die Teilnehmerdatensätze gelöscht werden.}} | |
==== Erstellen von Fragen ==== | ==== Erstellen von Fragen ==== | ||
− | + | Man legt eine neue Frage an, indem man im Seiteneditor den Befehl '''Neue Frage''' auswählt. | |
[[Datei:umfrage_neue_frage.png |Erstellen einer neuen Frage im Seiteneditor|center|frame]] | [[Datei:umfrage_neue_frage.png |Erstellen einer neuen Frage im Seiteneditor|center|frame]] | ||
− | Für | + | Für die Umfrage stehen die folgenden Fragentypen zur Verfügung: |
− | + | {|border="1" cellpadding="5" cellspacing="0" | |
− | | Offene Frage | Einzeilig | Einzeiliges Textfeld für beliebige Texteingaben | | + | ! Fragentyp |
− | | Offene Frage | Mehrzeilig | Mehrzeiliges Textfeld für beliebige Texteingaben | | + | ! Untertyp |
− | | Offene Frage | Ganzzahl | Einzeiliges Textfeld für ganze Zahlen | | + | ! Beschreibung |
− | | Offene Frage | Kommazahl | Einzeiliges Textfeld für Kommazahlen | | + | |- |
− | | Offene Frage | Datum | Einzeiliges Textfeld für Datumsangaben | | + | | Offene Frage |
− | | Offene Frage | Uhrzeit | Einzeiliges Textfeld für Uhrzeiten | | + | | Einzeilig |
− | | Multiple Choice Frage | Einfachauswahl | Multiple Choice Fragen mit Einfachauswahl (eine Auswahlmöglichkeit) | | + | | Einzeiliges Textfeld für beliebige Texteingaben |
− | | 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 | | + | | Offene Frage |
− | | Matrixfrage | Einfachauswahl | Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Eine Auswahl pro Zeile | | + | | Mehrzeilig |
− | | Matrixfrage | Mehrfachauswahl | Matrixfrage (mehrere Fragen und Antwortmöglichkeiten in Tabellenform). Mehrere Auswahlmöglichkeiten pro Zeile | | + | | Mehrzeiliges Textfeld für beliebige Texteingaben |
− | | Feste Summe || Textfrage mit mehreren Einzelzeilen zum Erfassen von Werten, die einen bestimmten Gesamtwert erreichen müssen oder nicht überschreiten dürfen | | + | |- |
+ | | 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 ===== | ===== Gemeinsamkeiten aller Fragentypen ===== | ||
Zeile 144: | Zeile 185: | ||
* '''Titel''' definiert den Fragentitel der als Überschrift über jeder Frage in der Umfrage erscheint. | * '''Titel''' definiert den Fragentitel der als Überschrift über jeder Frage in der Umfrage erscheint. | ||
− | * Den '''Autor''' | + | * Den '''Autor''' der Frage wählt man aus der Auswahlliste der verfügbaren Backend-Benutzer aus. |
− | * Über '''Untertyp''' | + | * Ü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. | * 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. | * 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. | * '''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''' | + | * Über das Auswahlfeld '''Sprache''' legt man die Sprache der Frage fest. |
[[Datei:umfrage_offen_titel.png |Titel und Fragentyp einer Frage|center|frame]] | [[Datei:umfrage_offen_titel.png |Titel und Fragentyp einer Frage|center|frame]] | ||
− | In das Feld '''Fragentext''' | + | 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. |
[[Datei:umfrage_offen_fragentext.png |Fragentext einer Frage|center|frame]] | [[Datei:umfrage_offen_fragentext.png |Fragentext einer Frage|center|frame]] | ||
− | Wenn | + | 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. |
[[Datei:umfrage_offen_pflicht.png |Festlegung einer Frage als Pflichtfrage|center|frame]] | [[Datei:umfrage_offen_pflicht.png |Festlegung einer Frage als Pflichtfrage|center|frame]] | ||
Zeile 167: | Zeile 208: | ||
====== Untertyp: Einzeilig ====== | ====== 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''' | + | 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''' | + | 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. |
[[Datei:umfrage_offen_einzeilig.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage|center|frame]] | [[Datei:umfrage_offen_einzeilig.png |Fragenspezifische Einstellungen einer einzeiligen offenen Frage|center|frame]] | ||
Zeile 175: | Zeile 216: | ||
====== Untertyp: Mehrzeilig ====== | ====== 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 | + | 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. |
[[Datei:umfrage_offen_mehrzeilig.png | Fragenspezifische Einstellungen einer mehrzeiligen offenen Frage|center|frame]] | [[Datei:umfrage_offen_mehrzeilig.png | Fragenspezifische Einstellungen einer mehrzeiligen offenen Frage|center|frame]] | ||
Zeile 182: | Zeile 223: | ||
Ganzzahl ist eine offene Frage, die aus einem einzeiligen Eingabefeld besteht, in das die Teilnehmer eine ganzzahlige Antwort eintragen müssen. | 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 | + | 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. | Das Ganzzahl-Eingabefeld wird natürlich auf die Eingabe von ganzen Zahlen überprüft. | ||
Zeile 198: | Zeile 239: | ||
====== Untertyp: Datum ====== | ====== 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 | + | 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. | Das Datum-Eingabefeld wird natürlich auf die Eingabe eines gültigen Datums überprüft. | ||
Zeile 207: | Zeile 248: | ||
====== Untertyp: Uhrzeit ====== | ====== 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 | + | 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. | Das Uhrzeit-Eingabefeld wird natürlich auf die Eingabe einer gültigen Uhrzeit überprüft. | ||
Zeile 219: | Zeile 260: | ||
====== Untertyp: Einfachauswahl ====== | ====== Untertyp: Einfachauswahl ====== | ||
− | Bei Multiple Choice Fragen mit Einfachauswahl sollen die Teilnehmer aus den vorgegebenen Antworten nur genau eine auswählen. Über den '''Antworten''' Eingabeassistenten | + | 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 | + | 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. | + | 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 | + | 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. |
[[Datei:umfrage_mc_sr.png |Fragenspezifische Einstellungen einer Multiple Choice Frage mit Einfachauswahl|center|frame]] | [[Datei:umfrage_mc_sr.png |Fragenspezifische Einstellungen einer Multiple Choice Frage mit Einfachauswahl|center|frame]] | ||
Zeile 248: | Zeile 289: | ||
====== Untertyp: Einfachauswahl ====== | ====== Untertyp: Einfachauswahl ====== | ||
− | Bei einer Matrixfrage mit Einfachauswahl müssen die Teilnehmer genau eine Antwort pro Zeile auswählen. Über den '''Zeilen''' Eingabeassistenten | + | 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 '''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''' | + | 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. |
[[Datei:umfrage_matrix_sr.png |Fragenspezifische Einstellungen einer Matrixfrage mit Einfachauswahl|center|frame]] | [[Datei:umfrage_matrix_sr.png |Fragenspezifische Einstellungen einer Matrixfrage mit Einfachauswahl|center|frame]] | ||
Zeile 263: | Zeile 304: | ||
===== Feste Summe ===== | ===== Feste Summe ===== | ||
− | Bei einer festen Summe dürfen die Teilnehmer eine bestimmte Anzahl von Punkten auf vorgegebene Antworten verteilen. | + | 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 | + | 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. |
[[Datei:umfrage_summe.png |Fragenspezifische Einstellungen einer Frage vom Typ Feste Summe|center|frame]] | [[Datei:umfrage_summe.png |Fragenspezifische Einstellungen einer Frage vom Typ Feste Summe|center|frame]] | ||
Zeile 271: | Zeile 312: | ||
=== Generieren und Verwalten von TAN Codes === | === Generieren und Verwalten von TAN Codes === | ||
− | Um TAN Codes für eine Umfrage zu erstellen oder zu verwalten, | + | Um TAN Codes für eine Umfrage zu erstellen oder zu verwalten, wählt man den Punkt '''TAN-Erzeugung''' in den Bearbeitungsoptionen der Umfrage aus. |
[[Datei:umfrage_tan_gen.png |TAN-Erzeugung und Verwaltung von TAN-Listen öffnen|center|frame]] | [[Datei:umfrage_tan_gen.png |TAN-Erzeugung und Verwaltung von TAN-Listen öffnen|center|frame]] | ||
==== Erzeugen von TAN-Codes ==== | ==== Erzeugen von TAN-Codes ==== | ||
− | + | Man erzeugt neue TAN-Codes für eine Umfrage, indem man die Aktion '''TAN-Codes erzeugen''' auswählt. | |
[[Datei:umfrage_tan_erzeugen.png |TAN-Codes erzeugen|center|frame]] | [[Datei:umfrage_tan_erzeugen.png |TAN-Codes erzeugen|center|frame]] | ||
− | In dem sich öffnenden Formular | + | In dem sich öffnenden Formular gibt man 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. |
[[Datei:umfrage_tan_erzeugen_dialog.png |Dialog zum Erzeugen von TAN-Codes|center|frame]] | [[Datei:umfrage_tan_erzeugen_dialog.png |Dialog zum Erzeugen von TAN-Codes|center|frame]] | ||
Zeile 289: | Zeile 330: | ||
==== Exportieren von TAN-Codes ==== | ==== Exportieren von TAN-Codes ==== | ||
− | Falls | + | Falls man die TAN-Codes exportieren muss, weil man z.B einen Serienbrief mit einer Einladung zu einer Umfrage an eine größere Gruppe von Teilnehmern versenden will, muss man die Aktion '''TAN-Codes exportieren''' auswählen. |
[[Datei:umfrage_tan_exportieren.png |TAN-Codes exportieren|center|frame]] | [[Datei:umfrage_tan_exportieren.png |TAN-Codes exportieren|center|frame]] | ||
− | Im folgenden Formular | + | Im folgenden Formular hat man die Möglichkeit, die Contao-Seite auszuwählen, auf der man die Umfrage durchführen wird. Wenn man eine Seite auswählt, wird Contao 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). | 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). | ||
− | + | Man bestätigen die Export-Einstellungen mit der Schaltfläche '''Exportieren''', wird Contao eine Excel-Datei generieren, welche die TAN-Liste enthält. Die Excel-Datei wird direkt zum Download angeboten. | |
[[Datei:umfrage_tan_exportieren_dialog.png |Export einer TAN-Liste für die externe Weiterverarbeitung im Excel XLS-Format|center|frame]] | [[Datei:umfrage_tan_exportieren_dialog.png |Export einer TAN-Liste für die externe Weiterverarbeitung im Excel XLS-Format|center|frame]] | ||
+ | |||
=== Verwalten der Teilnehmerdaten === | === Verwalten der Teilnehmerdaten === | ||
− | Um die Teilnehmerdaten für eine Umfrage zu verwalten, | + | Um die Teilnehmerdaten für eine Umfrage zu verwalten, wählt man den Punkt '''Teilnehmerdaten''' in den Bearbeitungsoptionen der Umfrage aus. |
[[Datei:umfrage_teilnehmer.png |Verwaltung der Teilnehmerdaten|center|frame]] | [[Datei:umfrage_teilnehmer.png |Verwaltung der Teilnehmerdaten|center|frame]] | ||
− | Alle Teilnehmer, die an der Umfrage teilgenommen haben oder gerade an der Umfrage teilnehmen, werden in der Teilnehmerliste angezeigt. Bei anonymen Umfragen | + | Alle Teilnehmer, die an der Umfrage teilgenommen haben oder gerade an der Umfrage teilnehmen, werden in der Teilnehmerliste angezeigt. Bei anonymen Umfragen sieht man statt des Teilnehmernamens lediglich einen Zufallscode, der zur Anonymisierung der Daten generiert werden. In Klammern hinter dem Namen findt man den Status des Teilnehmers. Die folgenden Statusmeldungen sind möglich: |
* '''begonnen''': Der Teilnehmer hat die Umfrage begonnen aber noch nicht abgeschlossen | * '''begonnen''': Der Teilnehmer hat die Umfrage begonnen aber noch nicht abgeschlossen | ||
Zeile 314: | Zeile 356: | ||
[[Datei:umfrage_teilnehmerliste.png |Teilnehmerliste einer anonymen Umfrage|center|frame]] | [[Datei:umfrage_teilnehmerliste.png |Teilnehmerliste einer anonymen Umfrage|center|frame]] | ||
− | + | Man kann 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''' | + | Mit der Option '''Detaillierter Export''' führt man einen detaillierten Export aller Teilnehmerdaten nach Microsoft Excel durch. |
=== Umfrage-Statistik === | === Umfrage-Statistik === | ||
− | Um die statistische Auswertung einer Umfrage zu erhalten, | + | Um die statistische Auswertung einer Umfrage zu erhalten, wählt man den Punkt '''Statistik''' in den Bearbeitungsoptionen der Umfrage aus. |
[[Datei:umfrage_statistik.png |Statistik der Umfrage anzeigen|center|frame]] | [[Datei:umfrage_statistik.png |Statistik der Umfrage anzeigen|center|frame]] | ||
Zeile 327: | Zeile 369: | ||
[[Datei:umfrage_statistik_liste.png |Statistikansicht mit einer Liste der Fragen und der Anzahl der beantworteten und übersprungenen Fragen|center|frame]] | [[Datei:umfrage_statistik_liste.png |Statistikansicht mit einer Liste der Fragen und der Anzahl der beantworteten und übersprungenen Fragen|center|frame]] | ||
− | Durch einen Klick auf die Details-Schaltfläche auf der rechten Seite eines jeden Eintrags | + | Durch einen Klick auf die Details-Schaltfläche auf der rechten Seite eines jeden Eintrags gelangt man in die Statistik-Details für diese Frage. |
Die Statistik-Details listen neben den Fragendaten die detaillierte kumulierte Verteilung der Antworten auf. | Die Statistik-Details listen neben den Fragendaten die detaillierte kumulierte Verteilung der Antworten auf. | ||
[[Datei:umfrage_statistik_details.png |Statistik-Details für eine Multiple Choice Frage|center|frame]] | [[Datei:umfrage_statistik_details.png |Statistik-Details für eine Multiple Choice Frage|center|frame]] | ||
− | Um die kumulierte Statistik mit allen Details mit einem externen System weiter zu verarbeiten, | + | Um die kumulierte Statistik mit allen Details mit einem externen System weiter zu verarbeiten, kann man 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 === | === Einfügen einer Umfrage in das Frontend === | ||
− | Um eine bestehende Umfrage in das Contao Frontend einzufügen, damit sie auf Ihrer Website angezeigt wird, | + | Um eine bestehende Umfrage in das Contao Frontend einzufügen, damit sie auf Ihrer Website angezeigt wird, wechselt man im Backend in den Artikelbaum und bearbeiten den Artikel der Seite, in die man die Umfrage einbetten möchte. Man erstellt hierzu ein neues Inhaltselement und wählt den Elementtyp '''Umfrage''' aus. |
− | Aus der Liste der verfügbaren Umfragen | + | Aus der Liste der verfügbaren Umfragen wählt man nun bitte die gewünschte Umfrage und speichern dann die Eingabe. |
Die Umfrage ist nun bereit für die Verwendung. Herzlichen Glückwunsch! | Die Umfrage ist nun bereit für die Verwendung. Herzlichen Glückwunsch! | ||
+ | |||
=== Durchführen einer Umfrage === | === Durchführen einer Umfrage === | ||
Zeile 392: | Zeile 436: | ||
*** Skalen ('''tl_survey_scale''') | *** Skalen ('''tl_survey_scale''') | ||
− | Die Ausgabe einer Umfrage wird durch das Inhaltselement Umfrage (ContentSurvey.php) durchgeführt. Jeder Fragentyp ist ein eigenes Widget: Multiple Choice Frage = FormMultipleChoiceQuestion.php | + | Die Ausgabe einer Umfrage wird durch das Inhaltselement Umfrage (ContentSurvey.php) durchgeführt. Jeder Fragentyp ist ein eigenes Widget:<br /> |
+ | Multiple Choice Frage = FormMultipleChoiceQuestion.php<br /> | ||
+ | Offene Frage = FormOpenEndedQuestion.php<br /> | ||
+ | MatrixFrage = FormMatrixQuestion.php<br /> | ||
+ | Konstante Summe = FormConstanSumQuestion.php.<br /> | ||
+ | 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, | + | Für die Berechnung der Umfrageergebnisse und den Export gibt es für jeden Fragentyp eine eigene Dienstklasse. Damit diese Dienstklassen korrekt eingebunden werden, muss man 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. | Mit dieser Kenntnis sollte es dann möglich sein, eigene Fragentypen zu entwickeln und zu integrieren. | ||
Zeile 442: | Zeile 491: | ||
// MyClass.php | // MyClass.php | ||
− | public function | + | public function surveyFinished($surveydata) |
{ | { | ||
// Do something, e.g. send confirmation mail to participant etc. | // Do something, e.g. send confirmation mail to participant etc. |
Aktuelle Version vom 25. Juli 2013, 17:25 Uhr
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ählt man den Punkt TAN-Erzeugung in den Bearbeitungsoptionen der Umfrage aus.
Erzeugen von TAN-Codes
Man erzeugt neue TAN-Codes für eine Umfrage, indem man die Aktion TAN-Codes erzeugen auswählt.
In dem sich öffnenden Formular gibt man 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 man die TAN-Codes exportieren muss, weil man z.B einen Serienbrief mit einer Einladung zu einer Umfrage an eine größere Gruppe von Teilnehmern versenden will, muss man die Aktion TAN-Codes exportieren auswählen.
Im folgenden Formular hat man die Möglichkeit, die Contao-Seite auszuwählen, auf der man die Umfrage durchführen wird. Wenn man eine Seite auswählt, wird Contao 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).
Man bestätigen die Export-Einstellungen mit der Schaltfläche Exportieren, wird Contao eine Excel-Datei generieren, welche die TAN-Liste enthält. Die Excel-Datei wird direkt zum Download angeboten.
Verwalten der Teilnehmerdaten
Um die Teilnehmerdaten für eine Umfrage zu verwalten, wählt man 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 sieht man statt des Teilnehmernamens lediglich einen Zufallscode, der zur Anonymisierung der Daten generiert werden. In Klammern hinter dem Namen findt man 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
Man kann 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ührt man einen detaillierten Export aller Teilnehmerdaten nach Microsoft Excel durch.
Umfrage-Statistik
Um die statistische Auswertung einer Umfrage zu erhalten, wählt man 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 gelangt man 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, kann man 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, wechselt man im Backend in den Artikelbaum und bearbeiten den Artikel der Seite, in die man die Umfrage einbetten möchte. Man erstellt hierzu ein neues Inhaltselement und wählt den Elementtyp Umfrage aus.
Aus der Liste der verfügbaren Umfragen wählt man nun bitte die gewünschte Umfrage und speichern dann die 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, muss man 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 surveyFinished($surveydata) { // Do something, e.g. send confirmation mail to participant etc. } ?>
--Hschottm 10:30, 11. Sep. 2010 (CEST)