Actions

Optionale Einstellungen

From LimeSurvey Manual

Revision as of 16:50, 19 May 2020 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

The following section is addressed to those of you who would like to edit those configuration settings that could not be modified with the help of the GUI (Graphical User Interface) of the LimeSurvey installation. Please bear in mind that all the changes from the LimeSurvey root directory are done at your own risk. Nevertheless, in the case in which you are experiencing problems/need further guidance, join the discussion forums or the IRC channel for help from the LimeSurvey community.

Hinweis

Diese optionalen Einstellungen können nur in der "config-defaults.php" einer Standard-Installation gefunden werden - einige von ihnen werden nur für die erste Installation genutzt und in den globalen Einstellungen überschrieben.

  Wenn Sie diese Einstellungen zu ändern möchten, ändern Sie bitte nicht in config-defaults.php, sondern kopieren Sie die jeweilige Einstellung/Zeile nach /application/config/config.php in 'config'=>array() und ändern es dort.


Alle Einstellungen in config.php überschreiben die Vorgabe-Werte der config-defaults.php und einige von diesen werden von den Globalen Einstellungen (Neu ab 1.87 ) überschrieben. Auf diese Weise ist es viel einfacher Ihre Installation zu einem späteren Zeitpunkt zu aktualisieren!

When an upgrade occurs, only the config-defaults.php settings are changed. Therefore, editing the config.php file will save your customized settings.

Um die LimeSurvey Konfiguration zu aktualisieren, müssen Sie das config array bearbeiten:

    'config'=>array(
        'debug'=>0,
        'debugsql'=>0,
        'LimeSurveyEinstellung'=>'Neuer Wert',
    )

Yii Einstellungen

LimeSurvey verwendet das Yii-Framework und Yii hat seine eigene Konfiguration in der Datei application/config/config.php. Sie können einige bestimmte Konfigurationseinstellungen von LimeSurvey über die Yii-Konfiguration setzen.

LimeSurvey uses the Yii framework, which has its own configuration parameters in application/config/internal.php and application/config/config.php file. You can also access some specific configuration settings of LimeSurvey via the Yii configuration.

Since config.php array is merged to the whole config, you can replace any Yii params in the config.php file.

Diese Einstellung wird im components Array gesetzt. Beispiel:

    'components' => array(
        'db' => array(
            ....
        ),
        'SpezifischeEinstellung'=>array(
            ....
        ),
    ),
For more information about the Yii framework, please access the following link.

Datenbank Einstellungen

Die Datenbankeinstellungen werden vom Installationsprogramm in die config.php-Datei geschrieben, wenn Sie LimeSurvey zum ersten Mal installieren. Bei Bedarf können Sie diesen Teil der Konfiguration aktualisieren. Bitte denken Sie daran, dass Sie dies auf eigene Gefahr tun. Siehe auch die Yii Dokumentation, und denken Sie bitte daran, dass LimeSurvey nur die Datenbanktypen mysql, pgsql , dblib, mssql und sqlsrv unterstützt.

Sitzungseinstellungen

Sie können einige Sitzungsparameter in config.php setzen - das erste Beispiel ist die Sitzung in der Datenbank. Sie können den Teil in config.php auskommentieren/hinzuzufügen wenn benötigt. Siehe [Yii Dokumentation] für weitere Einstellungen.

You can set some session parameters in config.php (check the two examples from below). You can uncomment/add the part needed in config.php. See the Yii Documentation for other settings.

  If you need to update session settings to have multiple LimeSurvey instances running on the same server, check if you don't have to update request settings for crsf cookie.


Use table-based sessions

LimeSurvey can use table-based sessions, you find a commented part on the default config.php generated file. To use table-based session, remove the // before each line.

        'session' => array (
            'class' => 'application.core.web.DbHttpSession',
            'connectionID' => 'db',
            'sessionTableName' => '{{sessions}}',
        ),
  Table-based sessions are currently not supported on MSSQL server.


Other sessions update

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

If you have mutiples installation on the same server, it can be more quick and easy to set different session name for each LimeSurvey instance. This can be need for IE11 in some condition (see issue 12083)

        // Set the name of the session
        'session' => array (
            'sessionName' => "LimeSurveyN1",
            ),

Anfrage-Einstellungen

Die Anfrage-Einstellungen sind wichtig, aber die Standardeinstellungen sind für die LimeSurvey Nutzung bereits optimiert. Siehe Yii Dokumentation für weitere Informationen.

Einige Beispiele, die Sie in Ihrer LimeSurvey Konfiguration ändern können : Auf eigene Gefahr!</ sup>:

        // CSRF Schutz deaktivieren
        'request' => array(
            'enableCsrfValidation'=>false,    
            ),
        // Erzwinge eine bestimmte Basis-URL
        'request' => array(
            'hostInfo' => 'http://www.example.org/'  
            ),
        // Setze den Cookie Domain Namen für CSRF Schutz
        'request' => array(
            'csrfCookie' => array( 'domain' => '.example.com' )
        ),

If you need to update only the url for token emails, set your publicurl in your config.php file.

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.

Logging settings

Yii provides different solutions to generate logs. To find out more about them, check the logging special topic. LimeSurvey uses '1' or '2' by default, which allows every web user to see the logs. You can create your own settings using Yii directly.

For example, a quick solution to log errors and warnings in files is:

return array(
	'components' => array(
		/* Other component part here 'db' for example */
		'log' => array(
			'routes' => array(
				'fileError' => array(
					'class' => 'CFileLogRoute',
					'levels' => 'warning, error',
					'except' => 'exception.CHttpException.404',
				),
			),
		),
		/* Other component part here 'urlManager' for example */
	),
	/* Final part (with 'runtimePath' 'config' for example) */
);
 Hint: The file is saved by default to limesurvey/tmp/runtime/application.log, which is located in the LimeSurvey root folder.
  Yii uses runtime path. By default, the logs are web accessible. They may contain a lot of information from your server. It is better to use a directory that cannot be accessed via the web. You can set it in routes or by updating the Runtime path.

.

Runtime path

The runtime path must be a readable and writable directory for the “web user”. However, the runtime path contains files with potential security information that are located in the public web access area. LimeSurvey collects these files in the temp directory of the LimeSurvey root directory. In order to eliminate the access to such important data, you can set the runtime path outside the public web access by editing the respective lines in the /application/config/config.php file:

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

Generelle Einstellungen

  • sitename: Gibt der Umfragen-Seite einen Namen. Dieser Name wird in der Umfragenliste und im Kopf des Administrationsbereiches erscheinen. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • siteadminemail: Die E-Mail-Adresse des Administrators, welche für Systemnachrichten und Kontaktmöglichkeiten genutzt wird. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • siteadminbounce: Die Mailadresse wohin zurückgeschickte Mails hinkommen. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • siteadminname: Der richtige Name des Seitenadmins. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).

Sicherheit

  • surveyPreview_require_Auth: Standard: 'true'. Wenn 'false' kann jede Person jede Umfrage durch Eingabe der Umfrage URL testen - ohne Login als Admin oder vorausgegangener Aktivierung der Umfrage. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • usercontrolSameGroupPolicy: Standard: 'true', nicht-Admis können im LimeSurvey Management nur User sehen, welche zu einer Gruppe gehören, in der die User selbst sind.
  • filterxsshtml: Diese Einstellung aktiviert die Filterung von HTML-Tags in Umfrage, Gruppen, Fragen und Antworten Texten im Admin-Center. Nur auf 'false' lassen, wenn den Usern, welche Umfragen erstellen können, absolut vertraut wird und ihnen erlaubt werden soll, JavaScript, Flash, usw. zu benutzen. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • demoModeOnly: Wenn diese Option aktiviert ist, geht LimeSurvey in den Demo-Mode. Der Demo-Modus ändert folgendes::
    • Man kann Admin und User Details und Passwörter nicht mehr bearbeiten
    • Im Template-Editor können keine neuen Dateien hochgeladen werden
    • Es werden keine Mail Einladungen und Erinnerungen mehr gesendet
    • Der DB-Dump wird deaktiviert
    • Folgende globale Einstellungen können nicht mehr gespeichert werden: Seitenname, Standard-Sprache, Standard-HTML-Editor Modus und XSS Filter

Ressourcen

  • sessionlifetime: Mit diesem Wert kann bestimmt werden, wie lange (in Sekunden) Umfrageteilnehmer inaktiv auf einer Seite verweilen dürfen, bevor die Daten auf der entsprechenden Seite wegen Zeitüberschreitung verloren gehen. (Standardwert: 3600) Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • memorylimit: Wie viel Speicher LimeSurvey benutzen kann. Minimum: '32M' (M=mb). Bei Problemen wie Time-outs oder Problemen beim Export sollte das Limit auf '128M' oder '256M' erhöht werden.
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: Set the number of seconds a script is allowed to run. If this is reached, the script returns a fatal error. To be allowed to export big survey data and statistics, LimeSurvey try to set it by default to 1200 seconds. You can set a bigger time or a lower time if needed. Only accessible via php config file.

Erscheinungsbild

  • $lwcdropdowns: (Obsolete since 2.0) Dieser Wert kann auf "L" oder "R" gesetzt werden. "R" hat zur Folge, dass beim Fragetyp "Liste mit Kommentar" die Fragen mit Radio-Buttons dargestellt werden. Dagegen werden bei "L" die Fragen in einer Dropdown-Box dargestellt.
  • $dropdownthreshold: Wenn bei "$lwcdropdowns" als Einstellung "R" gewählt ist, dann kann hier der Maximalwert festgelegt werden, bevor automatisch von Radio-Buttons auf Dropdown-Box umgestellt wird. Da eine größere Anzahl an Radio-Buttons sehr schnell unübersichtlich wird, sollen hierdurch lange Listen für den Umfrageteilnehmer leichter zu verarbeiten sein. Deshalb sollte der Wert nicht allzu hoch gewählt werden. (Standard = 25)
  • $repeatheadings: Beim Verwenden des Fragetyps Feld (Flexible Beschriftung) wird m meist eine sehr große Anzahl an Antworten vorgeben, welche alle auf einer Seite dargestellt werden. Mit diesem Wert kann bestimmt werden, nach wie vielen Antworten wieder die Spalten-Überschrift angezeigt wird. Ein guter Wert, welcher sich hier eignet ist 15. Sollte keine Wiederholung der Spalten-Überschrift gewünscht sein, muss der Wert, wie er auch standardmäßig ist, auf 0 gesetzt werden.
  • $minrepeatheadings: Dieser Wert bestimmt bei Verwendung des Fragetyp Feld (Flexible Beschriftung) die Mindestanzahl von verbleibenden Fragen bevor die Spalten-Überschrift wiederholt wird.
  • $addTitleToLinks: Wenn diese Option auf 'true' gesetzt ist, wird LimeSurvey ein 'title' HTML Attribut in alle Links, die im Menü benutzt werden, setzen. Screenreader können dadurch das Menü besser analysieren. Nur aktiveren, wenn tatsächlich Screenreader benutzt werden, da die Anzeige mit Tooltips überlappt.
  • defaulttemplate: Das Standard-Template für öffentliche Listen der Umfragen. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ).
  • defaulthtmleditormode: Standard Modus für den integrierten HTML-Editor. Diese Einstellung wird durch die globalen Einstellungen überschrieben (New in 1.87 ). Gültige Einstellungsmöglichkeiten:
    • inline: Inline Ersetzung der Felder durch einen HTML-Editor Langsam, aber Benutzerfreundlich (Standard)
    • popup: Ein Icon, welches ein Popup mit dem HTML-Editor öffnet. Schneller, aber HTML-Code wird im Formular angezeigt.
    • none: Kein HTML-Editor.

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.

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

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

Erweiterte Ordner Einstellungen

  • homeurl: Dieser Wert soll auf das URL-Verzeichnis mit den Administratoren-Skripts (Standard: /limesurvey/admin) zeigen. In angepassten Fall könnte dies "http://www.example.com/limesurvey/html/admin" sein. Keinen Slash an des Ende der Adresse anhängen! In der Standardeinstellung von config.php wird der Name des Verzeichnis auf dem Server automatisch mit der PHP-Variable - {$_SERVER['SERVER_NAME']} zugewiesen. Im Normalfall benötigt dieser Wert keine Änderung und man muss nur die richtige Einstellung des Wertes "$rooturl" vornehmen.
  • publicurl: Dieser Wert sollte auf das URL-Verzeichnis gesetzt werden, in dem alle "öffentlichen Skripts" liegen. Unter "öffentlichen Skripts" werden jene verstanden, welche im "LimeSurvey"-Verzeichnis (oder wie immer das das Stammverzeichnis von LimeSurvey genannt wurde) sind. Neben den öffentlichen Skripts finden man in diesem Verzeichnis auch noch die Unterverzeichnisse wie /admin, /classes, /docs,...
  • tempurl: Dieser Wert soll auf das "/limesurvey/tmp"-Verzeichnis zeigen, oder auf jenes Verzeichnis, in dem   alle temporären Dateien vom LimeSurvey gespeichert werden sollen und welcher für Uploads benutzt werden soll. Dieses Verzeichnis benötigt zudem folgende Zugriffsrechte: Lesen/Schreiben (chmod 755).
  • imagefiles: Diesen Wert sollte auf der Standardeinstellung (/limesurvey/admin/images) belassen werdem, er zeigt auf jenes Verzeichnis, in dem zu Beginn die benötigen Bilder und Icons installiert wurden. Wenn es gewünscht wird, können die Bilder und Icons natürlich auch in einen anderen Ordner abgelegt werden, dann muss hier natürlich das entsprechende Verzeichnis angegeben werden.
  • homedir: Hier soll das physikalische Verzeichnis, auf dem die Administratoren-Skripts am Server liegen eingetragen werden - zum Beispiel: "/home/usr/htdocs/limesurvey/admin". In der Standardeinstellung von config.php wird der Standard-Verzeichnispfad automatisch mit der PHP-Variable - {$_SERVER['DOCUMENT_ROOT']} zugewiesen. Im Normalfall benötigt dieser Wert keine Änderung und es muss nur die richtige Einstellung des Wertes "$rootdir" vorgenommen werden.
  • publicdir: Hier soll das physikalische Verzeichnis, auf dem die "öffentlichen Skripts" zu finden ist eingetragen werden.
  • tempdir: Hier soll das physikalische Verzeichnis, auf dem das /limesurvey/tmp-Verzeichnis zu finden ist eingetragen werden, sodass das Skript-Dateien Lesen und Schreiben kann.
  • fckeditordir: URL des fckeditor-Scripts
  • fckeditexpandtoolbar: Definiert, ob die FCKeditor-Toolbar standardmäßig geöffnet werden soll
  • pdfexportdir: Verzeichnis mit tcpdf.php und extensiontcpdf.php
  • pdffonts: Ordner der TCPDF-Schriften

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.

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.