====== 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.

===== EMFF für mp3-Audiodateien =====

Um im Fragebogen Audio-Dateien im mp3-Format abzuspielen, eignet sich EMFF ([[http://emff.sourceforge.net|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/''.

  - Die SWF-Dateien des EMFF (im Paket im Verzeichnis /skins) in ein Verzeichnis von SoSci Survey kopieren, vorzugsweise ''plugins/emff/''
  - 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.
  - Wenn das Speichern funktioniert hat, kann man künftig mp3-Dateien einfach beim **Fragebogen zusammenstellen** aus der Auswahlliste in den Fragebogen ziehen.

===== reCaptcha =====

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 [[http://www.google.com/recaptcha| reCaptcha]] von Google einbinden. Dafür benötigt man einen privaten und öffentlichen Schlüssel, um auf reCaptcha zuzugreifen. Diesen erhält man von Google auf der [[http://www.google.com/recaptcha| reCaptcha Homepage]].

Das Schlüsselpaar muss man in der **Server-Verwaltung** bei **Erweiterungen** eintragen. Anschließend kann die Captcha-Frage wie jede andere Frage im Fragebogen verwendet werden.

===== Google Translate =====

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 [[https://code.google.com/apis/console/?api=translate|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.

===== Verbotene E-Mail-Adressen =====

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. [[http://www.mogelmail.de|mogelmail.de]]. Allerdings ist die Liste mittlerweile nicht mehr als Datei abrufbar. Das Installationspaket von SoSci Survey enthält eine veraltete Liste dieses Anbieters.

===== Panel-Modul =====

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 [[https://www.soscisurvey.de/panel|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.


===== Frage-Module =====

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.