Actions

Optional settings/nl: Difference between revisions

From LimeSurvey Manual

No edit summary
(Updating to match new version of source page)
Line 1: Line 1:
<languages />  
<languages />  
__TOC__
__TOC__
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 [https://www.limesurvey.org/forum discussion forums] or the [irc://irc.freenode.net/limesurvey|IRC IRC channel] for help from the LimeSurvey community.


=Wijzigen van optionele instellingen=
=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 [[Global settings/nl|Globale instellingen]].  
To modify the configuration settings of the installation, you have to edit the optional settings. They can be found in the /application/config/'''config-defaults.php''', which is located in the LimeSurvey root directory. The default settings of the standard installation can be found in config-defaults.php. Some of them can be overridden by using the [[Global settings|global settings]] dialog, while the others will have to be manually edited.


{{Alert| 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 <nowiki>'config'=>array()</nowiki> en wijzig ze daar.}} Alle instellingen in dit bestand gaan voor die in config-defaults.php. {{NewIn/nl|1.87}} Sommige waarden worden in de functie Globale instellingen overschreven. Door deze werkwijze is het gemakkelijker om een nieuwe versie te installeren!
{{Alert| 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 <nowiki>'config'=>array()</nowiki> en wijzig ze daar.}} Alle instellingen in dit bestand gaan voor die in config-defaults.php. {{NewIn/nl|1.87}} Sommige waarden worden in de functie Globale instellingen overschreven. Door deze werkwijze is het gemakkelijker om een nieuwe versie te installeren!
When an upgrade occurs, only the config-defaults.php settings are changed. Therefore, editing the config.php file will save your customized settings.


Om de instellingen van LimeSurvey te wijzigen moet je het config array in application/config/config.php aanpassen:
Om de instellingen van LimeSurvey te wijzigen moet je het config array in application/config/config.php aanpassen:
Line 31: Line 35:
     ),
     ),
</syntaxhighlight>
</syntaxhighlight>
{{Note|For more information about the Yii framework, please access the [http://www.yiiframework.com/doc-2.0/guide-index.html following link.]}}


==Database==
==Database==
Line 99: Line 105:
</syntaxhighlight>
</syntaxhighlight>
Meer informatie : [http://www.yiiframework.com/doc/guide/1.1/en/topics.url Yii documentatie].
Meer informatie : [http://www.yiiframework.com/doc/guide/1.1/en/topics.url Yii documentatie].
==Logging settings==
Yii provides different solutions to generate logs. To find out more about them, check the [http://www.yiiframework.com/doc/guide/1.1/en/topics.logging 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:
<syntaxhighlight lang="php" enclose="pre">      // Log error
'log' => array(
    'routes' => array(
        'fileError' => array(
            'class' => 'CFileLogRoute',
            'levels' => 'warning, error',
        ),
    ),
),
</syntaxhighlight>
{{Hint|Text=The file is saved by default to <code><nowiki>limesurvey/tmp/runtime/application.log</nowiki></code>, which is located in the LimeSurvey root folder.}}
{{Alert|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 [[Optional settings#Yii settings#Runtime path|Runtime path]].}}.
==Runtime path==
[http://www.yiiframework.com/doc/guide/1.1/en/basics.convention#directory 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:
<syntaxhighlight lang="php" enclose="pre">
return array(
  'components' => array(
    […]
    'runtimePath'=>'/var/limesurvey/runtime/',
    'config'=>array(
    […]
    )
  )
)
</syntaxhighlight>


=Algemene instellingen=
=Algemene instellingen=
Line 111: Line 152:
=Beveiliging=
=Beveiliging=


* '''maxLoginAttempt''': Als de gebruiker het gebruikerswachtwoord foutief invult : aantal toegestane pogingen voor blokkeren (op IP) .  
* '''maxLoginAttempt''': This is the number of attempts a user has to enter the correct password before he or she gets her or his IP address blocked/locked out. The default value is 3 and it can be modified from config.php.  
* '''timeOutTime''': Als de gebruiker het gebruikerswachtwoord <maxLoginAttempt> keer foutief invult  :  tijd dat het IP is geblokkeerd (op IP).  
* '''timeOutTime''': If the user enters the password incorrectly for <maxLoginAttempt>, she or he gets locked out for <timeOutTime> seconds. The default value is 10 minutes and it can be modified from config.php.
* '''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 [[Global settings/nl|Globale instellingen]] {{NewIn/nl|1.87}}.
* '''surveyPreview_require_Auth''': Set to true by default. If you set this to 'false', any person can test your survey using the survey URL, without logging in to the administration panel and without having to activate the survey first. This setting is a default value and can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
* '''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 [[Global settings/nl|Globale instellingen]]  
* '''usercontrolSameGroupPolicy''': Set to true by default. By default, non-admin users defined in the LimeSurvey management interface will only be able to see users they create or users that belong to at least one same group. The default value can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
* '''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  [[Global settings/nl|Globale instellingen]]. {{NewIn/nl|1.87}}.
*'''filterxsshtml:''' This setting enables the filtering of suspicious html tags located within surveys, groups, and questions and answer texts in the administration interface. Leave this to 'false' only if you absolutely trust the users you created for the administration of LimeSurvey and if you want to allow these users to be able to use Javascript, Flash Movies, etc.. <span class="warning">The super admins never have their HTML filtered</span>. The default value can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
* '''demoModeOnly:''' Als deze instelling "aan" (true) staat zal LimeSurvey in demo-modus werken. Dat betekent:
*'''demoMode:''' If this option is set to 'true' in config.php, then LimeSurvey will go into demo mode. The demo mode changes the following things:
** Het is niet mogelijk om het beheeraccount te wijzigen
** Disables admin user's details and password changing;
** Het is niet mogelijk om bestanden te uploaden in sjaboonbeheer
** Disables the upload of files on the template editor;
** Het is niet mogelijk om uitnodigingen en herinneringen via email te verzenden
** Disables sending email invitations and reminders;
** Het is niet mogelijk om een dump van een database te maken
** Disables the creation of a database dump;
** Het is niet mogelijk om de volgende zaken aan te passen: sitenaam, standaardtaal, standaard html-editor modus, XSS filter.
** Disables the ability to modify the following global settings: site name, default language, default HTML editor mode, XSS filter.


= Bronbeheer=
= Resources=
* '''sessionlifetime:''' geeft aan hoe lang de sessie van een enquête geldig is. Alleen van toepassing bij gebruik van database-sessies. (Deze waarde wordt overschreven met de waarden uit het [[Global settings/nl|Globale instellingen]]) {{NewIn/nl|1.87}}.
*'''sessionlifetime:''' Defines the time in seconds after which a survey session expires. It applies only if you are using database sessions. If you do use database sessions, change the parameter in config.php or override the default value from the [[Global settings|global settings]] dialog.
* '''memorylimit:''' geeft aan hoeveel geheugen LimeSurvey mag gebruiken. 128M (Megabyte) is het minimum om goed te kunnen werken. Mocht je time-outs (of andere problemen) hebben bij het genereren van statistieken, overweeg dan om 256M of nog hoger te gebruiken. Als je webserver een hogere limiet toekent dan wordt deze instelling niet gebruikt.
*'''memorylimit:''' This determines how much memory LimeSurvey can access. '128 MB' is the minimum (MB=Megabyte) recommended. If you receive time out errors or have problems generating statistics or exporting files, raise this limit to '256 MB' or higher. If your web server has set a higher limit in config.php, then this setting will be ignored.  


<div class="warningbox">Denk eraan dat deze lokale instelling altijd genegeerd kan worden door de globale serverinstellingen.
<div class="warningbox">Denk eraan dat deze lokale instelling altijd genegeerd kan worden door de globale serverinstellingen.
Line 135: Line 176:
* php_value memory_limit 128M te zetten in een .htaccess-bestand in de directory waar LimeSurvey staat
* php_value memory_limit 128M te zetten in een .htaccess-bestand in de directory waar LimeSurvey staat


=Presentatie=
=Appearance=
*'''lwcdropdowns''': {{ObsoleteIn/nl|2.0}} mogelijke waarden zijn "L" of "R". Zet deze op "R" om 'Lijst met opmerkingen'-vragen als radioknoppen te tonen, of op "L" om deze vraag als een dropdown-selectielijst te tonen.  
*'''dropdownthreshold'''{{ObsoleteIn|2.50}}: When "R" is selected for <code>$dropdowns</code>, the administrator is allowed to set a maximum number of options that will be displayed as radio buttons, before converting back to a dropdown list. If there is a question that has a large number of options, displaying all of them at once as radio buttons can look unwieldy, and can become counter-intuitive to users. Setting this to a maximum of, say 25 (which is the default) means that large lists are easier to be used by the administrators for the survey participant.
*'''dropdownthreshold''': {{ObsoleteIn/nl|2.50}} als je $dropdowns op "R" hebt gezet, is dit het maximale aantal opties dat getoond wordt als radioknoppen, voordat LimeSurvey deze vervangt door een dropdown-selectielijst. Als je dit maximum op iets van 25 zet (de standaardwaarde) zijn lange lijsten voor de gebruiker evenvoudiger gebruiken.
*'''repeatheadings:''' With the Array question type, you'll often 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|global settings]] dialog {{NewIn|2.05}}.
*'''repeatheadings:''' standaard '0' (niet herhalen). Zet deze op een waarde om bij vragen van het arraytype de kop opnieuw te tonen na dit aantal subvragen. Dit is nuttig als je veel subvragen, meer dan een scherm,  hebt. Een redelijk geschikte waarde is 15. Als je de kop niet wilt herhalen, zet dan deze waarde op 0. (Deze waarde wordt overschreven in de [[Global settings/nl|Globale instellingen]] dialoog) {{NewIn/nl|2.05}}.
*'''minrepeatheadings:''' The minimum number of remaining subquestions that are required before repeating the headings in Array questions. The default value is 3 and it can be edited in config.php.  
*'''minrepeatheadings:''' Het minimale aantal resterende subvragen dat verplicht is voordat de koppen bij arrayvragen wordt herhaald.
*'''defaulttemplate:''' This setting specifies the default theme used for the 'public list' of surveys. This setting can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
*'''defaulttemplate:''' deze instelling bepaald het standaardthema dat gebruikt wordt voor het tonen van de 'publieke lijst' van enquêtes. (Deze waarde wordt overschreven met de waarde in de [[Global settings/nl|Globale instellingen]]) {{ObsoleteIn/nl|2.0}}
*'''defaulthtmleditormode:''' Sets the default mode for the integrated HTML editor. This setting can be overridden in the [[Global settings|global settings]] dialog or edited in config.php. The valid settings are:
*'''defaulthtmleditormode:''' bepaalt de standaardmodus waarin de HTML-editor opstart. (Deze waarde wordt overschreven met de waarde in de  [[Global settings/nl|Globale instellingen]]). {{NewIn/nl|1.87}}.
** 'inline' - Inline replacement of fields by an HTML editor. Slow but convenient and user friendly;
** ''inline'' inline vervanging van velden door een HTML-editor. Langzaam, maar makkelijk en gebruikersvriendelijk
** 'popup' - Adds an icon that runs the HTML editor in a popup if needed. Faster, but HTML code is displayed in the form;
** ''popup'' voegt een icoon toe, die bij selectie de HTML-editor indien nodig in een popup toont. Sneller, maar de html-code is zichtbaar 
** 'none'-  No HTML editor;
** ''none'' geen HTML-editor gebruiken
*'''column_style:''' Defines how columns are rendered for survey answers when using [[QS:Display_columns|display_columns]]. It can be edited in the config.php file. The valid settings are:  
*'''column_style:''' Bepaald hoe kolommen van antwoorden worden weergegeven bij gebruik van  [[QS:Display_columns/nl|display_columns]]. De waarden zijn:  
** 'css' - it uses one of the various CSS methods to create columns (see the template style sheet for details);
** 'css' gebruik een van de verschillende CSS alleen methoden voor aanmaken kolommen (bekijk het sjabloon stylesheet voor details).
** 'ul' - the columns are rendered as multiple floated unordered lists (default);
** 'ul' gebruik multiple floated unordered lists. (standaard)
** 'table' - it uses conventional-tables-based layout;
** 'table' gebruik traditionele tabellenlayout.
** NULL - it disables the use of columns.
** NULL uitschakelen gebruik kolommen


=Taal en tijd=
=Taal en tijd=
Line 155: Line 195:
*'''timeadjust:''' Als de webserver in een andere tijdzone staat dan waar jouw enquête wordt gebruikt, zet hier dan de afwijking in uren. Dit is met name van belang voor enquêtes die werken met de tijd of een tijdstempel gebruiken. Voorbeeld: je voert een enquête uit in Australië en gebruikt een server in de VS. Er is dan een tijdsverschil van 14 uur, de instelling wordt dan "14". Deze  waarde wordt overschreven met de waarde in de [[Global settings/nl|Globale instellingen]]. {{NewIn/nl|1.87}}.
*'''timeadjust:''' Als de webserver in een andere tijdzone staat dan waar jouw enquête wordt gebruikt, zet hier dan de afwijking in uren. Dit is met name van belang voor enquêtes die werken met de tijd of een tijdstempel gebruiken. Voorbeeld: je voert een enquête uit in Australië en gebruikt een server in de VS. Er is dan een tijdsverschil van 14 uur, de instelling wordt dan "14". Deze  waarde wordt overschreven met de waarde in de [[Global settings/nl|Globale instellingen]]. {{NewIn/nl|1.87}}.


=Gedrag=
=Survey behavior=
*'''deletenonvalues:''' Wees hier voorzichtig mee. Standaard (waarde '1') worden antwoorden die niet ter zake doen opgeslagen met waarde 'NULL'. Een voorbeeld is dat een deelnemer de vraag 'geslacht?' beantwoord met 'vrouw'. Vervolgens beantwoordt hij een aantal vrouw-specifieke vragen, zich realiseert dat hij een fout gemaakt heeft, terugkeert naar de geslacht-vraag, en  de optie 'man' kiest. Nu zijn de antwoorden op de vrouw-vragen irrelevant, want hij krijgt (en beantwoordt) de man-specifieke vragen. Als je toch wilt dat de irrelevante antwoorden bewaard worden, zet deze instelling dan op '0'. {{NewIn/nl|1.87}}.
*'''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. For example, you ask a male 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 <code>$deletenonvalues==1</code>, those irrelevant values will be cleared (NULLed) in the database. If <code>$deletenonvalues==0</code>, his erroneous answers will not be deleted, so they will still be present in the database when you analyze it.  
*'''shownoanswer:''' Als de antwoorden op een vraag van een selectielijst (radio/select) invulbaar zijn (List of Array-vragen) en deze instelling staat op '1', wordt er een optie toegevoegd met de waarde 'Geen antwoord'. Zo kan de gebruiker kiezen om de vraag niet te beantwoorden. '0' laat de gebruiker in ieder geval iets intypen. Bij '2' kan de beheerder van de enquête kiezen.
*'''shownoanswer:''' When a radio button/select type question that contains editable answers (i.e.: 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 can be overridden from the [[Global settings|global settings]] dialog or edited in config.php. Valid values are:
*'''printanswershonorsconditions:''' Deze instelling bepaalt of antwoorden op vragen die niet gesteld zijn vanwege één of meerdere conditie(s) getoond worden. De standaard '1' verbergt deze antwoorden.
**'0': No;
*'''hide_groupdescr_allinone:''' Deze instelling wordt gebruikt door enquêtes met condities. Zet deze op de waarde true (de standaardwaarde) als je wilt dat de groepsnaam en beschrijving ook verborgen worden als alle condities in de groep ook verborgen zijn.{{NewIn/nl|1.85}}
**'1': Yes;
*'''showpopups:''' Deze instelling bepaald of er popups getoond worden als vragen niet of niet correct beantwoord zijn. Waarde '1' (standaard) betekent dat popups getoond worden, '0' betekent dat de melding op de pagina zelf getoond wordt, en '-1' betekent dat er geen melding gedaan wordt. Gebruikers zien echter nog steeds de indicatie bij de vragen die verplicht beantwoord moeten worden.  
**'2': The 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:''' 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. The default value is 'true'  - hides group name and description when all questions in the group are hidden by conditions. It can be edited in config.php.
*'''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).


=Ontwikkeling en debugging=
=Ontwikkeling en debugging=
Line 272: Line 318:


     // return Array();</syntaxhighlight>
     // return Array();</syntaxhighlight>
{{Alert|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.}}
== Gebruikersnaam omsleutelen==
== 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:
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:


<syntaxhighlight lang="php" enclose="div">$config['auth_webserver_user_map'] = Array ('myname' => 'admin');</syntaxhighlight>
<syntaxhighlight lang="php" enclose="div">'config'=>array(
Zodra de gebruiker 'myname' is geauthenticeerd, zal deze als de 'admin' gebruiker door LimeSurvey gezien worden.
...
'auth_webserver_user_map' => array ('myname' => 'admin');
)</syntaxhighlight>
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.
Uiteraard is dit onveilig, dus wees er voorzichtig mee, en bescherm de config.php tegen het wijzigen door de webserver.

Revision as of 16:00, 27 September 2017

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.

Wijzigen van optionele instellingen

To modify the configuration settings of the installation, you have to edit the optional settings. They can be found in the /application/config/config-defaults.php, which is located in the LimeSurvey root directory. The default settings of the standard installation can be found in config-defaults.php. Some of them can be overridden by using the global settings dialog, while the others will have to be manually edited.

  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!

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

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(
            ....
        ),
    ),
For more information about the Yii framework, please access the following link.

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.

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:

       // Log error
'log' => array(
    'routes' => array(
        'fileError' => array(
            'class' => 'CFileLogRoute',
            'levels' => 'warning, error',
        ),
    ),
),
 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(
    []
    )
  )
)

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: This is the number of attempts a user has to enter the correct password before he or she gets her or his IP address blocked/locked out. The default value is 3 and it can be modified from config.php.
  • timeOutTime: If the user enters the password incorrectly for <maxLoginAttempt>, she or he gets locked out for <timeOutTime> seconds. The default value is 10 minutes and it can be modified from config.php.
  • surveyPreview_require_Auth: Set to true by default. If you set this to 'false', any person can test your survey using the survey URL, without logging in to the administration panel and without having to activate the survey first. This setting is a default value and can be overridden in the global settings dialog or edited in config.php.
  • usercontrolSameGroupPolicy: Set to true by default. By default, non-admin users defined in the LimeSurvey management interface will only be able to see users they create or users that belong to at least one same group. The default value can be overridden in the global settings dialog or edited in config.php.
  • filterxsshtml: This setting enables the filtering of suspicious html tags located within surveys, groups, and questions and answer texts in the administration interface. Leave this to 'false' only if you absolutely trust the users you created for the administration of LimeSurvey and if you want to allow these users to be able to use Javascript, Flash Movies, etc.. The super admins never have their HTML filtered. The default value can be overridden in the global settings dialog or edited in config.php.
  • demoMode: If this option is set to 'true' in config.php, then LimeSurvey will go into demo mode. The demo mode changes the following things:
    • Disables admin user's details and password changing;
    • Disables the upload of files on the template editor;
    • Disables sending email invitations and reminders;
    • Disables the creation of a database dump;
    • Disables the ability to modify the following global settings: site name, default language, default HTML editor mode, XSS filter.

Resources

  • sessionlifetime: Defines the time in seconds after which a survey session expires. It applies only if you are using database sessions. If you do use database sessions, change the parameter in config.php or override the default value from the global settings dialog.
  • memorylimit: This determines how much memory LimeSurvey can access. '128 MB' is the minimum (MB=Megabyte) recommended. If you receive time out errors or have problems generating statistics or exporting files, raise this limit to '256 MB' or higher. If your web server has set a higher limit in config.php, 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

  • dropdownthreshold (Obsolete since 2.50): When "R" is selected for $dropdowns, the administrator is allowed to set a maximum number of options that will be displayed as radio buttons, before converting back to a dropdown list. If there is a question that has a large number of options, displaying all of them at once as radio buttons can look unwieldy, and can become counter-intuitive to users. Setting this to a maximum of, say 25 (which is the default) means that large lists are easier to be used by the administrators for the survey participant.
  • repeatheadings: With the Array question type, you'll often 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. The default value is 3 and it can be edited in config.php.
  • defaulttemplate: This setting specifies the default theme used for the 'public list' of surveys. This setting can be overridden in the global settings dialog or edited in config.php.
  • defaulthtmleditormode: Sets the default mode for the integrated HTML editor. This setting can be overridden in the global settings dialog or edited in config.php. The 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. It can be edited in the config.php file. The valid settings are:
    • 'css' - it uses one of the various CSS methods to create columns (see the template style sheet for details);
    • 'ul' - the columns are rendered as multiple floated unordered lists (default);
    • 'table' - it uses conventional-tables-based layout;
    • NULL - it disables the use of columns.

Taal en tijd

  • defaultlang: Zet deze op de standaardtaal waarin het beheerpaneel, en de openbare enquêtes getoond worden. Binnen een enquête kun je zelf een afwijkende taal gebruiken. Deze waarde wordt overschreven met de waarde in de Globale instellingen (Nieuw in 1.87).
  • timeadjust: Als de webserver in een andere tijdzone staat dan waar jouw enquête wordt gebruikt, zet hier dan de afwijking in uren. Dit is met name van belang voor enquêtes die werken met de tijd of een tijdstempel gebruiken. Voorbeeld: je voert een enquête uit in Australië en gebruikt een server in de VS. Er is dan een tijdsverschil van 14 uur, de instelling wordt dan "14". Deze waarde wordt overschreven met de waarde in de Globale instellingen. (Nieuw 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. For example, you ask a male 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 radio button/select type question that contains editable answers (i.e.: 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 can be overridden from the global settings dialog or edited in config.php. Valid values are:
    • '0': No;
    • '1': Yes;
    • '2': The 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: 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. The default value is 'true' - hides group name and description when all questions in the group are hidden by conditions. It can be edited in config.php.
  • 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).

Ontwikkeling en debugging

  • debug: Met deze instelling zet je de PHP-error mededelingen op niveau E_ALL. Dit betekent dat elke afwijking op een script getoond wordt. Zet de waarde op '1' als je de applicatie aan het debuggen bent, of '2' als je een ontwikkelaar bent. Laat deze waarde in productieomgeving op (de standaard) '0' staan, anders kunnen hackers mogelijk belangrijke informatie inzien.
  • debugsql: Activeer deze instelling als je de SQL-queries die worden uitgevoerd wilt tonen, ze worden getoond onderaan de pagina. Handig als je de queries wilt optimaliseren.

Als je een fout in de applicatie wilt melden en informatie op het forum wilt geven, dan kun je eerst de debugging inschakelen zodat je meer informatie kunt geven.

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

Emailinstellingen

Opmerking: Alle waarden worden overschreven met de waarden uit de Globale instellingen. (Nieuw in 1.87)

  • emailmethod: Bepaalt via welke methode een email verzonden wordt:
    • mail: via de interne PHP mailer
    • sendmail: via sendmail
    • smtp: via smtp-verwijzing. Gebruik deze optie als je LimeSurvey draait op een computer die niet je mailserver is.
  • emailsmtphost: Als je als mailmethode 'smtp' gekozen hebt, vul hier dan de SMTP-server in. Als je bijvoorbeeld Google-mail gebruikt, vul dan indien nodig ook de pport in
 $emailsmtphost = 'smtp.gmail.com:465';
  • emailsmtpuser: Vul hier de gebruikersnaam voor de SMTP-server in. Als de server geen toegangscontrole heeft, laat het dan leeg
  • emailsmtppassword: Vul hier het wachtwoord voor de SMTP-server in. Als de server geen toegangscontrole heeft, laat het dan leeg
  • emailsmtpssl: Vul hier de waarde 'ssl' of 'tls' in om SSL/TLS te gebruiken voor de connectie met de SMTP-server
  • maxemails: Als je uitnodigingen of herinneringen stuurt aan deelnemers bepaalt deze instelling hoeveel mails er in een batch maximaal verstuurd mogen worden. Als dit getal te hoog staat kan het zijn dat het mailscript in een time-out loopt. Een gemiddelde webserver kan ongeveer 100 mails versturen in de 30 seconden dat een script draait. Krijg je daarbij time-outs, zet dan hier een lager aantal neer. Als je de emails gaat versturen en er zijn er meer emails dan het hier opgegeven maximum aantal dan kun je de emails per dit maximum versturen, je moet dan per zending op een vervolgknop klikken. Je hoeft dit versturen niet in een sessie te doen.

Statistieken en respons bekijken

  • usejpgraph: (Vervallen sinds 1.8) De JPGraph-bibliotheek geeft de mogelijkheid om statistieken in staaf- en taartgrafieken te tonen. Als je een goed geconfigureerde jpgraph hebt geïnstalleerd, zet dan deze instelling op "1". Laat het anders op "0" staan. Let op: redelijk experimenteel, kan vreemde resultaten geven.
  • jpgraphdir: (Vervallen sinds 1.8) De fysieke locatie van de jpgraph bibliotheek.
  • jpgraphfont: (Vervallen sinds 1.8) Het lettertype dat gebruikt wordt in de grafieken. Een goed werkende instelling is "FF_FONT1".
  • embedded: (Vervallen sinds 2.0) Als je LimeSurvey wilt integreren in een andere websitepagina, dan kun je hier het versturen van HTML-headers uitzetten. Denk er dan wel aan dat je in de code gaat verwijzen naar de header-verzending van de bovenliggende pagina!
  • filterout_incomplete_answers: Bepaal het standaardgedrag van de respons bij niet compleet gegeven antwoorden. Omdat deze de statistieken kunnen vervuilen, zit er een optie in de interface om deze uit te zetten. Voor meer informatie : Resultaten bekijken. Het standaardgedrag kan als volgt ingesteld worden:
    • show: Toon zowel de compleet, als de niet compleet gegeven antwoorden
    • filter: Toon alleen de complete gegeven antwoorden
    • incomplete: Toon alleen de niet compleet gegeven antwoorden
  • strip_query_from_referer_url: Deze instelling bepaalt of de complete URL, inclusief parameters, van de aanvrager wordt opgeslagen. Zet deze op false (standaard) als de URL inclusief parameters wilt opslaan, op true als je alleen de URL wilt opslaan.
  • showaggregateddata: (Nieuw in 1.8) Zet deze instelling op "aan" om standaard deviatie en gemiddelde bij statistieken te tonen. Ook worden geschaalde antwoorden (Array 5 punten en 5 puntkeuze) samengepakt tot de waarden "goed" *(1+2), "matig" (3), en "slecht" (4+5).
  • PDF Export Settings: (Nieuw in 1.85) Zet de mogelijkheid om naar PDF te kunnen exporteren. Nog zeer experimenteel: de output is lelijk. Wil je ons helpen om dit te verbeteren? Neem dan contact met ons op.
    • usepdfexport: Zet deze op "0" om geen PDF te kunnen exporteren, "1" om dat wel te kunnen.
    • pdfdefaultfont: Standaard lettertype van de PDF-export
    • alternatepdffontfile: een array met key voor taal en specifiek font voor die taal, kan worden vervangen of gewijzigd .
    • pdffontsize: Standaard lettergrootte van de PDF-export. De titel van de enquête is +4, groepen worden als +2 weergegeven.
    • notsupportlanguages = array('zh-Hant-TW','zh-Hant-HK','zh-Hans','ja','th');
    • pdforientation: Zet deze op 'L' voor Landschap of 'P' voor Portretafdruk
  • '"Graph setting"'
    • chartfontfile : te gebruiken font-bestand : moet staan in fontmap van de server of in de map ./fot
    • alternatechartfontfile : een array met key voor taal en specifiek font voor de taal, kan worden vervangen of gewijzigd.
  • showsgqacode: (Nieuw in 1.91) Deze instelling wordt gebruikt bij het afdrukken van de enquête. De waarde true zorgt ervoor dat de ID's van iedere vraag (en antwoorden) getoond worden. Deze kunnen dan gebruikt worden bij handmatige query's op de tabel 'Lime_survey_12345'. Standaardwaarde false.

LDAP instellingen

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

Authenticatie

Vanaf LimeSurvey 2.05 wordt de authenticatie gedaan met plugins. De onderstaande informatie kan daarom verouderd zijn.

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


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'=>array(
...
'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

(Nieuw in 1.81) Een gebruiker kan het beheerpaneel openen op /limesurvey/admin, en een wegwerpwachtwoord gebruiken. Hiervoor is de kolom 'one_time_pw' in de gebruikerstabel beschikbaar.

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

Geavanceerde padinstellingen

  • homeurl: De absolute URL naar de beheerscripts. De standaard is "http://www.voorbeeld.nl/limesurvey/html/admin", zonder achterliggende schuine streep ("/"): de naam van je domein wordt door config.php ingevuld met de variabele {$_SERVER['SERVER_NAME']}. Waarschijnlijk kun je dit gebruiken, en alleen de resterende directorystructuur aangeven om bij de beheerscripts te komen.
  • 'publicurl: De absolute URL naar de publieke scripts. Deze staan standaard in de directory waar je ook LimeSurvey hebt neergezet. Deze instelingen is beschikbaar in config.php en wordt gebruikt voor het e-mailen van een toegangscode.
  • tempurl: Deze wijst naar de URL locatie van de "/limesurvey/tmp" directory, of een directory waarin je LimeSurvey tijdelijke bestanden wilt laten opslaan. De webserver moet op deze directory lees- en schrijfrechten hebben.
  • imagefiles: De URL naar de locatie van de /limesurvey/admin/images-directory. Als je de plaatjes ergens anders wilt neerzetten, verander dan deze URL naar die locatie.
  • $homedir: Wijst naar de fysieke locatie van de LimeSurvey beheerscripts (bijv. "/home/usr/htdocs/limesurvey/admin"). Gebruik geen achterliggende schuine streep ("/"). De naam van de locatie wordt door config.php ingevuld met de phpvariabele {$_SERVER['DOCUMENT_ROOT']}. Waarschijnlijk kun je dit gebruiken, en alleen de resterende directorystructuur aangeven om bij de beheerscripts te komen.
  • publicdir: Wijst naar de fysieke locatie van de LimeSurvey publieke scripts
  • tempdir: Wijst naar de fysieke locatie van de /limesurvey/tmp directory.
  • sCKEditorURL: Wijst naar de fysieke locatie van de FCKEditor
  • fckeditexpandtoolbar: Bepaalt of de FCK Editor de toolbar laat zien als deze geopend wordt
  • pdfexportdir: De fysieke locatie voor de PDF-exportscripts (tcpdf.php extensiontcpdf.php)
  • pdffonts: De fysieke locatie van de TCPDF Lettertypen