Optional settings/ro

Următoarea secțiune se adresează celor dintre dumneavoastră care ar dori să editeze acele setări de configurare care nu au putut fi modificate cu ajutorul GUI (Graphical User Interface) a instalării LimeSurvey. Vă rugăm să rețineți că toate modificările din directorul rădăcină LimeSurvey se fac pe propriul risc. Cu toate acestea, în cazul în care întâmpinați probleme/aveți nevoie de îndrumare suplimentară, alăturați-vă forumurilor de discuții [1] sau IRC canal pentru ajutor din partea comunității LimeSurvey.

Introducere

Pentru a modifica setările de configurare ale instalării, trebuie să editați setările opționale. Acestea pot fi găsite în /application/config/config-defaults.php, care se află în directorul rădăcină LimeSurvey. Setările implicite ale instalării standard pot fi găsite în config-defaults.php. Unele dintre ele pot fi suprascrise folosind dialogul Setări globale, în timp ce celelalte vor trebui editate manual.

  Dacă doriți să modificați aceste setări, vă rugăm să nu le modificați în config-defaults.php, ci copiați setarea/linia specială în /application/config/config.php în 'config' => array( ) si schimba-l acolo. Toate setările nou modificate/introduse din fișierul config.php vor suprascrie valorile implicite din config-defaults.php.

Când are loc o actualizare, doar setările config-defaults.php sunt modificate. Prin urmare, editarea fișierului config.php va salva setările dvs. personalizate.

Pentru a actualiza/a adăuga setările LimeSurvey în /application/config/config.php, trebuie să actualizați matricea de config:

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Valoare nouă', // Actualizați configurația implicită LimeSurvey aici
 )

Yii setări

LimeSurvey folosește cadrul Yii, care are propriii parametri de configurare în fișierul application/config/internal.php și application/config/config.php. De asemenea, puteți accesa unele setări de configurare specifice ale LimeSurvey prin configurația Yii.

Deoarece matricea config.php este îmbinată cu întreaga configurație, puteți înlocui orice parametri Yii din fișierul config.php.

Setările specifice Yii sunt setate în matricea de componente:

 
 'components' => array(
 'db' => array(
 ....
 ),
 'Setări specifice'=>array(
 ....
 ),
 ),

Setări baze de date

Setările bazei de date sunt scrise în config.php de fișierul de instalare când instalați LimeSurvey pentru prima dată. Dacă este necesar, puteți actualiza această parte a fișierului config.php. Vă rugăm să rețineți că faceți acest lucru pe propriul risc! Consultați și Yii documentație și vă rugăm rețineți că LimeSurvey acceptă numai următoarele tipuri de baze de date: mysql, pgsql, dblib, mssql și sqlsrv.

Setări de sesiune

Puteți seta niște parametri de sesiune în config.php (verificați cele două exemple de mai jos). Puteți decomenta/adăugați partea necesară în config.php. Consultați Yii Documentation pentru alte setări.

Utilizați sesiuni bazate pe tabel

LimeSurvey poate folosi sesiuni bazate pe tabel, găsiți o parte comentată în fișierul implicit generat config.php. Pentru a utiliza sesiunea bazată pe tabel, eliminați // dinaintea fiecărei linii.

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

Actualizare alte sesiuni

Dacă utilizați SSL ('https') pentru instalarea dvs. LimeSurvey, adăugarea următoarelor linii la config.php va crește securitatea sesiunii:

 // Setați cookie-ul prin SSL
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // utilizați SSL pentru cookie-uri
 'httponly' => true // Cookie-urile nu pot fi utilizate de către alte protocoale - experimentale
 ),
 ),

Dacă doriți să reparați domeniul pentru un cookie, utilizați următoarea sintaxă în config.php:

 // Setați domeniul pentru cookie
 'session' => matrice (
 'cookieParams' => matrice(
 'domeniu' => '.example.org',
 ),
 ),

Dacă aveți mai multe instalări pe același server, poate fi mai rapid și mai ușor să setați un nume de sesiune diferit pentru fiecare instanță LimeSurvey. Acest lucru poate fi necesar pentru IE11 în anumite condiții (consultați problema 12083)

 // Setați numele sesiunii
 'session' => matrice (
 'sessionName' => "LimeSurveyN1",
 ),

Setări de solicitare

Setările de solicitare sunt importante, dar setările implicite sunt deja optimizate pentru utilizarea LimeSurvey. Pentru a citi mai multe despre ele, consultați Yii Documentation.

De exemplu, configurația setărilor de solicitare LimeSurvey poate fi modificată în următorul mod (pe propriul risc) :

 // Dezactivează protecția CSRF
 'request' => array(
 'enableCsrfValidation'=>false, 
 ),

 // Implementați o anumită bază URL 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Setați numele domeniului cookie și calea pentru protecția CSRF, calea este folosită dacă aveți instanță diferită pe același domeniu
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'path' => '/limesurvey/',
 ) 
 ),

Dacă trebuie să actualizați doar adresa URL pentru e-mailurile cu simbol, setați publicurl în fișierul config.php.

Permite utilizarea sondajelor într-un iframe

După ce ați permis Încorporarea Iframe, o soluție 100% fiabilă poate fi garantată numai dacă site-ul de încadrare folosește același domeniu rădăcină. Dacă utilizați LimeSurvey Cloud, acest lucru poate fi realizat utilizând alias de domeniu need-it

Setări URL

  Dacă trebuie să actualizați numai adresa URL pentru simbol și alte e-mailuri, setați publicurl în fișierul config.php.

Pentru a modifica setările implicite de URL, actualizați urlManager:

 // Folosiți adresa URL scurtă
 'urlManager' => array(
 'urlFormat' => 'cale',
 'showScriptName' => false,
 ),

De asemenea, puteți adăuga .html după id-ul sondajului în felul următor:

 // Utilizați adresa URL scurtă
 'urlManager' => array(
 'urlFormat' => 'cale',
 'rules' => matrice (
 '<sid:\d+> ' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => fals,
 ),

Pentru mai multe informații, consultați documentația Yii.

Setări de înregistrare

Yii oferă diferite soluții pentru a genera jurnalele. Pentru a afla mai multe despre ele, consultați subiectul special de logare. LimeSurvey folosește „1” sau „2” în mod implicit, ceea ce permite fiecărui utilizator web să vadă jurnalele. Puteți crea propriile setări folosind Yii direct.

De exemplu, o soluție rapidă pentru a înregistra erori și avertismente în fișiere este:

 
return array(
 'components' => array(
 /* O altă componentă aici 'db', de exemplu */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'avertisment, eroare',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* O altă parte componentă aici 'urlManager', de exemplu */
 ),
 /* Partea finală (cu ' runtimePath' 'config' de exemplu) */
);

 Hint: Fișierul este salvat implicit în <code>limesurvey/tmp/runtime/application.log</code> , care se află în folderul rădăcină LimeSurvey.

Template:Alerta.

Cale de rulare

Calea de rulare trebuie să fie un director care poate fi citit și scris pentru „utilizatorul web”. Totuși, calea de rulare conține fișiere cu informații potențiale de securitate care se află în zona publică de acces web. LimeSurvey colectează aceste fișiere în directorul temporar al directorului rădăcină LimeSurvey. Pentru a elimina accesul la astfel de date importante, puteți seta calea de rulare în afara accesului web public prin editarea liniilor respective în fișierul /application/config/config.php:

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

Setări generale

• sitename: Oferă un nume site-ului dvs. de sondaj. Acest nume va apărea în prezentarea generală a listei de sondaje și în antetul de administrare. Valoarea implicită este „LimeSurvey” și poate fi înlocuită în dialogul global settings sau editată în config.php.
• siteadminemail: Aceasta este adresa de e-mail implicită a administratorul site-ului și este folosit pentru mesajele de sistem și opțiunile de contact. Această setare este folosită numai ca valoare implicită și poate fi înlocuită în dialogul Setări globale.
• siteadminbounce: Aceasta este adresa de e-mail la care vor fi trimise e-mailurile returnate. Această setare este folosită numai ca valoare implicită și poate fi înlocuită de dialogul Setări globale.
• siteadminname: Numele real al administratorului site-ului. Această setare este folosită numai ca valoare implicită și poate fi înlocuită în dialogul Setări globale).
• proxy_host_name: Acesta este numele de gazdă al serverului dumneavoastră proxy (are de menționat dacă sunteți în spatele unui proxy și doriți să actualizați LimeSurvey folosind ComfortUpdate).
• proxy_host_port: Acesta este portul serverului dumneavoastră proxy (trebuie să fie menționat dacă sunteți în spatele unui proxy și doriți să actualizați LimeSurvey folosind ComfortUpdate).

Securitate

• maxLoginAttempt: Acesta este numărul de încercări pe care le are un utilizator pentru a introduce parola corectă înainte ca adresa sa IP să fie blocată/blocata. Valoarea implicită este 3 și poate fi modificată din config.php.
• timeOutTime: Dacă utilizatorul introduce parola incorect pentru<maxLoginAttempt> , ea sau el este blocat pentru<timeOutTime> secunde. Valoarea implicită este de 10 minute și poate fi modificată din config.php.
• maxLoginAttemptParticipants: Acesta este numărul de încercări pe care le are un participant pentru a introduce un token valid înainte de a-și obține Adresă IP blocată/blocat. Valoarea implicită este 3 și poate fi modificată din config.php.
• timeOutParticipants: Dacă participantul introduce incorect jetonul pentru<maxLoginAttemptParticipants> , ea sau el este blocat pentru<timeOutParticipants> secunde. Valoarea implicită este de 10 minute și poate fi modificată din config.php.
• surveyPreview_require_Auth: Setată implicit la true. Dacă setați acest lucru la „fals”, orice persoană vă poate testa sondajul folosind adresa URL a sondajului, fără a se conecta la panoul de administrare și fără a fi nevoie să activeze mai întâi sondajul. Această setare este o valoare implicită și poate fi suprascrisă în dialogul Setări globale sau editată în config.php.
• usercontrolSameGroupPolicy: Setată la true implicit. În mod implicit, utilizatorii non-administratori definiți în interfața de gestionare LimeSurvey vor putea vedea doar utilizatorii pe care îi creează sau utilizatorii care aparțin cel puțin unui același grup. Valoarea implicită poate fi înlocuită în dialogul Setări globale sau editată în config.php.
• filterxsshtml: Această setare permite filtrarea etichetelor html suspecte aflate în sondaje, grupuri și texte cu întrebări și răspunsuri în interfața de administrare. Lăsați acest lucru la „fals” doar dacă aveți încredere absolută în utilizatorii pe care i-ați creat pentru administrarea LimeSurvey și dacă doriți să le permiteți acestor utilizatori să poată folosi Javascript, Flash Movies etc.. Super-administratorii nu au niciodată filtrat HTML . Valoarea implicită poate fi înlocuită în dialogul global settings sau editată în config.php.
• demoMode: Dacă această opțiune este setată la „true” în config.php. , apoi LimeSurvey va intra în modul demonstrativ. Modul demo modifică următoarele lucruri:
  • Dezactivează detaliile utilizatorului administrator și schimbarea parolei;
  • Dezactivează încărcarea fișierelor în editorul de șabloane;
  • Dezactivează trimiterea de invitații și mementouri prin e-mail;!N !** Dezactivează crearea unui dump de bază de date;
  • Dezactivează posibilitatea de a modifica următoarele setări globale: numele site-ului, limba implicită, modul editor HTML implicit, filtrul XSS.
• 'forcedsuperadmin:' Matrice de id-uri de utilizator cu toate drepturile pe toate LimeSurvey. Aceste setări pot fi actualizate numai în fișierul config.php. Drepturile acestui utilizator nu pot fi editate în permisiunile globale pentru un utilizator nici măcar de către alt super-administrator forțat. Implicit: utilizatorul cu aceste drepturi este utilizator cu id: 1. Primul utilizator creat imediat după instalare.
• force_ssl: forțează LimeSurvey să ruleze prin HTTPS sau să blocheze HTTPS. Consultați Force HTTPS în GUI de administrare a setărilor globale.
• ssl_emergency_override: Această setare forțează SSL dezactivat. Dacă ați activat HTTPS/SSL în setările globale, dar serverul dvs. nu are HTTPS activat, singura modalitate de a-l dezactiva este prin modificarea directă a unei valori din baza de date. Acest lucru vă permite să forțați dezactivarea HTTPS în timp ce modificați setările globale pentru Force Secure. Acest lucru ar trebui să fie întotdeauna fals, cu excepția situațiilor de urgență în care îl schimbați în adevărat până când remediați problema. Această setare poate fi setată numai prin fișierul config.php.
• ssl_disable_alert: Dezactivați alerta pentru super-administrator despre SSL neforțat, dacă într-adevăr nu puteți sau nu doriți să forțați ssl. Această setare poate fi setată numai prin fișierul config.php.

Resources

• sessionlifetime: Definește timpul în secunde după care expiră o sesiune de sondaj. Se aplică numai dacă utilizați sesiuni de bază de date. Dacă folosiți sesiuni de bază de date, modificați parametrul în config.php sau înlocuiți valoarea implicită din dialogul Setări globale.
• memorylimit: Aceasta determină câtă memorie LimeSurvey poate accesa. „128 MB” este minimul recomandat (MB=Megabyte). Dacă primiți erori de timeout sau aveți probleme la generarea de statistici sau la exportul fișierelor, ridicați această limită la „256 MB” sau mai mare. Dacă serverul dvs. web a stabilit o limită mai mare în config.php, atunci această setare va fi ignorată.

Vă rugăm să rețineți că astfel de setări locale pot fi întotdeauna anulate de modificările făcute în dialogul de setări globale.

Pentru a crește limita de memorie la 128M, puteți încerca, de asemenea, să adăugați:

• memory_limit = 128M la fișierul php.ini principal al serverului dvs. (recomandat, dacă aveți acces)
• memory_limit = 128M la un fișier php.ini în rădăcina LimeSurvey
• php_value memory_limit 128M într-un fișier .htaccess în rădăcina LimeSurvey

• max_execution_time: Setează numărul de secunde în care un script poate rula. Dacă se ajunge la aceasta, scriptul returnează o eroare fatală. Pentru a putea exporta date și statistici mari ale sondajelor, LimeSurvey încearcă să le seteze implicit la 1200 de secunde. Puteți seta un timp mai mare sau un timp mai mic dacă este necesar. Accesibil numai prin fișierul de configurare php.

Aspect

• dropdownthreshold ^{(Obsolete since 2.50)}: Când „R” este selectat pentru $dropdowns , administratorului i se permite să seteze un număr maxim de opțiuni care vor fi afișate ca butoane radio , înainte de a converti înapoi la o listă derulantă. Dacă există o întrebare care are un număr mare de opțiuni, afișarea lor pe toate simultan ca butoane radio poate părea greoaie și poate deveni contra-intuitivă pentru utilizatori. Setarea la maximum, să spunem 25 (care este implicit) înseamnă că listele mari sunt mai ușor de utilizat de către administratori pentru participantul la sondaj.
• repeatheadings: Cu tipul de întrebare Array, veți avea adesea o mulțime de subîntrebări, care - atunci când sunt afișate pe ecran - ocupă mai mult de o pagină. Această setare vă permite să decideți câte subîntrebări ar trebui să fie afișate înainte de a repeta informațiile din antet pentru întrebare. O setare bună pentru aceasta este în jur de 15. Dacă nu doriți ca titlurile să se repete, setați-o la 0. Această setare este înlocuită în dialogul Setări globale ^{(New in 2.05 )} .
• minrepeatheadings: Numărul minim de subîntrebări rămase care sunt necesare înainte de a repeta titlurile în întrebările Array. Valoarea implicită este 3 și poate fi editată în config.php.
• defaulttemplate: Această setare specifică tema implicită folosită pentru „lista publică” a sondajelor. Această setare poate fi suprascrisă în dialogul Setări globale sau editată în config.php.
• defaulthtmleditormode: Setează modul implicit pentru editorul HTML integrat. Această setare poate fi suprascrisă în dialogul global settings sau editată în config.php. Setările valide sunt:
  • 'inline' - Înlocuirea inline a câmpurilor cu un editor HTML. Lent, dar convenabil și ușor de utilizat;
  • „popup” - Adaugă o pictogramă care rulează editorul HTML într-o fereastră pop-up, dacă este necesar. Mai rapid, dar codul HTML este afișat sub forma;
  • „niciunul”- Fără editor HTML;
• column_style: Definește modul în care sunt randate coloanele pentru răspunsurile la sondaj atunci când se utilizează afișare_coloane. Poate fi editat în fișierul config.php. Setările valide sunt:
  • 'css' - folosește una dintre diferitele metode CSS pentru a crea coloane (consultați foaia de stil șablon pentru detalii);
  • 'ul' - coloanele sunt redate ca multiple liste neordonate plutitoare (implicit);
  • „tabel” - folosește un aspect bazat pe tabele convenționale;
  • NULL - dezactivează utilizarea coloanelor.

Language & time

• defaultlang: Aceasta ar trebui să fie setată la limba implicită pentru a fi utilizată în scripturile dvs. de administrare, precum și setarea implicită pentru limba din lista de sondaje publice. Această setare poate fi suprascrisă în dialogul Setări globale sau editată în config.php.
• timeadjust: Dacă serverul dvs. web se află într-un alt fus orar față de locația în care sondajele dvs. se vor baza, puneți diferența dintre serverul dvs. și fusul orar de acasă aici. De exemplu, locuiesc în Australia, dar folosesc un server web din SUA. Serverul web este cu 14 ore în urmă cu fusul orar local. Deci setarea mea aici este „14”. Cu alte cuvinte, adaugă 14 ore la timpul serverelor web. Această setare este deosebit de importantă atunci când sondajele marchează răspunsurile. Această setare poate fi suprascrisă în dialogul global settings sau editată în config.php.

Comportament sondaj

• deletenonvalues: Utilizați această caracteristică cu precauție. În mod implicit (o valoare de 1), întrebările irelevante sunt NULL în baza de date. Acest lucru asigură că datele din baza de date sunt consecvente intern. Cu toate acestea, există cazuri rare în care s-ar putea să doriți să păstrați valori irelevante, caz în care puteți seta valoarea la 0. De exemplu, întrebați o persoană de sex masculin sexul său, iar acesta spune accidental „femeie” și apoi răspunde unei femei. -întrebări specifice (întrebări care sunt condiționate de a fi femeie, deci sunt relevante doar pentru femei). Apoi, își dă seama de greșeala sa, dă înapoi, setează genul la „masculin” și continuă sondajul. Acum, întrebările specifice femeilor sunt irelevante. Dacă $deletenonvalues==1 , acele valori irelevante vor fi șterse (null) în baza de date. Dacă $deletenonvalues==0 , răspunsurile sale eronate nu vor fi șterse, deci vor fi în continuare prezente în baza de date atunci când o analizați.
• shownoanswer: Când un buton radio/select tip întrebare care conține răspunsuri editabile (de exemplu: Listă, întrebări Array) nu este obligatoriu și „shownoanswer” este setat la 1, un „Fără răspuns” suplimentar intrarea este afișată - astfel încât participanții pot alege să nu răspundă la întrebare. Unii oameni preferă ca acest lucru să nu fie disponibil. Această setare poate fi înlocuită din dialogul global settings sau editată în config.php. Valorile valide sunt:
  • '0': Nu;
  • '1': Da;
  • '2': Administratorul sondajului poate alege.
• printanswershonorsconditions: Această setare determină dacă caracteristica printanswers va afișa intrări de la întrebări care au fost ascunse prin ramificarea condițiilor (Implicit: 1 = ascunde răspunsurile de la întrebările ascunse de condiții).
• ' hide_groupdescr_allinone:' Această setare este relevantă pentru sondajele all-in-one care utilizează condiții . Când este setat la „adevărat”, numele și descrierea grupului sunt ascunse dacă toate întrebările din grup sunt ascunse. Valoarea implicită este „adevărat” - ascunde numele și descrierea grupului atunci când toate întrebările din grup sunt ascunse de condiții. Poate fi editat în config.php.
• showpopups: Afișează mesaje pop-up dacă la întrebările obligatorii sau condiționate nu s-a răspuns corect:
  • '2' = definit de opțiunea Temă (implicit )
  • '1'= afișează mesajul pop-up;
  • '0'= arată mesajul pe pagină;
  • '-1'= nu afișează deloc mesajul (în acest caz , utilizatorii vor vedea în continuare sfaturile specifice întrebărilor care indică întrebările la care trebuie să se răspundă).

Comportamentul tipului de întrebare numerică

• bFixNumAuto: Câmpurile numerice pot fi filtrate automat pentru a elimina toate valorile nenumerice. În mod implicit, acesta este activat, îl puteți dezactiva global. Aceste setări sunt legate de „Remediați automat valoarea numerică” în opțiunile principale ale temei. A fost activat pentru „Da”, dezactivat pentru „Numai pentru expresie” și „Nu”.
• bNumRealValue: Câmpurile numerice utilizate în managerul de expresii pot fi fixate sau nu. Este remediat implicit. Dacă NUMERIC este o întrebare numerică: dezactivați sau 0: {NUMERIC} cu caractere greșite trimiteți '' , activați sau 1 : {NUMERIC} trimite toate caracterele introduse. Aceste setări sunt legate de „Remediați automat valoarea numerică” în opțiunile principale ale temei. A fost activat pentru „Da” și „Numai pentru expresie” și dezactivat pentru „Nu”.

Dezvoltare și depanare

• debug: Cu această setare, setați raportarea erorilor PHP la E_ALL. Aceasta înseamnă că fiecare mică notificare, avertisment sau eroare legată de script este afișată. Această setare ar trebui să fie comutată la „1” numai dacă încercați să depanați aplicația din orice motiv. Dacă sunteți dezvoltator, comutați-l la „2”. Nu îl comutați la „1” sau „2” în producție, deoarece ar putea cauza divulgarea căii. Valoarea implicită este „0” și poate fi editată în config.php.
• debugsql: Activați această setare dacă doriți să afișați toate interogările SQL executate pentru script în partea de jos a fiecărei pagini. Foarte util pentru optimizarea numărului de interogări. Pentru a-l activa, schimbați valoarea implicită la „1” din fișierul config.php.
• use_asset_manager: Implicit: modul de depanare dezactivați managerul de active, vă puteți permite să utilizați managerul asse cu modul de depanare activat.

În cazul în care întâmpinați o eroare în aplicație, vă recomandăm insistent să activați setarea de depanare pentru a obține o eroare mai detaliată pe care o puteți trimite împreună cu raportul de eroare:

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

Dacă lucrați la plugin și aveți nevoie de o modalitate rapidă de a descărca variabilele pe ecran: puteți utiliza funcția traceVar. Dacă este setată depanarea: această funcție folosește CWebLogRoute pentru a fi afișată pe pagina HTML. Utilizare traceVar($MyVariable)

Setări e-mail

All the settings from below can be overridden in the global settings dialog.

• 'emailmethod: This determines how email messages are being sent. The following options are available:
  • 'mail:' it uses internal PHP mailer;
  • 'sendmail:' it uses sendmail mailer;
  • 'smtp:' it uses SMTP relaying. Use this setting when you are running LimeSurvey on a host that is not your mail server.
• 'emailsmtphost: If you use 'smtp' as $emailmethod, then you have to put your SMTP-server here. If you are using Google mail you might have to add the port number like $emailsmtphost = 'smtp.gmail.com:465'.
• emailsmtpuser: If your SMTP-server needs authentication then set this to your user name, otherwise it must be blank.
• emailsmtppassword: If your SMTP-server needs authentication then set this to your password, otherwise it must be blank.
• emailsmtpssl: Set this to 'ssl' or 'tls' to use SSL/TLS for SMTP connection.
• maxemails: When sending invitations or reminders to survey participants, this setting is used to determine how many emails can be sent in one bunch. Different web servers have different email capacities and if your script takes too long to send a bunch of emails, the script could time out and cause errors. Most web servers can send 100 emails at a time within the default 30 second time limit for a PHP script. If you get script timeout errors when sending large numbers of emails, reduce the number in this setting. Clicking the 'send email invitation' button 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.

Statistics and response browsing

• filterout_incomplete_answers: Control the default behavior of filtering incomplete answers when browsing or analyzing responses. For a discussion on incomplete responses see our 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:
  • 'show': Allows you to visualize both complete and incomplete answers;
  • 'filter': It shows only complete answers;
  • 'incomplete': Show only incomplete answers.
• 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.
• 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).
• 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.
  • 'usepdfexport': Set '0' to disable and '1' to enable;
  • '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 PDF core fonts.
  • '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': 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': 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' for Landscape or 'P' for portrait format. It can be edited from the config.php file.
• 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;
  • 'alternatechartfontfile': It's an array with language keys and their corresponding font. It can be edited in the config.php file.
• 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.

LDAP settings

As this is an extensive topic we have moved LDAP settings to another page.

Authentication

Starting with LimeSurvey 2.05, authentication will be handled by plugins. As a result, the information below might be outdated. See the plugins wiki for most up to date information.

Authentication delegation to the webserver

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:

• set auth_webserver to 'true' in config.php;
• enable authentication from the web server side.

Please note that:

• LimeSurvey will then bypass its own authentication process (by using the login name reported by the web server without asking for a password);
• this can only replace the LimeSurvey GUI authentication system, not the survey invitation system (participant interface).

Authentication delegation with no automatic user import

Please note that Authentication Delegation doesn't bypass the LimeSurvey authorization system by default - 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.

A user is then granted access to LimeSurvey if and only if:

• he has been authenticated to the web server;
• 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).

Authentication delegation with automatic user import

When managing a huge user database, it is sometimes easier to auto-import users in the LimeSurvey database:

• 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_profile: An array describing the default profile that will be assigned to the user, including the full (fake) name, email, and privileges.

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.

The hook_get_auth_webserver_profile function takes the user login name as the only argument and can return:

• False or an empty array - in this case the user is denied access to LimeSurvey;
• an array containing all common userprofile entries as described in the $WebserverAuth_autouserprofile

function hook_get_auth_webserver_profile($user_name)
{
     // Retrieve user's data from your database backend (for instance LDAP) here
     ... get $user_name_from_backend
     ... get $user_email_from_backend
     ... get $user_lang_from_backend
     ... from groups defined in your backend set $user_admin_status_frombackend_0_or_1
     return Array(
                     'full_name' => "$user_name_from_backend",
                     'email' => "$user_email_from_backend",
                     'lang' => '$user_lang_from_backend',
                     'htmleditormode' => 'inline',
                     'templatelist' => 'default,basic,MyOrgTemplate',
                     'create_survey' => 1,
                     'create_user' => 0,
                     'delete_user' => 0,
                     'superadmin' => $user_admin_status_frombackend_0_or_1,
                     'configurator' =>0,
                     'manage_template' => 0,
                     'manage_label' => 0);
}

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

     // return Array();

  The optionnal 'hook_get_auth_webserver_profile' function is for advanced user usage only! For further details, please read the comments from the config-defaults.php file.

User name mapping

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:

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

After a successful authentication with the 'myname' login and web server password, you'll be directly authorized to use LimeSurvey as the 'admin' user.

This has serious security implications, so use it with care. Also, protect your config.php from write access by the web server.

Use one-time passwords

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.

This setting has to be turned on config.php file to enable the usage of one-time passwords (default = false).

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

More information can be found in the "Manage Users" section.

Encryption settings ^{(New in 4.0.0 )}

  Once set, encryption keys should never be changed, otherwise all encrypted data could be lost !

When update or install, this parameters was generated by LimeSurvey and set in application/config/security.php file. You can move this settings in config.php if you want or leave in security.php.

See data encryption for detail on this feature.

• encryptionkeypair
• encryptionpublickey
• encryptionsecretkey

Advanced url settings

• 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).
• 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 - {$_SERVER['SERVER_NAME']}. In most cases, you can leave this and just modify the remainder of this string to match the directory name you have put the LimeSurvey scripts in.
• 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.
• 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.

Advanced path settings

• homedir: This should be set to the physical disk location of your administration scripts - for example "/home/usr/htdocs/limesurvey/admin". Don't add a trailing slash to this entry. The default setting in config.php attempts to detect the default root path of all your documents using the php variable setting {$_SERVER['DOCUMENT_ROOT']}. In most cases you can leave this and just modify the remainder of this string to match the directory name you have put the LimeSurvey scripts in.
• publicdir: This should be set to the physical disk location of your 'public scripts'.
• tempdir: This should be set to the physical disk location of your /limesurvey/tmp directory so that the script can read and write files.
• uploaddir: This should be set to the physical disk location of your /limesurvey/upload directory so that the script can read and write files.
• sCKEditorURL: url of the fckeditor script.
• fckeditexpandtoolbar: defines if the fckeditor toolbar should be opened by default.
• pdfexportdir: This is the directory with the tcpdf.php extensiontcpdf.php.
• pdffonts: This is the directory for the TCPDF fonts.

Other advanced settings

Upload files

• allowedthemeuploads: File types allowed to be uploaded in theme editor
• allowedresourcesuploads: File types allowed to be uploaded in the resources sections, and with the HTML Editor
• allowedfileuploads ^{(New in 4.0.0 )} Global restriction on file type to be uploaded
• magic_database: ^{(New in 3.17.17 )} Allow to use a different MIME database for finfo_open. Can be updated only in config.php file. Example : /usr/share/misc/magic.mgc for redhat based linux.
• magic_file: ^{(New in 3.17.17 )} Allow to use a different file to get the array of extension by mime type than the included one. Must be a PHP file return an array. Can be updated only in config.php file.

Update

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