Actions

Optionale Einstellungen

From LimeSurvey Manual

Revision as of 14:34, 24 October 2013 by C schmitz (talk | contribs)
Other languages:

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

  Zum Ändern der Optionen sollte diese nicht in der "config-defaults.php", sondern kopieren Sie entsprechende Einstellung nach "config.php" in die Sektion 'config'=>array() und ändern diese dort.


Alle Einstellungen der "config.php" überschreiben die Standard-Werte der "config-defaults.php" und einige dieser Einstellungen werden wiederum in den globalen Einstellungen überschrieben (New in 1.87 ). Auf diesem Weg kann man viel einfacher und schneller später auf eine neue Version aktualisieren!

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

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.

Language & Time

  • $defaultlang: This should be set to the default language to be used in your administration scripts, and also the default setting for language in the public surveys. You can change this setting for public surveys on a survey-by-survey basis from the admin scripts. This setting is overridden in the Global settings dialog) (New in 1.87 ).
  • $timeadjust: If your web server is in a different time zone to the location where your surveys will be based, put the difference between your server and your home time zone here. For example, I live in Australia but use a US web server. The web server is 14 hours behind my local time zone. So my setting here is "14". In other words, it adds 14 hours to the web servers time. This setting is particularly important when surveys timestamp the responses. This setting is overridden in the Global settings dialog) (New in 1.87 ).
  • $modrewrite: (Obsolete since 2.0) If set to 1, it activates the fancy URL feature (Example: http://survey.example.com/123456/lang-fr/tk-sdlfkjozeiru instead of http://survey.example.com/index.php?sid=123456⟨=fr&token;=sdlfkjozeiru). Before you activate this, you must rename "htaccess.txt" file to ".htaccess". You need to run an Apache web server with correctly installed mod_rewrite module.

Survey Behavior

  • $allowmandbackwards: A setting of 1 for this variable will allow survey participants to move to a previous question even if they haven't answered a mandatory question. If it is set on 0, then participants will have to answer that question even to move to a previous question.
  • $deletenonvalues: Use this feature with caution.  By default (a value of 1), irrelevant questions are NULLed in the database.  This ensures that the data in your database is internally consistent.  However, there are rare cases where you might want to hold onto irrelevant values, in which case you can set the value to 0.  Say you ask the person his gender, and he accidentally says 'female' and then answers some female-specific questions (questions that are conditioned on being female, so are only relevant for women).  Then, he realizes his mistake, backs up, sets the gender to 'male', and continues with the survey.  Now, the female-specific questions are irrelevant.  If $deletenonvalues==1, those irrelevant values will be cleared (NULLed) in the database.  If $deletenonvalues==0, his erroneous answers will not be deleted, so they will still be present in the database when you analyze it.
  • $shownoanswer: When a question of a radio button/select type that contains editable answers (ie: List, Array questions) is not mandatory and $shownoanswer is set to 1, an additional entry is shown for "N/A" - so that participants may choose to not answer the question. Some people prefer this not to be available. Set this to 0 to turn this off. This setting is overridden in the Global settings dialog) (New in 1.87 ).
  • $printanswershonorsconditions: This setting determines if the printanswers feature will display entries from questions that were hidden by conditions-branching (Default: 1 = hide answers from questions hidden by conditions).
  • $hide_groupdescr_allinone: (New in 1.85RC3 ) This setting is relevant for all-in-one surveys using conditions . When this is set to true the group name and description is hidden if all questions in the group are hidden. (Default: true (hide group name and description when all conditions in the group are hidden by conditions))
  • $showpopups:  Show popup messages if mandatory or conditional questions have not been answered correctly. 1=Show popup message (default), 0=Show message on page instead, -1=Do not show the message at all (in this case, users will still see the question-specific tips indicating which questions must be answered).

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 ihn auf 2 setzen. Des Weiteren sollte dieser Wert nicht aktiviert werden, wenn LimeSurvey zu produktiven Zwecken eingesetzt wird. (Standardeinstellung: 0)

Email-Einstellungen

Note: All these settings in this section are overridden in the Global settings dialog (New in 1.87 ).

  • $emailmethod:  This determines how E-mail messages are being sent. The following options are available:
    • mail: use internal PHP mailer
    • sendmail: use sendmail mailer
    • smtp:use SMTP relaying. Use this setting when you are running LimeSurvey on a host that is not your mail server.
  • $emailsmtphost: If you use 'smtp' as $emailmethod then you have to put your SMTP-server here. If you are using Google mail you might have to add the port number like $emailsmtphost = 'smtp.gmail.com:465';
  • $emailsmtpuser: If your SMTP-server needs authentication then set this to your user name, otherwise it must be blank.
  • $emailsmtppassword: If your SMTP-server needs authentication then set this to your password, otherwise it must be blank.
  • $emailsmtpssl: Set this to 'ssl' or 'tls' to use SSL/TLS for SMTP connection
  • $maxemails: When sending invitations or reminders to survey participants, this setting is used to determine how many emails can be sent in one bunch. Different web servers have different email capacities, and if your script takes too long to send a bunch of emails, the script could time out and cause errors. Most web servers can send 100 emails at a time within the default 30 second time limit for a PHP script. If you get script timeout errors when sending large numbers of emails, reduce the number in this setting.  Clicking the 'send email invitation' button on the token control toolbar, (not the button on the right of each token), sends the maxemails number of invitations, then displays a list of the addresses sent to and a warning that "There are more emails pending than could be sent in one batch. Continue sending emails by clicking below. There are ### emails still to be sent." and provides a "continue button" to proceed with the next batch. I.e., the user determines when to send the next batch after each batch gets emailed.  It is not necessary to wait with this screen active.  The admin could log off and come back at a later time to send the next batch of invites.

Statistics and Response Browsing

  • usejpgraph: (Obsolete since 1.8) The JPGraph-library lets you display the results of your survey in the statistics part of LimeSurvey  in bar- and pie charts. If you have a correctly configured jpgraph class set up on your server, you can turn this feature on or off (1=on, 0=off). Please have a look, every version of PHP needs another version of JPGraph! This feature is currently in development, so expect a few weird outcomes.
  • jpgraphdir: (Obsolete since 1.8) The physical disk location of the jpgraph class scripts. This setting is only required if $usejpgraph is equal to 1.
  • jpgraphfont: (Obsolete since 1.8) The font to use with graphs. A failsafe setting would be "FF_FONT1"
  • embedded: (Obsolete since 2.0) If you want to integrate LimeSurvey into another page then you can turn off sending HTML headers by using this setting and point instead to the header method of a custom function. This is a dirty hack but should work for a quick integration.
  • filterout_incomplete_answers: Control the default behaviour of  filtering incomplete answers when browsing or analyzing responses. For a discussion on incomplete Responses see Browsing survey results. Since these records can corrupt the statistics, an option is given to switch this filter on or off in several GUI forms. This parameter config.php is just the default state for the incomplete answer filter. The following options are available:
    • show: Show both complete and incomplete answers
    • filter: Show only complete answers
    • incomplete: Show only incomplete answers
  • strip_query_from_referer_url: This setting determine if the referrer URL saves parameter or not. Default value is "false" (in this case referrer URL saves all parameter). Alternatively this value can be set to "true" and the parameter part of the referrer URL will be removed.
  • showaggregateddata: (New in 1.8 ) When activated there are additional values like arithmetic mean and standard deviation at statistics. Furthermore data is aggregated to get a faster overview e.g. results of scale 1+2 and 4+5 are added to have a general ranking like "good" (1/2), "average" (3) and "bad" (4/5). This only affects question types "A" (5 point array) and "5" (5 point choice).
  • PDF Export Settings: (New in 1.85 ) This feature activates PDF export for printable survey and Print Answers. The PDF export is totally experimental. The output is mostly ugly. At this point no support can be given - if you want to help to fix it please get in touch with us.
    • usepdfexport: Set 0 to disable; 1 to enable
    • pdfdefaultfont: Default font for the pdf Export
    • pdffontsize: Fontsize for normal text; Surveytitle is +4; grouptitle is +2
    • notsupportlanguages = array('zh-Hant-TW','zh-Hant-HK','zh-Hans','ja','th');
    • pdforientation: Set L for Landscape or P for portrait format
  • $showsgqacode: (New in 1.91 ) This setting is used at the printable survey feature {IMG(attId="78",height="16",width="16")} and defaults to false. If you set showsgqacode = true; the IDs for each question - and answer if applicable - will be shown; these IDs match the column heading at the Lime_survey_12345 table which holds the answer data for a certain survey. These Ids can be used for a code book for manual database queries.
  • {IMG(attId="79",height="200",width="400")}

LDAP Einstellungen

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

Authentifikation

In LimeSurvey 2.05 authentication will be handled by plugins. Because of this the information below might be outdated. See Plugins for most up to date information.

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();

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['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

 Hint: This features is available starting in version 1.81


Seit Version 1.81 ist es 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. Um das Einloggen mittels Einmalpasswort zu ermöglichen, muss diese Einstellung aktiviert werden ($use_one_time_passwords = true;), standardmäßig ist die Funktion aus Sicherheitsgründen deaktiviert. Weitere Informationen befinden sich auf der Seite "Benutzerverwaltung".

This setting has to be turned on (use_one_time_passwords => true) to enable the usage of one time passwords (default = false). More information can be found at "Manage Users".

Erweiterte Ordner Einstellungen

If possible do no touch these settings. Additionally these settings can only be adjusted on config-defaults.php.

  • $homeurl: This should be set to the URL location of your administration scripts. These are the scripts 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.
  • $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).
  • $tempurl: This should be set to the URL location of your "/limesurvey/tmp" directory - or a directory which you would like LimeSurvey to use to store temporary files, including uploads. This directory must be set to read & write for your webserver (e.g. chmod 755)
  • $imagefiles: By default you should leave this pointing to the URL location of /limesurvey/admin/images - where the images are installed initially. You may, however, prefer to move these images to another location and if so point this to the URL directory where they are stored.
  • $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.
  • $fckeditordir: url of the fckeditor script
  • $fckeditexpandtoolbar: defines if the FCKeditor toolbar should be opened by default
  • $pdfexportdir: Directory with the tcpdf.php extensiontcpdf.php
  • $pdffonts: Directory for the TCPDF fonts
Retrieved from "http://manual.limesurvey.org/index.php?title=Optional_settings/de&oldid=58088"