Actions

Optionale Einstellungen

From LimeSurvey Manual

Revision as of 08:10, 2 August 2023 by Maren.fritz (talk | contribs)

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, treten Sie den Diskussionsforen oder dem IRC Kanal für Hilfe von der LimeSurvey-Community.

Einführung

Um die Konfigurationseinstellungen der Installation zu ändern, müssen Sie die optionalen Einstellungen bearbeiten. Sie finden sie in der Datei /application/config/config-defaults.php, die sich im LimeSurvey-Stammverzeichnis befindet. Die Standardeinstellungen der Standardinstallation finden Sie in config-defaults.php. Einige davon können über den Dialog globale Einstellungen überschrieben werden, während die anderen 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/Zeile nach /application/config/config.php in 'config'=>array( ) und dort ändern. Alle neu geänderten/eingeführten Einstellungen aus der Datei config.php überschreiben die Standardwerte aus config-defaults.php.


Bei einem Upgrade werden nur die Einstellungen von config-defaults.php geändert. Daher werden durch Bearbeiten der Datei config.php Ihre benutzerdefinierten Einstellungen gespeichert.

Um die LimeSurvey-Einstellungen in /application/config/config.php zu aktualisieren/hinzufü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(
 ....
 ),
 ),

Template:Hinweis

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 die Sitzungseinstellungen aktualisieren müssen, damit mehrere LimeSurvey-Instanzen auf demselben Server ausgeführt werden, prüfen Sie, ob Sie Anfrageeinstellungen für das CRSF-Cookie nicht aktualisieren müssen.


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',
                ),
            ),

Wenn Sie mehrere Installationen auf demselben Server haben, kann es schneller und einfacher sein, für jede LimeSurvey-Instanz einen anderen Sitzungsnamen festzulegen. Dies kann unter bestimmten Bedingungen für IE11 erforderlich sein (siehe Ausgabe 12083)

 // Den Namen der Sitzung festlegen
 'session' => array (
 'sessionName' => "LimeSurveyN1",
 ),

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/' 
 ),
 // Legen Sie den Cookie-Domänennamen und -Pfad für den CSRF-Schutz fest. Der Pfad wird verwendet, wenn Sie eine andere Instanz in derselben Domäne haben
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'path' => '/limesurvey/',
 ) 
 ),

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


Nutzung der Sitzung und Csrf-Validierung in iFrame zulassen

Nachdem Sie Iframe-Einbettung zugelassen haben, müssen Sie einige Konfigurationsteile aktualisieren.

'Achtung: Diese Lösung funktioniert nicht in allen Browsern zuverlässig, selbst wenn alle Einstellungen vorgenommen wurden.

Eine bessere und 100 % zuverlässige Lösung kann nur gewährleistet werden, wenn die Framing-Site dieselbe Root-Domain verwendet.

Diese Einstellungen wurden mit Firefox 81.0.2 und Chromium 85.0.4183.121 getestet.

Sitzungsstart im Iframe zulassen

Die Sitzung muss sicher (gültiges https), httponly und samesite auf None sein. Alle Einstellungen müssen auf Kleinbuchstaben eingestellt sein.

'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

Identisch mit Sitzung: muss sicher sein und samesite auf „Keine“ gesetzt sein. Das gesamte Array muss auf derselben Ebene wie die Sitzung hinzugefügt werden.

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

URL-Einstellungen

Um das gleiche Verhalten wie die alte 'Fancy URL "-Funktion zu habenhaben, können Sie die urlManager aktualisieren:

       // Nutze kurze  URLs
		'urlManager' => array(
			'urlFormat' => 'path',
			'showScriptName' => false,
		),

Adding .html after the survey id

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

Mehr Informationen finden Sie in der Yii Dokumentation.

  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 Datei wird standardmäßig gespeichert unter <code>limesurvey/tmp/runtime/application.log</code>, das sich im LimeSurvey-Stammordner befindet.

Alert|Yii verwendet den Laufzeitpfad. Standardmäßig sind die Protokolle über das Internet 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 Routen 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 erscheint in der Übersicht der Umfrageliste und im Verwaltungskopf. Der Standardwert ist „LimeSurvey“ und kann im Dialogfeld „Globale Einstellungen“ überschrieben oder in config.php bearbeitet werden.
  • siteadminemail: Dies ist die Standard-E-Mail-Adresse von Der Site-Administrator wird für Systemnachrichten und Kontaktmöglichkeiten verwendet. Diese Einstellung wird nur als Standardwert verwendet und kann im Dialogfeld Globale Einstellungen überschrieben werden.
  • siteadminbounce: Dies ist die E-Mail-Adresse, an die zurückgesendete E-Mails gesendet werden. Diese Einstellung wird nur als Standardwert verwendet und kann im Dialogfeld Globale Einstellungen überschrieben werden.
  • siteadminname: Der tatsächliche Name des Site-Administrators. Diese Einstellung wird nur als Standardwert verwendet und kann im Dialog globale Einstellungen überschrieben werden.
  • ''proxy_host_name: Dies ist der Hostname Ihres Proxyservers (er hat muss erwähnt werden, wenn Sie sich hinter einem Proxy befinden und LimeSurvey mit ComfortUpdate aktualisieren möchten).
  • ''proxy_host_port: Dies ist der Port Ihres Proxy-Servers (er muss sein). wird erwähnt, wenn Sie sich hinter einem Proxy befinden und LimeSurvey mit ComfortUpdate aktualisieren möchten.

Sicherheit

  • 'maxLoginAttempt: Dies ist die Anzahl der Versuche, die ein Benutzer hat, um das richtige Passwort einzugeben, bevor seine IP-Adresse gesperrt/gesperrt wird. Der Standardwert ist 3 und kann in config.php geändert werden.
  • timeOutTime: Wenn der Benutzer das Passwort falsch eingibt<maxLoginAttempt> , sie oder er wird ausgesperrt<timeOutTime> Sekunden. Der Standardwert beträgt 10 Minuten und kann in config.php geändert werden.
  • maxLoginAttemptParticipants: Dies ist die Anzahl der Versuche, die ein Teilnehmer hat, um einen gültigen Token einzugeben, bevor er oder sie ihn erhält IP-Adresse blockiert/gesperrt. Der Standardwert ist 3 und kann in config.php geändert werden.
  • 'timeOutParticipants: Wenn der Teilnehmer den Token falsch eingibt<maxLoginAttemptParticipants> , sie oder er wird ausgesperrt<timeOutParticipants> Sekunden. Der Standardwert beträgt 10 Minuten und kann in 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 zuerst aktivieren zu müssen. Diese Einstellung ist ein Standardwert und kann im Dialogfeld globale Einstellungen überschrieben oder in config.php bearbeitet werden.
  • usercontrolSameGroupPolicy: Standardmäßig auf true gesetzt. Standardmäßig können in der LimeSurvey-Verwaltungsoberfläche definierte Nicht-Administratorbenutzer nur die von ihnen erstellten Benutzer oder Benutzer sehen, die mindestens derselben Gruppe angehören. Der Standardwert kann im Dialogfeld globale Einstellungen überschrieben oder in config.php bearbeitet werden.
  • filterxsshtml: Diese Einstellung ermöglicht das Filtern verdächtiger HTML-Tags in Umfragen. Gruppen sowie Frage- und Antworttexte in der Administrationsoberfläche. Lassen Sie dies nur dann auf „false“, wenn Sie den Benutzern, die Sie für die Verwaltung von LimeSurvey erstellt haben, absolut vertrauen und wenn Sie diesen Benutzern die Verwendung von Javascript, Flash-Filmen usw. ermöglichen möchten. Der HTML-Code der Superadministratoren wird niemals gefiltert . Der Standardwert kann im Dialog globale Einstellungen überschrieben oder in config.php bearbeitet werden.
  • demoMode: Wenn diese Option in config.php auf 'true' gesetzt ist , dann wechselt LimeSurvey in den Demo-Modus. Der Demomodus ändert die folgenden Dinge:
    • Deaktiviert die Details des Admin-Benutzers und die Änderung des Passworts;
    • Deaktiviert das Hochladen von Dateien im Vorlageneditor;
    • Deaktiviert das Senden von E-Mail-Einladungen und Erinnerungen;!N !** Deaktiviert die Erstellung eines Datenbank-Dumps;
    • Deaktiviert die Möglichkeit, die folgenden globalen Einstellungen zu ändern: Site-Name, Standardsprache, Standard-HTML-Editormodus, XSS-Filter.
  • forcedsuperadmin:' Array von Benutzer-IDs mit allen Rechten für alle LimeSurvey. Diese Einstellungen können nur in der Datei config.php aktualisiert werden. Die Rechte dieses Benutzers können nicht in globale Berechtigungen für einen Benutzer bearbeitet werden, auch nicht durch einen anderen erzwungenen Superadministrator. Standardmäßig ist der Benutzer mit diesen Rechten der Benutzer mit der ID: 1. Der erste Benutzer, der direkt nach der Installation erstellt wurde.
  • force_ssl: zwingt LimeSurvey, über HTTPS zu laufen oder HTTPS zu blockieren. Siehe Force HTTPS in der Admin-GUI für globale Einstellungen.
  • ssl_emergency_override: Diese Einstellung erzwingt die Deaktivierung von SSL. Wenn Sie HTTPS/SSL in den globalen Einstellungen aktiviert haben, HTTPS auf Ihrem Server jedoch nicht aktiviert ist, können Sie es nur deaktivieren, indem Sie einen Wert direkt in der Datenbank ändern. Dadurch können Sie HTTPS erzwingen, während Sie die globalen Einstellungen für Force Secure ändern. Dies sollte immer „false“ sein, außer in Notfällen, in denen Sie es in „true“ ändern, bis Sie das Problem behoben haben. Diese Einstellung kann nur über die Datei config.php festgelegt werden.
  • ssl_disable_alert: Deaktivieren Sie die Warnung für Superadministratoren über nicht erzwungenes SSL, wenn Sie SSL wirklich nicht erzwingen können oder wollen. Diese Einstellung kann nur über die Datei config.php festgelegt werden.

Resources

  • 'sessionlifetime: Definiert die Zeit in Sekunden, nach der eine Umfragesitzung abläuft. Dies gilt nur, wenn Sie Datenbanksitzungen verwenden. Wenn Sie Datenbanksitzungen verwenden, ändern Sie den Parameter in config.php oder überschreiben Sie den Standardwert im Dialogfeld globale Einstellungen.
  • memorylimit: Dies bestimmt, wie viel Speicher LimeSurvey hat kann Zugreifen. „128 MB“ ist das empfohlene Minimum (MB=Megabyte). Wenn Sie Zeitüberschreitungsfehler erhalten oder Probleme beim Generieren von Statistiken oder beim Exportieren von Dateien haben, erhöhen Sie dieses Limit auf „256 MB“ oder höher. Wenn Ihr Webserver in der config.php 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.

Appearance

  • dropdownthreshold (Obsolete since 2.50): Wenn „R“ für $dropdowns ausgewählt ist, kann der Administrator eine maximale Anzahl von Optionen festlegen, die als Optionsfelder angezeigt werden , bevor es wieder in eine Dropdown-Liste konvertiert wird. Wenn es eine Frage mit einer großen Anzahl von Optionen gibt, kann die gleichzeitige Anzeige aller Optionen als Optionsfelder unhandlich wirken und für Benutzer kontraintuitiv sein. B. 25 (Standardeinstellung), bedeutet, dass große Listen von den Administratoren einfacher für den Umfrageteilnehmer verwendet werden können.
  • repeatheadings: Mit dem Fragetyp Array Sie werden oft viele Unterfragen haben, die – wenn sie auf dem Bildschirm angezeigt werden – mehr als eine Seite einnehmen. Mit dieser Einstellung können Sie entscheiden, wie viele Unterfragen angezeigt werden sollen, bevor die Kopfzeileninformationen für die Frage wiederholt werden. Eine gute Einstellung hierfür liegt bei etwa 15. Wenn Sie nicht möchten, dass sich die Überschriften überhaupt wiederholen, setzen Sie diese auf 0. Diese Einstellung wird im Dialogfeld globale Einstellungen überschrieben (New in 2.05 ) .
  • minrepeatheadings:' Die Mindestanzahl der verbleibenden Unterfragen, die erforderlich sind, bevor die Überschriften in Array-Fragen wiederholt werden. Der Standardwert ist 3 und kann in config.php bearbeitet werden.
  • defaulttemplate: Diese Einstellung gibt das Standardthema an, das für die „öffentliche Liste“ der Umfragen verwendet wird. Diese Einstellung kann im Dialog globale Einstellungen überschrieben oder in 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 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 bei Bedarf den HTML-Editor in einem Popup ausführt. Schneller, aber HTML-Code wird in der Form angezeigt;
    • 'none'- Kein HTML-Editor;
  • column_style: Definiert, wie Spalten für Umfrageantworten gerendert werden, wenn Anzeigespalten. Es kann in der Datei config.php bearbeitet werden. Die gültigen Einstellungen sind:
    • 'css' – es verwendet eine der verschiedenen CSS-Methoden zum Erstellen von Spalten (Einzelheiten finden Sie im Template-Stylesheet);
    • 'ul' – die Spalten werden als mehrere gerendert schwebende ungeordnete Listen (Standard);
    • 'table' – es verwendet ein herkömmliches, auf Tabellen basierendes Layout;
    • NULL – es deaktiviert die Verwendung von Spalten.

Sprache und Zeit

  • $defaultlang: Mit diesem Wert bestimmt man die Standardsprache, welche im Administratoren-Skript und als Standardspracheinstellung für öffentliche Umfrage verwendet wird. Über das Administratoren-Skript kann dieser Wert für öffentliche Umfragen für jede Umfrage einzeln festgelegt werden. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • $timeadjust: Sollte der Webserver in einer anderen Zeitzone beheimatet sein, als Umfrage durchgeführt wird, kann hier die Differenz Server und der Umfragen-Zeitzone eingetragen werden. Beispiel: Umfrage in Australien und Webserver in den USA, dann ist der Webserver 14 Stunden hinter der Uhrzeit vor Ort. In diesem Fall muss hier der Wert "14" eingetragen werden. Dann werden 14 Stunden zur Uhrzeit des Webservers addiert. Diese Einstellung ist besonders bei Umfragen in Kombination mit Zeit- und Datumsstempel wichtig. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • $modrewrite: (Obsolete since 2.0) Wenn auf 1 gesetzt, wird das "schöne-URL Feature" aktiviert (Beispiel: http://survey.example.com/123456/lang-fr/tk-sdlfkjozeiru statt http://survey.example.com/index.php?sid=123456⟨=fr&token;=sdlfkjozeiru). Vor der Aktivierung muss== die "htaccess.txt" in ".htaccess" umbenannt werden. Dazu ist ein Apache Web-Server mit korrekt installiertem mod_rewrite-Module Pflicht!

Umfrageverhalten

  • $allowmandbackwards: Ein Wert von "1" erlaubt es Umfrageteilnehmern zu einer früheren Frage zurückzukehren, auch wenn die Teilnehmer eine Frage, welche unbedingt beantwortet werden muss ausgelassen haben.  Bei einem Wert von "0" muss diese Frage beantwortet werden, ansonsten kann man nicht zur früheren Frage zurückkehren.
  • $deletenonvalues: Dieser Wert bestimmt, ob die Antwort einer Frage, welche durch eine Änderung einer vorhergehenden Frage nicht beantwortet werden muss gespeichert werden soll oder nicht. Was damit gemeint wird, kann man wohl am Besten mit einem Beispiel erklären: Bei einem Wert von "0", wird die Antwort auf Frage "B", welche nur gezeigt wird, wenn bei Frage "A" eine bestimme Antwort gewählt wird gespeichert, auch wenn im Nachhinein die Antwort auf Frage "A" geändert wird und Frage "B" dann gar nicht mehr angezeigt wird. Einige Benutzer wünschen diese Einstellung, nach dem Motto, man kann gar nicht genug Informationen sammeln, andere wiederum wollen nur Antworten haben, welche bei einem korrekten und logischen Fragebogendurchlauf gesammelt werden. Bei einem Wert von "1" werden die redundanten Informationen nicht gespeichert.
  • $shownoanswer: Mit einem Wert von "0" kann man bei Frage, welche nicht beantwortet werden müssen die Antwortkategorie "keine Antwort" global abschalten. Bei einem Wert von "1" wird bei editierbaren Antwortkategorien (Liste, Feld), welche nicht verpflichtend beantwortet werden müssen automatisch die Kategorie "keine Antwort" hinzugefügt. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • $printanswershonorsconditions: Diese Einstellung legt fest, ob beim "Fragen drucken"-Feature die Fragen ausgeblendet werden, die wegen vom Nutzer gesetzter Bedingungen nicht angezeigt wurden. (Standard: 1 = zeige durch Bedingungen ausgeblendete Fragen nicht an)
  • $hide_groupdescr_allinone: Diese Einstellung ist relevant für alle 'all-in-one' Umfragen, welche Bedingungen benutzen (New in 1.85 ). Wenn aktiviert, werden der Gruppenname und die Beschreibung von allen Fragen der Gruppe versteckt. (Standard: true (Verstecke Gruppennamen und Beschreibungen wenn alle Bedingungen in der Gruppe durch Bedingungen versteckt werden))
  • $showpopups: Zeige Popups, wenn Fragen nicht richtig beantwortet wurden. 1 = Popup (Standard), 0 = Nachricht stattdessen auf der Seite anzeigen.

Numerical question type behavior

  • bFixNumAuto: Numeric fields can be automatically filtered to remove all non numeric values. By default this is enable, you can disable it globally. This settings is related to Fix automatically numeric value in core theme options. It was enable for Yes, disable for Only for expression and No.
  • bNumRealValue: Numeric fields used in expression manager can be fixed or not. It's fixed by default. If NUMERIC is a numerical question : disable or 0 : {NUMERIC} with bad caracters send '', enable or 1 : {NUMERIC} send all character entered. This settings is related to Fix automatically numeric value in core theme options. It was enable for Yes and Only for expression and disable for No.

Entwicklung

  • $debug: Mit diesem Wert kann festgelegt werden, dass alle PHP-Fehler angezeigt werden (E_ALL). Das bedeutet, dass wirkliche jede kleine Notiz, Warnung und Fehler im Skript berichtet wird. Diese Einstellung sollte nur aktiviert werden (=1), wenn einem Fehler im Skript auf den Grund gegangen werden soll. Programmierer sollten dies auf 2 setzen. Desweiteren sollte dieser Wert nicht aktiviert werden, wenn LimeSurvey zu produktiven Zwecken eingesetzt wird, da sonst Pfade offengelegt werden könnten. (Standardeinstellung: 0)

Wenn ein Fehler in der Anwendung auftritt, empfehlen wir dringend, die Debug-Einstellung zu aktivieren, so dass Sie in der Regel ein wesentlich ausführlichere Fehlermeldung erhalten, die Sie mit dem Fehlerbericht einreichen können:

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

If you work on plugin and need a quick way to dump variables on screen : you can use traceVar function. If debug is set : this function use CWebLogRoute to be shown on HTML page. Usage traceVar($MyVariable)

E-Mail-Einstellungen

Alle diese Einstellungen werden durch die globalen Einstellungen überschrieben ( (New in 1.87 )).

  • emailmethod: Dieser Wert legt fest, auf welche Art E-Mail von LimeSurvey versendet werden. Folgende Optionen stehen zur Auswahl:
    • mail: benutzt den integrierten PHP-Mailer zum Versenden
    • sendmail: benutzt sendmail zum Versenden
    • smtp: benutzt SMTP zum Versenden. Nutzen Sie diese Option, wen der Webserver nicht der Mailserver ist.
  • emailsmtphost: Bei der Verwendung von "smtp" zum Versenden ($emailmethod) muss hier der SMTP-Server eingetragen werden. Bei Google Mail ist es eventuell notwendig die Portnummer mit anzugeben, Beispiel: $emailsmtphost = 'smtp.gmail.com:465';
  • emailsmtpuser: Bei der Verwendung von "smtp" zum Versenden ($emailmethod) und wenn der Server eine Authentifizierung verlangt, muss hier der Benutzername eingetragen werden, ansonsten muss der Wert freigelassen werden.
  • emailsmtppassword: Bei der Verwendung von "smtp" zum Versenden ($emailmethod) und wenn der Server eine Authentifizierung verlangt, muss hier das Passwort eingetragen werden, ansonsten muss der Wert freigelassen werden.
  • emailsmtpssl: Auf 'ssl' oder 'tls' setzen, um SSL/TLS für SMTP-Verbindungen zu benutzen.
  • maxemails: Wenn Einladungs- oder Erinnerungs-Emails an Umfrageteilnehmer verschickt werden sollen, legt dieser Wert fest, wie viele E-Mails auf einmal versendet werden. Es gibt verschiedene Arten von Webservern und einige neigen dazu, dass bei einer großen Anzahl an gleichzeitig versendeten E-Mails ein Time-Out Fehler entsteht. Die meisten E-Mail-Server können 100 E-Mails innerhalb des 30sec-Limits des PHP-Skripts versenden. Sollte ein Timeout-Fehler auftreten, sollte dieser Wert entsprechend verringert werden. Durch Klicken des 'Email-Einladung-Senden' Buttons in der Token Control-Toolbar, (nicht der Button rechts von jedem Token), sendet die maximale Nummer von Mail-Einladungen und zeigt dann eine Liste der Adressen an, denen eine Einladung zugesellte wurden. Da drunter steht "Es gibt mehr Adressen, als die, die in einem Durchlauf angemailt werden konnten. Fortsetzung des Versands durch Drücken des Buttons. ### Mails müssen noch gesendet werden." und ein "Fortsetzen-Button", um den nächsten Durchgang zu starten. Der Admin kann sich ausloggen, und später zurückkommen, um die fehlenden Einladungen zu senden.

Statistiken

  • $usejpgraph: (Obsolete since 1.8) Wenn die JPGraph-Bibliothek auf dem Server richtig konfiguriert ist (Achtung: jede PHP-Version benötigt eine andere Version), kann mit dieser Erweiterung im Statistik-Teil von LimeSurvey die Ergebnisausgabe als Kreis- und Balken-Diagramme aktiviert werden. ("1" - aktiviert, "0" - abgeschaltet). Achtung: Experimentelles Feature!
  • $jpgraphdir: (Obsolete since 1.8) Das physikalische Verzeichnis auf dem das jpgraph-Skript zu finden ist. Diese Einstellung wird nur benötigt, wenn "$usejpgraph" aktiviert ist. Sollte eine Änderung dieses Wertes nicht den gewünschten Effekt bringen, muss diese Einstellung in der JPGraph Installation vorgenommen werden. Dazu muss in der Datei "jpg-config.inc" der Wert "Define ("TTF_DIR", "....../") auskommentiert werden und das entsprechende Verzeichnis dort eingefügt werden.
  • $jpgraphfont: (Obsolete since 1.8) Jene Schriftart, welche von JPGraph verwendet werden soll. "FF_FONT1" sollte auf jedem Server funktionieren.
  • $embedded: (Obsolete since 2.0) Wenn LimeSurvey in eine andere Seite integrieren werden soll, dann kann mit dieser Einstellung das Senden des HTML-Header abgeschaltet werden und stattdessen auf die Header-Methode einer anderen Funktion verweisen. Dies ist zwar eher ein "dirty hack", sollte aber für eine schnelle Integration reichen.
  • $filterout_incomplete_answers: Auf "true" setzen, wenn gewünscht wird, dass LimeSurvey unvollständige Antworten standardmäßig beim Anzeigen von Antworten und in der Auswertung/Statistik automatisch ausschließen soll. Für weitere Infos zu diesem Thema gibt es unter "Umfrageergebnisse ansehen". Aufgrund der Tatsache, dass dieser Wert die Ergebnisse in der Statistik sehr stark (auch negativ) beeinflussen kann, wurde zudem eine Option im Backend eingebaut, mit der man diesen Filter ein- bzw. ausschalten kann. Die folgenden Optionen sind verfügbar:
    • show: Zeige vollständige und unvollständige Daten
    • filter: Zeige nur vollständige Antworten
    • incomplete: Zeige nur unvollständige Antworten
  • $stripQueryFromRefurl: Mit diesem Wert wird festgelegt, ob mit der Referrer-URL Parameter gespeichert werden oder nicht. Standardmäßig ist der Wert "false" eingestellt und die Referrer-URL wird mit allen Parametern gespeichert. Alternativ kann dieser Wert auf "true" gesetzt werden und es wird nur die URL ohne Parameter gespeichert.
  • $showaggregateddata: (New in 1.8 ) Diese Einstellung ist standardmäßig aktiviert und sorgt dafür, dass zusätzliche Werte wie arithmetisches Mittel und Standardabweichung bei der Auswertung angezeigt werden. Weiterhin werden Ergebnisse zusammengefasst, um einen schnellen Überblick zu erhalten. So werden bei 5er Skalen die Daten von 1+2 sowie von 4+5 zusammengefasst, um allgemeine Aussagen wie "gut" (1/2), "mittel" (3) und "schlecht" (4/5) zu erhalten. Diese Funktionen betreffen nur die Fragetypen "A" (5 Punkte Array) und "5" (5 Punkte Auswahl).
  • PDF Export Einstellungen: (New in 1.85 ) Diese Funktion aktiviert den PDF-Export für druckbare Umfragen und Antworten. Experimentelles Feature! Meist keine schöne Ausgabe. Es kann keine Hilfe gegeben werden! Wenn du an der Verbesserung mithelfen willst, kontaktiere uns!
    • $usepdfexport: 0 für Deaktivierung; 1 für Aktivierung
    • $pdfdefaultfont: Standard-Schrift für den PDF-Export
    • $pdffontsize: Schriftgröße für normalen Text; Umfragetitel ist +4; Gruppenname ist +2
    • $notsupportlanguages = array('zh-Hant-TW','zh-Hant-HK','zh-Hans','ja','th');
    • $pdforientation: 'L' = Quer-, 'P' = Hochformat
  • $showsgqacode: (New in 1.91 ) Diese Einstellung ist für das Feature der druckbaren Version eines Fragebogens {IMG(attId="78",height="16",width="16")} und ist standardmäßig auf false gesetzt. Wird die Einstellung auf $showsgqacode = true; geändert, so werden die Frage- und, wo sinnvoll, die Antwort-IDs in der Druckversion angezeigt. Diese IDs entsprechen den Spaltennamen der Tabelle lime_survey_12345 in welcher die Antwortdaten für einen bestimmten Fragebogen gespeichert werden. Die IDs können dann als Referenz für eine manuelle Auswertungen genutzt werden.

{IMG(attId="79",thumb="mouseover",height="100",width="200")}

LDAP Einstellungen (Englisch)

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

Authentifikation

In LimeSurvey 2.05 wird Authentifizierung durch sog. Plugins gehandhabt. Daher könnten die die folgenden Informationen veraltet sein. Bitte werfen Sie einen Blick auf die Plugin-Seite für die aktuellsten Informationen.

Delegieren der Anmeldung am Webserver

System-Admins wollen vielleicht ihre eigene Umfragenadministrations-Anmeldung mit einem zentralen Anmeldedienst (z.B. Active Directory, openLdap, Radius, ...), anstatt die interne DB nutzen. Ein einfacher Weg dazu ist dieses System. LimeSurvey wird der vom Webserver zurückgegebenen Authentifizierung vertrauen! Zur Aktivierung muss folgendes erledigt werden:

  • $useWebserverAuth in der config.php auf 'true' setzen
  • Die Anmeldung auf der Serverseite 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 User hat nur Zugriff, wenn:

  • Er vom Webserver authentifiziert wurde
  • Sein Loginname in der LimeSurvey DB steht (der User hat die Berechtigungen, wie in der DB angegeben).

Delegieren der Anmeldung mit Import der Benutzer

Wenn eine große DB verwaltet wird, ist es manchmal einfacher neue User, welche z.B. schon in einer Benutzer-Tabelle von dir stehen, automatisch in die LimeSurvey DB zu importieren.

  • $WebserverAuth_autocreateUser: Wenn 'true' wird LimeSurvey versuchen, User, welche vom Server authentifiziert wurden und noch nicht in der LimeSurvey DB sind, automatisch zu importieren
  • $WebserverAuth_autouserprofile: Ein Array, welches das Standard-Profil eines Users beschreibt, der so importiert wird (beinhaltet Nick-, Vor- und Nachname, E-Mail-Adresse und Berechtigungen)

Wenn das standardmäßige Profil an die User angepasst werden soll, muss eine einfache Funktion geschrieben werden: hook_get_autouserprofile: Hole mit dieser Funktion die benötigten Benutzerdaten (beinhaltet Vor- und Nachname sowie die E-Mail-Adresse) aus einer Datenbank, oder z.B. aus einem LDAP Verzeichnis. Es kann auch seine Berechtigungen basierend auf z.B. externen Gruppen geändert werden.

Die hook_get_autouserprofile Funktion nimmt nur den Loginnamen als Argument und kann folgendes zurückgeben:

  • 'False' oder ein leeres Array: In diesem Fall wird dem User der Zugriff auf LimeSurvey verweigert
  • Ein Array mit allen Benutzerdaten, wie in $WebserverAuth_autouserprofile beschreiben
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
     ... from groups defined in your backend set $user_admin_status_frombackend_0_or_1
     return Array(
                     'full_name' => "$user_name_from_backend",
                     'email' => "$user_email_from_backend",
                     'lang' => '$user_lang_from_backend',
                     'htmleditormode' => 'inline',
                     'templatelist' => 'default,basic,MyOrgTemplate',
                     'create_survey' => 1,
                     'create_user' => 0,
                     'delete_user' => 0,
                     'superadmin' => $user_admin_status_frombackend_0_or_1,
                     'configurator' =>0,
                     'manage_template' => 0,
                     'manage_label' => 0);
}

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

     // return Array();
  The optionnal 'hook_get_auth_webserver_profile' function is for advanced user usage only! For further details, please read the comments from the config-defaults.php file.


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

Es ist möglich, den Login über /limesurvey/admin aufzurufen und gleichzeitig einen Benutzernamen und ein Einmalpasswort, das zuvor von einer externen Anwendung in die Tabelle users (Spalte one_time_pw)geschrieben wurde, per URL zu übertragen.

Diese Einstellung muss aktiviert werden (use_one_time_passwords => true) um die Verwendung von Einmal-Passwörtern zu ermöglichen (Standard = false). Mehr Informationen finden Sie auf der Seite Benutzer verwalten.

More information can be found in the "Manage Users" section.


Encryption settings (New in 4.0.0 )

  Attention : Once set, encryption keys should never be changed, otherwise all encrypted data could be lost !


When update or install, this parameters was generated by LimeSurvey and set in application/config/security.php file. You can move this settings in config.php if you want or leave in security.php.

See data encryption for detail on this feature.

  • encryptionkeypair
  • encryptionpublickey
  • encryptionsecretkey

Advanced url settings

  • publicurl: This should be set to the URL location of your 'public scripts'. The public scripts are those located in the "limesurvey" folder (or whatever name you gave to the directory that all the other scripts and directories are kept in). This settings is available in config.php and it is used when LimeSurvey need an absolute url (for example when token emails are sent).
  • homeurl: This should be set to the URL location of your administration scripts. These are located in the /limesurvey/admin folder. This should be set to the WEB URL location - for example, http://www.example.com/limesurvey/html/admin. Don't add a trailing slash to this entry. The default setting in config.php attempts to detect the name of your server automatically using a php variable setting - {$_SERVER['SERVER_NAME']}. In most cases, you can leave this and just modify the remainder of this string to match the directory name you have put the LimeSurvey scripts in.
  • tempurl: This should be set to the URL location of your "/limesurvey/tmp" directory - or to a directory in which you would like LimeSurvey to use to serve temporary files.
  • uploadurl: This should be set to the URL location of your "/limesurvey/upload" directory - or to a directory in which you would like LimeSurvey to use to serve uploaded files. This allow you to set uploaded files on another url domain.

Erweiterte Ordner Einstellungen

  • homedir: This should be set to the physical disk location of your administration scripts - for example "/home/usr/htdocs/limesurvey/admin". Don't add a trailing slash to this entry. The default setting in config.php attempts to detect the default root path of all your documents using the php variable setting {$_SERVER['DOCUMENT_ROOT']}. In most cases you can leave this and just modify the remainder of this string to match the directory name you have put the LimeSurvey scripts in.
  • publicdir: This should be set to the physical disk location of your 'public scripts'.
  • tempdir: This should be set to the physical disk location of your /limesurvey/tmp directory so that the script can read and write files.
  • uploaddir: This should be set to the physical disk location of your /limesurvey/upload directory so that the script can read and write files.
  • sCKEditorURL: url of the fckeditor script.
  • fckeditexpandtoolbar: defines if the fckeditor toolbar should be opened by default.
  • pdfexportdir: This is the directory with the tcpdf.php extensiontcpdf.php.
  • pdffonts: This is the directory for the TCPDF fonts.

Other advanced settings

Upload files

  • allowedthemeuploads: File types allowed to be uploaded in theme editor
  • allowedresourcesuploads: File types allowed to be uploaded in the resources sections, and with the HTML Editor
  • allowedfileuploads (New in 4.0.0 ) Global restriction on file type to be uploaded
  • magic_database: (New in 3.17.17 ) Allow to use a different MIME database for finfo_open. Can be updated only in config.php file. Example : /usr/share/misc/magic.mgc for redhat based linux.
  • magic_file: (New in 3.17.17 ) Allow to use a different file to get the array of extension by mime type than the included one. Must be a PHP file return an array. Can be updated only in config.php file.

Update

  • updatable: This setting is in version.php. Can be true or false. If you set to true : when an super admin user log in : LimeSurvey checks if an update is available and show you a warning. If set to false : no check is done and you can't use ComfortUpdate.