Erweiterungen

SoSci Survey unterstützt einige Erweiterungen zur Verwendung in Befragungsprojekten oder bei der Server-Verwaltung. Diese Kapitel beschreibt, wie die Erweiterungen auf einem Server installiert werden.

Um im Fragebogen Audio-Dateien im mp3-Format abzuspielen, eignet sich EMFF (Easy Musicplayer For Flash) sehr gut. Damit nicht jeder Projektleiter die Dateien des Players hochladen und mit HTML-Code jonglieren muss, kann SoSci Survey den EMFF direkt ansprechen. Um EMFF direkt zu nutzen, sind folgende Schritte notwendig.

Hinweis: Das Installationspaket von SoSci Survey enthält den EMFF-Player bereits im Verzeichnis plugins/emff/.

1. Die SWF-Dateien des EMFF (im Paket im Verzeichnis /skins) in ein Verzeichnis von SoSci Survey kopieren, vorzugsweise plugins/emff/
2. In der Server-Verwaltung unter Server-Einstellungen bei Erweiterungen das Verzeichnis eintragen, z.B. „plugins/emff“ und speichern. Falls SoSci Survey den EMFF nicht im angegeben Verzeichnis findet, erscheint eine Fehlermeldung.
3. Wenn das Speichern funktioniert hat, kann man künftig mp3-Dateien einfach beim Fragebogen zusammenstellen aus der Auswahlliste in den Fragebogen ziehen.

Mit einem Captcha kann im Fragebogen überprüft werden, ob der Teilnehmer ein Mensch oder nur ein Computer ist. Zur Anzeige von Captchas im Fragebogen kann SoSci Survey das Modul reCaptcha von Google einbinden. Dafür benötigt man…

1. Einen privaten und öffentlichen Schlüssel, um auf reCaptcha zuzugreifen. Diesen erhält man von Google auf der reCaptcha Homepage.
2. Die reCAPTCHA PHP library, die z.B. in plugins/reCaptcha entpackt wird. Notwendig ist dabei nur die Datei recaptchalib.php.

Hinweis: Das Installationspaket von SoSci Survey enthält die Datei recaptchalib.php bereits im Verzeichnis plugins/reCaptcha/ – und zusätzlich 4 Grafik-Dateien, die als Vorschau-Bilder für die unterschiedlichen Darstellungsoptionen dienen.

Anschließend muss man in der Server-Verwaltung bei Erweiterungen noch den relativen Pfad zum reCaptcha-PlugIn eintragen (z.B. plugins/reCaptcha) sowie die beiden Schlüssel. Anschließend kann die Captcha-Frage wie jede andere Frage im Fragebogen verwendet werden.

SoSci Survey kann die Übersetzung von Fragebögen unter Sprachversionen → Übersetzungshilfe aktiv unterstützen. Dabei werden die Textbausteine zur automatischen Übersetzung an Google Translate weitergeleitet. Der Projektleiter kann diese Übersetzungen anschließend prüfen, korrigieren und übernehmen.

Um den kostenpflichtigen Übersetzungs-Dienst von Google zu verwenden, benötigt man einen API Key (Schlüssel). Zur Erzeugung des Schlüssels benötigt man ein Google-Konto, mit dem man sich auf der Google API Konsole einloggt. Für den (neuen) API Key muss die Funktion „Translate API“ aktiviert werden. Den API Key trägt man anschließend in den Server-Einstellungen von SoSci Survey ein.

Hinweis: Der eingetragene API Key wird unverschlüsselt in der Konfiguration von SoSci Survey gespeichert. Verwenden Sie diesen Schlüssel nur für Google Translate und nutzen Sie für andere Services andere Schlüssel.

Hinweis: Bei der automatischen Übersetzung werden die Texte an die API (Application Programming Interface) des Unternehmens Google übermittelt, dort verarbeitet und u.U. gespeichert und analysiert.

Falls bei der Registrierung bestimmte E-Mail-Adressen oder Domains gesperrt werden sollen, können entsprechende Listen z.B. im Verzeichnis plugins/trashmail/ gespeichert werden. Das Verzeichnis (nicht die Liste) muss in den Server-Einstellungen → Erweiterungen eingetragen werden.

SoSci Survey lädt bei einer Registrierung alle Dateien in dem Verzeichnis. Die Zeilen können entweder…

• eine E-Mail-Adresse (z.B. max.mustermann@beispiel.de),
• eine Domain (z.B. beispieldomain.de) oder
• einen Kommentar enthalten, der mit einem Sharp-Zeichen (#) beginnt (z.B. # Liste vom 24.12.2010)

Falls auf die E-Mail-Adresse oder Domain noch etwas folgt (z.B. ein Tabulator, ein Semikolon, ein Kommentar), wird dies ignoriert.

Eine Liste von Wegwerf-E-Mail-Adressen pflegt z.B. mogelmail.de. Allerdings ist die Liste mittlerweile nicht mehr als Datei abrufbar. Das Installationspaket von SoSci Survey enthält eine veraltete Liste dieses Anbieters.

SoSci Survey bringt einen Fragetyp mit, um E-Mail-Adressen von Teilnehmern getrennt von den anderen Daten zu erheben. Dieser Fragetyp kann die E-Mail-Adresse auf Wunsch auch in einen Befragten-Pool eintragen. Entwickelt wurde diese Funktion für das SoSci Panel, einem Schwesterprojekt von SoSci Survey.

Damit diese Option angezeigt wird, muss ein Panel-PlugIn installiert werden. Das Modul kann prinzipiell auch für andere Teilnehmer-Pools als das SoSci Panel (Software OpenPool) verwendet werden. Das Modul ist einfach ein PHP-Script mit dem Namen interface.OpenPool.php. Dieses Script muss in das Plugin-Verzeichnis (etwa plugins/OpenPool/) gespeichert werden und eine Funktion OpenPool::addParticipant($email, $ref) bereitstellen. Diese Funktion wird aufgerufen, sobald eine E-Mail-Adresse in das Panel eingetragen werden soll. Als Parameter wird die E-Mail-Adresse und eine Referenz zum aktuellen Befragungsprojekt (dessen Verzeichnis) übergeben.

SoSci Survey verwendet für die Darstellung von Fragen einzelne Module, zu finden im Verzeichnis modules/. Prinzipiell können so auch neue Frage-Typen einfach integriert werden – allerdings sind die Funktionen der Module bisher nicht dokumentiert.