Actions

Optional settings/it: Difference between revisions

From LimeSurvey Manual

(Updating to match new version of source page)
(Updating to match new version of source page)
 
(110 intermediate revisions by 3 users not shown)
Line 2: Line 2:
__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.
La sezione seguente è indirizzata a coloro che desiderano modificare quelle impostazioni di configurazione che non possono essere modificate con l'aiuto della GUI (Graphical User Interface) dell'installazione di LimeSurvey. Tieni presente che tutte le modifiche dalla directory principale di LimeSurvey vengono eseguite a tuo rischio. Tuttavia, nel caso in cui riscontri problemi/necessiti di ulteriore assistenza, unisciti ai [https://www.limesurvey.org/forum forum di discussione] o all'[irc://irc.freenode.net/limesurvey|IRC IRC channel] per l'aiuto della community di LimeSurvey.


Come modificare le impostazioni opzionali
Come modificare le impostazioni opzionali


<div class="mw-translate-fuzzy">
Per modificare le impostazioni di configurazione dell'installazione, è necessario modificare le impostazioni opzionali. Possono essere trovati in /application/config/'''config-defaults.php''', che si trova nella directory principale di LimeSurvey. Le impostazioni predefinite dell'installazione standard si trovano in config-defaults.php. Alcuni di essi possono essere sovrascritti utilizzando la finestra di dialogo [[Impostazioni globali|impostazioni globali]], mentre gli altri dovranno essere modificati manualmente.   
Le impostazioni opzionali sono collocate unicamente nel file /application/config/config-defaults.php di un'installazione standard - alcune di esse sono utilizzate unicamente per la prima installazione, altre sono sovrascritte nelle Impostazioni Generali.
</div>  


{{Alert|If you want to change these settings, please do not change them in config-defaults.php, but copy the particular setting/line to /application/config/'''config.php''' in <nowiki>'config'=>array( )</nowiki> and change it there. All the newly modified/introduced settings from the config.php file will override the default values from config-defaults.php.}}
{{Avviso|Se desideri modificare queste impostazioni, non modificarle in config-defaults.php, ma copia la specifica impostazione/linea in /application/config/'''config.php''' in<nowiki> 'config'=>array( )</nowiki> e cambialo lì. Tutte le impostazioni appena modificate/introdotte dal file config.php sovrascriveranno i valori predefiniti da config-defaults.php.}}


When an upgrade occurs, only the config-defaults.php settings are changed. Therefore, editing the config.php file will save your customized settings.  
Quando si verifica un aggiornamento, vengono modificate solo le impostazioni di config-defaults.php. Pertanto, la modifica del file config.php salverà le impostazioni personalizzate.  


To update/add the LimeSurvey settings in /application/'''config/config.php''', you have to update the config array:
Per aggiornare/aggiungere le impostazioni di LimeSurvey in /application/'''config/config.php''', devi aggiornare l'array di configurazione:
<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">  
    'config'=>array(
'config'=>array(
        'debug'=>0,
'debug'=>0,
        'debugsql'=>0,
'debugsql'=>0,
        'LimeSurveySetting'=>'New value', // Update default LimeSurvey config here
'LimeSurveySetting'=>'Nuovo valore', // Aggiorna la configurazione predefinita di LimeSurvey qui
    )
)
</syntaxhighlight>
</syntaxhighlight>


=Yii settings=
=Impostazioni Yii=


LimeSurvey uses the Yii framework, which has its own configuration parameters in application/config/'''internal.php''' and application/config/'''config.php''' file. You can also access some specific configuration settings of LimeSurvey via the Yii configuration.
LimeSurvey utilizza il framework Yii, che ha i propri parametri di configurazione nei file application/config/'''internal.php''' e application/config/'''config.php'''. Puoi anche accedere ad alcune impostazioni di configurazione specifiche di LimeSurvey tramite la configurazione di Yii.


Since config.php array is merged to the whole config, you can replace any Yii params in the config.php file.
Poiché l'array config.php è unito all'intera configurazione, puoi sostituire qualsiasi parametro Yii nel file config.php.


The Yii specific settings are set in the components array:
Le impostazioni specifiche di Yii sono impostate nell'array dei componenti:
<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">  
    'components' => array(
'componenti' => array(
        'db' => array(
'db' => array(
            ....
....
        ),
),
        'Specific settings'=>array(
'Impostazioni specifiche'=>array(
            ....
....
        ),
),
    ),
),
</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.]}}
{{Nota|Per ulteriori informazioni sul framework Yii, accedere al [http://www.yiiframework.com/doc-2.0/guide-index.html seguente collegamento.]}}


==Impostazioni Database==
==Impostazioni Database==
Line 47: Line 45:
Vedi anche [[http://www.yiiframework.com/doc/blog/1.1/en/prototype.database#establishing-database-connection Yii documentation]], e per piacere ricorda che LimeSurvey supporta solo le seguenti tipologie di database: mysql, pgsql, dblib, mssql e sqlsrv.
Vedi anche [[http://www.yiiframework.com/doc/blog/1.1/en/prototype.database#establishing-database-connection Yii documentation]], e per piacere ricorda che LimeSurvey supporta solo le seguenti tipologie di database: mysql, pgsql, dblib, mssql e sqlsrv.


<div class="mw-translate-fuzzy">
==Impostazioni sessione==
==Impostazioni di Sessione==
Puoi settare alcuni parametri di sessione in config.php, un primo esempio è la sessione nel database. Puoi decommentare/aggiungere le parti di cui necessiti in config.php.
Vedi [[http://www.yiiframework.com/doc/api/1.1/CHttpSession Yii Documentation]], per altre impostazioni.
</div>


You can set some session parameters in config.php (check the two examples from below). You can uncomment/add the part needed in config.php. See the [http://www.yiiframework.com/doc/api/1.1/CHttpSession Yii Documentation] for other settings.
Puoi impostare alcuni parametri di sessione in config.php (controlla i due esempi di seguito). Puoi decommentare/aggiungere la parte necessaria in config.php. Vedere la [http://www.yiiframework.com/doc/api/1.1/CHttpSession Documentazione Yii] per altre impostazioni.


{{Alert|If you need to update session settings to have multiple LimeSurvey instances running on the same server, check if you don't have to update [[Optional_settings#Request_settings|request settings]] for crsf cookie.}}
{{Avviso|Se devi aggiornare le impostazioni della sessione per avere più istanze di LimeSurvey in esecuzione sullo stesso server, controlla se non devi aggiornare [[Optional_settings#Request_settings|impostazioni della richiesta]] per il cookie crsf.}}


===Use table-based sessions===
===Usa sessioni basate su tabella===


LimeSurvey can use table-based sessions, you find a commented part on the default config.php generated file. To use table-based session, remove the // before each line.
LimeSurvey può utilizzare sessioni basate su tabelle, trovi una parte commentata nel file generato config.php predefinito. Per utilizzare una sessione basata su tabella, rimuovere // prima di ogni riga.


<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">
        'session' => array (
'session' => array (
            'class' => 'application.core.web.DbHttpSession',
'class' => 'application.core.web.DbHttpSession',
            'connectionID' => 'db',
'connectionID' => 'db',
            'sessionTableName' => '{{sessions}}',
'sessionTableName' => '{{sessions} }',
        ),
),
</syntaxhighlight>
</syntaxhighlight>


{{Alert|Table-based sessions are currently not supported on MSSQL server.}}
{{Avviso|Le sessioni basate su tabella non sono attualmente supportate sul server MSSQL.}}


===Other sessions update===
===Aggiornamento di altre sessioni===


If you use SSL ('https') for your LimeSurvey installation, adding the following lines to your config.php will increase the security of the session:
Se utilizzi SSL ("https") per l'installazione di LimeSurvey, l'aggiunta delle seguenti righe al file config.php aumenterà la sicurezza della sessione:
<syntaxhighlight lang="php" enclose="pre">       // Set the cookie via SSL
<syntaxhighlight lang="php" enclose="pre"> // Imposta il cookie tramite SSL
        'session' => array (
'session' => array (
            'cookieParams' => array(
'cookieParams' => array(
                    'secure' => true, // use SSL for cookies
'secure' => true, // utilizza SSL per i cookie
                    'httponly' => true // Cookies may not be used by other protocols - experimental
'httponly' => true // I cookie non possono essere utilizzati da altri protocolli - sperimentale
                ),
),
            ),
),
</syntaxhighlight>
</syntaxhighlight>


If you want to fix the domain for a cookie, use the following syntax in config.php:
Se vuoi correggere il dominio per un cookie, usa la seguente sintassi in config.php:
<syntaxhighlight lang="php" enclose="pre">       // Set the domain for cookie
<syntaxhighlight lang="php" enclose="pre"> // Imposta il dominio per cookie
        'session' => array (
'session' => array (
            'cookieParams' => array(
'cookieParams' => array(
                    'domain' => '.example.org',
'domain' => '.example.org',
                ),
),
            ),
),
</syntaxhighlight>
</syntaxhighlight>


If you have mutiples installation on the same server, it can be more quick and easy to set different session name for each LimeSurvey instance. This can be need for IE11 in some condition (see [https://bugs.limesurvey.org/view.php?id=12083#c42892 issue 12083])
Se hai più installazioni sullo stesso server, può essere più facile e veloce impostare un nome di sessione diverso per ogni istanza di LimeSurvey. Questo può essere necessario per IE11 in alcune condizioni (vedi [https://bugs.limesurvey.org/view.php?id=12083#c42892 issue 12083])
<syntaxhighlight lang="php" enclose="pre">       // Set the name of the session
<syntaxhighlight lang="php" enclose="pre"> // Imposta il nome della sessione
        'session' => array (
'session' => array (
            'sessionName' => "LimeSurveyN1",
'sessionName' => "LimeSurveyN1",
            ),
),
</syntaxhighlight>
</syntaxhighlight>


==Request settings==
==Impostazioni della richiesta==
The request settings are important, but the default settings are already optimized for LimeSurvey usage. To read more about them, see the [http://www.yiiframework.com/doc/api/1.1/CHttpRequest Yii Documentation].
Le impostazioni della richiesta sono importanti, ma le impostazioni predefinite sono già ottimizzate per l'utilizzo di LimeSurvey. Per saperne di più su di loro, vedere la [http://www.yiiframework.com/doc/api/1.1/CHttpRequest Documentazione Yii].


For example, the LimeSurvey request settings configuration may be modified in the following way (at your own risk) :
Ad esempio, la configurazione delle impostazioni della richiesta di LimeSurvey può essere modificata nel modo seguente (a proprio rischio):
<syntaxhighlight lang="php" enclose="pre">       // Disable CSRF protection
<syntaxhighlight lang="php" enclose="pre"> // Disabilita la protezione CSRF
        'request' => array(
'request' => array(
            'enableCsrfValidation'=>false,  
'enableCsrfValidation'=>false,  
            ),
),
</syntaxhighlight>
</syntaxhighlight>  
<syntaxhighlight lang="php" enclose="pre">       // Enforce a certain URL base
<syntaxhighlight lang="php" enclose="pre"> // Applica una determinata base di URL  
        'request' => array(
'request' => array(
            'hostInfo' => 'http://www.example.org/'   
'hostInfo' => 'http://www.example.org/'  
            ),
  ),
</syntaxhighlight>
</syntaxhighlight>  
<syntaxhighlight lang="php" enclose="pre">       // Set the cookie domain name and path for CSRF protection, path is used if you have different instance on same domain
<syntaxhighlight lang="php" enclose="pre"> // Imposta il nome di dominio del cookie e il percorso per la protezione CSRF, il percorso viene utilizzato se hai un'istanza diversa sullo stesso dominio
        'request' => array(
'request' => array(
            'csrfCookie' => array(  
'csrfCookie' => array(  
                'domain' => '.example.com',
'domain' => '.example.com',
                'path' => '/limesurvey/',
'path' => '/limesurvey/',
            )
)  
        ),
),
</syntaxhighlight>
</syntaxhighlight>


If you need to update only the url for token emails, set your [[Optional_settings#Advanced_path_settings|publicurl]] in your config.php file.
Se devi aggiornare solo l'url per le email token, imposta il tuo [[Optional_settings#Advanced_path_settings|publicurl]] nel tuo file config.php.
 


==Consenti l'utilizzo della sessione e della convalida Csrf nell'iFrame {{NewIn|v=3.24.3}}==


==Allow usage of session and Csrf Validation in iFrame {{NewIn|v=3.24.3}}==
<div class="mw-translate-fuzzy">
Dopo aver consentito l'[[Global_settings#Security|Incorporamento Iframe]] è necessario aggiornare alcune parti della configurazione. Attenzione, anche con tutte le impostazioni: il modulo Consenti in iframe può rompersi su alcuni browser. Questa impostazione è stata testata con Firefox 81.0.2 e Chromium 85.0.4183.121.
</div>


After allow [[Global_settings#Security|Iframe embedding]] you need to update some configuration part. Attention, even with all settings : allow form in iframe can broke on some browser. This settings was tested with Firefox 81.0.2 and Chromium 85.0.4183.121.
{{Alert|Attention, even with all settings : allow form in iframe can broke on some browser or with user specific settings. This settings was tested with Firefox 81.0.2 to 115 and Chromium 85.0.4183.121 to 119, and119 Edge with default settings. '''No support on this feature, only community support'''.}}


===Allow session start in iframe===
===Consenti avvio sessione in iframe===


The session need to be secure (valid https) , httponly and samesite to None. All settings must be sent all lowercase.
La sessione deve essere sicura (https valido), httponly e samesite su None. Tutte le impostazioni devono essere tutte minuscole.


<syntaxhighlight lang="php" enclose="pre"> 'session' => array (
<syntaxhighlight lang="php" enclose="pre">'session' => array (
'sessionName'=>'LS-VBXZZORFJZCAKGYI',
'sessionName'=>'LS-VBXZZORFJZCAKGYI',
// Uncomment the following lines if you need table-based sessions.
// Rimuovi il commento dalle seguenti righe se hai bisogno di sessioni basate su tabella.
// Note: Table-based sessions are currently not supported on MSSQL server.
// Nota: le sessioni basate su tabella sono attualmente non supportato sul server MSSQL.
// 'class' => 'application.core.web.DbHttpSession',
// 'class' => 'application.core.web.DbHttpSession',
// 'connectionID' => 'db',
// 'connectionID' => 'db',
// 'sessionTableName' => '{{sessions}}',
// 'sessionTableName' = > '{{sessions}}',
'cookieParams' => array(
'cookieParams' => array(
'secure' => true,
'secure' => true,
'httponly' => true,
'httponly' => true,
'samesite' => 'None',
'samesite' => 'Nessuno' ,
),
),
),
),
</syntaxhighlight>
</syntaxhighlight>


===Allow csrf cookie in iframe===
===Consenti cookie csrf in iframe===


Same than session: must be secure and samesite to None. Whole array must be added at same level than session
<div class="mw-translate-fuzzy">
Uguale alla sessione: deve essere sicuro e samesite impostato su Nessuno. L'intero array deve essere aggiunto allo stesso livello della sessione.
</div>


<syntaxhighlight lang="php" enclose="pre"> 'request' => array(
<syntaxhighlight lang="php" enclose="pre">'request' => array(
'enableCsrfValidation'=>true,
'enableCsrfValidation'=>true,
'csrfCookie' => array(
'csrfCookie' => array(
'sameSite' => 'None',
'sameSite' => 'Nessuno',
'secure' => true,
'secure' => true,! N! ),
),
),
),
</syntaxhighlight>
</syntaxhighlight>


==URL settings==
==Impostazioni URL==


{{Alert|If you need to update only the url for token and other emails, set your [[Optional_settings#Advanced_url_settings|publicurl]] in your config.php file.}}
{{Avviso|Se devi aggiornare solo l'url per il token e altre email, imposta le tue [[Optional_settings#Advanced_url_settings|publicurl]] nel tuo file config.php.}}


To change the default URL settings, update the urlManager:
Per modificare le impostazioni URL predefinite, aggiorna urlManager:
<syntaxhighlight lang="php" enclose="pre">       // Use short URL
<syntaxhighlight lang="php" enclose="pre"> // Usa URL breve
'urlManager' => array(
'urlManager' => array(
'urlFormat' => 'path',
'urlFormat' => 'percorso',
'showScriptName' => false,
'showScriptName' => false,
),
),
</syntaxhighlight>
</syntaxhighlight>




You can also add .html after the survey id in the following way:
Puoi anche aggiungere .html dopo l'ID del sondaggio nel modo seguente:
<syntaxhighlight lang="php" enclose="pre">       // Use short URL
<syntaxhighlight lang="php" enclose="pre"> // Usa URL breve
'urlManager' => array(
'urlManager' => array(
'urlFormat' => 'path',
'urlFormat' => 'percorso',
'rules' => array (
'rules' => array (
    '<sid:\d+>' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
'<sid:\d+> ' => array('sondaggio/indice','urlSuffix'=>'.html','matchValue'=>true),
),
),
'showScriptName' => false,
'showScriptName' => falso,
),
),
</syntaxhighlight>
</syntaxhighlight>  
For more information, check the [http://www.yiiframework.com/doc/guide/1.1/en/topics.url Yii documentation].
Per ulteriori informazioni, consulta la [http://www.yiiframework.com/doc/guide/1.1/en/topics.urldocumentazione Yii].


==Logging settings==
==Impostazioni di registrazione==


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.
Yii fornisce diverse soluzioni per generare i log. Per saperne di più, consulta l'[http://www.yiiframework.com/doc/guide/1.1/en/topics.logging logging special topic]. LimeSurvey utilizza '1' o '2' per impostazione predefinita, che consente a tutti gli utenti web di vedere i log. Puoi creare le tue impostazioni usando direttamente Yii.


For example, a quick solution to log errors and warnings in files is:  
Ad esempio, una soluzione rapida per registrare errori e avvisi nei file è:  
<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">  
return array(
return array(
'components' => array(
'components' => array(
/* Other component part here 'db' for example */
/* Altro componente qui 'db' per esempio */
'log' => array(
'log' => array(
'routes' => array(
'routes' => array(
'fileError' => array(
'fileError' => array(
'class' => 'CFileLogRoute',
'class' => 'CFileLogRoute',
'levels' => 'warning, error',
'levels' => 'avviso, errore',
'except' => 'exception.CHttpException.404',
'except' => 'exception.CHttpException .404',
),
),
),
),
),
),
/* Other component part here 'urlManager' for example */
/* Altro componente qui 'urlManager' ad esempio */
),
),
/* Final part (with 'runtimePath' 'config' for example) */
/* Parte finale (con ' runtimePath' 'config' per esempio) */
);
);
</syntaxhighlight>
</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.}}
{{Hint|Text=Il file viene salvato per impostazione predefinita in<nowiki> <code>limesurvey/tmp/runtime/application.log</code></nowiki> , che si trova nella cartella principale di LimeSurvey.}}
{{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]].}}.
{{Alert|Yii utilizza il percorso di runtime. Per impostazione predefinita, i log sono accessibili tramite Web. Possono contenere molte informazioni dal tuo server. È preferibile utilizzare una directory a cui non è possibile accedere tramite il Web. Puoi impostarlo nei percorsi o aggiornando il [[Optional settings#Yii settings#Runtime path|Runtime path]].}}.


==Runtime path==
==Percorso di runtime==


[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:
[http://www.yiiframework.com/doc/guide/1.1/en/basics.convention#directory Il percorso di runtime] deve essere una directory leggibile e scrivibile per l'"utente web". Tuttavia, il percorso di runtime contiene file con potenziali informazioni sulla sicurezza che si trovano nell'area di accesso Web pubblica. LimeSurvey raccoglie questi file nella directory temp della directory root di LimeSurvey. Per eliminare l'accesso a dati così importanti, è possibile impostare il percorso di runtime al di fuori dell'accesso Web pubblico modificando le rispettive righe nel file /application/config/config.php:


<syntaxhighlight lang="php" enclose="pre">  
<syntaxhighlight lang="php" enclose="pre">
return array(
return array(
  'components' => array(
'components' => array(
    […]
[…]
    'runtimePath'=>'/var/limesurvey/runtime/',
'runtimePath'=>'/var/limesurvey/runtime/',
    'config'=>array(
'config'=>array(  
    […]
[…]
    )
)
  )
)
)
)
</syntaxhighlight>
</syntaxhighlight>


=General settings=
=Impostazioni generali=


*'''sitename''': Gives your survey site a name. This name will appear in the survey list overview and in the administration header. The default value is 'LimeSurvey' and it can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
*'''sitename''': assegna un nome al sito del sondaggio. Questo nome apparirà nella panoramica dell'elenco dei sondaggi e nell'intestazione dell'amministrazione. Il valore predefinito è 'LimeSurvey' e può essere sovrascritto nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificato in config.php.
*'''siteadminemail:''' This is the default email address of the site administrator and it is used for system messages and contact options. This setting is used only as default value and can be overridden in the [[Global settings|global settings]] dialog.
*'''siteadminemail:''' Questo è l'indirizzo email predefinito di l'amministratore del sito e viene utilizzato per i messaggi di sistema e le opzioni di contatto. Questa impostazione è utilizzata solo come valore predefinito e può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]].
*'''siteadminbounce:''' This is the email address where bounced emails will be sent to. This setting is used only as default value and can be  overridden by the [[Global settings|global settings]] dialog.
*'''siteadminbounce:''' Questo è l'indirizzo email a cui verranno inviate le email respinte. Questa impostazione è usata solo come valore predefinito e può essere sovrascritta dalla finestra di dialogo [[Impostazioni globali|impostazioni globali]].
*'''siteadminname:''' The real name of the site administrator. This setting is used only as default value and can be overridden in the [[Global settings|global settings]] dialog).
*'''siteadminname:''' Il vero nome dell'amministratore del sito. Questa impostazione è usata solo come valore predefinito e può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]].
*'''proxy_host_name:''' This is the host name of your proxy server (it has to be mentioned if you are behind a proxy and you want to update LimeSurvey using [[ComfortUpdate|ComfortUpdate]]).
*'''proxy_host_name:''' Questo è il nome host del tuo server proxy (ha da menzionare se sei dietro un proxy e vuoi aggiornare LimeSurvey usando [[ComfortUpdate|ComfortUpdate]]).
*'''proxy_host_port:''' This is the port of your proxy server (it has to be mentioned if you are behind a proxy and you want to update LimeSurvey using [[ComfortUpdate|ComfortUpdate]]).
*'''proxy_host_port:''' Questa è la porta del tuo server proxy (deve essere menzionato se sei dietro un proxy e vuoi aggiornare LimeSurvey usando [[ComfortUpdate|ComfortUpdate]]).


= Security=
= Sicurezza=


* '''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.  
* '''maxLoginAttempt''': questo è il numero di tentativi che un utente deve inserire per inserire la password corretta prima che il suo indirizzo IP venga bloccato/bloccato. Il valore predefinito è 3 e può essere modificato da 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.
* '''timeOutTime''': Se l'utente inserisce la password in modo errato per<maxLoginAttempt> , lei o lui viene bloccato per<timeOutTime> secondi. Il valore predefinito è 10 minuti e può essere modificato da 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|global settings]] dialog or edited in config.php.
* '''maxLoginAttemptParticipants''': Questo è il numero di tentativi che un partecipante ha a disposizione per inserire un token valido prima di ottenere il suo Indirizzo IP bloccato/bloccato. Il valore predefinito è 3 e può essere modificato da 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|global settings]] dialog or edited in config.php.
* '''timeOutParticipants''': Se il partecipante inserisce il token in modo errato per<maxLoginAttemptParticipants> , lei o lui viene bloccato per<timeOutParticipants> secondi. Il valore predefinito è 10 minuti e può essere modificato da 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.. <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.
* '''surveyPreview_require_Auth''': impostato su true per impostazione predefinita. Se lo imposti su 'false', chiunque può testare il tuo sondaggio utilizzando l'URL del sondaggio, senza accedere al pannello di amministrazione e senza dover prima attivare il sondaggio. Questa impostazione è un valore predefinito e può essere sovrascritto nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificato 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:
* '''usercontrolSameGroupPolicy''': impostato su true per impostazione predefinita. Per impostazione predefinita, gli utenti non amministratori definiti nell'interfaccia di gestione di LimeSurvey potranno vedere solo gli utenti che creano o gli utenti che appartengono ad almeno uno stesso gruppo. Il valore predefinito può essere sovrascritto nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificato in config.php.
** Disables admin user's details and password changing;
*'''filterxsshtml:''' Questa impostazione abilita il filtraggio dei tag html sospetti che si trovano all'interno dei sondaggi, gruppi e testi di domande e risposte nell'interfaccia di amministrazione. Lascia questo su 'false' solo se ti fidi assolutamente degli utenti che hai creato per l'amministrazione di LimeSurvey e se vuoi permettere a questi utenti di poter usare Javascript, Flash Movies, ecc.. <span class="warning">I super admin non hanno mai il loro HTML filtrato</span> . Il valore predefinito può essere sovrascritto nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificato in config.php.
** Disables the upload of files on the template editor;
*'''demoMode:''' Se questa opzione è impostata su 'true' in config.php , LimeSurvey entrerà in modalità demo. La modalità demo cambia le seguenti cose:
** Disables sending email invitations and reminders;
** Disabilita i dettagli dell'utente amministratore e la modifica della password;
** Disables the creation of a database dump;
** Disabilita il caricamento di file sull'editor di modelli;
** Disables the ability to modify the following global settings: site name, default language, default HTML editor mode, XSS filter.
** Disabilita l'invio di inviti e promemoria via e-mail;!N !** Disabilita la creazione di un dump del database;
*'''forcedsuperadmin:''' Array of user id whith all rights on all LimeSurvey. This settings can only be updated in config.php file. This user's rights can not be edited in [[Manage_users#Set_global_permissions_for_a_user|global permissions for a user]] even by other forced super administrator. By default : user with this rights is user with id : 1. The first user created just after installation.
** Disabilita la possibilità di modificare le seguenti impostazioni globali: nome del sito, lingua predefinita, modalità editor HTML predefinita, filtro XSS.
*'''force_ssl:''' forces LimeSurvey to run through HTTPS or to block HTTPS. See [https://manual.limesurvey.org/Global_settings#Security Force HTTPS] in global settings admin GUI.
*'''forcedsuperadmin:' '' Array di user id con tutti i diritti su tutti i LimeSurvey. Queste impostazioni possono essere aggiornate solo nel file config.php. I diritti di questo utente non possono essere modificati in [[Manage_users#Set_global_permissions_for_a_user|autorizzazioni globali per un utente]] nemmeno da altri super amministratori forzati. Per impostazione predefinita: l'utente con questi diritti è utente con id: 1. Il primo utente creato subito dopo l'installazione.
*'''ssl_emergency_override:''' This setting forces SSL off. If You've turned HTTPS/SSL on in the global settings but your server doesn't have HTTPS enabled, the only way to turn it off is by changing a value in the database directly. This allows you to force HTTPS off while you change the global settings for Force Secure. This should always be false except in emergencies where you change it to true until you fix the problem. This setting can be only set via config.php file.
*'''force_ssl:''' forza LimeSurvey a funzionare tramite HTTPS oa bloccare HTTPS. Vedi [https://manual.limesurvey.org/Global_settings#Security Force HTTPS] nella GUI di amministrazione delle impostazioni globali.
*'''ssl_disable_alert:''' Disable alert for super-admin about unforced SSL, if you really can not or don't want to force ssl. This setting can be only set via config.php file.
*'''ssl_emergency_override:''' Questa impostazione forza la disattivazione di SSL. Se hai attivato HTTPS/SSL nelle impostazioni globali ma il tuo server non ha HTTPS abilitato, l'unico modo per disattivarlo è modificare direttamente un valore nel database. Ciò consente di forzare la disattivazione di HTTPS mentre si modificano le impostazioni globali per Force Secure. Questo dovrebbe essere sempre falso tranne in caso di emergenza in cui lo si cambia in vero fino a quando non si risolve il problema. Questa impostazione può essere impostata solo tramite il file config.php.
*'''ssl_disable_alert:''' Disabilita l'avviso per super-admin su SSL non forzato, se davvero non puoi o non vuoi forzare ssl. Questa impostazione può essere impostata solo tramite il file config.php.


= Resources=
= 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|global settings]] dialog.
*'''sessionlifetime:''' Definisce il tempo in secondi dopo il quale scade una sessione di sondaggio. Si applica solo se si utilizzano sessioni di database. Se usi sessioni di database, cambia il parametro in config.php o sostituisci il valore predefinito dalla finestra di dialogo [[Impostazioni globali|impostazioni globali]].
*'''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.  
*'''memorylimit:''' Questo determina quanta memoria LimeSurvey può accedere. '128 MB' è il minimo consigliato (MB=Megabyte). Se ricevi errori di timeout o hai problemi a generare statistiche o ad esportare file, aumenta questo limite a '256 MB' o superiore. Se il tuo server web ha impostato un limite più alto in config.php, questa impostazione verrà ignorata.  


<div class="warningbox">'''Please bear in mind that such local settings can always be overruled by the changes done in the global settings dialog'''.</div>
<div class="warningbox">'''Tieni presente che tali impostazioni locali possono sempre essere annullate dalle modifiche apportate nella finestra di dialogo delle impostazioni globali'''.</div>


To increase the memory limit to 128M you could also try adding:
Per aumentare il limite di memoria a 128M puoi anche provare ad aggiungere:
*memory_limit = 128M to your server's main php.ini file (recommended, if you have access)
*memory_limit = 128M al file php.ini principale del tuo server (consigliato, se hai accesso)
*memory_limit = 128M to a php.ini file in the LimeSurvey root
*memory_limit = 128M a un file php.ini in la radice di LimeSurvey
*php_value memory_limit 128M in a .htaccess file in the LimeSurvey root
*php_value memory_limit 128M in un file .htaccess nella radice di LimeSurvey


*'''max_execution_time:''' Set the number of seconds a script is allowed to run. If this is reached, the script returns a fatal error. To be allowed to export big survey data and statistics, LimeSurvey try to set it by default to 1200 seconds. You can set a bigger time or a lower time if needed. Only accessible via php config file.
*'''max_execution_time:''' Imposta il numero di secondi che uno script può eseguire. Se questo viene raggiunto, lo script restituisce un errore irreversibile. Per poter esportare dati e statistiche di grandi sondaggi, LimeSurvey prova a impostarlo per impostazione predefinita su 1200 secondi. È possibile impostare un tempo maggiore o minore se necessario. Accessibile solo tramite il file di configurazione php.


=Appearance=
=Aspetto=
*'''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|2.50}}: quando "R" è selezionato per <code>$dropdowns</code> , l'amministratore può impostare un numero massimo di opzioni che verranno visualizzate come pulsanti di opzione , prima di riconvertirlo in un elenco a discesa. Se c'è una domanda che ha un gran numero di opzioni, visualizzarle tutte contemporaneamente come pulsanti di opzione può sembrare ingombrante e può diventare controintuitivo per gli utenti. Impostandolo su un massimo di, diciamo 25 (che è l'impostazione predefinita), significa che gli elenchi di grandi dimensioni possono essere utilizzati più facilmente dagli amministratori per il partecipante al sondaggio.
*'''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:''' Con il tipo di domanda Array, spesso avrai molte domande secondarie che, quando visualizzate sullo schermo, occupano più di una pagina. Questa impostazione ti consente di decidere quante domande secondarie devono essere visualizzate prima di ripetere le informazioni di intestazione per la domanda. Una buona impostazione per questo è intorno a 15. Se non vuoi che le intestazioni si ripetano affatto, imposta questa impostazione su 0. Questa impostazione è sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] {{NewIn|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:''' Il numero minimo di domande secondarie rimanenti richieste prima di ripetere le intestazioni nelle domande matrice. Il valore predefinito è 3 e può essere modificato 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|global settings]] dialog or edited in config.php.
*'''defaulttemplate:''' Questa impostazione specifica il tema predefinito utilizzato per la 'lista pubblica' dei sondaggi. Questa impostazione può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificata in config.php.
*'''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:''' Imposta la modalità predefinita per l'editor HTML integrato. Questa impostazione può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificata in config.php. Le impostazioni valide sono:
** 'inline' - Inline replacement of fields by an HTML editor. Slow but convenient and user friendly;
** 'inline' - Sostituzione in linea dei campi con un editor HTML. Lento ma comodo e facile da usare;
** 'popup' - Adds an icon that runs the HTML editor in a popup if needed. Faster, but HTML code is displayed in the form;
** 'popup' - Aggiunge un'icona che esegue l'editor HTML in un popup se necessario. Più veloce, ma il codice HTML viene visualizzato nel modulo;
** 'none'- No HTML editor;
** 'none'- Nessun editor HTML;
*'''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:''' Definisce come vengono visualizzate le colonne per le risposte al sondaggio quando si utilizza [[QS: Visualizza_colonne|visualizza_colonne]]. Può essere modificato nel file config.php. Le impostazioni valide sono:  
** 'css' - it uses one of the various CSS methods to create columns (see the template style sheet for details);
** 'css' - utilizza uno dei vari metodi CSS per creare colonne (vedere il foglio di stile del modello per i dettagli);
** 'ul' - the columns are rendered as multiple floated unordered lists (default);
** 'ul' - le colonne sono visualizzate come multiple liste floated non ordinate (default);
** 'table' - it uses conventional-tables-based layout;
** 'table' - utilizza un layout basato su tabelle convenzionali;
** NULL - it disables the use of columns.
** NULL - disabilita l'uso delle colonne.


=Language & time=
=Lingua & ora=
*'''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 can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
*'''defaultlang:''' Questo dovrebbe essere impostato sulla lingua predefinita da usare nei tuoi script di amministrazione, e anche l'impostazione predefinita per la lingua nell'elenco dei sondaggi pubblici. Questa impostazione può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificata in config.php.
*'''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 I 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 can be overridden in the [[Global settings|global settings]] dialog or edited in config.php.
*'''timeadjust:''' Se il tuo server web si trova in un fuso orario diverso rispetto alla posizione in cui i tuoi sondaggi saranno basati, metti qui la differenza tra il tuo server e il fuso orario di casa. Ad esempio, vivo in Australia, ma utilizzo un server Web statunitense. Il server web è indietro di 14 ore rispetto al mio fuso orario locale. Quindi la mia impostazione qui è "14". In altre parole, aggiunge 14 ore al tempo dei server web. Questa impostazione è particolarmente importante quando i sondaggi effettuano il timestamp delle risposte. Questa impostazione può essere sovrascritta nella finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificata in config.php.


=Survey behavior=
=Comportamento del sondaggio=
*'''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.  
*'''deletenonvalues:''' Usa questa funzione con cautela. Per impostazione predefinita (un valore pari a 1), le domande irrilevanti vengono annullate nel database. Ciò garantisce che i dati nel database siano internamente coerenti. Tuttavia, ci sono rari casi in cui potresti voler mantenere valori irrilevanti, nel qual caso puoi impostare il valore su 0. Ad esempio, chiedi a una persona di sesso maschile il suo genere e lui dice accidentalmente "femmina" e poi risponde a una donna -domande specifiche (domande che sono condizionate dall'essere donne, quindi sono rilevanti solo per le donne). Quindi, si rende conto del suo errore, fa marcia indietro, imposta il genere su "maschio" e continua con il sondaggio. Ora, le domande specifiche per le donne sono irrilevanti. Se <code>$deletenonvalues==1</code> , quei valori irrilevanti verranno cancellati (NULL) nel database. Se <code>$deletenonvalues==0</code> , le sue risposte errate non verranno eliminate, quindi saranno ancora presenti nel database quando lo analizzi.  
*'''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:
*'''shownoanswer:''' Quando una domanda con pulsante di opzione/seleziona tipo che contiene risposte modificabili (ad es. domande List, Array) non è obbligatoria e 'shownoanswer' è impostata su 1, un ulteriore 'Nessuna risposta' viene visualizzata la voce, in modo che i partecipanti possano scegliere di non rispondere alla domanda. Alcune persone preferiscono che questo non sia disponibile. Questa impostazione può essere sovrascritta dalla finestra di dialogo [[Impostazioni globali|impostazioni globali]] o modificata in config.php. I valori validi sono:
**'0': No;  
**'0': No;  
**'1': Yes;
**'1': Sì;
**'2': The Survey admin can choose.
**'2': L'amministratore del sondaggio può scegliere.  
*'''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).
*'''printanswershonorsconditions:''' Questa impostazione determina se la funzione printanswers visualizzerà le voci delle domande che erano nascoste dalle condizioni-diramazione (Predefinito: 1 = nascondi le risposte dalle domande nascoste dalle condizioni).
*'''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.
*' ''hide_groupdescr_allinone:''' Questa impostazione è rilevante per i sondaggi all-in-one che utilizzano le condizioni . Quando è impostato su "true", il nome e la descrizione del gruppo sono nascosti se tutte le domande nel gruppo sono nascoste. Il valore predefinito è 'true': nasconde il nome e la descrizione del gruppo quando tutte le domande nel gruppo sono nascoste dalle condizioni. Può essere modificato in config.php.
*'''showpopups:'''  Show popup messages if mandatory or conditional questions have not been answered correctly:
*'''showpopups:''' Mostra i messaggi popup se le domande obbligatorie o condizionali non hanno ricevuto una risposta corretta:
**   '2' = defined by Theme option (default)
** '2' = definito dall'opzione Tema (predefinito )
**   '1'= show popup message;
** '1'= mostra il messaggio popup;
**   '0'= show message on page instead;
** '0'= mostra invece il messaggio sulla pagina;
** '-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).
** '-1'= non mostra affatto il messaggio (in questo caso , gli utenti vedranno comunque i suggerimenti specifici per le domande che indicano a quali domande è necessario rispondere).


== Numerical question type behavior  ==
== Comportamento del tipo di domanda numerica ==


*'''bFixNumAuto:''' Numeric fields can be automatically filtered to remove all non numeric values. By default this is enable, you can disable it globally. This settings is related to ''Fix automatically numeric value'' in core theme options. It was enable for ''Yes'', disable for ''Only for expression'' and ''No''.
*'''bFixNumAuto:''' I campi numerici possono essere filtrati automaticamente per rimuovere tutti i valori non numerici. Per impostazione predefinita questo è abilitato, puoi disabilitarlo a livello globale. Questa impostazione è correlata a ''Correggi automaticamente il valore numerico'' nelle opzioni del tema principale. Era abilitato per ''Sì'', disabilitato per ''Solo per espressione'' e ''No''.
*'''bNumRealValue:''' Numeric fields used in expression manager can be fixed or not. It's fixed by default. If NUMERIC is a numerical question : disable or 0 : {NUMERIC} with bad caracters send <nowiki>''</nowiki>, enable or 1 : {NUMERIC} send all character entered. This settings is related to ''Fix automatically numeric value'' in core theme options. It was enable for ''Yes'' and ''Only for expression'' and  disable for ''No''.
*'''bNumRealValue:''' I campi numerici utilizzati nel gestore espressioni possono essere corretti o meno. È fisso per impostazione predefinita. Se NUMERIC è una domanda numerica : disabilita o 0 : {NUMERIC} con caratteri errati invia<nowiki> ''</nowiki> , abilita o 1 : {NUMERIC} invia tutti i caratteri inseriti. Questa impostazione è correlata a ''Correggi automaticamente il valore numerico'' nelle opzioni del tema principale. Era abilitato per ''Sì'' e ''Solo per espressione'' e disabilitato per ''No''.


=Development and debugging=
=Sviluppo e debugging=
*'''debug:''' With this setting, you set the PHP error reporting to E_ALL. This means that every little notice, warning or error related to 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. The default value is '0' and it can be edited in config.php.  
*'''debug:''' Con questa impostazione, imposti la segnalazione degli errori PHP su E_ALL. Ciò significa che viene mostrato ogni piccolo avviso, avviso o errore relativo allo script. Questa impostazione deve essere impostata su "1" solo se si sta tentando di eseguire il debug dell'applicazione per qualsiasi motivo. Se sei uno sviluppatore, passa a "2". Non passare a "1" o "2" in produzione poiché potrebbe causare la divulgazione del percorso. Il valore predefinito è '0' e può essere modificato in config.php.  
*'''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 the optimization of the the number of queries. In order to activate it, change the default value to '1' from the config.php file.
*'''debugsql:''' Attiva questa impostazione se vuoi visualizzare tutte le query SQL eseguite per lo script in fondo a ogni pagina. Molto utile per l'ottimizzazione del numero di query. Per attivarlo, modifica il valore predefinito a '1' dal file config.php.
*'''use_asset_manager:''' By default : debug mode disable asset manager, you can allow you to use asse manager with debug mode enable.  
*'''use_asset_manager:''' Per impostazione predefinita: modalità di debug disabilita asset manager, puoi permetterti di utilizzare asset manager con la modalità di debug abilitata.  


In the case in which you experience an error in the application, we strongly recommend to activate the debug setting in order to get a more detailed error that you can submit with the bug report:
Nel caso in cui riscontri un errore nell'applicazione, ti consigliamo vivamente di attivare l'impostazione di debug per ottenere un errore più dettagliato che puoi inviare con la segnalazione del bug:


<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">
    'config'=>array(
'config'=>array(
        'debug'=>2,
'debug'=>2,
        'debugsql'=>0,
'debugsql'=>0,
    )
)
</syntaxhighlight>
</syntaxhighlight>


If you work on plugin and need a quick way to dump variables on screen : you can use traceVar function. If debug is set : this function use CWebLogRoute to be shown on HTML page. Usage <code>traceVar($MyVariable)</code>
Se lavori su plugin e hai bisogno di un modo rapido per scaricare le variabili sullo schermo: puoi usare la funzione traceVar. Se il debug è impostato: questa funzione usa CWebLogRoute per essere mostrata sulla pagina HTML. Utilizzo <code>traceVar($MyVariable)</code>


= Email settings=
= Impostazioni e-mail=


All the settings from below can be overridden in the [[Global settings|global settings]] dialog.
Tutte le impostazioni sottostanti possono essere sovrascritte nella finestra di dialogo [[Impostazioni globali|impostazioni globali]].
*'''emailmethod:'' This determines how email messages are being sent. The following options are available:
*'''emailmethod:'' Determina come vengono inviati i messaggi email. Sono disponibili le seguenti opzioni:
**'mail:' it uses internal PHP mailer;
**'mail:' utilizza il PHP mailer interno;
**'sendmail:' it uses sendmail mailer;
**'sendmail:' utilizza il mailer sendmail;
**'smtp:' it uses SMTP relaying. Use this setting when you are running LimeSurvey on a host that is not your mail server.
**'smtp:' utilizza l'inoltro SMTP. Usa questa impostazione quando esegui LimeSurvey su un host che non è il tuo server di posta.
*'''emailsmtphost:'' If you use 'smtp' as <code>$emailmethod</code>, 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'.
*'''emailsmtphost:'' Se usi 'smtp' come <code>$emailmethod</code> , devi inserire qui il tuo server SMTP. Se utilizzi la posta di Google potresti dover aggiungere il numero di porta come $emailsmtphost = 'smtp.gmail.com:465'.
*''emailsmtpuser:'' If your SMTP-server needs authentication then set this to your user name, otherwise it must be blank.
*''emailsmtpuser:'' Se il tuo server SMTP richiede l'autenticazione, impostalo sul tuo nome utente, altrimenti deve essere vuoto.
*''emailsmtppassword:'' If your SMTP-server needs authentication then set this to your password, otherwise it must be blank.
*''emailsmtppassword:'' Se il tuo server SMTP richiede l'autenticazione, imposta questo sulla tua password, altrimenti deve essere vuoto.
*''emailsmtpssl:'' Set this to 'ssl' or 'tls' to use SSL/TLS for SMTP connection.
*''emailsmtpssl:'' Imposta this a 'ssl' o 'tls' per utilizzare SSL/TLS per la connessione SMTP.
*''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 from the token control toolbar (not the button situated on the right of each token) sends the <maxemails> number of invitations, then it displays a list of the addresses of the recipients 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 out and come back at a later time to send the next batch of invites.
*''maxemails:'' Quando si inviano inviti o promemoria ai partecipanti al sondaggio, questa impostazione viene utilizzata per determinare quante email possono essere inviate un mazzo. Diversi server Web hanno diverse capacità di posta elettronica e se il tuo script impiega troppo tempo per inviare una serie di messaggi di posta elettronica, lo script potrebbe scadere e causare errori. La maggior parte dei server Web può inviare 100 e-mail alla volta entro il limite di tempo predefinito di 30 secondi per uno script PHP. Se ricevi errori di timeout dello script durante l'invio di un numero elevato di e-mail, riduci il numero in questa impostazione. Facendo clic sul pulsante "invia invito tramite posta elettronica" dalla barra degli strumenti di controllo del token (non sul pulsante situato a destra di ogni token) viene inviato il<maxemails> numero di inviti, quindi visualizza un elenco degli indirizzi dei destinatari e un avviso che ''ci sono più email in sospeso di quelle che potrebbero essere inviate in un batch. Continua a inviare e-mail facendo clic di seguito. Ci sono ancora ### email da inviare.'' e fornisce un "pulsante continua" per procedere con il batch successivo. Cioè, l'utente determina quando inviare il batch successivo dopo che ogni batch viene inviato via email. Non è necessario attendere con questa schermata attiva. L'amministratore potrebbe disconnettersi e tornare in un secondo momento per inviare il prossimo gruppo di inviti.


= Statistics and response browsing=
= Statistiche e risposta browse=
*'''filterout_incomplete_answers:''' Control the default behavior of filtering incomplete answers when browsing or analyzing responses. For a discussion on incomplete responses see our [[Responses & statistics#Responses summary|browsing survey results wiki]]. Since these records can corrupt the statistics, an option is given to switch this filter on or off in several GUI forms. The parameter can be edited in the config.php. The following options are available:
*'''filterout_incomplete_answers:''' Controlla il comportamento predefinito del filtraggio delle risposte incomplete durante la navigazione o l'analisi delle risposte. Per una discussione sulle risposte incomplete, consulta il nostro [[Responses & statistics#Responses summary|browsing survey results wiki]]. Poiché questi record possono corrompere le statistiche, viene fornita un'opzione per attivare o disattivare questo filtro in diversi moduli della GUI. Il parametro può essere modificato in config.php. Sono disponibili le seguenti opzioni:
**'show': Allows you to visualize both complete and incomplete answers;
**'mostra': permette di visualizzare sia le risposte complete che quelle incomplete;
**'filter': It shows only complete answers;
**'filtro': mostra solo le risposte complete;
**'incomplete': Show only incomplete answers.
**'incomplete': mostra solo risposte incomplete.
*'''strip_query_from_referer_url''': This setting determines if the referrer URL saves the parameter or not. The default value is 'false' (in this case, the referrer URL saves all parameters). Alternatively, this value can be set to 'true' and the parameter part of the referrer URL will be removed.
*'''strip_query_from_referer_url''': questa impostazione determina se l'URL del referrer salva o meno il parametro. Il valore predefinito è 'false' (in questo caso, l'URL del referrer salva tutti i parametri). In alternativa, questo valore può essere impostato su 'true' e la parte del parametro dell'URL del referrer verrà rimossa.
*'''showaggregateddata:''' when activated, additional statistical values such as the arithmetic mean and standard deviation are shown. Furthermore, the data is aggregated to get a faster overview. For example, 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).
*'''showaggregateddata:''' quando attivato, vengono visualizzati valori statistici aggiuntivi come la media aritmetica e la deviazione standard mostrato. Inoltre, i dati vengono aggregati per ottenere una panoramica più rapida. Ad esempio, i risultati della scala 1+2 e 4+5 vengono sommati per avere una classifica generale come "buono" (1/2), "medio" (3) e "cattivo" (4/5). Ciò riguarda solo i tipi di domanda "A" (matrice di 5 punti) e "5" (scelta di 5 punti).
* '''PDF Export Settings:''' This feature activates PDF export for printable surveys and Print Answers. The PDF export function is totally experimental and the output is far from being perfect. Unfortunately, no support can be given at the moment - if you want to help to fix it, please get in touch with us.
* '''Impostazioni di esportazione PDF:''' Questa funzione attiva l'esportazione in PDF per sondaggi stampabili e Stampa risposte. La funzione di esportazione PDF è totalmente sperimentale e l'output è lungi dall'essere perfetto. Sfortunatamente, al momento non è possibile fornire supporto - se vuoi aiutarci a risolverlo, contattaci.
**'usepdfexport': Set '0' to disable and '1' to enable;
**'usepdfexport': Imposta '0' per disabilitare e '1' per abilitare;! N!**'pdfdefaultfont': Rappresenta il font predefinito che verrà utilizzato dalla funzione di esportazione pdf. Il valore predefinito è 'auto'. Per cambiarlo, devi impostarlo su uno dei [https://tcpdf.org/docs/fonts/ PDF core fonts].  
**'pdfdefaultfont': It represents the default font that will be used by the pdf export function. The default value is 'auto'. To change it, you have to set it to one of the [https://tcpdf.org/docs/fonts/ PDF core fonts].  
**'alternatepdffontfile': è un array con le chiavi della lingua e il carattere corrispondente. Il carattere predefinito per ogni lingua può essere sostituito nel file config.php;
**'alternatepdffontfile': It's an array with language keys and their corresponding font. The default font for each language can be replaced in the config.php file;
**'pdffontsize': mostra la dimensione del carattere per i testi normali; Per il titolo del sondaggio, lo è<pdffontsize> +4, mentre per il titolo di gruppo è<pdffontsize> +2. Può essere modificato nel file config.php o dalla finestra di dialogo [Impostazioni globali|impostazioni globali]];
**'pdffontsize': it shows the font size for normal texts; For the title of the survey, it is <pdffontsize>+4, while for the group title is <pdffontsize>+2. It can be edited in the config.php file or from the [Global settings|global settings]] dialog;
**'notsupportlanguages': include un elenco con le lingue per le quali non è stato trovato alcun font PDF. L'elenco include amarico ('am'), singalese ('si') e tailandese ('th') e può essere trovato nel file config-defaults.php;
**'notsupportlanguages': it includes a list with the languages for which no PDF font was found. The list includes Amharic ('am'), Sinhala ('si'), and Thai ('th'), and it can be found in the config-defaults.php file;
**'pdforientation': Set ' L' per Orizzontale o 'P' per formato verticale. Può essere modificato dal file config.php.
**'pdforientation': Set 'L' for Landscape or 'P' for portrait format. It can be edited from the config.php file.
*'''Graph setting'''
*'''Graph setting'''
**'chartfontfile': Sets the font file name that is used to create the statistical charts. The file has to be located in the fonts directory, located in the LimeSurvey root folder. It can be edited in the config.php file;
**'chartfontfile': Imposta il nome del file del carattere utilizzato per creare i grafici statistici. Il file deve trovarsi nella directory dei font, che si trova nella cartella principale di LimeSurvey. Può essere modificato nel file config.php;
**'alternatechartfontfile': It's an array with language keys and their corresponding font. It can be edited in the config.php file.
**'alternatechartfontfile': è un array con le chiavi della lingua e il carattere corrispondente. Può essere modificato nel file config.php.
*'''showsgqacode:''' This setting is used at the printable survey feature and defaults to 'false''. If you set showsgqacode = 'true';, the IDs of 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.
*'''showsgqacode:''' Questa impostazione viene utilizzata nella funzione di sondaggio stampabile e il valore predefinito è 'false''. Se imposti showsgqacode = 'true';, verranno mostrati gli ID di ogni domanda e la risposta se applicabile. Questi ID corrispondono all'intestazione della colonna nella tabella Lime_survey_12345, che contiene i dati delle risposte per un determinato sondaggio. Questi ID possono essere utilizzati per un libro di codici per query di database manuali.


= [[LDAP settings]]=
= [[Impostazioni LDAP]]=


As this is an extensive topic we have moved [[LDAP settings]] to [[LDAP settings|another page.]]
Poiché si tratta di un argomento vasto, abbiamo spostato [[Impostazioni LDAP]] in [[Impostazioni LDAP|un'altra pagina.]]


= Authentication=
= Autenticazione=


Starting with LimeSurvey 2.05, authentication will be handled by plugins. As a result, the information below might be outdated. See [[Plugins|the plugins wiki]] for most up to date information.
A partire da LimeSurvey 2.05, l'autenticazione sarà gestita dai plugin. Di conseguenza, le informazioni riportate di seguito potrebbero non essere aggiornate. Vedi [[Plugins|il wiki dei plugin]] per le informazioni più aggiornate.


== Authentication delegation to the webserver==
== Delega di autenticazione al server web==


System administrators may want to have their '''survey administrators''' authenticated against a central authentication system (Active Directory, openLdap, Radius, ...) rather than using the internal LimeSurvey database. An easy way to do this is to setup your web server software to use this external authentication system, and then ask LimeSurvey to trust the user identity reported by the web server. In order to enable this feature, you have to:
Gli amministratori di sistema potrebbero volere che i loro '''amministratori del sondaggio''' siano autenticati rispetto a un sistema di autenticazione centrale (Active Directory, openLdap, Radius, ...) piuttosto che utilizzare il database interno di LimeSurvey. Un modo semplice per farlo è impostare il software del server web in modo che utilizzi questo sistema di autenticazione esterno, quindi chiedere a LimeSurvey di fidarsi dell'identità dell'utente segnalata dal server web. Per abilitare questa funzione, devi:
* set '''auth_webserver''' to 'true' in config.php;
* impostare '''auth_webserver''' su 'true' in config.php;
* enable authentication from the web server side.
* abilitare l'autenticazione dal lato server web.


Please note that:
Si prega di notare che:
* LimeSurvey will then bypass its own authentication process (by using the login name reported by the web server without asking for a password);
* LimeSurvey ignorerà quindi il proprio processo di autenticazione (utilizzando il nome di accesso riportato dal server Web senza richiedere una password);
* this can only replace the LimeSurvey GUI authentication system, '''not the survey invitation system''' (participant interface).
* questo può sostituire solo il sistema di autenticazione della GUI di LimeSurvey, '' 'non il sistema di invito al sondaggio''' (interfaccia partecipante).


== Authentication delegation with no automatic user import==
== Delega di autenticazione senza importazione automatica degli utenti==


Please note that <u>Authentication Delegation doesn't bypass the LimeSurvey authorization system by default</u> - meaning that, even if you don't have to manage passwords in LimeSurvey, you still need to define the users in the LimeSurvey database and assign them the correct set of rights in order to let them access the administration panel.
Tieni presente che <u>la delega dell'autenticazione non ignora il sistema di autorizzazione di LimeSurvey per impostazione predefinita</u> , il che significa che, anche se non devi gestire le password in LimeSurvey, devi comunque definire gli utenti nel database di LimeSurvey e assegnare loro il set corretto di diritti per consentirgli di accedere al pannello di amministrazione.


A user is then granted access to LimeSurvey if and only if:
A un utente viene quindi concesso l'accesso a LimeSurvey se e solo se:
* he has been authenticated to the web server;
* è stato autenticato sul server web;
* his login name is defined as a user in the LimeSurvey user database (the user is then granted the privileges of the user defined in the LimeSurvey user database).
* il suo nome di accesso è definito come utente nel database degli utenti di LimeSurvey (all'utente viene quindi concesso il privilegi dell'utente definiti nel database utenti di LimeSurvey).


== Authentication delegation with automatic user import==
== Delega di autenticazione con importazione automatica degli utenti==


When managing a huge user database, it is sometimes easier to auto-import users in the LimeSurvey database:
Quando si gestisce un enorme database di utenti, a volte è più semplice importare automaticamente gli utenti nel database di LimeSurvey:
*'''auth_webserver_autocreate_user''': If set to 'true', LimeSurvey will try to auto-import users authenticated by the web server but not already in its users DB.
*'''auth_webserver_autocreate_user''': se impostato su 'true', LimeSurvey tenterà di importare automaticamente gli utenti autenticati da il server web ma non già nel suo DB utenti.
*'''auth_webserver_autocreate_profile''': An array describing the default profile that will be assigned to the user, including the full (fake) name, email, and privileges.
*'''auth_webserver_autocreate_profile''': un array che descrive il profilo predefinito che verrà assegnato all'utente, inclusi il nome completo (falso), l'e-mail e i privilegi.


If you want to customize the user profile so that it matches the logged-in user, you'll have to develop a simple function called '''hook_get_autouserprofile''' - with this function you can retrieve from a central user account database (for instance, from a LDAP directory) the true full name, names, and email of a particular user. You can even customize his privileges on the system based on the groups he is allocated in the external database.
Se vuoi personalizzare il profilo utente in modo che corrisponda all'utente che ha effettuato l'accesso, dovrai sviluppare una semplice funzione chiamata '''hook_get_autouserprofile''' - con questa funzione puoi recuperare da un database di account utente centrale (per esempio, da una directory LDAP) il vero nome completo, i nomi e l'e-mail di un particolare utente. Puoi persino personalizzare i suoi privilegi sul sistema in base ai gruppi che gli sono assegnati nel database esterno.


The '''hook_get_auth_webserver_profile''' function takes the user login name as the only argument and can return:
La funzione '''hook_get_auth_webserver_profile''' accetta il nome di login dell'utente come unico argomento e può restituire:
* False or an empty array - in this case the user is denied access to LimeSurvey;
* False o un array vuoto - in questo caso all'utente viene negato l'accesso a LimeSurvey;
* an array containing all common userprofile entries as described in the <code>$WebserverAuth_autouserprofile</code>
* un array contenente tutte le voci comuni del profilo utente come descritto in <code>$WebserverAuth_autouserprofile</code>
<syntaxhighlight lang="php" enclose="div">function hook_get_auth_webserver_profile($user_name)
<syntaxhighlight lang="php">function hook_get_auth_webserver_profile($user_name)
{
{
     // Retrieve user's data from your database backend (for instance LDAP) here
     // Retrieve user's data from your database backend (for instance LDAP) here
Line 417: Line 416:


     // 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.}}
{{Avviso|La funzione opzionale 'hook_get_auth_webserver_profile' è solo per utenti avanzati! Per ulteriori dettagli, leggi i commenti dal file config-defaults.php.}}


== User name mapping==
== Mappatura nome utente==


In the case in which some users have an external user name that is different from their LimeSurvey user name, you may find useful to use a user name mapping. This is done in LimeSurvey by using the '''auth_webserver_user_map''' parameter. For instance, imagine you don't have an 'admin' user name defined in your external authentication database. Then, in order to login to LimeSurvey as admin, you'll have to map your external user name (let's call it 'myname') to the admin login name in LimeSurvey. The corresponding setup is:
Nel caso in cui alcuni utenti abbiano un nome utente esterno diverso dal proprio nome utente LimeSurvey, può essere utile utilizzare una mappatura del nome utente. Questo viene fatto in LimeSurvey usando il parametro '''auth_webserver_user_map'''. Ad esempio, immagina di non avere un nome utente "admin" definito nel tuo database di autenticazione esterno. Quindi, per accedere a LimeSurvey come amministratore, dovrai mappare il tuo nome utente esterno (chiamiamolo 'myname') al nome di accesso dell'amministratore in LimeSurvey. La configurazione corrispondente è:


<syntaxhighlight lang="php" enclose="div">'config'=>array(
<syntaxhighlight lang="php">'config'=>array(
...
...
'auth_webserver_user_map' => array ('myname' => 'admin');
'auth_webserver_user_map' => array ('myname' => 'admin');
)</syntaxhighlight>
)</syntaxhighlight>
After a successful authentication with the 'myname' login and web server password, you'll be directly authorized to use LimeSurvey as the 'admin' user.  
Dopo un'autenticazione riuscita con il login 'myname' e la password del server web, sarai direttamente autorizzato a utilizzare LimeSurvey come utente 'admin'.  


This has serious security implications, so use it with care. Also, protect your config.php from write access by the web server.
Questo ha serie implicazioni sulla sicurezza, quindi usalo con cura. Inoltre, proteggi il tuo config.php dall'accesso in scrittura da parte del server web.


== Use one-time passwords==
=Utilizzare one-time password=


A user can open the LimeSurvey login page at default.com/limesurvey/admin and type the username and the one-time password which was previously written into the users table (column one_time_pw) by an external application.
Un utente può aprire la pagina di accesso di LimeSurvey all'indirizzo default.com/limesurvey/admin e digitare il nome utente e la password monouso che sono stati precedentemente scritti nella tabella degli utenti (colonna one_time_pw) da un'applicazione esterna.


This setting has to be turned on config.php file to enable the usage of one-time passwords (default = false).
Questa impostazione deve essere attivata nel file config.php per abilitare l'uso di password monouso (default = false).
<syntaxhighlight lang="php" enclose="pre">
<syntaxhighlight lang="php" enclose="pre">  
    'config'=>array(
'config'=>array(
        'debug'=>0,
'debug'=>0,
        'debugsql'=>0,
'debugsql'=>0,
        'use_one_time_passwords'=>true,
'use_one_time_passwords'=>true,
    )
)
</syntaxhighlight>
</syntaxhighlight>


More information can be found in the [[Manage users#Use one-time passwords|"Manage Users" section]].
Ulteriori informazioni sono disponibili nella sezione [[Gestisci utenti#Utilizza password monouso|"Gestisci utenti"]].




= Encryption settings {{NewIn|4.0.0}} =
= Impostazioni di crittografia {{NewIn|4.0.0}} =


{{Alert|title=Attention|text=Once set, encryption keys should never be changed, otherwise all encrypted data could be lost !}}
{{Alert|title=Attenzione|text=Una volta impostate, le chiavi di crittografia non devono mai essere modificate, altrimenti tutti i dati crittografati potrebbero andare persi!}}


{{Note|When update or install, this parameters was generated by LimeSurvey and set in <code>application/config/security.php</code> file. You can move this settings in config.php if you want or leave in security.php.}}
{{Nota|Durante l'aggiornamento o l'installazione, questi parametri sono stati generati da LimeSurvey e impostati nel file <code>application/config/security.php</code> . Puoi spostare queste impostazioni in config.php se vuoi o lasciare in security.php.}}


See [[data encryption]] for detail on this feature.
Vedere [[crittografia dei dati]] per i dettagli su questa funzione.


*'''encryptionkeypair'''
*'''coppia di chiavi di crittografia'''
*'''encryptionpublickey'''
*'''chiave pubblica di crittografia'''
*'''encryptionsecretkey'''
*'''chiave segreta di crittografia'''


= Advanced url settings=
= Impostazioni URL avanzate=


*'''publicurl:''' This should be set to the URL location of your 'public scripts'. The public scripts are those located in the "limesurvey" folder (or whatever name you gave to the directory that all the other scripts and directories are kept in). '''This settings is available in config.php and it is used when LimeSurvey need an absolute url (for example when token emails are sent).'''
*'''publicurl:''' Questo dovrebbe essere impostato sulla posizione dell'URL dei tuoi 'script pubblici'. Gli script pubblici sono quelli che si trovano nella cartella "limesurvey" (o qualunque nome tu abbia dato alla directory in cui sono conservati tutti gli altri script e directory). '''Questa impostazione è disponibile in config.php e viene utilizzata quando LimeSurvey necessita di un URL assoluto (ad esempio quando vengono inviate email token).'''
*'''homeurl:''' This should be set to the URL location of your administration scripts. These are located in the /limesurvey/admin folder. This should be set to the WEB URL location - for example, ''http://www.example.com/limesurvey/html/admin''. Don't add a trailing slash to this entry. The default setting in config.php attempts to detect the name of your server automatically using a php variable setting - <code>{$_SERVER<nowiki>[</nowiki>'SERVER_NAME']}</code>. '''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.'''
*'''homeurl:''' Questo dovrebbe essere impostato alla posizione dell'URL degli script di amministrazione. Questi si trovano nella cartella /limesurvey/admin. Dovrebbe essere impostato sulla posizione dell'URL WEB, ad esempio ''http://www.example.com/limesurvey/html/admin''. Non aggiungere una barra finale a questa voce. L'impostazione predefinita in config.php tenta di rilevare automaticamente il nome del tuo server utilizzando un'impostazione della variabile php - <code>{$_SERVER [ 'SERVER_NAME']}</code><nowiki> <code>{$_SERVER [ 'SERVER_NAME']}</code></nowiki> <code>{$_SERVER [ 'SERVER_NAME']}</code> . '''Nella maggior parte dei casi, puoi lasciarlo e modificare semplicemente il resto di questa stringa in modo che corrisponda al nome della directory in cui hai inserito gli script LimeSurvey.'''
*'''tempurl:''' This should be set to the URL location of your "/limesurvey/tmp" directory - or to a directory in which you would like LimeSurvey to use to serve temporary files.  
*'''tempurl:''' Questo dovrebbe essere impostato sulla posizione dell'URL della tua directory "/limesurvey/tmp" - o su una directory in cui desideri che LimeSurvey utilizzi per servire i file temporanei.  
*'''uploadurl:''' This should be set to the URL location of your "/limesurvey/upload" directory - or to a directory in which you would like LimeSurvey to use to serve uploaded files. This allow you to set uploaded files on another url domain.
*'''uploadurl:''' Questo dovrebbe essere impostato sulla posizione dell'URL della tua directory "/limesurvey/upload" - o su una directory in cui desideri che LimeSurvey utilizzi per servire i file caricati. Ciò ti consente di impostare i file caricati su un altro dominio URL.


= Advanced path settings=
= Impostazioni percorso avanzate=


*'''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  <code>{$_SERVER<nowiki>[</nowiki>'DOCUMENT_ROOT']}</code>. 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.
*'''homedir:''' Questo dovrebbe essere impostato sulla posizione del disco fisico dei tuoi script di amministrazione - per esempio "/home/usr/htdocs/limesurvey/admin". Non aggiungere una barra finale a questa voce. L'impostazione predefinita in config.php tenta di rilevare il percorso root predefinito di tutti i tuoi documenti utilizzando l'impostazione della variabile php <code>{$_SERVER [ 'DOCUMENT_ROOT']}</code><nowiki> <code>{$_SERVER [ 'DOCUMENT_ROOT']}</code></nowiki> <code>{$_SERVER [ 'DOCUMENT_ROOT']}</code> . Nella maggior parte dei casi puoi lasciarlo e modificare semplicemente il resto di questa stringa in modo che corrisponda al nome della directory in cui hai inserito gli script di LimeSurvey.
*'''publicdir:''' This should be set to the physical disk location of your 'public scripts'.
*'''publicdir:''' Questo dovrebbe essere impostato sulla posizione del disco fisico di i tuoi 'script pubblici'.
*'''tempdir:''' This should be set to the physical disk location of your /limesurvey/tmp directory so that the script can read and write files.
*'''tempdir:''' Questo dovrebbe essere impostato sulla posizione del disco fisico della tua directory /limesurvey/tmp in modo che lo script possa leggere e scrivere file.
*'''uploaddir:''' This should be set to the physical disk location of your /limesurvey/upload directory so that the script can read and write files.
*'' 'uploaddir:''' Dovrebbe essere impostato sulla posizione del disco fisico della directory /limesurvey/upload in modo che lo script possa leggere e scrivere file.
*'''sCKEditorURL:''' url of the fckeditor script.
*'''sCKEditorURL:''' url dello script fckeditor.  
*'''fckeditexpandtoolbar:''' defines if the fckeditor toolbar should be opened by default.
*'''fckeditexpandtoolbar:''' definisce se la barra degli strumenti fckeditor deve essere aperta per impostazione predefinita.
*'''pdfexportdir:''' This is the directory with the tcpdf.php extensiontcpdf.php.
*'''pdfexportdir:''' Questa è la directory con l'estensione tcpdf.phptcpdf.php.!N !*'''pdffonts:''' Questa è la directory per i font TCPDF.
*'''pdffonts:''' This is the directory for the TCPDF fonts.


= Other advanced settings=
= Altre impostazioni avanzate=


== Upload files==
== Carica file==


*'''allowedthemeuploads:''' File types allowed to be uploaded in theme editor
*'''allowedthemeuploads:''' Tipi di file che possono essere caricati nell'editor del tema
*'''allowedresourcesuploads:''' File types allowed to be uploaded in the resources sections, and with the HTML Editor
*'''allowedresourcesuploads:''' Tipi di file che possono essere caricati nelle sezioni delle risorse e con l'editor HTML
*'''allowedfileuploads''' {{NewIn|4.0.0}} Global restriction on file type to be uploaded
* '''allowedfileuploads''' {{NewIn|4.0.0}} Restrizione globale sul tipo di file da caricare
*'''magic_database:''' {{NewIn|3.17.17}} Allow to use a different MIME database for [https://www.php.net/manual/en/function.finfo-open.php finfo_open]. Can be updated only in config.php file. Example : <code>/usr/share/misc/magic.mgc</code> for redhat based linux.
*'''magic_database:''' {{NewIn|3.17.17}} Consenti di utilizzare un diverso Database MIME per [https://www.php.net/manual/en/function.finfo-open.php finfo_open]. Può essere aggiornato solo nel file config.php. Esempio: <code>/usr/share/misc/magic.mgc</code> per Linux basato su redhat.
*'''magic_file:''' {{NewIn|3.17.17}} Allow to use a different file to get the array of extension by mime type than the [https://github.com/LimeSurvey/LimeSurvey/blob/master/framework/utils/mimeTypes.php included one]. Must be a PHP file return an array. Can be updated only in config.php file.
*'''magic_file:''' {{NewIn|3.17.17}} Consente di utilizzare un file diverso per ottenere l'array di estensioni per tipo mime rispetto a [https://github.com/LimeSurvey/LimeSurvey/blob/master/application/core/utils/fileExtensions.php incluso uno]. Deve essere un file PHP e restituire un array. Può essere aggiornato solo nel file config.php.


== Update ==
== Aggiorna ==


*'''updatable:''' This setting is in version.php. Can be true or false. If you set to true : when an super admin user log in : LimeSurvey checks if an update is available and show you a warning. If set to false : no check is done and you can't use ComfortUpdate.
*'''aggiornabile:''' Questa impostazione è in version.php. Può essere vero o falso. Se imposti su true : quando un utente super amministratore accede : LimeSurvey controlla se è disponibile un aggiornamento e ti mostra un avviso. Se impostato su false : non viene effettuato alcun controllo e non è possibile utilizzare ComfortUpdate.

Latest revision as of 16:58, 2 April 2024

Other languages:

La sezione seguente è indirizzata a coloro che desiderano modificare quelle impostazioni di configurazione che non possono essere modificate con l'aiuto della GUI (Graphical User Interface) dell'installazione di LimeSurvey. Tieni presente che tutte le modifiche dalla directory principale di LimeSurvey vengono eseguite a tuo rischio. Tuttavia, nel caso in cui riscontri problemi/necessiti di ulteriore assistenza, unisciti ai forum di discussione o all'IRC channel per l'aiuto della community di LimeSurvey.

Come modificare le impostazioni opzionali

Per modificare le impostazioni di configurazione dell'installazione, è necessario modificare le impostazioni opzionali. Possono essere trovati in /application/config/config-defaults.php, che si trova nella directory principale di LimeSurvey. Le impostazioni predefinite dell'installazione standard si trovano in config-defaults.php. Alcuni di essi possono essere sovrascritti utilizzando la finestra di dialogo impostazioni globali, mentre gli altri dovranno essere modificati manualmente.

Template:Avviso

Quando si verifica un aggiornamento, vengono modificate solo le impostazioni di config-defaults.php. Pertanto, la modifica del file config.php salverà le impostazioni personalizzate.

Per aggiornare/aggiungere le impostazioni di LimeSurvey in /application/config/config.php, devi aggiornare l'array di configurazione: 

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Nuovo valore', // Aggiorna la configurazione predefinita di LimeSurvey qui
 )

Impostazioni Yii

LimeSurvey utilizza il framework Yii, che ha i propri parametri di configurazione nei file application/config/internal.php e application/config/config.php. Puoi anche accedere ad alcune impostazioni di configurazione specifiche di LimeSurvey tramite la configurazione di Yii.

Poiché l'array config.php è unito all'intera configurazione, puoi sostituire qualsiasi parametro Yii nel file config.php.

Le impostazioni specifiche di Yii sono impostate nell'array dei componenti: 

 
 'componenti' => array(
 'db' => array(
 ....
 ),
 'Impostazioni specifiche'=>array(
 ....
 ),
 ),

Template:Nota

Impostazioni Database

Le impostazioni del database sono scritte dall'installer nel file config.php quanto installi LimeSurvey per la prima volta. Se necessario, puoi aggiornare questa parte del file. Ricorda però che lo fai a tuo rischio. Vedi anche [Yii documentation], e per piacere ricorda che LimeSurvey supporta solo le seguenti tipologie di database: mysql, pgsql, dblib, mssql e sqlsrv.

Impostazioni sessione

Puoi impostare alcuni parametri di sessione in config.php (controlla i due esempi di seguito). Puoi decommentare/aggiungere la parte necessaria in config.php. Vedere la Documentazione Yii per altre impostazioni.

Template:Avviso

Usa sessioni basate su tabella

LimeSurvey può utilizzare sessioni basate su tabelle, trovi una parte commentata nel file generato config.php predefinito. Per utilizzare una sessione basata su tabella, rimuovere // prima di ogni riga. 

 'session' => array (
 'class' => 'application.core.web.DbHttpSession',
 'connectionID' => 'db',
 'sessionTableName' => '{{sessions} }',
 ),

Template:Avviso

Aggiornamento di altre sessioni

Se utilizzi SSL ("https") per l'installazione di LimeSurvey, l'aggiunta delle seguenti righe al file config.php aumenterà la sicurezza della sessione: 

 // Imposta il cookie tramite SSL
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // utilizza SSL per i cookie
 'httponly' => true // I cookie non possono essere utilizzati da altri protocolli - sperimentale
 ),
 ),

Se vuoi correggere il dominio per un cookie, usa la seguente sintassi in config.php: 

 // Imposta il dominio per cookie
 'session' => array (
 'cookieParams' => array(
 'domain' => '.example.org',
 ),
 ),

Se hai più installazioni sullo stesso server, può essere più facile e veloce impostare un nome di sessione diverso per ogni istanza di LimeSurvey. Questo può essere necessario per IE11 in alcune condizioni (vedi issue 12083) 

 // Imposta il nome della sessione
 'session' => array (
 'sessionName' => "LimeSurveyN1",
 ),

Impostazioni della richiesta

Le impostazioni della richiesta sono importanti, ma le impostazioni predefinite sono già ottimizzate per l'utilizzo di LimeSurvey. Per saperne di più su di loro, vedere la Documentazione Yii.

Ad esempio, la configurazione delle impostazioni della richiesta di LimeSurvey può essere modificata nel modo seguente (a proprio rischio): 

 // Disabilita la protezione CSRF
 'request' => array(
 'enableCsrfValidation'=>false, 
 ),

 // Applica una determinata base di URL 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Imposta il nome di dominio del cookie e il percorso per la protezione CSRF, il percorso viene utilizzato se hai un'istanza diversa sullo stesso dominio
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'path' => '/limesurvey/',
 ) 
 ),

Se devi aggiornare solo l'url per le email token, imposta il tuo publicurl nel tuo file config.php.


Consenti l'utilizzo della sessione e della convalida Csrf nell'iFrame (New in 3.24.3 )

Dopo aver consentito l'Incorporamento Iframe è necessario aggiornare alcune parti della configurazione. Attenzione, anche con tutte le impostazioni: il modulo Consenti in iframe può rompersi su alcuni browser. Questa impostazione è stata testata con Firefox 81.0.2 e Chromium 85.0.4183.121.

  Attention, even with all settings : allow form in iframe can broke on some browser or with user specific settings. This settings was tested with Firefox 81.0.2 to 115 and Chromium 85.0.4183.121 to 119, and119 Edge with default settings. No support on this feature, only community support.


Consenti avvio sessione in iframe

La sessione deve essere sicura (https valido), httponly e samesite su None. Tutte le impostazioni devono essere tutte minuscole. 

'session' => array (
 'sessionName'=>'LS-VBXZZORFJZCAKGYI',
 // Rimuovi il commento dalle seguenti righe se hai bisogno di sessioni basate su tabella.
 // Nota: le sessioni basate su tabella sono attualmente non supportato sul server MSSQL.
 // 'class' => 'application.core.web.DbHttpSession',
 // 'connectionID' => 'db',
 // 'sessionTableName' = > '{{sessions}}',
 'cookieParams' => array(
 'secure' => true,
 'httponly' => true,
 'samesite' => 'Nessuno' ,
 ),
 ),

Consenti cookie csrf in iframe

Uguale alla sessione: deve essere sicuro e samesite impostato su Nessuno. L'intero array deve essere aggiunto allo stesso livello della sessione. 

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

Impostazioni URL

Template:Avviso

Per modificare le impostazioni URL predefinite, aggiorna urlManager: 

 // Usa URL breve
 'urlManager' => array(
 'urlFormat' => 'percorso',
 'showScriptName' => false,
 ),


Puoi anche aggiungere .html dopo l'ID del sondaggio nel modo seguente: 

 // Usa URL breve
 'urlManager' => array(
 'urlFormat' => 'percorso',
 'rules' => array (
 '<sid:\d+> ' => array('sondaggio/indice','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => falso,
 ),

Per ulteriori informazioni, consulta la Yii.

Impostazioni di registrazione

Yii fornisce diverse soluzioni per generare i log. Per saperne di più, consulta l'logging special topic. LimeSurvey utilizza '1' o '2' per impostazione predefinita, che consente a tutti gli utenti web di vedere i log. Puoi creare le tue impostazioni usando direttamente Yii.

Ad esempio, una soluzione rapida per registrare errori e avvisi nei file è: 

 
return array(
 'components' => array(
 /* Altro componente qui 'db' per esempio */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'avviso, errore',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* Altro componente qui 'urlManager' ad esempio */
 ),
 /* Parte finale (con ' runtimePath' 'config' per esempio) */
);
 Hint: Il file viene salvato per impostazione predefinita in <code>limesurvey/tmp/runtime/application.log</code> , che si trova nella cartella principale di LimeSurvey.
  Yii utilizza il percorso di runtime. Per impostazione predefinita, i log sono accessibili tramite Web. Possono contenere molte informazioni dal tuo server. È preferibile utilizzare una directory a cui non è possibile accedere tramite il Web. Puoi impostarlo nei percorsi o aggiornando il Runtime path.

.

Percorso di runtime

Il percorso di runtime deve essere una directory leggibile e scrivibile per l'"utente web". Tuttavia, il percorso di runtime contiene file con potenziali informazioni sulla sicurezza che si trovano nell'area di accesso Web pubblica. LimeSurvey raccoglie questi file nella directory temp della directory root di LimeSurvey. Per eliminare l'accesso a dati così importanti, è possibile impostare il percorso di runtime al di fuori dell'accesso Web pubblico modificando le rispettive righe nel file /application/config/config.php: 

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

Impostazioni generali

  • sitename: assegna un nome al sito del sondaggio. Questo nome apparirà nella panoramica dell'elenco dei sondaggi e nell'intestazione dell'amministrazione. Il valore predefinito è 'LimeSurvey' e può essere sovrascritto nella finestra di dialogo impostazioni globali o modificato in config.php.
  • siteadminemail: Questo è l'indirizzo email predefinito di l'amministratore del sito e viene utilizzato per i messaggi di sistema e le opzioni di contatto. Questa impostazione è utilizzata solo come valore predefinito e può essere sovrascritta nella finestra di dialogo impostazioni globali.
  • siteadminbounce: Questo è l'indirizzo email a cui verranno inviate le email respinte. Questa impostazione è usata solo come valore predefinito e può essere sovrascritta dalla finestra di dialogo impostazioni globali.
  • siteadminname: Il vero nome dell'amministratore del sito. Questa impostazione è usata solo come valore predefinito e può essere sovrascritta nella finestra di dialogo impostazioni globali.
  • proxy_host_name: Questo è il nome host del tuo server proxy (ha da menzionare se sei dietro un proxy e vuoi aggiornare LimeSurvey usando ComfortUpdate).
  • proxy_host_port: Questa è la porta del tuo server proxy (deve essere menzionato se sei dietro un proxy e vuoi aggiornare LimeSurvey usando ComfortUpdate).

Sicurezza

  • maxLoginAttempt: questo è il numero di tentativi che un utente deve inserire per inserire la password corretta prima che il suo indirizzo IP venga bloccato/bloccato. Il valore predefinito è 3 e può essere modificato da config.php.
  • timeOutTime: Se l'utente inserisce la password in modo errato per<maxLoginAttempt> , lei o lui viene bloccato per<timeOutTime> secondi. Il valore predefinito è 10 minuti e può essere modificato da config.php.
  • maxLoginAttemptParticipants: Questo è il numero di tentativi che un partecipante ha a disposizione per inserire un token valido prima di ottenere il suo Indirizzo IP bloccato/bloccato. Il valore predefinito è 3 e può essere modificato da config.php.
  • timeOutParticipants: Se il partecipante inserisce il token in modo errato per<maxLoginAttemptParticipants> , lei o lui viene bloccato per<timeOutParticipants> secondi. Il valore predefinito è 10 minuti e può essere modificato da config.php.
  • surveyPreview_require_Auth: impostato su true per impostazione predefinita. Se lo imposti su 'false', chiunque può testare il tuo sondaggio utilizzando l'URL del sondaggio, senza accedere al pannello di amministrazione e senza dover prima attivare il sondaggio. Questa impostazione è un valore predefinito e può essere sovrascritto nella finestra di dialogo impostazioni globali o modificato in config.php.
  • usercontrolSameGroupPolicy: impostato su true per impostazione predefinita. Per impostazione predefinita, gli utenti non amministratori definiti nell'interfaccia di gestione di LimeSurvey potranno vedere solo gli utenti che creano o gli utenti che appartengono ad almeno uno stesso gruppo. Il valore predefinito può essere sovrascritto nella finestra di dialogo impostazioni globali o modificato in config.php.
  • filterxsshtml: Questa impostazione abilita il filtraggio dei tag html sospetti che si trovano all'interno dei sondaggi, gruppi e testi di domande e risposte nell'interfaccia di amministrazione. Lascia questo su 'false' solo se ti fidi assolutamente degli utenti che hai creato per l'amministrazione di LimeSurvey e se vuoi permettere a questi utenti di poter usare Javascript, Flash Movies, ecc.. I super admin non hanno mai il loro HTML filtrato . Il valore predefinito può essere sovrascritto nella finestra di dialogo impostazioni globali o modificato in config.php.
  • demoMode: Se questa opzione è impostata su 'true' in config.php , LimeSurvey entrerà in modalità demo. La modalità demo cambia le seguenti cose:
    • Disabilita i dettagli dell'utente amministratore e la modifica della password;
    • Disabilita il caricamento di file sull'editor di modelli;
    • Disabilita l'invio di inviti e promemoria via e-mail;!N !** Disabilita la creazione di un dump del database;
    • Disabilita la possibilità di modificare le seguenti impostazioni globali: nome del sito, lingua predefinita, modalità editor HTML predefinita, filtro XSS.
  • 'forcedsuperadmin:' Array di user id con tutti i diritti su tutti i LimeSurvey. Queste impostazioni possono essere aggiornate solo nel file config.php. I diritti di questo utente non possono essere modificati in autorizzazioni globali per un utente nemmeno da altri super amministratori forzati. Per impostazione predefinita: l'utente con questi diritti è utente con id: 1. Il primo utente creato subito dopo l'installazione.
  • force_ssl: forza LimeSurvey a funzionare tramite HTTPS oa bloccare HTTPS. Vedi Force HTTPS nella GUI di amministrazione delle impostazioni globali.
  • ssl_emergency_override: Questa impostazione forza la disattivazione di SSL. Se hai attivato HTTPS/SSL nelle impostazioni globali ma il tuo server non ha HTTPS abilitato, l'unico modo per disattivarlo è modificare direttamente un valore nel database. Ciò consente di forzare la disattivazione di HTTPS mentre si modificano le impostazioni globali per Force Secure. Questo dovrebbe essere sempre falso tranne in caso di emergenza in cui lo si cambia in vero fino a quando non si risolve il problema. Questa impostazione può essere impostata solo tramite il file config.php.
  • ssl_disable_alert: Disabilita l'avviso per super-admin su SSL non forzato, se davvero non puoi o non vuoi forzare ssl. Questa impostazione può essere impostata solo tramite il file config.php.

Resources

  • sessionlifetime: Definisce il tempo in secondi dopo il quale scade una sessione di sondaggio. Si applica solo se si utilizzano sessioni di database. Se usi sessioni di database, cambia il parametro in config.php o sostituisci il valore predefinito dalla finestra di dialogo impostazioni globali.
  • memorylimit: Questo determina quanta memoria LimeSurvey può accedere. '128 MB' è il minimo consigliato (MB=Megabyte). Se ricevi errori di timeout o hai problemi a generare statistiche o ad esportare file, aumenta questo limite a '256 MB' o superiore. Se il tuo server web ha impostato un limite più alto in config.php, questa impostazione verrà ignorata.
Tieni presente che tali impostazioni locali possono sempre essere annullate dalle modifiche apportate nella finestra di dialogo delle impostazioni globali.

Per aumentare il limite di memoria a 128M puoi anche provare ad aggiungere:

  • memory_limit = 128M al file php.ini principale del tuo server (consigliato, se hai accesso)
  • memory_limit = 128M a un file php.ini in la radice di LimeSurvey
  • php_value memory_limit 128M in un file .htaccess nella radice di LimeSurvey
  • max_execution_time: Imposta il numero di secondi che uno script può eseguire. Se questo viene raggiunto, lo script restituisce un errore irreversibile. Per poter esportare dati e statistiche di grandi sondaggi, LimeSurvey prova a impostarlo per impostazione predefinita su 1200 secondi. È possibile impostare un tempo maggiore o minore se necessario. Accessibile solo tramite il file di configurazione php.

Aspetto

  • dropdownthreshold (Obsolete since 2.50): quando "R" è selezionato per $dropdowns , l'amministratore può impostare un numero massimo di opzioni che verranno visualizzate come pulsanti di opzione , prima di riconvertirlo in un elenco a discesa. Se c'è una domanda che ha un gran numero di opzioni, visualizzarle tutte contemporaneamente come pulsanti di opzione può sembrare ingombrante e può diventare controintuitivo per gli utenti. Impostandolo su un massimo di, diciamo 25 (che è l'impostazione predefinita), significa che gli elenchi di grandi dimensioni possono essere utilizzati più facilmente dagli amministratori per il partecipante al sondaggio.
  • repeatheadings: Con il tipo di domanda Array, spesso avrai molte domande secondarie che, quando visualizzate sullo schermo, occupano più di una pagina. Questa impostazione ti consente di decidere quante domande secondarie devono essere visualizzate prima di ripetere le informazioni di intestazione per la domanda. Una buona impostazione per questo è intorno a 15. Se non vuoi che le intestazioni si ripetano affatto, imposta questa impostazione su 0. Questa impostazione è sovrascritta nella finestra di dialogo impostazioni globali (New in 2.05 ) .
  • minrepeatheadings: Il numero minimo di domande secondarie rimanenti richieste prima di ripetere le intestazioni nelle domande matrice. Il valore predefinito è 3 e può essere modificato in config.php.
  • defaulttemplate: Questa impostazione specifica il tema predefinito utilizzato per la 'lista pubblica' dei sondaggi. Questa impostazione può essere sovrascritta nella finestra di dialogo impostazioni globali o modificata in config.php.
  • defaulthtmleditormode: Imposta la modalità predefinita per l'editor HTML integrato. Questa impostazione può essere sovrascritta nella finestra di dialogo impostazioni globali o modificata in config.php. Le impostazioni valide sono:
    • 'inline' - Sostituzione in linea dei campi con un editor HTML. Lento ma comodo e facile da usare;
    • 'popup' - Aggiunge un'icona che esegue l'editor HTML in un popup se necessario. Più veloce, ma il codice HTML viene visualizzato nel modulo;
    • 'none'- Nessun editor HTML;
  • column_style: Definisce come vengono visualizzate le colonne per le risposte al sondaggio quando si utilizza visualizza_colonne. Può essere modificato nel file config.php. Le impostazioni valide sono:
    • 'css' - utilizza uno dei vari metodi CSS per creare colonne (vedere il foglio di stile del modello per i dettagli);
    • 'ul' - le colonne sono visualizzate come multiple liste floated non ordinate (default);
    • 'table' - utilizza un layout basato su tabelle convenzionali;
    • NULL - disabilita l'uso delle colonne.

Lingua & ora

  • defaultlang: Questo dovrebbe essere impostato sulla lingua predefinita da usare nei tuoi script di amministrazione, e anche l'impostazione predefinita per la lingua nell'elenco dei sondaggi pubblici. Questa impostazione può essere sovrascritta nella finestra di dialogo impostazioni globali o modificata in config.php.
  • timeadjust: Se il tuo server web si trova in un fuso orario diverso rispetto alla posizione in cui i tuoi sondaggi saranno basati, metti qui la differenza tra il tuo server e il fuso orario di casa. Ad esempio, vivo in Australia, ma utilizzo un server Web statunitense. Il server web è indietro di 14 ore rispetto al mio fuso orario locale. Quindi la mia impostazione qui è "14". In altre parole, aggiunge 14 ore al tempo dei server web. Questa impostazione è particolarmente importante quando i sondaggi effettuano il timestamp delle risposte. Questa impostazione può essere sovrascritta nella finestra di dialogo impostazioni globali o modificata in config.php.

Comportamento del sondaggio

  • deletenonvalues: Usa questa funzione con cautela. Per impostazione predefinita (un valore pari a 1), le domande irrilevanti vengono annullate nel database. Ciò garantisce che i dati nel database siano internamente coerenti. Tuttavia, ci sono rari casi in cui potresti voler mantenere valori irrilevanti, nel qual caso puoi impostare il valore su 0. Ad esempio, chiedi a una persona di sesso maschile il suo genere e lui dice accidentalmente "femmina" e poi risponde a una donna -domande specifiche (domande che sono condizionate dall'essere donne, quindi sono rilevanti solo per le donne). Quindi, si rende conto del suo errore, fa marcia indietro, imposta il genere su "maschio" e continua con il sondaggio. Ora, le domande specifiche per le donne sono irrilevanti. Se $deletenonvalues==1 , quei valori irrilevanti verranno cancellati (NULL) nel database. Se $deletenonvalues==0 , le sue risposte errate non verranno eliminate, quindi saranno ancora presenti nel database quando lo analizzi.
  • shownoanswer: Quando una domanda con pulsante di opzione/seleziona tipo che contiene risposte modificabili (ad es. domande List, Array) non è obbligatoria e 'shownoanswer' è impostata su 1, un ulteriore 'Nessuna risposta' viene visualizzata la voce, in modo che i partecipanti possano scegliere di non rispondere alla domanda. Alcune persone preferiscono che questo non sia disponibile. Questa impostazione può essere sovrascritta dalla finestra di dialogo impostazioni globali o modificata in config.php. I valori validi sono:
    • '0': No;
    • '1': Sì;
    • '2': L'amministratore del sondaggio può scegliere.
  • printanswershonorsconditions: Questa impostazione determina se la funzione printanswers visualizzerà le voci delle domande che erano nascoste dalle condizioni-diramazione (Predefinito: 1 = nascondi le risposte dalle domande nascoste dalle condizioni).
  • ' hide_groupdescr_allinone:' Questa impostazione è rilevante per i sondaggi all-in-one che utilizzano le condizioni . Quando è impostato su "true", il nome e la descrizione del gruppo sono nascosti se tutte le domande nel gruppo sono nascoste. Il valore predefinito è 'true': nasconde il nome e la descrizione del gruppo quando tutte le domande nel gruppo sono nascoste dalle condizioni. Può essere modificato in config.php.
  • showpopups: Mostra i messaggi popup se le domande obbligatorie o condizionali non hanno ricevuto una risposta corretta:
    • '2' = definito dall'opzione Tema (predefinito )
    • '1'= mostra il messaggio popup;
    • '0'= mostra invece il messaggio sulla pagina;
    • '-1'= non mostra affatto il messaggio (in questo caso , gli utenti vedranno comunque i suggerimenti specifici per le domande che indicano a quali domande è necessario rispondere).

Comportamento del tipo di domanda numerica

  • bFixNumAuto: I campi numerici possono essere filtrati automaticamente per rimuovere tutti i valori non numerici. Per impostazione predefinita questo è abilitato, puoi disabilitarlo a livello globale. Questa impostazione è correlata a Correggi automaticamente il valore numerico nelle opzioni del tema principale. Era abilitato per Sì, disabilitato per Solo per espressione e No.
  • bNumRealValue: I campi numerici utilizzati nel gestore espressioni possono essere corretti o meno. È fisso per impostazione predefinita. Se NUMERIC è una domanda numerica : disabilita o 0 : {NUMERIC} con caratteri errati invia '' , abilita o 1 : {NUMERIC} invia tutti i caratteri inseriti. Questa impostazione è correlata a Correggi automaticamente il valore numerico nelle opzioni del tema principale. Era abilitato per Sì e Solo per espressione e disabilitato per No.

Sviluppo e debugging

  • debug: Con questa impostazione, imposti la segnalazione degli errori PHP su E_ALL. Ciò significa che viene mostrato ogni piccolo avviso, avviso o errore relativo allo script. Questa impostazione deve essere impostata su "1" solo se si sta tentando di eseguire il debug dell'applicazione per qualsiasi motivo. Se sei uno sviluppatore, passa a "2". Non passare a "1" o "2" in produzione poiché potrebbe causare la divulgazione del percorso. Il valore predefinito è '0' e può essere modificato in config.php.
  • debugsql: Attiva questa impostazione se vuoi visualizzare tutte le query SQL eseguite per lo script in fondo a ogni pagina. Molto utile per l'ottimizzazione del numero di query. Per attivarlo, modifica il valore predefinito a '1' dal file config.php.
  • use_asset_manager: Per impostazione predefinita: modalità di debug disabilita asset manager, puoi permetterti di utilizzare asset manager con la modalità di debug abilitata.

Nel caso in cui riscontri un errore nell'applicazione, ti consigliamo vivamente di attivare l'impostazione di debug per ottenere un errore più dettagliato che puoi inviare con la segnalazione del bug: 

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

Se lavori su plugin e hai bisogno di un modo rapido per scaricare le variabili sullo schermo: puoi usare la funzione traceVar. Se il debug è impostato: questa funzione usa CWebLogRoute per essere mostrata sulla pagina HTML. Utilizzo traceVar($MyVariable)

Impostazioni e-mail

Tutte le impostazioni sottostanti possono essere sovrascritte nella finestra di dialogo impostazioni globali.

  • 'emailmethod: Determina come vengono inviati i messaggi email. Sono disponibili le seguenti opzioni:
    • 'mail:' utilizza il PHP mailer interno;
    • 'sendmail:' utilizza il mailer sendmail;
    • 'smtp:' utilizza l'inoltro SMTP. Usa questa impostazione quando esegui LimeSurvey su un host che non è il tuo server di posta.
  • 'emailsmtphost: Se usi 'smtp' come $emailmethod , devi inserire qui il tuo server SMTP. Se utilizzi la posta di Google potresti dover aggiungere il numero di porta come $emailsmtphost = 'smtp.gmail.com:465'.
  • emailsmtpuser: Se il tuo server SMTP richiede l'autenticazione, impostalo sul tuo nome utente, altrimenti deve essere vuoto.
  • emailsmtppassword: Se il tuo server SMTP richiede l'autenticazione, imposta questo sulla tua password, altrimenti deve essere vuoto.
  • emailsmtpssl: Imposta this a 'ssl' o 'tls' per utilizzare SSL/TLS per la connessione SMTP.
  • maxemails: Quando si inviano inviti o promemoria ai partecipanti al sondaggio, questa impostazione viene utilizzata per determinare quante email possono essere inviate un mazzo. Diversi server Web hanno diverse capacità di posta elettronica e se il tuo script impiega troppo tempo per inviare una serie di messaggi di posta elettronica, lo script potrebbe scadere e causare errori. La maggior parte dei server Web può inviare 100 e-mail alla volta entro il limite di tempo predefinito di 30 secondi per uno script PHP. Se ricevi errori di timeout dello script durante l'invio di un numero elevato di e-mail, riduci il numero in questa impostazione. Facendo clic sul pulsante "invia invito tramite posta elettronica" dalla barra degli strumenti di controllo del token (non sul pulsante situato a destra di ogni token) viene inviato il<maxemails> numero di inviti, quindi visualizza un elenco degli indirizzi dei destinatari e un avviso che ci sono più email in sospeso di quelle che potrebbero essere inviate in un batch. Continua a inviare e-mail facendo clic di seguito. Ci sono ancora ### email da inviare. e fornisce un "pulsante continua" per procedere con il batch successivo. Cioè, l'utente determina quando inviare il batch successivo dopo che ogni batch viene inviato via email. Non è necessario attendere con questa schermata attiva. L'amministratore potrebbe disconnettersi e tornare in un secondo momento per inviare il prossimo gruppo di inviti.

Statistiche e risposta browse

  • filterout_incomplete_answers: Controlla il comportamento predefinito del filtraggio delle risposte incomplete durante la navigazione o l'analisi delle risposte. Per una discussione sulle risposte incomplete, consulta il nostro browsing survey results wiki. Poiché questi record possono corrompere le statistiche, viene fornita un'opzione per attivare o disattivare questo filtro in diversi moduli della GUI. Il parametro può essere modificato in config.php. Sono disponibili le seguenti opzioni:
    • 'mostra': permette di visualizzare sia le risposte complete che quelle incomplete;
    • 'filtro': mostra solo le risposte complete;
    • 'incomplete': mostra solo risposte incomplete.
  • strip_query_from_referer_url: questa impostazione determina se l'URL del referrer salva o meno il parametro. Il valore predefinito è 'false' (in questo caso, l'URL del referrer salva tutti i parametri). In alternativa, questo valore può essere impostato su 'true' e la parte del parametro dell'URL del referrer verrà rimossa.
  • showaggregateddata: quando attivato, vengono visualizzati valori statistici aggiuntivi come la media aritmetica e la deviazione standard mostrato. Inoltre, i dati vengono aggregati per ottenere una panoramica più rapida. Ad esempio, i risultati della scala 1+2 e 4+5 vengono sommati per avere una classifica generale come "buono" (1/2), "medio" (3) e "cattivo" (4/5). Ciò riguarda solo i tipi di domanda "A" (matrice di 5 punti) e "5" (scelta di 5 punti).
  • Impostazioni di esportazione PDF: Questa funzione attiva l'esportazione in PDF per sondaggi stampabili e Stampa risposte. La funzione di esportazione PDF è totalmente sperimentale e l'output è lungi dall'essere perfetto. Sfortunatamente, al momento non è possibile fornire supporto - se vuoi aiutarci a risolverlo, contattaci.
    • 'usepdfexport': Imposta '0' per disabilitare e '1' per abilitare;! N!**'pdfdefaultfont': Rappresenta il font predefinito che verrà utilizzato dalla funzione di esportazione pdf. Il valore predefinito è 'auto'. Per cambiarlo, devi impostarlo su uno dei PDF core fonts.
    • 'alternatepdffontfile': è un array con le chiavi della lingua e il carattere corrispondente. Il carattere predefinito per ogni lingua può essere sostituito nel file config.php;
    • 'pdffontsize': mostra la dimensione del carattere per i testi normali; Per il titolo del sondaggio, lo è<pdffontsize> +4, mentre per il titolo di gruppo è<pdffontsize> +2. Può essere modificato nel file config.php o dalla finestra di dialogo [Impostazioni globali|impostazioni globali]];
    • 'notsupportlanguages': include un elenco con le lingue per le quali non è stato trovato alcun font PDF. L'elenco include amarico ('am'), singalese ('si') e tailandese ('th') e può essere trovato nel file config-defaults.php;
    • 'pdforientation': Set ' L' per Orizzontale o 'P' per formato verticale. Può essere modificato dal file config.php.
  • Graph setting
    • 'chartfontfile': Imposta il nome del file del carattere utilizzato per creare i grafici statistici. Il file deve trovarsi nella directory dei font, che si trova nella cartella principale di LimeSurvey. Può essere modificato nel file config.php;
    • 'alternatechartfontfile': è un array con le chiavi della lingua e il carattere corrispondente. Può essere modificato nel file config.php.
  • showsgqacode: Questa impostazione viene utilizzata nella funzione di sondaggio stampabile e il valore predefinito è 'false. Se imposti showsgqacode = 'true';, verranno mostrati gli ID di ogni domanda e la risposta se applicabile. Questi ID corrispondono all'intestazione della colonna nella tabella Lime_survey_12345, che contiene i dati delle risposte per un determinato sondaggio. Questi ID possono essere utilizzati per un libro di codici per query di database manuali.

Impostazioni LDAP

Poiché si tratta di un argomento vasto, abbiamo spostato Impostazioni LDAP in un'altra pagina.

Autenticazione

A partire da LimeSurvey 2.05, l'autenticazione sarà gestita dai plugin. Di conseguenza, le informazioni riportate di seguito potrebbero non essere aggiornate. Vedi il wiki dei plugin per le informazioni più aggiornate.

Delega di autenticazione al server web

Gli amministratori di sistema potrebbero volere che i loro amministratori del sondaggio siano autenticati rispetto a un sistema di autenticazione centrale (Active Directory, openLdap, Radius, ...) piuttosto che utilizzare il database interno di LimeSurvey. Un modo semplice per farlo è impostare il software del server web in modo che utilizzi questo sistema di autenticazione esterno, quindi chiedere a LimeSurvey di fidarsi dell'identità dell'utente segnalata dal server web. Per abilitare questa funzione, devi:

  • impostare auth_webserver su 'true' in config.php;
  • abilitare l'autenticazione dal lato server web.

Si prega di notare che:

  • LimeSurvey ignorerà quindi il proprio processo di autenticazione (utilizzando il nome di accesso riportato dal server Web senza richiedere una password);
  • questo può sostituire solo il sistema di autenticazione della GUI di LimeSurvey, 'non il sistema di invito al sondaggio' (interfaccia partecipante).

Delega di autenticazione senza importazione automatica degli utenti

Tieni presente che la delega dell'autenticazione non ignora il sistema di autorizzazione di LimeSurvey per impostazione predefinita , il che significa che, anche se non devi gestire le password in LimeSurvey, devi comunque definire gli utenti nel database di LimeSurvey e assegnare loro il set corretto di diritti per consentirgli di accedere al pannello di amministrazione.

A un utente viene quindi concesso l'accesso a LimeSurvey se e solo se:

  • è stato autenticato sul server web;
  • il suo nome di accesso è definito come utente nel database degli utenti di LimeSurvey (all'utente viene quindi concesso il privilegi dell'utente definiti nel database utenti di LimeSurvey).

Delega di autenticazione con importazione automatica degli utenti

Quando si gestisce un enorme database di utenti, a volte è più semplice importare automaticamente gli utenti nel database di LimeSurvey:

  • auth_webserver_autocreate_user: se impostato su 'true', LimeSurvey tenterà di importare automaticamente gli utenti autenticati da il server web ma non già nel suo DB utenti.
  • auth_webserver_autocreate_profile: un array che descrive il profilo predefinito che verrà assegnato all'utente, inclusi il nome completo (falso), l'e-mail e i privilegi.

Se vuoi personalizzare il profilo utente in modo che corrisponda all'utente che ha effettuato l'accesso, dovrai sviluppare una semplice funzione chiamata hook_get_autouserprofile - con questa funzione puoi recuperare da un database di account utente centrale (per esempio, da una directory LDAP) il vero nome completo, i nomi e l'e-mail di un particolare utente. Puoi persino personalizzare i suoi privilegi sul sistema in base ai gruppi che gli sono assegnati nel database esterno.

La funzione hook_get_auth_webserver_profile accetta il nome di login dell'utente come unico argomento e può restituire:

  • False o un array vuoto - in questo caso all'utente viene negato l'accesso a LimeSurvey;
  • un array contenente tutte le voci comuni del profilo utente come descritto 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();

Template:Avviso

Mappatura nome utente

Nel caso in cui alcuni utenti abbiano un nome utente esterno diverso dal proprio nome utente LimeSurvey, può essere utile utilizzare una mappatura del nome utente. Questo viene fatto in LimeSurvey usando il parametro auth_webserver_user_map. Ad esempio, immagina di non avere un nome utente "admin" definito nel tuo database di autenticazione esterno. Quindi, per accedere a LimeSurvey come amministratore, dovrai mappare il tuo nome utente esterno (chiamiamolo 'myname') al nome di accesso dell'amministratore in LimeSurvey. La configurazione corrispondente è: 

'config'=>array(
...
'auth_webserver_user_map' => array ('myname' => 'admin');
)

Dopo un'autenticazione riuscita con il login 'myname' e la password del server web, sarai direttamente autorizzato a utilizzare LimeSurvey come utente 'admin'.

Questo ha serie implicazioni sulla sicurezza, quindi usalo con cura. Inoltre, proteggi il tuo config.php dall'accesso in scrittura da parte del server web.

Utilizzare one-time password

Un utente può aprire la pagina di accesso di LimeSurvey all'indirizzo default.com/limesurvey/admin e digitare il nome utente e la password monouso che sono stati precedentemente scritti nella tabella degli utenti (colonna one_time_pw) da un'applicazione esterna.

Questa impostazione deve essere attivata nel file config.php per abilitare l'uso di password monouso (default = false). 

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'use_one_time_passwords'=>true,
 )

Ulteriori informazioni sono disponibili nella sezione "Gestisci utenti".


Impostazioni di crittografia (New in 4.0.0 )

  Attenzione : Una volta impostate, le chiavi di crittografia non devono mai essere modificate, altrimenti tutti i dati crittografati potrebbero andare persi!


Template:Nota

Vedere crittografia dei dati per i dettagli su questa funzione.

  • coppia di chiavi di crittografia
  • chiave pubblica di crittografia
  • chiave segreta di crittografia

Impostazioni URL avanzate

  • publicurl: Questo dovrebbe essere impostato sulla posizione dell'URL dei tuoi 'script pubblici'. Gli script pubblici sono quelli che si trovano nella cartella "limesurvey" (o qualunque nome tu abbia dato alla directory in cui sono conservati tutti gli altri script e directory). Questa impostazione è disponibile in config.php e viene utilizzata quando LimeSurvey necessita di un URL assoluto (ad esempio quando vengono inviate email token).
  • homeurl: Questo dovrebbe essere impostato alla posizione dell'URL degli script di amministrazione. Questi si trovano nella cartella /limesurvey/admin. Dovrebbe essere impostato sulla posizione dell'URL WEB, ad esempio http://www.example.com/limesurvey/html/admin. Non aggiungere una barra finale a questa voce. L'impostazione predefinita in config.php tenta di rilevare automaticamente il nome del tuo server utilizzando un'impostazione della variabile php - {$_SERVER [ 'SERVER_NAME']} <code>{$_SERVER [ 'SERVER_NAME']}</code> {$_SERVER [ 'SERVER_NAME']} . Nella maggior parte dei casi, puoi lasciarlo e modificare semplicemente il resto di questa stringa in modo che corrisponda al nome della directory in cui hai inserito gli script LimeSurvey.
  • tempurl: Questo dovrebbe essere impostato sulla posizione dell'URL della tua directory "/limesurvey/tmp" - o su una directory in cui desideri che LimeSurvey utilizzi per servire i file temporanei.
  • uploadurl: Questo dovrebbe essere impostato sulla posizione dell'URL della tua directory "/limesurvey/upload" - o su una directory in cui desideri che LimeSurvey utilizzi per servire i file caricati. Ciò ti consente di impostare i file caricati su un altro dominio URL.

Impostazioni percorso avanzate

  • homedir: Questo dovrebbe essere impostato sulla posizione del disco fisico dei tuoi script di amministrazione - per esempio "/home/usr/htdocs/limesurvey/admin". Non aggiungere una barra finale a questa voce. L'impostazione predefinita in config.php tenta di rilevare il percorso root predefinito di tutti i tuoi documenti utilizzando l'impostazione della variabile php {$_SERVER [ 'DOCUMENT_ROOT']} <code>{$_SERVER [ 'DOCUMENT_ROOT']}</code> {$_SERVER [ 'DOCUMENT_ROOT']} . Nella maggior parte dei casi puoi lasciarlo e modificare semplicemente il resto di questa stringa in modo che corrisponda al nome della directory in cui hai inserito gli script di LimeSurvey.
  • publicdir: Questo dovrebbe essere impostato sulla posizione del disco fisico di i tuoi 'script pubblici'.
  • tempdir: Questo dovrebbe essere impostato sulla posizione del disco fisico della tua directory /limesurvey/tmp in modo che lo script possa leggere e scrivere file.
  • 'uploaddir:' Dovrebbe essere impostato sulla posizione del disco fisico della directory /limesurvey/upload in modo che lo script possa leggere e scrivere file.
  • sCKEditorURL: url dello script fckeditor.
  • fckeditexpandtoolbar: definisce se la barra degli strumenti fckeditor deve essere aperta per impostazione predefinita.
  • pdfexportdir: Questa è la directory con l'estensione tcpdf.phptcpdf.php.!N !*pdffonts: Questa è la directory per i font TCPDF.

Altre impostazioni avanzate

Carica file

  • allowedthemeuploads: Tipi di file che possono essere caricati nell'editor del tema
  • allowedresourcesuploads: Tipi di file che possono essere caricati nelle sezioni delle risorse e con l'editor HTML
  • allowedfileuploads (New in 4.0.0 ) Restrizione globale sul tipo di file da caricare
  • magic_database: (New in 3.17.17 ) Consenti di utilizzare un diverso Database MIME per finfo_open. Può essere aggiornato solo nel file config.php. Esempio: /usr/share/misc/magic.mgc per Linux basato su redhat.
  • magic_file: (New in 3.17.17 ) Consente di utilizzare un file diverso per ottenere l'array di estensioni per tipo mime rispetto a incluso uno. Deve essere un file PHP e restituire un array. Può essere aggiornato solo nel file config.php.

Aggiorna

  • aggiornabile: Questa impostazione è in version.php. Può essere vero o falso. Se imposti su true : quando un utente super amministratore accede : LimeSurvey controlla se è disponibile un aggiornamento e ti mostra un avviso. Se impostato su false : non viene effettuato alcun controllo e non è possibile utilizzare ComfortUpdate.
Retrieved from "http://manual.limesurvey.org/index.php?title=Optional_settings/it&oldid=376526"