Optionale Einstellungen

Der folgende Abschnitt richtet sich an diejenigen unter Ihnen, die Konfigurationseinstellungen bearbeiten möchten, die mit Hilfe der GUI (Graphical User Interface) der LimeSurvey-Installation nicht geändert werden konnten. Bitte beachten Sie, dass alle Änderungen am LimeSurvey-Stammverzeichnis auf Ihr eigenes Risiko erfolgen. Sollten Sie dennoch auf Probleme stoßen/weitere Beratung benötigen, wenden Sie sich bitte an die LimeSurvey-Community in den Diskussionsforen.

Einleitung

Um die Konfigurationseinstellungen der Installation zu ändern, müssen Sie die optionalen Einstellungen bearbeiten. Diese finden Sie in der Datei `/application/config/`, die sich im LimeSurvey-Stammverzeichnis befindet. Die Standardeinstellungen der Installation sind ebenfalls in `config-defaults.php` enthalten. Einige davon können über den Dialog „Globale Einstellungen“ überschrieben werden, während andere manuell bearbeitet werden müssen.

  Wenn Sie diese Einstellungen ändern möchten, ändern Sie sie bitte nicht in config-defaults.php, sondern kopieren Sie die jeweilige Einstellung bzw. Zeile nach /application/config/config.php in 'config'=>array( ) und ändern Sie sie dort. Alle neu geänderten oder hinzugefügten Einstellungen aus der Datei config.php überschreiben die Standardwerte aus config-defaults.php.

Bei einem Upgrade werden nur die Einstellungen in der Datei config-defaults.php geändert. Daher bleiben Ihre benutzerdefinierten Einstellungen erhalten, wenn Sie die Datei config.php bearbeiten.

Um die LimeSurvey-Einstellungen in /application/config/config.php zu aktualisieren/hinzuzufügen, müssen Sie das Konfigurationsarray aktualisieren:

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Neuer Wert', // Standard-LimeSurvey-Konfiguration hier aktualisieren
 )

Yii-Einstellungen

LimeSurvey verwendet das Yii-Framework, das über eigene Konfigurationsparameter in den Dateien application/config/internal.php und application/config/config.php verfügt. Über die Yii-Konfiguration können Sie auch auf einige spezifische Konfigurationseinstellungen von LimeSurvey zugreifen.

Da das config.php-Array mit der gesamten Konfiguration zusammengeführt wird, können Sie alle Yii-Parameter in der config.php-Datei ersetzen.

Die Yii-spezifischen Einstellungen werden im Komponentenarray festgelegt:

 
 'components' => array(
 'db' => array(
 ....
 ),
 'Spezifische Einstellungen'=>array(
 ....
 ),
 ),

Weitere Informationen zum Yii-Framework finden Sie unter folgendem Link.

Datenbankeinstellungen

Die Datenbankeinstellungen werden von der Installationsdatei in config.php geschrieben, wenn Sie LimeSurvey zum ersten Mal installieren. Bei Bedarf können Sie diesen Teil der Datei config.php aktualisieren. Bitte denken Sie daran, dass Sie dies auf eigenes Risiko tun! Siehe auch die Yii-Dokumentation und bitte Denken Sie daran, dass LimeSurvey nur die folgenden Datenbanktypen unterstützt: mysql, pgsql, dblib, mssql und sqlsrv.

Sitzungseinstellungen

Sie können einige Sitzungsparameter in config.php festlegen (sehen Sie sich die beiden Beispiele unten an). Sie können den benötigten Teil in config.php auskommentieren/hinzufügen. Weitere Einstellungen finden Sie in der Yii-Dokumentation.

  Wenn Sie mehrere LimeSurvey-Instanzen auf derselben Domain betreiben, geben Sie jeder Instanz einen eigenen Sitzungsnamen. Sie müssen weder den Pfad des Sitzungs-Cookies noch die CSRF-Cookie-Einstellungen ändern.

Tabellenbasierte Sitzungen verwenden

LimeSurvey kann tabellenbasierte Sitzungen verwenden. Sie finden einen kommentierten Teil in der standardmäßig generierten Datei config.php. Um eine tabellenbasierte Sitzung zu verwenden, entfernen Sie das // vor jeder Zeile.

 'session' => array (
 'class' => 'application.core.web.DbHttpSession',
 'connectionID' => 'db',
 'sessionTableName' => '{{sessions} }',
 ),

  Tabellenbasierte Sitzungen werden derzeit auf dem MSSQL-Server nicht unterstützt.

Andere Sitzungen aktualisieren

Wenn Sie SSL ("https") für Ihre LimeSurvey Installation nutzen, können die folgenden Zeilen in Ihrer config.php die Sicherheit erhöhen:

        // Setze den Cookie via SSL
        'session' => array (
            'cookieParams' => array(
                    'secure' => true, // use SSL for cookies
                    'httponly' => true // Cookies dürfen nicht von anderen Protokollen genutzt werden
                ),
            ),

Wenn Sie die Domain für einen Cookie setzen möchten, setzen Sie dies in config.php:

        // Set the domain for cookie
        'session' => array (
            'cookieParams' => array(
                    'domain' => '.example.org',
                ),
            ),

Jede LimeSurvey-Instanz auf derselben Domain benötigt einen eigenen Sitzungsnamen. Andernfalls werden Sie beim Anmelden bei einer Instanz von der anderen abgemeldet. Das Installationsprogramm legt in config.php einen zufälligen Sitzungsnamen fest. Wenn Sie die config.php von einer anderen Instanz kopiert haben oder Ihre config.php aus einer Version älter als LimeSurvey 4.0 stammt, fügen Sie die Zeile sessionName im vorhandenen Abschnitt session hinzu oder ändern Sie sie, und verwenden Sie für jede Instanz einen anderen Wert:

        // Set the name of the session
        'session' => array (
            'sessionName' => 'LS-ABCDEFGHIJKLMNOP',
            ),

Anfrageeinstellungen

Die Anfrageeinstellungen sind wichtig, aber die Standardeinstellungen sind bereits für die Verwendung von LimeSurvey optimiert. Weitere Informationen dazu finden Sie in der Yii-Dokumentation.

Beispielsweise kann die Konfiguration der LimeSurvey-Anfrageeinstellungen auf folgende Weise geändert werden (auf eigenes Risiko):

        // CSRF-Schutz deaktivieren
        'request' => array(
            'enableCsrfValidation'=>false,    
            ),

        // Eine bestimmte URL-Basis erzwingen 
        'request' => array(
            'hostInfo' => 'http://www.example.org/'  
            ),

        // Cookie-Domainnamen und -Pfad für den CSRF-Schutz festlegen
        'request' => array(
            'csrfCookie' => array( 
                'domain' => '.example.com',
                'path' => '/limesurvey/',
            )
        ),

Wenn Sie nur die URL für E-Mails mit Zugangscodes aktualisieren müssen, legen Sie Ihre publicurl in Ihrer Datei config.php fest.

Nutzung von Sitzungs- und CSRF-Validierung in iFrames zulassen

Die Aktivierung von „IFrame-Einbettung erlaubt“ in den globalen Sicherheitseinstellungen (Globale Sicherheitseinstellungen) ermöglicht es Browsern lediglich, Ihre Umfragen in einem iFrame anzuzeigen. Damit Teilnehmer eine Umfrage innerhalb eines iFrames ausfüllen und absenden können, müssen Sie außerdem die Einstellungen für Sitzungs- und CSRF-Cookies in der Datei config.php wie unten beschrieben ändern. Beide Cookies müssen mit SameSite=None gesendet werden, was Browser nur über eine gültige HTTPS-Verbindung akzeptieren.

  Trotz all dieser Einstellungen können Umfragen in einem iFrame in einigen Browsern oder mit bestimmten Browsereinstellungen weiterhin fehlschlagen, beispielsweise im privaten Browsermodus oder wenn Cookies von Drittanbietern blockiert sind. Diese Einstellungen wurden mit Firefox 81.0.2 bis 115, Chromium 85.0.4183.121 bis 119 und Edge 119 mit ihren Standardeinstellungen getestet. LimeSurvey bietet für diese Konfiguration keinen Support, es steht lediglich Community-Support zur Verfügung.

Sitzungsstart im Iframe zulassen

Der Session-Cookie muss sicher sein (erfordert eine gültige HTTPS-Verbindung) und auf httponly gesetzt sein; samesite muss deaktiviert sein. Die Schlüssel in cookieParams müssen in Kleinbuchstaben geschrieben werden.

'session' => array (
 'sessionName'=>'LS-VBXZZORFJZCAKGYI',
 // Kommentieren Sie die folgenden Zeilen aus, wenn Sie tabellenbasierte Sitzungen benötigen.
 // Hinweis: Tabellenbasierte Sitzungen sind wird derzeit auf dem MSSQL-Server nicht unterstützt.
 // 'class' => 'application.core.web.DbHttpSession',
 // 'connectionID' => 'db',
 // 'sessionTableName' = > '{{sessions}}',
 'cookieParams' => array(
 'secure' => true,
 'httponly' => true,
 'samesite' => 'None' ,
 ),
 ),

Csrf-Cookie im Iframe zulassen

Wie beim Session-Cookie muss auch der CSRF-Cookie sicher sein, und sameSite muss auf None gesetzt werden. Beachten Sie, dass der Schlüssel hier sameSite lautet. Fügen Sie das gesamte request Array auf derselben Ebene wie session hinzu.

'request' => array(
 'enableCsrfValidation'=>true,
 'csrfCookie' => array(
 'sameSite' => 'None',
 'secure' => true,! N! ),
 ),

URL-Einstellungen

  Wenn Sie nur die URL für Token und andere E-Mails aktualisieren müssen, legen Sie Ihre publicurl in Ihrer config.php-Datei fest.

Um die Standard-URL-Einstellungen zu ändern, aktualisieren Sie urlManager:

 // Kurze URL verwenden
 'urlManager' => array(
 'urlFormat' => 'path',
 'showScriptName' => false,
 ),

Sie können .html auch wie folgt nach der Umfrage-ID hinzufügen:

 // Kurze URL verwenden
 'urlManager' => array(
 'urlFormat' => 'path',
 'rules' => array (
 '<sid:\d+> ' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => false,
 ),

Weitere Informationen finden Sie in der Yii-Dokumentation.

Protokollierungseinstellungen

Yii bietet verschiedene Lösungen zum Generieren von Protokollen. Um mehr darüber zu erfahren, schauen Sie sich das spezielle Thema zur Protokollierung an. LimeSurvey verwendet standardmäßig „1“ oder „2“, wodurch jeder Webbenutzer die Protokolle sehen kann. Sie können Ihre eigenen Einstellungen direkt mit Yii erstellen.

Eine schnelle Lösung zum Protokollieren von Fehlern und Warnungen in Dateien lautet beispielsweise:

 
return array(
 'components' => array(
 /* Anderer Komponententeil hier 'db' zum Beispiel */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'warning, error',
 'exclusive' => 'Exception.CHttpException .404',
 ),
 ),
 ),
 /* Anderer Komponententeil hier 'urlManager' zum Beispiel */
 ),
 /* Schlussteil (mit ' runtimePath' 'config' zum Beispiel) */
);

 Hint: Die application.controller.customInit.max_execution_time und application.controller.customInit.memory_limit Kategorien werden verwendet, um Versuche zur Änderung von PHP-Einstellungen zu protokollieren.

Wenn Sie diese Protokollmeldungen kennen und sie aus den Protokollen ausschließen möchten, können Sie diese Kategorien wie unten gezeigt zur Option except in der Konfiguration Ihrer Log-Route hinzufügen:

'except' => [
    'exception.CHttpException.404',
    'application.controller.customInit.max_execution_time',
    'application.controller.customInit.memory_limit',
],

 Hint: Die Datei wird standardmäßig unter limesurvey/tmp/runtime/application.log gespeichert, das sich im LimeSurvey-Stammordner befindet. Mit logFile können Sie einen anderen Dateinamen festlegen.

  Yii verwendet den Laufzeitpfad. Standardmäßig sind die Protokolle über das Web zugänglich. Sie können viele Informationen von Ihrem Server enthalten. Besser ist es, ein Verzeichnis zu verwenden, auf das nicht über das Web zugegriffen werden kann. Sie können es in logPath festlegen oder indem Sie den Laufzeitpfad aktualisieren.

.

Laufzeitpfad

Der Laufzeitpfad muss ein les- und beschreibbares Verzeichnis für den „Webbenutzer“ sein. Der Laufzeitpfad enthält jedoch Dateien mit potenziellen Sicherheitsinformationen, die sich im öffentlichen Webzugriffsbereich befinden. LimeSurvey sammelt diese Dateien im temporären Verzeichnis des LimeSurvey-Stammverzeichnisses. Um den Zugriff auf solch wichtige Daten zu verhindern, können Sie den Laufzeitpfad außerhalb des öffentlichen Webzugriffs festlegen, indem Sie die entsprechenden Zeilen in der Datei /application/config/config.php bearbeiten:

return array(
 'components' => array(
 […]
 'runtimePath'=>'/var/limesurvey/runtime/',
 'config'=>array( 
 […]
 )
 )
)

Generelle Einstellungen

• sitename: Gibt Ihrer Umfrageseite einen Namen. Dieser Name wird in der Umfrageübersicht und im Administrationsbereich angezeigt. Der Standardwert ist 'LimeSurvey' und kann im Dialogfeld Globale Einstellungen oder in der Datei config.php geändert werden.
• siteadminemail: Dies ist die Standard-E-Mail-Adresse des Website-Administrators und wird für Systemmeldungen und Kontaktoptionen verwendet. Diese Einstellung dient nur als Standardwert und kann im Dialogfeld Globale Einstellungen überschrieben werden.
• showEmailInError: Standard-E-Mail-Adresse des Website-Administrators (siteadminemail) für den Mailto-Link auf der Fehlerseite verwenden. Deaktivieren Sie diese Option, um nur den Namen des Administrators anzuzeigen. Standardmäßig aktiviert, um Spam im Administrationsbereich zu vermeiden.
• siteadminbounce: Dies ist die E-Mail-Adresse, an die unzustellbare E-Mails gesendet werden. Diese Einstellung dient nur als Standardwert und kann im Dialogfeld „Globale Einstellungen“ überschrieben werden.
• siteadminname: Der tatsächliche Name des Website-Administrators. Diese Einstellung dient nur als Standardwert und kann im Dialogfeld „Globale Einstellungen“ überschrieben werden.
• proxy_host_name: Dies ist der Hostname Ihres Proxy-Servers (dieser muss angegeben werden, wenn Sie einen Proxy verwenden und LimeSurvey mit ComfortUpdate aktualisieren möchten).
• proxy_host_port: Dies ist der Port Ihres Proxy-Servers (dieser muss angegeben werden, wenn Sie einen Proxy verwenden und LimeSurvey mit ComfortUpdate aktualisieren möchten).

Sicherheit

• maxLoginAttempt: Dies ist die Anzahl der Versuche, die ein Benutzer hat, das richtige Passwort einzugeben, bevor seine IP-Adresse blockiert bzw. gesperrt wird. Der Standardwert ist 3 und kann in der Datei config.php geändert werden.
• timeOutTime: Wenn der Benutzer das Passwort <maxLoginAttempt>-mal falsch eingibt, wird er für <timeOutTime> Sekunden gesperrt. Der Standardwert beträgt 10 Minuten und kann in der Datei config.php geändert werden.
• maxLoginAttemptParticipants: Dies ist die Anzahl der Versuche, die ein Teilnehmer hat, einen gültigen Zugangscode einzugeben, bevor seine IP-Adresse blockiert bzw. gesperrt wird. Der Standardwert ist 3 und kann in der Datei config.php geändert werden.
• timeOutParticipants: Wenn der Teilnehmer den Zugangscode <maxLoginAttemptParticipants>-mal falsch eingibt, wird er für <timeOutParticipants> Sekunden gesperrt. Der Standardwert beträgt 10 Minuten und kann in der Datei config.php geändert werden.
• surveyPreview_require_Auth: Standardmäßig auf „true“ gesetzt. Wenn Sie dies auf „false“ setzen, kann jede Person Ihre Umfrage über die Umfrage-URL testen, ohne sich im Administrationsbereich anzumelden und ohne die Umfrage zuvor aktivieren zu müssen. Diese Einstellung ist ein Vorgabewert und kann im Dialog Globale Einstellungen überschrieben oder in der Datei config.php bearbeitet werden.
• usercontrolSameGroupPolicy: Standardmäßig auf „true“ gesetzt. Standardmäßig können Benutzer ohne Administratorrechte, die in der LimeSurvey-Verwaltungsoberfläche definiert sind, nur Benutzer sehen, die sie selbst erstellt haben oder die mindestens derselben Gruppe angehören. Der Vorgabewert kann im Dialog Globale Einstellungen überschrieben oder in der Datei config.php bearbeitet werden.
• demoMode: Wenn diese Option in der Datei config.php auf „true“ gesetzt ist, wechselt LimeSurvey in den Demo-Modus. Der Demo-Modus ändert Folgendes:
  • Deaktiviert die Änderung der Details und des Passworts von Administratorbenutzern;
  • Deaktiviert das Hochladen von Dateien im Vorlagen-Editor;
  • Deaktiviert den Versand von E-Mail-Einladungen und -Erinnerungen;
  • Deaktiviert die Erstellung eines Datenbank-Dumps;
  • Deaktiviert die Möglichkeit, die folgenden globalen Einstellungen zu ändern: Sitename, Standardsprache, Standard-HTML-Editormodus, XSS-Filter.
• forcedsuperadmin: Array von Benutzerkennungen mit allen Rechten für ganz LimeSurvey. Diese Einstellung kann nur in der Datei config.php aktualisiert werden. Die Rechte dieser Benutzer können unter Globale Berechtigungen für einen Benutzer auch von anderen erzwungenen Super-Administratoren nicht bearbeitet werden. Standardmäßig ist dies der Benutzer mit der Kennung 1, also der erste Benutzer, der direkt nach der Installation erstellt wurde.
• force_ssl: Erzwingt, dass LimeSurvey über HTTPS ausgeführt wird, oder blockiert HTTPS. Siehe Erzwinge HTTPS in der Benutzeroberfläche der globalen Einstellungen.
• ssl_emergency_override: Diese Einstellung schaltet SSL zwangsweise aus. Wenn Sie HTTPS/SSL in den globalen Einstellungen aktiviert haben, Ihr Server jedoch kein HTTPS unterstützt, können Sie es nur durch direktes Ändern eines Werts in der Datenbank ausschalten. Damit können Sie HTTPS erzwungen ausschalten, während Sie die globalen Einstellungen für „Force Secure“ ändern. Dieser Wert sollte immer „false“ sein, außer in Notfällen, in denen Sie ihn auf „true“ setzen, bis das Problem behoben ist. Diese Einstellung kann nur über die Datei config.php vorgenommen werden.
• ssl_disable_alert: Deaktiviert die Warnung für den Super-Administrator über nicht erzwungenes SSL, falls Sie SSL nicht erzwingen können oder wollen. Diese Einstellung kann nur über die Datei config.php vorgenommen werden.
• allow_unserialize_attributedescriptions: Erlaubt das Deserialisieren (mit der PHP-Funktion unserialize) von Zugangscode-Attributen beim Importieren oder Lesen eines Umfrageobjekts. Die Daten der Zugangscode-Attribute werden als JSON gespeichert. Wenn Sie eine Umfragedatei aus einer sehr alten LimeSurvey Version importieren und deren Zugangscode-Attribute benötigen, müssen Sie diese Einstellung aktivieren. Warnung: Die Deserialisierung kann dazu führen, dass Code durch Objektinstanziierung und Autoloading geladen und ausgeführt wird, und ein böswilliger Benutzer kann dies unter Umständen ausnutzen. Diese Einstellung kann nur über die Datei config.php vorgenommen werden.
• allow_unserialize_attachments: Erlaubt das Deserialisieren (mit der PHP-Funktion unserialize) von Anhangsattributen beim Importieren einer Umfrage. In LimeSurvey 6.16.17 wurde das Anhangsattribut von serialize auf json_encode umgestellt. Wenn Sie Anhänge beim Importieren alter LSS-Dateien behalten möchten, müssen Sie dies erlauben. Warnung: Die Deserialisierung kann dazu führen, dass Code durch Objektinstanziierung und Autoloading geladen und ausgeführt wird, und ein böswilliger Benutzer kann dies unter Umständen ausnutzen. Diese Einstellung kann nur über die Datei config.php vorgenommen werden.
• twig_getConfig_extraallowlist: Ermöglicht es, bestimmte Elemente für die Funktion getConfig in Twig zuzulassen. LimeSurvey erlaubt bereits die meisten benötigten und verwendeten Einstellungen, aber möglicherweise benötigen Sie weitere. Wenn Sie „securesetting“ und „anothersetting“ erlauben möchten, setzen Sie dies auf ['securesetting','anothersetting'], also so: 'twig_getConfig_extraallowlist' => ['securesetting','anothersetting']. Diese Einstellung kann nur über die Datei config.php vorgenommen werden.

Schutz vor Cross-Site-Scripting (XSS)

LimeSurvey erlaubt keine Benutzerskripte auf der Administrationsseite. Sollten Sie dennoch eine Möglichkeit finden, ein XSS-Skript auf der Administrationsseite einzufügen, lesen Sie bitte unsere Sicherheitsrichtlinie.

Die Skripte der öffentlichen Seite werden durch XSS-Filtereinstellungen verwaltet.

• filterxsshtml: Diese Einstellung aktiviert das Filtern verdächtiger HTML-Tags in Umfragen, Gruppen und Frage-Antwort-Texten der Verwaltungsoberfläche. Lassen Sie diese Option nur dann auf „false“, wenn Sie den von Ihnen für die LimeSurvey-Administration erstellten Benutzern absolut vertrauen und ihnen die Verwendung von JavaScript, Flash-Filmen usw. erlauben möchten. Die HTML-Inhalte von Super-Admins werden nie gefiltert . Der Standardwert kann im Dialogfeld „Globale Einstellungen“ überschrieben werden.
• filterxsshtml_forcedall: Erzwingt die Aktivierung filterxsshtml für alle Benutzer und deaktiviert Aktualisierungen in der Verwaltungsoberfläche. Aktiviert das Filtern verdächtiger HTML-Tags auch für Super-Admins.
• filterxsshtml_allowforcedsuperadmin: Wird nur verwendet, wenn filterxsshtml_forcedall auf „true“ gesetzt ist. Hinzufügen von Skripten und HTML durch forcedsuperadmin (standardmäßig Administratorbenutzer #1) zulassen.
• disablescriptwithxss: Aktualisierung des betreffenden Skripts zulassen: Standardmäßig true: XSS-Regeln befolgen; auf false setzen, um es für alle Benutzer zuzulassen. Der Standardwert kann im Dialogfeld Globale Einstellungen überschrieben werden.
• filterxsshtml_enablescript: Wird nur verwendet, wenn filterxsshtml_forcedall auf true gesetzt ist. Frageskript für bestimmten Benutzer aktivieren: gui : Aktualisierung der Einstellungen über die GUI zulassen; superadmin : Nur Superadmin; forcedsuperadmin : Nur erzwungener Superadmin; Standardmäßig: Kein Benutzer und keine Aktualisierung über die GUI zulassen

Zulässiger Datei-Upload

• allowedthemeimageformats: Zulässige Bilddateitypen für den Upload im Themenbereich. SVG-Dateien sind aufgrund potenzieller XSS-Angriffe standardmäßig deaktiviert.
• allowedthemeuploads: Weitere zulässige Dateitypen für den Upload im Themenbereich (ZIP-Datei).
• allowedresourcesuploads: Zulässige Dateitypen für den Upload im Ressourcenbereich und mit dem HTML-Editor.
• allowedpluginuploads: Zulässige Dateitypen beim Hochladen von Plugin-ZIP-Dateien.

Geben Sie einfach eine durch Kommas getrennte Zeichenkette mit den Dateierweiterungen ein. Zum Beispiel:

 'allowedthemeimageformats' => 'jpg,jpeg,gif,png,webm,svg',

Warnung: Seien Sie beim Hochladen von Dateien stets vorsichtig. Es ist mit schädlichen Aktivitäten zu rechnen.

Plugins

• usePluginWhitelist: Wenn diese Option aktiviert ist, können Plugins, die nicht auf der Zulassungsliste (siehe 'pluginWhitelist') stehen, weder installiert noch geladen werden. Dies kann bereits installierte Plugins deaktivieren.
• pluginWhitelist: Liste der Plugin-Namen, deren Installation und Laden erlaubt ist, wenn 'usePluginWhitelist' aktiviert ist. Kern-Plugins sind implizit auf der Zulassungsliste.
• corePluginBlacklist: Liste der Kern-Plugin-Namen, deren Verwendung verboten ist, wenn 'usePluginWhitelist' aktiviert ist.
• disablePluginUpload: Wenn diese Einstellung aktiviert ist, ist die Funktion „Plugin-Upload“ deaktiviert.

Host-Kontrolle

• allowedHosts : Um Host-Header-Injection zu vermeiden, können Sie die zulässigen Hosts für alle Aktionen festlegen. Wenn Sie für die öffentliche Seite und die Admin-Seite unterschiedliche Hosts verwenden, müssen Sie beide als zulässige Hosts festlegen.

 
 'config'=>array(
 ....
, // Standard-LimeSurvey-Konfiguration hier aktualisieren
 'allowedHosts' => [
 'survey.example.org',
 'proxy.survey.example.com',
 'example.limesurvey.org',
 ],
 ),

Ressourcen

• iSessionExpirationTime: Legt die Zeit in Sekunden fest, nach der eine Umfragesitzung abläuft. Dies gilt nur, wenn Sie Datenbanksitzungen verwenden. Falls Sie Datenbanksitzungen verwenden, ändern Sie den Parameter in der Datei config.php oder überschreiben Sie den Vorgabewert im Dialog Globale Einstellungen.
• memory_limit: Legt fest, wie viel Arbeitsspeicher LimeSurvey nutzen kann, in Megabyte. Der Vorgabewert ist '256'. Wenn Timeout-Fehler auftreten oder Probleme beim Erzeugen von Statistiken oder beim Exportieren von Dateien auftreten, erhöhen Sie diesen Wert auf '512' oder höher. Wenn Ihr Webserver in der Datei php.ini ein höheres Limit festgelegt hat, wird diese Einstellung ignoriert.

Bitte beachten Sie, dass solche lokalen Einstellungen durch globalen Server-Einstellungen überschrieben werden können.

Zur Erhöhung der Speicherlimits auf 128M könnten Sie auch folgendes versuchen:

• memory_limit = 128M in der PHP-Konfigration Ihres Servers (php.ini-Datei) setzen (empfohlen, wenn Sie Zugriff haben)
• memory_limit = 128M in einer php.ini Datei im LimeSurvey Stammverzeichnis
• php_value memory_limit 128M in einer .htaccess-Datei im LimeSurvey Stammverzeichnis

• max_execution_time: Legen Sie die Anzahl der Sekunden fest, die ein Skript ausführen darf. Wenn dieser Wert erreicht ist, gibt das Skript einen schwerwiegenden Fehler zurück. Um große Umfragedaten und Statistiken exportieren zu können, versucht LimeSurvey, diese standardmäßig auf 1200 Sekunden festzulegen. Sie können bei Bedarf eine größere oder eine kürzere Zeit einstellen. Nur über PHP-Konfigurationsdatei zugänglich.

Darstellung

• repeatheadings: Beim Fragetyp „Array“ haben Sie oft viele Teilfragen, die – wenn sie auf dem Bildschirm angezeigt werden – mehr als eine Seite einnehmen. Mit dieser Einstellung legen Sie fest, wie viele Teilfragen angezeigt werden sollen, bevor die Kopfzeileninformationen der Frage wiederholt werden. Ein guter Wert hierfür liegt bei etwa 15. Wenn die Überschriften gar nicht wiederholt werden sollen, setzen Sie den Wert auf 0. Diese Einstellung wird im Dialog Globale Einstellungen überschrieben.
• minrepeatheadings: Die Mindestanzahl der verbleibenden Teilfragen, die erforderlich ist, bevor die Überschriften in Array-Fragen wiederholt werden. Der Vorgabewert ist 3 und kann in der Datei config.php bearbeitet werden.
• defaulttheme: Diese Einstellung legt die Standard-Designvorlage fest, die für die „öffentliche Liste“ der Umfragen verwendet wird. Diese Einstellung kann im Dialog Globale Einstellungen überschrieben oder in der Datei config.php bearbeitet werden.
• defaulthtmleditormode: Legt den Standardmodus für den integrierten HTML-Editor fest. Diese Einstellung kann im Dialog Globale Einstellungen überschrieben oder in der Datei config.php bearbeitet werden. Die gültigen Einstellungen sind:
  • 'inline' - Inline-Ersetzung von Feldern durch einen HTML-Editor. Langsam, aber praktisch und benutzerfreundlich;
  • 'popup' - Fügt ein Symbol hinzu, das den HTML-Editor bei Bedarf in einem Popup startet. Schneller, aber der HTML-Code wird im Formular angezeigt;
  • 'none'- Kein HTML-Editor;
• column_style: Legt fest, wie Spalten für Umfrageantworten dargestellt werden, wenn display_columns verwendet wird. Dies kann in der Datei config.php bearbeitet werden. Die gültigen Einstellungen sind:
  • 'css' - Es wird eine der verschiedenen CSS-Methoden zum Erstellen von Spalten verwendet (Einzelheiten finden Sie im Stylesheet der Vorlage);
  • 'ul' - Die Spalten werden als mehrere gleitende, ungeordnete Listen dargestellt (Standard);
  • 'table' - Es wird ein herkömmliches, tabellenbasiertes Layout verwendet;
  • NULL - Die Verwendung von Spalten wird deaktiviert.

Language & time

• defaultlang: Dies sollte auf die Standardsprache eingestellt werden, die in Ihren Verwaltungsskripten verwendet werden soll, und auch auf die Standardeinstellung für die Sprache in der öffentlichen Umfrageliste. Diese Einstellung kann im Dialog globale Einstellungen überschrieben oder in config.php bearbeitet werden.
• timeadjust: Wenn sich Ihr Webserver in einer anderen Zeitzone als der Standort befindet Ihre Umfragen basieren darauf, geben Sie hier die Differenz zwischen Ihrem Server und Ihrer Heimatzeitzone ein. Ich lebe beispielsweise in Australien, verwende aber einen US-amerikanischen Webserver. Der Webserver liegt 14 Stunden hinter meiner lokalen Zeitzone. Meine Einstellung hier ist also „14“. Mit anderen Worten: Es verlängert die Zeit des Webservers um 14 Stunden. Diese Einstellung ist besonders wichtig, wenn Umfragen die Antworten mit einem Zeitstempel versehen. Diese Einstellung kann im Dialog globale Einstellungen überschrieben oder in config.php bearbeitet werden.

Umfrageverhalten

• deletenonvalues: Verwenden Sie diese Funktion mit Vorsicht. Standardmäßig (Wert 1) werden irrelevante Fragen in der Datenbank auf NULL gesetzt. Dadurch ist sichergestellt, dass die Daten in Ihrer Datenbank intern konsistent sind. Es gibt jedoch seltene Fälle, in denen Sie irrelevante Werte möglicherweise behalten möchten. In diesem Fall können Sie den Wert auf 0 setzen. Ein Beispiel: Sie fragen einen Mann nach seinem Geschlecht, er antwortet versehentlich „weiblich“ und beantwortet dann einige frauenspezifische Fragen (Fragen, die an das weibliche Geschlecht gebunden und daher nur für Frauen relevant sind). Dann bemerkt er seinen Fehler, geht zurück, setzt das Geschlecht auf „männlich“ und setzt die Umfrage fort. Nun sind die frauenspezifischen Fragen irrelevant. Wenn $deletenonvalues==1, werden diese irrelevanten Werte in der Datenbank gelöscht (auf NULL gesetzt). Wenn $deletenonvalues==0, werden seine fehlerhaften Antworten nicht gelöscht und sind somit bei der Analyse weiterhin in der Datenbank vorhanden.
• shownoanswer: Wenn eine Frage vom Typ Optionsfeld/Auswahl mit bearbeitbaren Antworten (z. B. Listen- oder Array-Fragen) nicht obligatorisch ist und „shownoanswer“ auf 1 gesetzt ist, wird zusätzlich der Eintrag „Keine Antwort“ angezeigt, damit die Teilnehmer die Frage nicht beantworten müssen. Manche bevorzugen es, wenn dieser Eintrag nicht verfügbar ist. Diese Einstellung kann im Dialog Globale Einstellungen überschrieben oder in der Datei config.php bearbeitet werden. Gültige Werte sind:
  • '0': Nein;
  • '1': Ja;
  • '2': Der Umfrageadministrator kann wählen.
• printanswershonorsconditions: Diese Einstellung legt fest, ob die Funktion zum Drucken von Antworten auch Einträge von Fragen anzeigt, die durch Bedingungsverzweigung ausgeblendet wurden (Standard: 1 = Antworten von Fragen ausblenden, die durch Bedingungen ausgeblendet wurden).
• showpopups: Popup-Meldungen anzeigen, wenn obligatorische oder bedingte Fragen nicht korrekt beantwortet wurden:
  • '2' = durch die Option der Designvorlage festgelegt (Standard)
  • '1'= Popup-Meldung anzeigen;
  • '0'= stattdessen Meldung auf der Seite anzeigen;
  • '-1'= Meldung überhaupt nicht anzeigen (in diesem Fall sehen Benutzer weiterhin die fragespezifischen Hinweise, welche Fragen beantwortet werden müssen).

Numerisches Fragetypverhalten

• bFixNumAuto: Numerische Felder können automatisch gefiltert werden, um alle nicht numerischen Werte zu entfernen. Standardmäßig ist dies aktiviert. Sie können es global deaktivieren. Diese Einstellungen beziehen sich auf „Automatisch numerischen Wert korrigieren“ in den Kerndesignoptionen. Es wurde für „Ja“ aktiviert, für „Nur für Ausdruck“ und „Nein“ deaktiviert.
• bNumRealValue: Im Ausdrucksmanager verwendete numerische Felder können festgelegt werden oder nicht. Es ist standardmäßig behoben. Wenn NUMERIC eine numerische Frage ist: deaktivieren oder 0: {NUMERIC} mit falschen Zeichen senden '' , aktivieren oder 1 : {NUMERIC} alle eingegebenen Zeichen senden. Diese Einstellungen beziehen sich auf „Automatisch numerischen Wert korrigieren“ in den Kerndesignoptionen. Es wurde für „Ja“ und „Nur für Ausdruck“ aktiviert und für „Nein“ deaktiviert.

Entwicklung und Debugging

• debug: Mit dieser Einstellung setzen Sie die PHP-Fehlerberichterstattung auf E_ALL. Das bedeutet, dass jeder noch so kleine Hinweis, jede Warnung und jeder Fehler im Zusammenhang mit dem Skript angezeigt wird. Diese Einstellung sollte nur dann auf '1' gesetzt werden, wenn Sie aus irgendeinem Grund die Anwendung debuggen möchten. Wenn Sie Entwickler sind, setzen Sie sie auf '2'. Setzen Sie sie im Produktivbetrieb nicht auf '1' oder '2', da dies zur Offenlegung von Pfaden führen kann. Der Vorgabewert ist '0' und kann in der Datei config.php bearbeitet werden.
• debugsql: Aktivieren Sie diese Einstellung, wenn Sie alle für das Skript ausgeführten SQL-Abfragen am Ende jeder Seite anzeigen möchten. Sehr nützlich für die Optimierung der Anzahl der Abfragen. Um sie zu aktivieren, ändern Sie in der Datei config.php den Vorgabewert auf '1'.
• use_asset_manager: Standardmäßig deaktiviert der Debug-Modus den Asset Manager. Sie können die Verwendung des Asset Managers auch bei aktiviertem Debug-Modus erlauben.
• rpc_log: ^{(New in 7.9.0 )} Setzen Sie diese Einstellung auf true, um jeden RemoteControl-Aufruf in tmp/runtime/remotecontrol.log zu protokollieren. Jede Zeile enthält die aufgerufene Methode, ihre Parameter, die IP-Adresse des Clients, die Dauer und den Anfang der Antwort. Passwörter werden entfernt, Sitzungsschlüssel durch einen kurzen Hash ersetzt und lange Werte gekürzt. Das Protokoll enthält weiterhin die gesendeten und empfangenen Umfrage-, Teilnehmer- und Antwortdaten. Aktivieren Sie die Einstellung daher nur, während Sie nach einem Problem suchen. Der Vorgabewert ist false.

Für den Fall, dass in der Anwendung ein Fehler auftritt, empfehlen wir dringend, die Debug-Einstellung zu aktivieren, um einen detaillierteren Fehler zu erhalten, den Sie mit dem Fehlerbericht einreichen können:

    'config'=>array(
        'debug'=>2,
        'debugsql'=>0,
    )

Wenn Sie an einem Plugin arbeiten und eine schnelle Möglichkeit benötigen, Variablen auf dem Bildschirm auszugeben, können Sie die Funktion „traceVar“ verwenden. Wenn Debug eingestellt ist: Diese Funktion verwendet CWebLogRoute, um auf der HTML-Seite angezeigt zu werden. Verwendung traceVar($MyVariable)

E-Mail-Einstellungen

Alle unten aufgeführten Einstellungen können im Dialog Globale Einstellungen überschrieben werden.

• 'emailmethod: Dies bestimmt, wie E-Mail-Nachrichten gesendet werden. Die folgenden Optionen sind verfügbar:
  • 'mail:' Es wird der interne PHP-Mailer verwendet;
  • 'sendmail:' Es wird der Sendmail-Mailer verwendet;
  • 'smtp:' Es wird SMTP-Relaying verwendet. Verwenden Sie diese Einstellung, wenn Sie LimeSurvey auf einem Host betreiben, der nicht Ihr Mailserver ist.
• 'emailsmtphost: Wenn Sie 'smtp' als $emailmethod verwenden, müssen Sie hier Ihren SMTP-Server angeben. Wenn Sie Google Mail verwenden, müssen Sie möglicherweise die Portnummer hinzufügen, z. B. $emailsmtphost = 'smtp.gmail.com:465'.
• emailsmtpuser: Wenn Ihr SMTP-Server eine Authentifizierung benötigt, setzen Sie dies auf Ihren Benutzernamen, andernfalls muss das Feld leer bleiben.
• emailsmtppassword: Wenn Ihr SMTP-Server eine Authentifizierung benötigt, setzen Sie dies auf Ihr Passwort, andernfalls muss das Feld leer bleiben.
• emailsmtpssl: Setzen Sie dies auf 'ssl' oder 'tls', um SSL/TLS für die SMTP-Verbindung zu verwenden.
• maxemails: Beim Versenden von Einladungen oder Erinnerungen an Umfrageteilnehmer legt diese Einstellung fest, wie viele E-Mails in einem Stapel gesendet werden können. Verschiedene Webserver haben unterschiedliche E-Mail-Kapazitäten. Wenn Ihr Skript zu lange braucht, um einen Stapel E-Mails zu senden, kann es zu einer Zeitüberschreitung des Skripts und zu Fehlern kommen. Die meisten Webserver können innerhalb des standardmäßigen Zeitlimits von 30 Sekunden für ein PHP-Skript 100 E-Mails auf einmal senden. Wenn Sie beim Senden einer großen Anzahl von E-Mails Fehler wegen Skript-Zeitüberschreitung erhalten, verringern Sie die Zahl in dieser Einstellung. Ein Klick auf die Schaltfläche „Sende E-Mail Einladung“ in der Symbolleiste der Zugangscode-Verwaltung (nicht auf die Schaltfläche rechts neben jedem Zugangscode) sendet die Anzahl <maxemails> an Einladungen. Anschließend wird eine Liste der Adressen der Empfänger angezeigt, zusammen mit einer Warnung, dass mehr E-Mails ausstehen, als in einem Stapel gesendet werden konnten. Setzen Sie den E-Mail-Versand fort, indem Sie unten klicken. Es müssen noch ### E-Mails gesendet werden. sowie eine Schaltfläche „Weiter“, um mit dem nächsten Stapel fortzufahren. Das heißt, der Benutzer bestimmt, wann der nächste Stapel gesendet wird, nachdem jeder Stapel verschickt wurde. Sie müssen nicht warten, während dieser Bildschirm aktiv ist. Der Administrator kann sich abmelden und zu einem späteren Zeitpunkt zurückkehren, um den nächsten Stapel Einladungen zu senden.
• send_error_saving_results_email: ^{(New in 7.8.0 )} Wenn eine Antwort nicht gespeichert werden kann, sendet LimeSurvey die Antworten in einer E-Mail mit dem Betreff „Fehler beim Speichern der Ergebnisse“ an den Umfrageadministrator. Setzen Sie die Einstellung auf false, um diese E-Mails zu unterbinden. Teilnehmer sehen weiterhin die Fehlermeldung. Der Vorgabewert ist true. Diese Einstellung kann nur in der Datei config.php geändert werden.

Statistiken und Durchsuchen von Antworten

• filterout_incomplete_answers: Steuert das Standardverhalten beim Filtern unvollständiger Antworten, wenn Sie Antworten durchsuchen oder analysieren. Eine Erläuterung zu unvollständigen Antworten finden Sie in unserem Wiki zum Durchsuchen von Umfrageergebnissen. Da diese Datensätze die Statistiken verfälschen können, gibt es in mehreren GUI-Formularen die Möglichkeit, diesen Filter ein- oder auszuschalten. Der Parameter kann in der config.php bearbeitet werden. Die folgenden Optionen stehen zur Verfügung:
  • 'all': Ermöglicht die Anzeige sowohl vollständiger als auch unvollständiger Antworten;
  • 'complete': Es werden nur vollständige Antworten angezeigt;
  • 'incomplete': Es werden nur unvollständige Antworten angezeigt.
• strip_query_from_referer_url: Diese Einstellung bestimmt, ob die Weiterleitungs-URL den Parameter speichert oder nicht. Der Vorgabewert ist „false“ (in diesem Fall speichert die Weiterleitungs-URL alle Parameter). Alternativ kann dieser Wert auf „true“ gesetzt werden; dann wird der Parameterteil der Weiterleitungs-URL entfernt.
• showaggregateddata: Wenn aktiviert, werden zusätzliche statistische Werte wie das Arithmetische Mittel und die Standard Abweichung angezeigt. Außerdem werden die Daten aggregiert, um einen schnelleren Überblick zu erhalten. Beispielsweise werden die Ergebnisse der Skalen 1+2 und 4+5 addiert, um eine allgemeine Rangfolge wie „gut“ (1/2), „durchschnittlich“ (3) und „schlecht“ (4/5) zu erhalten. Dies betrifft nur die Fragetypen „A“ (5-Punkte-Anordnung) und „5“ (5 Punkte Auswahl).
• PDF-Exporteinstellungen: Diese Funktion aktiviert den PDF-Export für druckbare Umfragen und Antworten drucken. Die PDF-Exportfunktion ist völlig experimentell und das Ergebnis ist alles andere als perfekt. Leider kann derzeit kein Support geleistet werden – wenn Sie bei der Behebung helfen möchten, nehmen Sie bitte Kontakt mit uns auf.
  • 'pdfdefaultfont': Dies ist die Standardschriftart, die von der PDF-Exportfunktion verwendet wird. Der Vorgabewert ist „auto“. Um sie zu ändern, müssen Sie sie auf eine der PDF-Kernschriftarten setzen.
  • 'alternatepdffontfile': Dies ist ein Array mit Sprachschlüsseln und der jeweils zugehörigen Schriftart. Die Standardschriftart für jede Sprache kann in der Datei config.php ersetzt werden;
  • 'pdffontsize': Gibt die Schriftgröße für normale Texte an. Für den Titel der Umfrage gilt <pdffontsize>+4, für den Gruppentitel <pdffontsize>+2. Sie kann in der Datei config.php oder im Dialogfeld Globale Einstellungen bearbeitet werden.
• Grafikeinstellung
  • 'chartfontfile': Legt den Dateinamen der Schriftartdatei fest, die zum Erstellen der statistischen Diagramme verwendet wird. Die Datei muss sich im Verzeichnis „fonts“ im LimeSurvey-Stammordner befinden. Sie kann in der Datei config.php bearbeitet werden;
  • 'alternatechartfontfile': Dies ist ein Array mit Sprachschlüsseln und der jeweils zugehörigen Schriftart. Es kann in der Datei config.php bearbeitet werden.
• showsgqacode: Diese Einstellung wird bei der Funktion „Druckbare Umfrageversion“ verwendet und ist standardmäßig auf „false“ gesetzt. Wenn Sie showsgqacode = 'true'; festlegen, werden die IDs jeder Frage – und gegebenenfalls der Antwort – angezeigt. Diese IDs entsprechen den Spaltenüberschriften in der Tabelle Lime_survey_12345, die die Antwortdaten einer bestimmten Umfrage enthält. Diese IDs können für ein Codebuch für manuelle Datenbankabfragen verwendet werden.

LDAP Einstellungen (Englisch)

Dieses ausführliche Kapitel wurde verschoben, aber noch nicht übersetzt: LDAP Einstellungen.

Authentifikation

Die Authentifizierung wird über Plugins abgewickelt. Die folgenden Einstellungen werden vom Plugin für die Webserver-Authentifizierung verwendet, siehe Authentifizierungs-Plugins.

Delegieren der Anmeldung am Webserver

Systemadministratoren möchten ihre Umfrageadministratoren unter Umständen über ein zentrales Authentifizierungssystem (Active Directory, openLdap, Radius, ...) authentifizieren, anstatt die interne LimeSurvey-Datenbank zu verwenden. Ein einfacher Weg dazu ist, die Webserver-Software so einzurichten, dass sie dieses externe Authentifizierungssystem verwendet, und LimeSurvey anschließend der vom Webserver gemeldeten Benutzeridentität vertrauen zu lassen. Um diese Funktion zu aktivieren, müssen Sie:

• das Plugin Webserver unter Konfiguration > Plugins aktivieren und in den Plugin-Einstellungen den Server-Schlüssel festlegen, der den Benutzernamen enthält (Vorgabewert: REMOTE_USER);
• die Authentifizierung auf der Webserver-Seite aktivieren.

Bitte beachte:

• LimeSurvey wird dann seinen eigenen Login-Prozess umgehen (durch Nutzung eines Loginnamens ohne Abfrage eines Passwortes);
• Das kann nur das LimeSurvey-Administrations-Loginsystem ersetzen, nicht das Umfragen-Einladungssystem (Benutzerschnittstelle)

Delegieren der Anmeldung ohne Import der Benutzer

Bitte beachte, dass standardmäßig eine Delegierung der Anmeldung nicht das Authentifizierungssystem von LimeSurvey außer Kraft setzt===: Dies bedeutet, dass LimeSurvey dann zwar keine Passwörter verwaltet, trotzdem aber in der DB die User mit den entsprechenden Berechtigungen eingetragen werden müssen, um Zugriff auf die Umfragenresourcen zu erhalten.

Ein Benutzer erhält nur dann Zugriff auf LimeSurvey, wenn:

• er am Webserver authentifiziert wurde;
• sein Anmeldename als Benutzer in der LimeSurvey-Benutzerdatenbank definiert ist (der Benutzer erhält dann die Berechtigungen des in der LimeSurvey-Benutzerdatenbank definierten Benutzers);
• er die globale Berechtigung Verwende Web-Server-Authentifizierung besitzt.

Delegieren der Anmeldung mit Import der Benutzer

Wenn Sie eine sehr große Benutzerdatenbank verwalten, ist es manchmal einfacher, Benutzer automatisch in die LimeSurvey-Datenbank zu importieren:

• auth_webserver_autocreate_user: Wenn auf „true“ gesetzt, versucht LimeSurvey, Benutzer, die vom Webserver authentifiziert wurden, aber noch nicht in der Benutzerdatenbank vorhanden sind, automatisch zu importieren.
• auth_webserver_autocreate_profile: Ein Array, das das Standardprofil beschreibt, das dem Benutzer zugewiesen wird: den (fiktiven) Vor- und Nachnamen, die E-Mail-Adresse und die Sprache.
• auth_webserver_autocreate_permissions: Ein Array mit den globalen Berechtigungen, die dem Benutzer zugewiesen werden.

Wenn Sie das Benutzerprofil so anpassen möchten, dass es dem angemeldeten Benutzer entspricht, müssen Sie in der config.php eine einfache Funktion namens hook_get_auth_webserver_profile entwickeln. Mit dieser Funktion können Sie aus einer zentralen Benutzerkontendatenbank (zum Beispiel aus einem LDAP-Verzeichnis) den tatsächlichen Vor- und Nachnamen, die E-Mail-Adresse und die Sprache eines bestimmten Benutzers abrufen.

Die Funktion hook_get_auth_webserver_profile erhält den Anmeldenamen des Benutzers als einziges Argument und kann Folgendes zurückgeben:

• False oder ein leeres Array – in diesem Fall wird dem Benutzer der Zugriff auf LimeSurvey verweigert;
• ein Array mit denselben Einträgen wie auth_webserver_autocreate_profile.

function hook_get_auth_webserver_profile($user_name)
{
    // Retrieve user's data from your database backend (for instance LDAP) here
    // ... get $user_name_from_backend
    // ... get $user_email_from_backend
    // ... get $user_lang_from_backend
    return array(
        'full_name' => $user_name_from_backend,
        'email' => $user_email_from_backend,
        'lang' => $user_lang_from_backend,
    );
}

// If user should be denied access, return an empty array
// return array();

  Die optionale Funktion „hook_get_auth_webserver_profile“ ist nur für die Verwendung durch fortgeschrittene Benutzer bestimmt! Für weitere Details lesen Sie bitte die Kommentare aus der Datei config-defaults.php.

Umschreibung des Benutzernamens

In einigen Fällen haben User einen anderen externen Namen als den LimeSurvey Usernamen, vielleicht ist deshalb das folgende Feature des Umschreibens der Namen sinnvoll. Dies wird in LimeSurvey durch den $userArrayMap Parameter erledigt. Z.B. gibt es keinen 'admin' Usernamen in einer externen DB. Um trotzdem als 'admin' eingeloggt zu werden muss der externe Benutzername, nennen wir ihn 'myname', umgeschrieben werden. Das sieht dann so aus:

'config'=>array(
...
'auth_webserver_user_map' => array ('myname' => 'admin');
)

Nach einer erfolgreichen Anmeldung mit dem 'myname' Loginnamen und des Passwortes wird man direkt als LimeSurvey 'Admin' Benutzer akzeptiert.

Diese Option ist sicherheitsrelevant, deshalb nur sorgsam benutzen und die config.php vor Schreibzugriff vom Webserver schützen!

Einmalpasswörter

Ein Benutzer kann die LimeSurvey-Anmeldeseite unter default.com/limesurvey/admin öffnen und den Benutzernamen und das Einmalpasswort eingeben, die zuvor von einer externen Anwendung in die Benutzertabelle (Spalte one_time_pw) geschrieben wurden.

Diese Einstellung muss in der Datei config.php aktiviert werden, um die Verwendung von Einmalkennwörtern zu ermöglichen (Standard = falsch).

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'use_one_time_passwords'=>true,
 )

Weitere Informationen finden Sie im Abschnitt Abschnitt „Benutzer verwalten“.

Verschlüsselungseinstellungen

  Einmal festgelegte Verschlüsselungsschlüssel sollten niemals geändert werden, da sonst alle verschlüsselten Daten verloren gehen könnten!

Einzelheiten zu dieser Funktion finden Sie unter Datenverschlüsselung.

• encryptionkeypair
• encryptionpublickey
• encryptionsecretkey
• encryptionnonce
• encryptionsecretboxkey

Erweiterte URL-Einstellungen

• publicurl: Hier sollte die URL Ihrer öffentlichen Skripte angegeben werden. Die öffentlichen Skripte befinden sich im Ordner „limesurvey“ (oder dem von Ihnen gewählten Namen für das Verzeichnis, in dem alle anderen Skripte und Verzeichnisse gespeichert sind). Diese Einstellung finden Sie in der Datei config.php. Sie wird verwendet, wenn LimeSurvey eine absolute URL benötigt (z. B. beim Versenden von Token-E-Mails).
• tempurl: Hier sollte die URL Ihres Verzeichnisses „/limesurvey/tmp“ angegeben werden – oder ein Verzeichnis, in dem LimeSurvey temporäre Dateien bereitstellen soll.
• uploadurl: Hier sollte die URL Ihres Verzeichnisses „/limesurvey/upload“ angegeben werden – oder ein Verzeichnis, in dem LimeSurvey hochgeladene Dateien bereitstellen soll. Dadurch können Sie hochgeladene Dateien auf einer anderen URL-Domain speichern.

Erweiterte Ordner Einstellungen

• homedir: Dies sollte auf den physischen Speicherort Ihrer Administrationsskripte auf der Festplatte gesetzt werden – zum Beispiel „/home/usr/htdocs/limesurvey/admin“. Fügen Sie diesem Eintrag keinen abschließenden Schrägstrich hinzu. Die Standardeinstellung in der config.php versucht, den Stammpfad aller Ihrer Dokumente mithilfe der PHP-Variable {$_SERVER['DOCUMENT_ROOT']} zu ermitteln. In den meisten Fällen können Sie dies belassen und nur den Rest dieser Zeichenfolge so ändern, dass er dem Verzeichnisnamen entspricht, in dem Sie die LimeSurvey-Skripte abgelegt haben.
• publicdir: Dies sollte auf den physischen Speicherort Ihrer „öffentlichen Skripte“ auf der Festplatte gesetzt werden.
• tempdir: Dies sollte auf den physischen Speicherort Ihres Verzeichnisses /limesurvey/tmp auf der Festplatte gesetzt werden, damit das Skript Dateien lesen und schreiben kann.
• uploaddir: Dies sollte auf den physischen Speicherort Ihres Verzeichnisses /limesurvey/upload auf der Festplatte gesetzt werden, damit das Skript Dateien lesen und schreiben kann.
• sCKEditorURL: URL des CKEditor-Skripts.

Andere erweiterte Einstellungen

Dateien hochladen

• magic_database: Ermöglicht die Verwendung einer anderen MIME-Datenbank für finfo_open. Kann nur in der Datei config.php geändert werden. Beispiel: /usr/share/misc/magic.mgc für Red-Hat-basierte Linux-Systeme.
• magic_file: Ermöglicht die Verwendung einer anderen Datei als der mitgelieferten, um das Array der Dateierweiterungen nach MIME-Typ abzurufen. Es muss sich um eine PHP-Datei handeln, die ein Array zurückgibt. Kann nur in der Datei config.php geändert werden.

Aktualisieren

• aktualisierbar: Diese Einstellung befindet sich in version.php. Kann wahr oder falsch sein. Wenn Sie „true“ festlegen: Wenn sich ein Superadministrator-Benutzer anmeldet, prüft LimeSurvey, ob ein Update verfügbar ist, und zeigt Ihnen eine Warnung an. Bei „false“ wird keine Prüfung durchgeführt und Sie können ComfortUpdate nicht verwenden.

Zugangscodes

• allowedcharacters_pattern_token : Mit diesen Einstellungen kann das Regexp-Muster beim Filtern von Token festgelegt werden.