Impostazioni opzionali

La sezione seguente è rivolta a coloro che desiderano modificare quelle impostazioni di configurazione che non possono essere modificate tramite la GUI (Graphical User Interface) dell'installazione di LimeSurvey. Tieni presente che tutte le modifiche alla directory principale di LimeSurvey vengono eseguite a tuo rischio. Tuttavia, se riscontri problemi o hai bisogno di ulteriore assistenza, unisciti ai forum di discussione per ricevere aiuto dalla 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.

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

Per ulteriori informazioni sul framework Yii, accedi al seguente link.

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.

  Se esegui più istanze di LimeSurvey sullo stesso dominio, assegna a ciascuna un proprio nome di sessione. Non è necessario modificare il percorso del cookie di sessione né le impostazioni del cookie CSRF.

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

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

Ogni istanza di LimeSurvey sullo stesso dominio richiede un proprio nome di sessione. In caso contrario, accedendo a un'istanza si viene disconnessi dall'altra. Il programma di installazione imposta un nome di sessione casuale in config.php. Se hai copiato config.php da un'altra istanza, oppure il tuo config.php proviene da una versione precedente a LimeSurvey 4.0, aggiungi o modifica la riga sessionName nella sezione session esistente e usa un valore diverso per ogni istanza:

        // Set the name of the session
        'session' => array (
            'sessionName' => 'LS-ABCDEFGHIJKLMNOP',
            ),

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

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

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

        // Set the cookie domain name and path for CSRF protection
        '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.

Consentire l'uso della sessione e della convalida CSRF in un iFrame

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.

  Anche con tutte queste impostazioni, le indagini in un iframe possono comunque non funzionare in alcuni browser o con alcune impostazioni del browser, ad esempio in modalità di navigazione privata o quando i cookie di terze parti sono bloccati. Queste impostazioni sono state testate con Firefox da 81.0.2 a 115, Chromium da 85.0.4183.121 a 119 ed Edge 119 con le loro impostazioni di default. LimeSurvey non fornisce supporto per questa configurazione, è disponibile solo il supporto della community.

Consenti avvio sessione in iframe

Il cookie di sessione deve essere sicuro (richiede una connessione HTTPS valida) e httponly, e samesite deve essere impostato su None. Le chiavi in cookieParams devono essere scritte interamente in minuscolo.

'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

Come per il cookie di sessione, il cookie CSRF deve essere sicuro e sameSite deve essere impostato su None. Nota che qui la chiave è scritta sameSite. Aggiungi l'intero array request allo stesso livello di session.

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

Impostazioni URL

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: Le categorie application.controller.customInit.max_execution_time e application.controller.customInit.memory_limit vengono utilizzate per registrare i tentativi di modifica delle impostazioni di PHP.

Se sei a conoscenza di questi messaggi di log e vuoi escluderli dai log, puoi aggiungere queste categorie all'opzione except nella configurazione della route di log, come mostrato di seguito:

'except' => [
    'exception.CHttpException.404',
    'application.controller.customInit.max_execution_time',
    'application.controller.customInit.memory_limit',
],

 Hint: Il file viene salvato per impostazione predefinita in limesurvey/tmp/runtime/application.log, che si trova nella cartella principale di LimeSurvey. Puoi impostare un altro nome di file utilizzando logFile.

  Yii utilizza il percorso di runtime. Per impostazione predefinita, i log sono accessibili tramite Web. Possono contenere molte informazioni sul tuo server. È preferibile utilizzare una directory a cui non è possibile accedere tramite Web. Puoi impostarla in logPath oppure aggiornando il percorso di runtime.

.

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.

Protezione dal Cross-site scripting (XSS)

LimeSurvey non consente alcuno script utente nella pagina di amministrazione. Se trovi un modo per aggiungere uno script XSS nella pagina di amministrazione tramite un utente qualsiasi, consulta la nostra Security Policy.

Gli script delle pagine pubbliche sono gestiti dalle impostazioni del filtro XSS.

• filterxsshtml: Questa impostazione abilita il filtraggio dei tag HTML sospetti presenti nei testi di indagini, gruppi, domande e risposte nell'interfaccia di amministrazione. Lascia 'false' solo se ti fidi completamente degli utenti creati per l'amministrazione di LimeSurvey e se vuoi consentire loro di usare Javascript, filmati Flash, ecc. L'HTML dei super amministratori non viene mai filtrato. Il valore di default può essere sovrascritto nella finestra di dialogo Impostazioni generali.
• filterxsshtml_forcedall: Forza filterxsshtml su true per tutti gli utenti e disabilita le modifiche nella GUI di amministrazione. Abilita il filtraggio dei tag HTML sospetti anche per il super amministratore.
• filterxsshtml_allowforcedsuperadmin: Utilizzata solo se filterxsshtml_forcedall è true. Consente a forcedsuperadmin (per default l'utente amministratore n. 1) di aggiungere qualsiasi script e HTML.
• disablescriptwithxss: Consente la modifica dello script nella domanda: per default è true e segue le regole XSS; impostalo su false per consentirlo a tutti gli utenti. Il valore di default può essere sovrascritto nella finestra di dialogo Impostazioni generali.
• filterxsshtml_enablescript: Utilizzata solo se filterxsshtml_forcedall è true. Abilita lo script della domanda per utenti specifici: gui: consente la modifica dell'impostazione tramite la GUI; superadmin: solo il super amministratore; forcedsuperadmin: solo il super amministratore forzato; per default: nessun utente e nessuna modifica tramite la GUI

Caricamento file consentito

• allowedthemeimageformats : Tipi di file immagine che possono essere caricati nella sezione dei temi. Per default i file SVG sono disabilitati a causa di potenziali attacchi XSS.
• allowedthemeuploads : Altri tipi di file che possono essere caricati nella sezione dei temi (file zip)
• allowedresourcesuploads : Tipi di file che possono essere caricati nella sezione delle risorse e con l'Editor HTML
• allowedpluginuploads : Tipi di file consentiti durante il caricamento del file zip di un plugin.

Inserisci semplicemente una stringa di estensioni separate da virgole. Ad esempio:

'allowedthemeimageformats' => 'jpg,jpeg,gif,png,webm,svg',

Attenzione: presta sempre attenzione quando consenti il caricamento di file. Potrebbero verificarsi attività dannose.

Plugin

• usePluginWhitelist : Se true, i plugin che non sono nella lista di quelli consentiti (vedi 'pluginWhitelist') non possono essere installati né caricati. Questo potrebbe disabilitare plugin già installati.
• pluginWhitelist : Elenco dei nomi dei plugin che possono essere installati e caricati quando 'usePluginWhitelist' è true. I plugin del core sono implicitamente consentiti.
• corePluginBlacklist : Elenco dei nomi dei plugin del core vietati quando 'usePluginWhitelist' è true.
• disablePluginUpload : Quando questa impostazione è true, la funzione "Plugin Upload" è disabilitata

Controllo degli host

• allowedHosts : per evitare la Host Header Injection, puoi impostare l'host consentito per tutte le azioni. Se usi host diversi per la pagina pubblica e per la pagina di amministrazione, devi impostarli entrambi come host consentiti.

    'config'=>array(
            ....
,		// Update default LimeSurvey config here
		'allowedHosts' => [
			'survey.example.org',
			'proxy.survey.example.com',
			'example.limesurvey.org',
		],
    ),

Risorse

• iSessionExpirationTime: Definisce il tempo in secondi dopo il quale scade una sessione di indagine. Si applica solo se usi le sessioni su database. In tal caso, modifica il parametro in config.php o sovrascrivi il valore di default dalla finestra di dialogo Impostazioni generali.
• memory_limit: Determina la quantità di memoria a cui LimeSurvey può accedere, in megabyte. Il valore di default è '256'. Se ricevi errori di timeout o hai problemi nella generazione delle statistiche o nell'esportazione dei file, aumenta questo limite a '512' o più. Se il tuo web server ha impostato un limite più alto in php.ini, 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 si imposta la segnalazione degli errori PHP su E_ALL. Ciò significa che viene mostrato ogni minimo avviso, warning 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, impostala su '2'. Non impostarla su '1' o '2' in produzione, poiché potrebbe causare la divulgazione del percorso. Il valore di default è '0' e può essere modificato in config.php.
• debugsql: Attiva questa impostazione se vuoi visualizzare in fondo a ogni pagina tutte le query SQL eseguite per lo script. È molto utile per ottimizzare il numero di query. Per attivarla, modifica il valore di default in '1' nel file config.php.
• use_asset_manager: Per impostazione predefinita, la modalità di debug disabilita l'asset manager; puoi consentirne l'uso anche quando la modalità di debug è abilitata.
• rpc_log: ^{(New in 7.9.0 )} Impostala su true per registrare ogni chiamata a RemoteControl in tmp/runtime/remotecontrol.log. Ogni riga contiene il metodo chiamato, i relativi parametri, l'indirizzo IP del client, la durata e l'inizio della risposta. Le password vengono rimosse, le chiavi di sessione vengono sostituite da un breve hash e i valori lunghi vengono abbreviati. Il log contiene comunque i dati dell'indagine, dei partecipanti e delle risposte inviati e ricevuti, quindi abilitalo solo mentre cerchi un problema. Il valore di default è false.

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

• 'emailmethod: Determina come vengono inviati i messaggi e-mail. Sono disponibili le seguenti opzioni:
  • 'mail:' utilizza il mailer PHP 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, ad esempio $emailsmtphost = 'smtp.gmail.com:465'.
• emailsmtpuser: Se il tuo server SMTP richiede l'autenticazione, imposta questo valore sul tuo nome utente, altrimenti deve essere vuoto.
• emailsmtppassword: Se il tuo server SMTP richiede l'autenticazione, imposta questo valore sulla tua password, altrimenti deve essere vuoto.
• emailsmtpssl: Imposta questo valore su 'ssl' o 'tls' per utilizzare SSL/TLS per la connessione SMTP.
• maxemails: Quando si inviano inviti o promemoria ai partecipanti all'indagine, questa impostazione determina quante e-mail possono essere inviate in un unico gruppo. Server web diversi hanno capacità di invio e-mail diverse e, se lo script impiega troppo tempo per inviare un gruppo di e-mail, potrebbe andare in timeout e causare errori. La maggior parte dei server web può inviare 100 e-mail alla volta entro il tempo limite di default 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' della barra degli strumenti di controllo dei token (non sul pulsante situato a destra di ogni token) vengono inviati <maxemails> inviti; poi viene visualizzato un elenco degli indirizzi dei destinatari insieme a un avviso che indica che ci sono più e-mail in sospeso di quante ne possano essere inviate in un unico gruppo. Continua l'invio delle e-mail facendo clic qui sotto. Ci sono ancora ### e-mail da inviare. e viene fornito un pulsante "continua" per procedere con il gruppo successivo. In altre parole, è l'utente a decidere quando inviare il gruppo successivo dopo l'invio di ciascun gruppo. Non è necessario attendere con questa schermata attiva: l'amministratore può disconnettersi e tornare in un secondo momento per inviare il gruppo successivo di inviti.
• send_error_saving_results_email: ^{(New in 7.8.0 )} Se non è possibile salvare una risposta, LimeSurvey invia le risposte all'amministratore dell'indagine in un'e-mail con l'oggetto "Errore nel salvataggio dei risultati". Impostala su false per interrompere l'invio di queste e-mail. I partecipanti vedono comunque il messaggio di errore. Il valore di default è true. Questa impostazione può essere modificata solo in config.php.

Statistiche e consultazione delle risposte

• filterout_incomplete_answers: Controlla il comportamento di default del filtraggio delle risposte incomplete durante la consultazione o l'analisi delle risposte. Per una discussione sulle risposte incomplete, consulta la nostra guida alla consultazione dei risultati dell'indagine. Poiché questi record possono alterare le statistiche, in diversi moduli della GUI è disponibile un'opzione per attivare o disattivare questo filtro. Il parametro può essere modificato in config.php. Sono disponibili le seguenti opzioni:
  • 'all': permette di visualizzare sia le risposte complete che quelle incomplete;
  • 'complete': mostra solo le risposte complete;
  • 'incomplete': mostra solo le risposte incomplete.
• strip_query_from_referer_url: Questa impostazione determina se l'URL di riferimento salva o meno il parametro. Il valore di default è 'false' (in questo caso, l'URL di riferimento salva tutti i parametri). In alternativa, questo valore può essere impostato su 'true' e la parte dei parametri dell'URL di riferimento verrà rimossa.
• showaggregateddata: quando è attivata, vengono mostrati valori statistici aggiuntivi come la media aritmetica e la deviazione standard. Inoltre, i dati vengono aggregati per ottenere una panoramica più rapida. Ad esempio, i risultati delle scale 1+2 e 4+5 vengono sommati per avere una classifica generale come "buono" (1/2), "medio" (3) e "cattivo" (4/5). Questo riguarda solo i tipi di domanda "A" (array a 5 punti) e "5" (scelta a 5 punti).
• Impostazioni di esportazione in PDF: Questa funzione attiva l'esportazione in PDF per le indagini stampabili e la Stampa delle risposte. La funzione di esportazione in PDF è totalmente sperimentale e il risultato è lontano dall'essere perfetto. Purtroppo al momento non è possibile fornire supporto: se vuoi aiutarci a correggerla, contattaci.
  • 'pdfdefaultfont': Rappresenta il carattere di default che verrà usato dalla funzione di esportazione in PDF. Il valore di default è 'auto'. Per cambiarlo, devi impostarlo su uno dei PDF core fonts.
  • 'alternatepdffontfile': È un array con i codici delle lingue e il carattere corrispondente. Il carattere di default per ogni lingua può essere sostituito nel file config.php;
  • 'pdffontsize': indica la dimensione del carattere per i testi normali; per il titolo dell'indagine è <pdffontsize>+4, mentre per il titolo del gruppo è <pdffontsize>+2. Può essere modificata nel file config.php o dalla finestra di dialogo Impostazioni generali.
• Impostazioni dei grafici
  • 'chartfontfile': Imposta il nome del file del carattere usato per creare i grafici statistici. Il file deve trovarsi nella directory dei font, situata nella cartella principale di LimeSurvey. Può essere modificato nel file config.php;
  • 'alternatechartfontfile': È un array con i codici delle lingue e il carattere corrispondente. Può essere modificato nel file config.php.
• showsgqacode: Questa impostazione viene usata nella funzione di indagine stampabile e per default è 'false'. Se imposti showsgqacode = 'true';, verranno mostrati gli ID di ogni domanda e, se applicabile, di ogni risposta. Questi ID corrispondono all'intestazione delle colonne nella tabella Lime_survey_12345, che contiene i dati delle risposte di una determinata indagine. Questi ID possono essere usati come libro codici per query manuali al database.

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 voler far autenticare i propri amministratori delle indagini tramite un sistema di autenticazione centrale (Active Directory, openLdap, Radius, ...) invece di usare il database interno di LimeSurvey. Un modo semplice per farlo è configurare il software del web server in modo che usi questo sistema di autenticazione esterno e poi chiedere a LimeSurvey di fidarsi dell'identità utente comunicata dal web server. Per abilitare questa funzione, devi:

• attivare il plugin Webserver in Configurazione > Plugin e impostare nelle impostazioni del plugin la chiave del server che contiene il nome utente (default: REMOTE_USER);
• abilitare l'autenticazione lato web server.

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 dal web server;
• il suo nome di accesso è definito come utente nel database utenti di LimeSurvey (all'utente vengono quindi concessi i privilegi definiti per quell'utente nel database utenti di LimeSurvey);
• ha il permesso globale Utilizzare l'autenticazione del server web.

Delega di autenticazione con importazione automatica degli utenti

Quando si gestisce un database utenti molto grande, 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 dal web server ma non ancora presenti nel proprio database utenti.
• auth_webserver_autocreate_profile: Un array che descrive il profilo di default che verrà assegnato all'utente: nome completo (fittizio), e-mail e lingua.
• auth_webserver_autocreate_permissions: Un array con i permessi globali che verranno assegnati all'utente.

Se vuoi personalizzare il profilo utente in modo che corrisponda all'utente connesso, dovrai sviluppare in config.php una semplice funzione chiamata hook_get_auth_webserver_profile: con questa funzione puoi recuperare da un database centrale di account utente (ad esempio da una directory LDAP) il vero nome completo, l'e-mail e la lingua di un particolare utente.

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

• False o un array vuoto: in questo caso all'utente viene negato l'accesso a LimeSurvey;
• un array contenente le stesse voci di auth_webserver_autocreate_profile.

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
    return array(
        'full_name' => $user_name_from_backend,
        'email' => $user_email_from_backend,
        'lang' => $user_lang_from_backend,
    );
}

// If user should be denied access, return an empty array
// return array();

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

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

Vedere crittografia dei dati per i dettagli su questa funzione.

• encryptionkeypair
• encryptionpublickey
• encryptionsecretkey
• encryptionnonce
• encryptionsecretboxkey

Impostazioni URL avanzate

• publicurl: Dovrebbe essere impostato sull'URL dei tuoi 'script pubblici'. Gli script pubblici sono quelli che si trovano nella cartella "limesurvey" (o come hai chiamato la directory che contiene tutti gli altri script e directory). Questa impostazione è disponibile in config.php e viene usata quando LimeSurvey ha bisogno di un URL assoluto (ad esempio quando vengono inviate le e-mail con i token).
• tempurl: Dovrebbe essere impostato sull'URL della tua directory "/limesurvey/tmp" o di una directory che vuoi che LimeSurvey usi per servire i file temporanei.
• uploadurl: Dovrebbe essere impostato sull'URL della tua directory "/limesurvey/upload" o di una directory che vuoi che LimeSurvey usi per servire i file caricati. Questo ti permette di impostare i file caricati su un altro dominio.

Impostazioni percorso avanzate

• homedir: Va impostato sulla posizione fisica su disco dei suoi script di amministrazione, ad esempio "/home/usr/htdocs/limesurvey/admin". Non aggiunga una barra finale a questa voce. L'impostazione predefinita in config.php tenta di rilevare il percorso root predefinito di tutti i suoi documenti utilizzando la variabile PHP {$_SERVER['DOCUMENT_ROOT']}. Nella maggior parte dei casi può lasciarla invariata e modificare solo il resto della stringa in modo che corrisponda al nome della directory in cui ha inserito gli script di LimeSurvey.
• publicdir: Va impostato sulla posizione fisica su disco dei suoi 'script pubblici'.
• tempdir: Va impostato sulla posizione fisica su disco della directory /limesurvey/tmp, in modo che lo script possa leggere e scrivere file.
• uploaddir: Va impostato sulla posizione fisica su disco della directory /limesurvey/upload, in modo che lo script possa leggere e scrivere file.
• sCKEditorURL: URL dello script CKEditor.

Altre impostazioni avanzate

Carica file

• magic_database: Consente di utilizzare un database MIME diverso per finfo_open. Può essere aggiornato solo nel file config.php. Esempio: /usr/share/misc/magic.mgc per Linux basato su Red Hat.
• magic_file: Consente di utilizzare un file diverso da quello incluso per ottenere l'array delle estensioni in base al tipo MIME. Deve essere un file PHP che restituisce 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.

Token

• allowedcharacters_pattern_token : Queste impostazioni consentono di definire il pattern regexp utilizzato per filtrare i token.