Optional settings/nl

Wijzigen van optionele instellingen

De instellingen zijn te vinden in het bestand /application/config/config-defaults.php bij een standaard installatie. Sommige van deze instellingen worden gebruikt tijdens de installatie, en worden overschreven door de waarden in de Globale instellingen.

  Als je deze instellingen wilt wijzigen, wijzig ze dan niet in het bestand config-defaults.php, maar kopieer de instellingen naar /application/config/config.php in 'config'=>array() en wijzig ze daar.

Alle instellingen in dit bestand gaan voor die in config-defaults.php.  (Nieuw in 1.87) Sommige waarden worden in de functie Globale instellingen overschreven. Door deze werkwijze is het gemakkelijker om een nieuwe versie te installeren!

Om de instellingen van LimeSurvey te wijzigen moet je het config array in application/config/config.php aanpassen:

    'config'=>array(
        'debug'=>0,
        'debugsql'=>0,
        'LimeSurveySetting'=>'New value',
    )

Yii-instellingen

LimeSurvey gebruikt het Yii-framework, Yii heeft zijn eigen configuratie in het bestand application/config/config.php. Je kunt enkele specifieke configuratie-instellingen van LimeSurvey benaderen via de Yii-configuratie.

Deze instellingen worden gezet in het components array:

    'components' => array(
        'db' => array(
            ....
        ),
        'Specific settings'=>array(
            ....
        ),
    ),

Database

De database wordt ingesteld bij de eerste installatie van LimeSurvey. Indien nodig kun je deze configuratie wijzigen. Dat doe je dan op eigen risico. Lees ook de [Yii documentatie], en denk eraan dat LimeSurvey alleen de database-types mysql, pgsql, dblib, mssql en sqlsrv ondersteund.

Sessie

Kunt u enkele sessie-parameters in config.php zetten, het eerste voorbeeld is de sessie in de database. Je kunt, indien nodig, commentaar verwijderen/toevoegen. Lees [Yii Documentatie] voor andere instellingen.

Als je SSL ('https') gebruikt voor LimeSurvey voeg dan de volgende regels toe in config.php:

        // Set the cookie via SSL
        'session' => array (
            'cookieParams' => array(
                    'secure' => true, // use SSL for cookies
                    'httponly' => true // Cookies may not be used by other protocols - experimental
                ),
            ),

Als je het domein wilt aanpassen voor het gebruik van cookies plaats dan in de config.php:

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

Request

Deze instellingen zijn veelomvattend, maar de optionele instellingen zijn al geoptimaliseerd voor het gebruik van LimeSurvey. Lees Yii Documentatie voor meer informatie.

Een aanpassing die je ^{op eigen risico} in je LimeSurvey-configuratie kunt doen :

        // Disable CSRF protection
        'request' => array(
            'enableCsrfValidation'=>false,    
            ),

        // Enforce a certain base URL 
        'request' => array(
            'hostInfo' => 'http://www.example.org/'  
            ),

        // Set the cookie domain name for CSRF protection
        'request' => array(
            'csrfCookie' => array( 'domain' => '.example.com' )
        ),

Als u alleen de url voor toegangscode e-mail wilt bijwerken: u kunt uw publicurl plaatsen in uw bestand config.php.

URL

Om de oude werking van de functie 'Fancy URL' te behouden, kun je de urlManager wijzigen

       // Use little url.
		'urlManager' => array(
			'urlFormat' => 'path',
			'showScriptName' => false,
		),

Voeg .html toe na de survey-id

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

Meer informatie : Yii documentatie.

Algemene instellingen

• sitename: Geeft je enquête-site een naam. De naam verschijnt in de lijst met enquêtes en in het administratiepaneel. Alleen gebruikt als standaard en wordt overschreven met de waarde in de Globale instellingen
• siteadminemail: Dit is het standaard e-mailadres van de websitebeheerder, waar meldingen en contactverzoeken naar worden verstuurd. Alleen gebruikt als standaard en wordt overschreven met de waarde in de Globale instellingen ^{(Nieuw in 1.87)}
• siteadminbounce: Dit is het e-mailadres waarnaar niet verzonden e-mails worden verstuurd. Alleen gebruikt als standaard en wordt overschreven met de waarde in de Globale instellingen ^{(Nieuw in 1.87)}
• siteadminname: De naam van de websitebeheerder. Alleen gebruikt als standaard en wordt overschreven met de waarde in de Globale instellingen ^{(Nieuw in 1.87)}
• proxy_host_name: De hostnaam van de proxy-server (als je achter een proxy zit en LimeSurvey wilt updaten met ComfortUpdate) ^{(New in 2.05 )}.
• proxy_host_port: De poort van de proxy-server (als je achter een proxy zit en LimeSurvey wilt updaten met ComfortUpdate) ^{(New in 2.05 )}

Beveiliging

• maxLoginAttempt: Als de gebruiker het gebruikerswachtwoord foutief invult : aantal toegestane pogingen voor blokkeren (op IP) .
• timeOutTime: Als de gebruiker het gebruikerswachtwoord <maxLoginAttempt> keer foutief invult  : tijd dat het IP is geblokkeerd (op IP).
• surveyPreview_require_Auth: standaard true. Zet deze false als iedereen de enquête kan testen, zonder in het beheergedeelte in te loggen, en zonder dat de enquête actief is. Deze waarde kan worden overschreven met de waarde in de Globale instellingen ^{(Nieuw in 1.87)}.
• usercontrolSameGroupPolicy: Standaard true. Niet-beheerders (opgenomen in de LimeSurvey beheerinterface) zullen alleen andere gebruikers kunnen zien als ze beiden aan minstens één dezelfde groep gekoppeld zijn. Deze waarde kan worden overschreven met de waarde in de Globale instellingen
• filterxsshtml: Als deze instelling true is zal LimeSurvey enquêtes, vragen, antwoorden en groepen scannen op verdachte html-tags. Zet deze instelling alleen op false als je je gebruikers vertrouwd met JavaScript, flashfilmpjes en dergelijke. Deze waarde kan worden overschreven met de waarde in de Globale instellingen. ^{(Nieuw in 1.87)}.
• demoModeOnly: Als deze instelling "aan" (true) staat zal LimeSurvey in demo-modus werken. Dat betekent:
  • Het is niet mogelijk om het beheeraccount te wijzigen
  • Het is niet mogelijk om bestanden te uploaden in sjaboonbeheer
  • Het is niet mogelijk om uitnodigingen en herinneringen via email te verzenden
  • Het is niet mogelijk om een dump van een database te maken
  • Het is niet mogelijk om de volgende zaken aan te passen: sitenaam, standaardtaal, standaard html-editor modus, XSS filter.

Resources

• sessionlifetime: Defines the time in seconds after which a survey session expires. It applies only if you are using database sessions. This setting is overridden in the Global settings dialog) ^{(New in 1.87 )}.
• memorylimit: This sets how much memory LimeSurvey can access. '128M' is the minimum (M=Megabyte) recommended. If you receive time out errors or have problems generating statistics or exporting files raise this limit to '256M' or higher. If your webserver has set a higher limit then this setting will be ignored.

Denk eraan dat deze lokale instelling altijd genegeerd kan worden door de globale serverinstellingen.

Mocht het dus niet werken, probeer dan:

• memory_limit = 128M te zetten in het php.ini-bestand op de server (als dat kan en mag)
• memory_limit = 128M te zetten in een php.ini-bestand in de directory waar LimeSurvey staat
• php_value memory_limit 128M te zetten in een .htaccess-bestand in de directory waar LimeSurvey staat

Appearance

• lwcdropdowns: ^{(Obsolete since 2.0)} This can be set to either "L" or "R". Setting it to "R" will result in 'List with Comment' questions being displayed as radio buttons, whereas "L" will result in 'List with Comment' questions being displayed in a 'dropdown' list box .
• dropdownthreshold:' ^{(Obsolete since 2.50)} When you have selected "R" for $dropdowns, this allows you to set a maximum number of options that will display as radio buttons, before converting back to a dropdown list. If you have a question that has a large number of options, displaying them all as radio buttons can look unweildy, and be counter-intuitive to users. Setting this to a maximum of, say 25 (which is the default) means that large lists are easier for the survey participant to use.
• repeatheadings: With the Array type question, often you'll have a lot of subquestions, which - when displayed on screen - take up more than one page. This setting lets you decide how many subquestions should be displayed before repeating the header information for the question. A good setting for this is around 15. If you don't want the headings to repeat at all, set this to 0. This setting is overridden in the Global settings dialog) ^{(New in 2.05 )}.
• minrepeatheadings: The minimum number of remaining subquestions that are required before repeating the headings in Array questions.
• defaulttemplate: This setting specifys the default theme used for the 'public list' of surveys. This setting is overridden in the Global settings dialog) ^{(New in 1.87 )}.
• defaulthtmleditormode: Sets the default mode for integrated HTML editor. This setting is overridden in the Global settings dialog) ^{(New in 1.87 )}. Valid settings are:
  • inline: Inline replacement of fields by an HTML editor. Slow but convenient and user friendly
  • popup: Adds an icon that runs the HTML editor in a popup if needed. Faster, but HTML code is displayed in the form.
  • none: No HTML editor
• column_style: Defines how columns are rendered for survey answers when using display_columns. Valid settings are:
  • 'css' using one of the various CSS only methods for creating columns (see template style sheet for details).
  • 'ul' using multiple floated unordered lists. (default)
  • 'table' using conventional tables based layout.
  • NULL disable the use of columns

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 survey list. 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 )}.

Survey behavior

• 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 'No answer' entry is shown - so that participants may choose to not answer the question. Some people prefer this not to be available. This setting is overridden in the Global settings dialog) ^{(New in 1.87 )}. Valid values are:
  • 0 = no ,
  • 1 = yes ,
  • 2 = survey admin can choose.
• 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.85 )} 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).

Development and debugging

• debug: With this setting you set the PHP error reporting to E_ALL. That means every little notice, warning or error with the script is shown. This setting should be only switched to 1 if you are trying to debug the application for any reason, if you are a developer switch it to 2. Don't switch it to 1 or 2 in production since it might cause path disclosure. (Default: 0)
• debugsql: Activate this setting if you want to display all SQL queries executed for the script on the bottom of each page. Very useful for optimizing the number of queries

If you experience an error in the application, we strongly recommend to acivate the debug setting so you usually get some more detailed error that you can submit with the bug report:

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

Emailinstellingen

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
  • alternatepdffontfile: an array with key for language and specific font for this language can be replaced or just updated .
  • 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
• '"Graph setting"'
  • chartfontfile : Font file to be used : must be in the server font directory or in ./fot directory
  • alternatechartfontfile : an array with key for language and specific font for this language can be replaced or just updated .
• showsgqacode: ^{(New in 1.91 )} This setting is used at the printable survey feature 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.

LDAP instellingen

Gezien de uitgebreidheid van dit onderwerp, staat de tekst hier.

Authenticatie

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

Delegeren van authenticatie naar de webserver

Systeembeheerders willen wellicht hun "enquêtebeheerders" authenticeren bij een centraal systeem (Active Directory, openLdap, Radius etc.) in plaats van via de LimeSurvey-database. Hiervoor zet je de benodigde software en opties aan op de webserver, en zet "auth_webserver"op "true"(aan) in config.php.

Bedenk daarbij wel dat

• LimeSurvey nu direct de gebruikersnaam van de webserver als geldige inlog gebruikt
• Dit alleen geldt voor de beheerinterface, niet voor het deelnemersgedeelte

Delegatie van authenticatie zonder automatische import van gebruikers

Doordat de authenticatie gedelegeerd wordt, is er geen wachtwoordonderhoud nodig. Maar er moeten nog steeds wel gebruikers in de database aangemaakt worden (plus de rechten die ze hebben) om LimeSurvey te laten werken.

Een gebruiker heeft toegang tot LimeSurvey als:

• hij/zij geauthenticeerd is door de webserver
• de gebruikte loginnaam geldig is als gebruiker voor de LimeSurvey database.

Delegatie van authenticatie met automatische import van gebruikers

Dit kan lastig worden als je veel gebruikers moet beheren. Daarom is het wellicht makkelijker om de automatische import aan te zetten. Hiervoor gebruik je:

• auth_webserver_autocreate_user: als deze "aan"(true) staat zal LimeSurvey geauthenticeerde gebruikers importeren.
• auth_webserver_autocreate_profile: beschrijft de array van waarden die aan het gebruikersprofiel gehangen worden (zoals een nep-voornaam en nep-achternaam, email en rechten)

Als je deze nep-waarden door echte waarden (uit het authenticatiesysteem) wilt vervangen, ontwikkel dan de functie hook_get_autouserprofile, waarin je het authenticatiesysteem vraagt naar deze waarden.

De hook_get_auth_webserver_profile functie heeft de gebruikersnaam als input, en levert:

• "false" of een lege array als de gebruiker niet geauthenticeerd is voor LimeSurvey
• een array met alle waarden zoals beschreven in $WebserverAuth_autouserprofile

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

Gebruikersnaam omsleutelen

Soms verschillen de gebruikersnaam in het authenticatieproces en de gebruikersnaam in LimeSurvey. Deze kun je echter omsleutelen met de auth_webserver_user_map parameter. Voorbeeld: je hebt geen externe gebruiker die 'admin' heet, maar je wilt wel dat de gebruiker 'myname' die rol krijgt. Deze kun je dan als volgt omsleutelen:

$config['auth_webserver_user_map'] = Array ('myname' => 'admin');

Zodra de gebruiker 'myname' is geauthenticeerd, zal deze als de 'admin' gebruiker door LimeSurvey gezien worden.

Uiteraard is dit onveilig, dus wees er voorzichtig mee, en bescherm de config.php tegen het wijzigen door de webserver.

Wegwerpwachtwoorden

^{(New in 1.81 )} A user can open the LimeSurvey login at /limesurvey/admin and pass username and a one time password which was previously written into the users table (column one_time_pw) by an external application.

Deze mogelijkheid moet echter wel aan gezet worden (use_one_time_passwords => true)
Bekijk ook: beheer van gebruikers.

Geavanceerde padinstellingen

• 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). This settings is available in config.php and is used when sending token email.
• 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.
• sCKEditorURL: 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