Optional settings/sl

Naslednji razdelek je namenjen tistim, ki bi radi uredili tiste konfiguracijske nastavitve, ki jih ni bilo mogoče spremeniti s pomočjo GUI (grafični uporabniški vmesnik) namestitve LimeSurvey. Upoštevajte, da vse spremembe iz korenskega imenika LimeSurvey izvajate na lastno odgovornost. Kljub temu se v primeru, da imate težave/potrebujete dodatna navodila, pridružite forumom za razprave ali IRC kanal za pomoč skupnosti LimeSurvey.

Uvod

Te dodatne nastavitve je možno najti le v datoteki /application/config/config-defaults.php pri običajni namestitvi - nekatere se uporabijo le za prvo namestitev in se prepišejo z globalnimi nastavitvami. Če želite spremeniti te nastavitve, jih prosimo ne spreminjajte v config-defaults.php datoteki, pač pa kopirajte izbrane vrstice nastavitev v /application/config/config.php in jih spremenite v tej datoteki. Vse nastavitve v config.php prepišejo privzete vrednosti iz config-defaults.php in začenši z različico 1.87 nekatere od teh nastavitev se prepišejo z globalnimi nastavitvami. Na ta način je bolj enostavno nadgraditi vašo kasnejšo namestitev.

Ko pride do nadgradnje, se spremenijo samo nastavitve config-defaults.php. Zato boste z urejanjem datoteke config.php shranili vaše prilagojene nastavitve.

Če želite posodobiti/dodati nastavitve LimeSurvey v /application/config/config.php, morate posodobiti konfiguracijsko polje:

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Nova vrednost', // Tukaj posodobite privzeto konfiguracijo LimeSurvey
 )

Nastavitve Yii

LimeSurvey uporablja ogrodje Yii, ki ima lastne konfiguracijske parametre v datotekah application/config/internal.php in application/config/config.php'. Do nekaterih posebnih konfiguracijskih nastavitev LimeSurvey lahko dostopate tudi prek konfiguracije Yii.

Ker je polje config.php združeno s celotno konfiguracijo, lahko zamenjate vse parametre Yii v datoteki config.php.

Posebne nastavitve Yii so nastavljene v nizu komponent:

 
 'components' => array(
 'db' => array(
 ....
 ),
 'Specifične nastavitve'=>array(
 ....
 ),
 ),

Nastavitve baze podatkov

Nastavitve baze podatkov se zapišejo v config.php z namestitveno datoteko, ko prvič namestite LimeSurvey. Po potrebi lahko posodobite ta del datoteke config.php. Ne pozabite, da to počnete na lastno odgovornost! Glejte tudi Yii dokumentacijo in prosim ne pozabite, da LimeSurvey podpira samo naslednje vrste baz podatkov: mysql, pgsql, dblib, mssql in sqlsrv.

Nastavitve seje

Nekatere parametre seje lahko nastavite v config.php (preverite dva spodnja primera). Potreben del lahko odkomentirate/dodate v config.php. Glejte Yii dokumentacijo za druge nastavitve.

Uporabite seje na osnovi tabel

LimeSurvey lahko uporablja seje, ki temeljijo na tabelah, v privzeti generirani datoteki config.php najdete del s komentarji. Če želite uporabiti sejo na podlagi tabele, odstranite // pred vsako vrstico.

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

Posodobitev drugih sej

Če uporabljate SSL ('https') za svojo namestitev LimeSurvey, bo dodajanje naslednjih vrstic v vaš config.php povečalo varnost seje:

 // Nastavite piškotek prek SSL
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // uporabi SSL za piškotke
 'httponly' => true // Piškotkov ne sme uporabljati drugi protokoli - eksperimentalni
 ),
 ),

Če želite popraviti domeno za piškotek, uporabite naslednjo sintakso v config.php:

 // Nastavi domeno za piškotek
 'session' => array (
 'cookieParams' => array(
 'domain' => '.example.org',
 ),
 ),

Če imate več namestitve na istem strežniku, je lahko hitreje in enostavneje nastaviti drugačno ime seje za vsako instanco LimeSurvey. To je lahko potrebno za IE11 pod določenimi pogoji (glejte izdaja 12083)

 // Nastavite ime seje
 'session' => niz (
 'sessionName' => "LimeSurveyN1",
 ),

Nastavitve zahteve

Nastavitve zahteve so pomembne, vendar so privzete nastavitve že optimizirane za uporabo LimeSurvey. Če želite prebrati več o njih, si oglejte dokumentacijo Yii.

Na primer, konfiguracijo nastavitev zahteve LimeSurvey lahko spremenite na naslednji način (na lastno odgovornost) :

 // Onemogoči zaščito CSRF
 'request' => array(
 'enableCsrfValidation'=>false, 
 ),

 // Uveljavi določeno bazo URL-jev 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Nastavite ime domene piškotka in pot za zaščito CSRF, pot se uporabi, če imate na isti domeni drug primerek
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'path' => '/limesurvey/',
 ) 
 ),

Če morate posodobiti samo url za e-poštna sporočila z žetonom, nastavite publicurl v datoteki config.php.

Dovoli uporabo preverjanja seje in Csrf v iFrame ^{(New in 3.24.3 )}

Ko omogočite vdelavo Iframe, morate posodobiti nekaj konfiguracijskih delov. Pozor, tudi z vsemi nastavitvami: dovoli obrazec v iframe se lahko v nekaterih brskalnikih pokvari. Ta nastavitev je bila preizkušena s Firefoxom 81.0.2 in Chromiumom 85.0.4183.121.

Dovoli začetek seje v iframe

Seja mora biti varna (veljaven https), httponly in samesite do None. Vse nastavitve morajo biti nastavljene na male črke.

'session' => array (
 'sessionName'=>'LS-VBXZZORFJZCAKGYI',
 // Odkomentirajte naslednje vrstice, če potrebujete seje, ki temeljijo na tabelah.
 // Opomba: Seje, ki temeljijo na tabelah, so trenutno ni podprto na strežniku MSSQL.
 // 'class' => 'application.core.web.DbHttpSession',
 // 'connectionID' => 'db',
 // 'sessionTableName' = > '{{sessions}}',
 'cookieParams' => array(
 'secure' => true,
 'httponly' => true,
 'samesite' => 'Brez' ,
 ),
 ),

Dovoli piškotek csrf v iframe

Enako kot seja: mora biti varno in isto mesto nastavljeno na Brez. Celotno polje je treba dodati na isti ravni kot seja.

'request' => array(
 'enableCsrfValidation'=>true,
 'csrfCookie' => array(
 'sameSite' => 'None',
 'secure' => true,
),
 ),

Nastavitve URL-ja

Če želite spremeniti privzete nastavitve URL-ja, posodobite urlManager:

 // Uporabi kratek URL
 'urlManager' => array(
 'urlFormat' => 'path',
 'showScriptName' => false,
 ),

Za ID ankete lahko dodate tudi .html na naslednji način:

 // Uporabi kratek URL
 'urlManager' => array(
 'urlFormat' => 'path',
 'rules' => array (
 '<sid:\d+> ' => array('anketa/indeks','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => false,
 ),

Za več informacij preverite dokumentacijo Yii.

Nastavitve beleženja

Yii ponuja različne rešitve za ustvarjanje dnevnikov. Če želite izvedeti več o njih, preverite posebna tema o beleženju. LimeSurvey privzeto uporablja '1' ali '2', kar vsakemu spletnemu uporabniku omogoča ogled dnevnikov. Svoje nastavitve lahko ustvarite neposredno z Yii.

Na primer, hitra rešitev za beleženje napak in opozoril v datoteke je:

 
return array(
 'components' => array(
 /* Drugi sestavni del tukaj 'db' na primer */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'opozorilo, napaka',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* Drugi sestavni del tukaj 'urlManager', na primer */
 ),
 /* Končni del (z ' runtimePath' 'config' na primer) */
);

 Hint: Datoteka je privzeto shranjena v <code>limesurvey/tmp/runtime/application.log</code> , ki se nahaja v korenski mapi LimeSurvey.

Template:Opozorilo.

Izvajalna pot

Pot med izvajanjem mora biti berljiv in zapisljiv imenik za »spletni uporabnik«. Vendar pa izvajalna pot vsebuje datoteke z morebitnimi varnostnimi informacijami, ki se nahajajo v javnem spletnem dostopnem območju. LimeSurvey te datoteke zbira v začasnem imeniku korenskega imenika LimeSurvey. Če želite odpraviti dostop do tako pomembnih podatkov, lahko nastavite pot izvajanja zunaj javnega spletnega dostopa tako, da uredite ustrezne vrstice v datoteki /application/config/config.php:

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

Splošne nastavitve

• 'sitename: poimenuje vašo anketno mesto. To ime bo prikazano v pregledu anketnega seznama in v skrbniški glavi. Privzeta vrednost je 'LimeSurvey' in jo je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• 'siteadminemail:' To je privzeti e-poštni naslov za skrbnik mesta in se uporablja za sistemska sporočila in kontaktne možnosti. Ta nastavitev se uporablja samo kot privzeta vrednost in jo je mogoče preglasiti v pogovornem oknu globalne nastavitve.
• 'siteadminbounce:' To je e-poštni naslov, na katerega bodo poslana zavrnjena e-poštna sporočila. Ta nastavitev se uporablja samo kot privzeta vrednost in jo lahko preglasi pogovorno okno globalne nastavitve.
• 'siteadminname:' Pravo ime skrbnika spletnega mesta. Ta nastavitev se uporablja samo kot privzeta vrednost in jo je mogoče preglasiti v pogovornem oknu globalne nastavitve.
• 'proxy_host_name:' To je ime gostitelja vašega strežnika proxy (ima omeniti, če ste za proxyjem in želite posodobiti LimeSurvey z ComfortUpdate).
• 'proxy_host_port:' To so vrata vašega proxy strežnika (morajo biti omenjeno, če ste za posrednikom in želite posodobiti LimeSurvey z ComfortUpdate).

Varnost

• maxLoginAttempt: To je število poskusov, ki jih mora uporabnik vnesti pravilno geslo, preden se njegov ali njegov naslov IP blokira/zaklene. Privzeta vrednost je 3 in jo je mogoče spremeniti v config.php.
• timeOutTime: Če uporabnik vnese napačno geslo za<maxLoginAttempt> , se ona ali on zaklene<timeOutTime> sekund. Privzeta vrednost je 10 minut in jo je mogoče spremeniti v config.php.
• maxLoginAttemptParticipants: To je število poskusov, ki jih mora udeleženec vnesti veljaven žeton, preden dobi svoj Naslov IP blokiran/zaklenjen. Privzeta vrednost je 3 in jo je mogoče spremeniti v config.php.
• timeOutParticipants: Če udeleženec vnese nepravilen žeton za<maxLoginAttemptParticipants> , se ona ali on zaklene<timeOutParticipants> sekund. Privzeta vrednost je 10 minut in jo lahko spremenite v config.php.
• surveyPreview_require_Auth: Privzeto nastavljeno na true. Če to nastavite na 'false', lahko katera koli oseba preizkusi vašo anketo z uporabo URL-ja ankete, ne da bi se prijavila v skrbniško ploščo in ne da bi predhodno aktivirala anketo. Ta nastavitev je privzeta vrednost in jo je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• usercontrolSameGroupPolicy: Privzeto je nastavljeno na true. Privzeto bodo neskrbniški uporabniki, določeni v upravljalnem vmesniku LimeSurvey, lahko videli samo uporabnike, ki jih ustvarijo, ali uporabnike, ki pripadajo vsaj eni isti skupini. Privzeto vrednost je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• 'filterxsshtml:' Ta nastavitev omogoča filtriranje sumljivih oznak html, ki se nahajajo v anketah, skupine ter besedila vprašanj in odgovorov v skrbniškem vmesniku. Pustite to na 'false' samo, če popolnoma zaupate uporabnikom, ki ste jih ustvarili za administracijo LimeSurvey, in če želite tem uporabnikom dovoliti uporabo Javascripta, Flash filmov itd. Superskrbniki nikoli ne filtrirajo svojega HTML-ja . Privzeto vrednost je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• 'demoMode:' Če je ta možnost nastavljena na 'true' v config.php , potem bo LimeSurvey prešel v demo način. Demo način spremeni naslednje stvari:
  • Onemogoči skrbniške podatke o uporabniku in spreminjanje gesla;
  • Onemogoči nalaganje datotek v urejevalnik predlog;
  • Onemogoči pošiljanje e-poštnih povabil in opomnikov;!N !** Onemogoči ustvarjanje izpisa baze podatkov;
  • Onemogoči možnost spreminjanja naslednjih globalnih nastavitev: ime spletnega mesta, privzeti jezik, privzeti način urejevalnika HTML, filter XSS.
• ''forcedsuperadmin:' Niz ID-jev uporabnikov z vsemi pravicami na vseh LimeSurvey. Te nastavitve je mogoče posodobiti samo v datoteki config.php. Pravic tega uporabnika ne more urejati v globalnih dovoljenjih za uporabnika niti drug prisilni superskrbnik. Privzeto : uporabnik s temi pravicami je uporabnik z id : 1. Prvi uporabnik, ustvarjen tik po namestitvi.
• force_ssl:' prisili LimeSurvey, da deluje prek HTTPS ali blokira HTTPS. Glejte Force HTTPS v skrbniškem GUI za globalne nastavitve.
• ssl_emergency_override:' Ta nastavitev izklopi SSL. Če ste v globalnih nastavitvah vklopili HTTPS/SSL, vendar vaš strežnik nima omogočenega HTTPS, je edini način, da ga izklopite, tako da neposredno spremenite vrednost v bazi podatkov. To vam omogoča, da vsiljeno izklopite HTTPS, medtem ko spreminjate globalne nastavitve za Force Secure. To mora biti vedno napačno, razen v nujnih primerih, ko ga spremenite v resnično, dokler ne odpravite težave. To nastavitev je mogoče nastaviti samo prek datoteke config.php.
• ssl_disable_alert:' Onemogoči opozorilo za super-skrbnika o neprisilnem SSL, če res ne morete ali ne želite vsiliti ssl. To nastavitev je mogoče nastaviti samo prek datoteke config.php.

Viri

• 'sessionlifetime: Določa čas v sekundah, po katerem poteče seja ankete. Velja le, če uporabljate seje baze podatkov. Če uporabljate seje zbirke podatkov, spremenite parameter v config.php ali preglasite privzeto vrednost v pogovornem oknu globalne nastavitve.
• 'memorylimit:' To določa, koliko pomnilnika LimeSurvey lahko dostopa. '128 MB' je najmanjši priporočeni (MB=megabajt). Če prejmete napake o časovni omejitvi ali imate težave pri ustvarjanju statistike ali izvozu datotek, dvignite to omejitev na '256 MB' ali več. Če je vaš spletni strežnik nastavil višjo omejitev v config.php, bo ta nastavitev prezrta.

Upoštevajte, da lahko take lokalne nastavitve vedno preglasijo spremembe, opravljene v pogovornem oknu globalnih nastavitev'.

Če želite povečati omejitev pomnilnika na 128M, lahko poskusite dodati tudi:

• memory_limit = 128M v glavno datoteko php.ini vašega strežnika (priporočeno, če imate dostop)
• memory_limit = 128M v datoteko php.ini v koren LimeSurvey
• php_value memory_limit 128M v datoteki .htaccess v korenu LimeSurvey

• 'max_execution_time:' Nastavite število sekund, ki jih lahko izvaja skript. Če je to doseženo, skript vrne usodno napako. Da bi lahko LimeSurvey lahko izvažal podatke in statistiko velikih anket, ga poskusi privzeto nastaviti na 1200 sekund. Po potrebi lahko nastavite daljši ali nižji čas. Dostopno samo prek konfiguracijske datoteke php.

Videz

• dropdownthreshold ^{(Obsolete since 2.50)}: Ko je za $dropdowns izbrano "R", sme skrbnik nastaviti največje število možnosti, ki bodo prikazane kot radijski gumbi , preden se pretvori nazaj v spustni seznam. Če obstaja vprašanje, ki ima veliko možnosti, je lahko prikaz vseh naenkrat kot izbirnih gumbov videti neroden in lahko uporabnikom postane neintuitiven. Če to nastavite na največ, recimo 25 (kar je privzeto), pomeni, da skrbniki lažje uporabljajo velike sezname za udeleženca ankete.
• 'repeatheadings:' Z vrsto vprašanja Array, pogosto boste imeli veliko podvprašanj, ki – ko so prikazana na zaslonu – zavzamejo več kot eno stran. Ta nastavitev vam omogoča, da se odločite, koliko podvprašanj naj bo prikazanih, preden ponovite informacije o glavi vprašanja. Dobra nastavitev za to je okoli 15. Če ne želite, da se naslovi sploh ponavljajo, nastavite to na 0. Ta nastavitev je preglasena v pogovornem oknu globalne nastavitve ^{(New in 2.05 )} .
• 'minrepeatheadings: Najmanjše število preostalih podvprašanj, ki so potrebna pred ponovitvijo naslovov v vprašanjih Array. Privzeta vrednost je 3 in jo lahko urejate v config.php.
• defaulttemplate: Ta nastavitev določa privzeto temo, uporabljeno za 'javni seznam' anket. To nastavitev je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• 'defaulthtmleditormode:' Nastavi privzeti način za integrirani urejevalnik HTML. To nastavitev je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php. Veljavne nastavitve so:
  • 'inline' - Inline zamenjava polj z urejevalnikom HTML. Počasen, a priročen in uporabniku prijazen;
  • 'popup' - doda ikono, ki po potrebi zažene urejevalnik HTML v pojavnem oknu. Hitreje, vendar je koda HTML prikazana v obliki;
  • 'brez'- Brez urejevalnika HTML;
• 'column_style:' Določa, kako so stolpci upodobljeni za odgovore ankete pri uporabi prikazni_stolpci. Urejamo ga lahko v datoteki config.php. Veljavne nastavitve so:
  • 'css' - uporablja eno od različnih metod CSS za ustvarjanje stolpcev (za podrobnosti si oglejte slogovno listo predloge);
  • 'ul' - stolpci so upodobljeni kot več lebdeči neurejeni seznami (privzeto);
  • 'table' - uporablja postavitev, ki temelji na običajnih tabelah;
  • NULL - onemogoča uporabo stolpcev.

Jezik & čas

• 'defaultlang: To mora biti nastavljeno na privzeti jezik, ki bo uporabljen v vaših skrbniških skriptih, in tudi na privzeto nastavitev za jezik na seznamu javnih anket. To nastavitev je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.
• 'timeadjust:' Če je vaš spletni strežnik v drugem časovnem pasu od lokacije, kjer vaše ankete bodo temeljile, tukaj vnesite razliko med vašim strežnikom in domačim časovnim pasom. Na primer, živim v Avstraliji, vendar uporabljam ameriški spletni strežnik. Spletni strežnik je 14 ur za mojim lokalnim časovnim pasom. Torej je moja nastavitev tukaj "14". Z drugimi besedami, k času spletnih strežnikov doda 14 ur. Ta nastavitev je še posebej pomembna, ko ankete označujejo odgovore s časovnim žigom. To nastavitev je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php.

Vedenje ankete

• 'deletenonvalues: To funkcijo uporabljajte previdno. Privzeto (vrednost 1) so nepomembna vprašanja v zbirki podatkov NIČELNA. To zagotavlja, da so podatki v vaši zbirki podatkov interno skladni. Vendar pa obstajajo redki primeri, ko bi morda želeli obdržati nepomembne vrednosti; v tem primeru lahko nastavite vrednost na 0. Na primer, vprašate moško osebo po spolu, in ta pomotoma reče 'female' in nato odgovori nekaj ženskega -specifična vprašanja (vprašanja, ki so pogojena z ženskostjo, zato so relevantna samo za ženske). Nato spozna svojo napako, se podpre, nastavi spol na 'moški' in nadaljuje z anketo. Vprašanja o ženskah so nepomembna. Če $deletenonvalues==1 , bodo te nepomembne vrednosti izbrisane (NULLed) v bazi podatkov. Če $deletenonvalues==0 , njegovi napačni odgovori ne bodo izbrisani, tako da bodo še vedno prisotni v bazi podatkov, ko jo analizirate.
• shownoanswer: Ko izbirni gumb/izberi vrsto vprašanja, ki vsebuje odgovore, ki jih je mogoče urejati (npr. Seznam, vprašanja niza), ni obvezen in je 'shownoanswer' nastavljen na 1, se pojavi dodatni 'Brez odgovora' prikazan je vnos - tako da se udeleženci lahko odločijo, da ne bodo odgovorili na vprašanje. Nekateri ljudje imajo raje, da to ni na voljo. To nastavitev je mogoče preglasiti v pogovornem oknu globalne nastavitve ali urediti v config.php. Veljavne vrednosti so:
  • '0': Ne;
  • '1': Da;
  • '2': Skrbnik ankete lahko izbira.
• printanswershonorsconditions: Ta nastavitev določa, ali bo funkcija tiskanja odgovorov prikazala vnose iz vprašanj, ki so bila skrita z razvejanjem pogojev (privzeto: 1 = skrij odgovore iz vprašanj, skritih s pogoji).
• ' hide_groupdescr_allinone:' Ta nastavitev je pomembna za ankete vse v enem, ki uporabljajo pogoje . Ko je to nastavljeno na »true«, sta ime in opis skupine skrita, če so skrita vsa vprašanja v skupini. Privzeta vrednost je 'true' - skrije ime in opis skupine, ko so vsa vprašanja v skupini skrita zaradi pogojev. Urejate ga lahko v config.php.
• showpopups: Prikaži pojavna sporočila, če na obvezna ali pogojna vprašanja niste pravilno odgovorili:
  • '2' = določeno z možnostjo Tema (privzeto )
  • '1'= prikaži pojavno sporočilo;
  • '0'= namesto tega prikaži sporočilo na strani;
  • '-1'= ne prikaži sporočila (v tem primeru , bodo uporabniki še vedno videli namige za specifična vprašanja, na katera vprašanja je treba odgovoriti).

Numerical question type behavior

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

Razvoj

• $debug: s to možnostjo nastavite prikaz sporočil o PHP napakah na E_ALL. To pomeni, da bo prikazano vsako manjše sporočilo, opozorilo ali napaka. Ta možnost naj bo nastavljena na 1 le, če želite testirati aplikacijo in odkriti morebitne napake. Če ste razvijalec, jo nastavite na 2. Ne nastavljajte je na 1 ali 2 v načinu uporabe, ker lahko povzroči napake v povezovanjih. (Privzeto: 0)

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:

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

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 traceVar($MyVariable)

Nastavitve elektronske pošte

Pomni: začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev.

• $emailmethod:  ta vrednost določa, kako bodo e-sporočila poslana. Na voljo so naslednje možnosti:
  • mail: uporabi notranji PHP program za pošiljanje e-pošte
  • sendmail: uporabi "sendmail" sistem za pošiljanje e-pošte
  • smtp: uporablja SMTP prenos. To možnost uporabite, kadar je LimeSurvey nameščen na strežniku, ki ni hkrati vaš strežnik za e-pošto.
• $emailsmtphost: če ste nastavili na 'smtp' pri $emailmethod, potem je potrebno tukaj nastaviti SMTP strežnik. Če uporabljate Googlovo e-pošto, potem boste morda dodali številko vrat: $emailsmtphost = 'smtp.gmail.com:465';
• $emailsmtpuser: če vaš SMTP strežnik potrebuje preverjanje pristnosti, potem to vrednost nastavite na vaše uporabniško ime, sicer pustite to možnost prazno.
• $emailsmtppassword: če vaš SMTP strežnik potrebuje preverjanje pristnosti, potem to vrednost nastavite na vaše geslo, sicer pustite to možnost prazno.
• $emailsmtpssl: nastavite to možnost na 'ssl' ali 'tls', da boste uporabili SSL/TLS način za SMTP povezavo
• $maxemails: ta nastavitev določa, koliko povabil ali opomnikov v obliki e-sporočil lahko pošlje LimeSurvey v enem sklopu. Različni spletni strežniki imajo različne zmožnosti pošiljanja e-sporočil in v kolikor vaše ukazne datoteke (skripte) potrebujejo preveč časa za posredovanje kopice e-sporočil, lahko sistem javi časovno prekinitev in povzroča napake. Večina spletnih strežnikov lahko pošlje 100 e-sporočil naenkrat v 30 sekundah, kolikor znaša privzeti čas za za izvajanje PHP ukaznih datotek (skript). V kolikor dobivate sporočila o časovnih prekinitvah pri pošiljanju večje količine e-sporočil, zmanjšajte številko pri tej nastavitvi. S klikom na gumb za 'pošiljanje e-povabil' v orodni vrstici za delo z žetoni (pri tem niso v mislih gumbki na desni strani vsakega žetona) sistem pošlje največjo količino povabil v obliki e-sporočil in prikaže seznam uporabljenih naslovov. V kolikor povabila niso bila poslana vsem uporabnikom z žetoni, bo sistem javil sporočilo, iz katerega bo razvidna informacija, da so še vedno povabila na čakanju in prikazal povezavo, preko katere je možno poslati še preostala povabila. Preostala povabila ni nujno takoj poslati - uporabnik anketnega sistema se lahko odjavi in kasneje pošlje naslednjo skupino povabil.

Statistika in brskanje po odgovorih

• usejpgraph: (< 1.8) s pomočjo JPGraph-knjižnice lahko v LimeSurvey-evem delu za statistiko vaše rezultate ankete prikažete v obliki stolpcev ali tortni obliki. Če imate na strežniku pravilno nastavljeno knjižnico (class) za jpgraf-e, lahko vklopite ali izklopite to funkcionalnost (1=vklop, 0=izklop). Prosimo preverite - vsaka PHP različica potrebuje drugo različico JPGraph-a! Ta funkcionalnost je še vedno v razvoju, zato lahko pričakujete tudi kakšen nenavaden rezultat.
• jpgraphdir: (< 1.8) dejansko fizično mesto zagonske datoteke (skripte) jpgraph knjižnice. Ta nastavitev je zahtevana le v primeru, če je možnost $usejpgraph nastavljena na 1.
• jpgraphfont: (< 1.8) oblika pisave, ki se uporablja v povezavi z grafi. Varna nastavitev bi bila "FF_FONT1"
• embedded: če želite vgraditi LimeSurvey na drugo stran, potem lahko izklopite pošiljanje HTML naslovov z uporabo te nastavitve in prestavite način na običajno delovanje.
• filterout_incomplete_answers: določa privzeto odzivanje filtriranja nepopolnih odgovorov pri brskanju ali analiziranju odgovorov. Obiščite razpravo o nepopolnih odzivih na povezavi: brskanje razultatov ankete. Ker lahko ti zapisi pokvarijo statistiko, lahko s to možnostjo ta filter vklopite ali izklopite v parih GUI oblikah. Ta vrednost v datoteki config.php je le privzeto stanje za filtriranje nepopolnih odgovorov. Na voljo so naslednje možnosti:
  • show: prikaže popolne in nepopolne odgovore
  • filter: prikaže le popolne odgovore
  • incomplete: prikaže le nepopolne odgovore
• strip_query_from_referer_url: ta nastavitev določa ali referenčni URL shrani vrednosti ali ne. Privzeta vrednost je "false" (v tem primeru referenčni URL shrani vse vrednosti). Druga možnost je nastavitev te vrednosti na "true", ki odstrani vrednosti poleg referenčnega URL-ja.
• showaggregateddata: (>=1.8) če je možnost vklopljena, potem so pri statistiki na voljo dodatne vrednosti kot sta aritmetična sredina in standardna deviacija. Še več podatki so v obliki skupnih seštevkov, da je možen hitrejši pregled oz. dodani so rezultati vrednosti 1+2 in 4+5, da je na voljo splošno razvrščanjev smislu "dobro" (1/2), "povprečno" (3) in "slabo" (4/5). To vpliva le na vprašanja tipa "A" (5 točkovne lestvice) in "5" (5 točkovne možnosti).
• PDF Export Settings: (>1.85) ta funkcija vklopi PDF izvoz za tiskanje ankete in tiskanje odgovorov. Ta izvoz je v celoti v preizkušanju. Ti izvozi so zaenkrat večinoma slabi. V tem trenutku ni možna nobena podpora - v kolikor želite pomoč pri popravkih teh izvozov se obrnite na nas.
  • usepdfexport: nastavite na 0 da jo izklopite; 1 da jo vklopite
  • pdfdefaultfont: privzeta oblika pisave za pdf izvoz
  • pdffontsize: velikost pisave za normalno besedilo; naslov ankete je +4; naslov skupine je +2
  • notsupportlanguages = array('zh-Hant-TW','zh-Hant-HK','zh-Hans','ja','th');
  • pdforientation: nastavite na L za ležečo ali P za pokončno obliko
• $showsgqacode: (>1.91) ta nastavitev se uporablja za funcijo tiskanja ankete {IMG(attId="78",height="16",width="16")} in je privzeto nastavljena na false. Če nastavite showsgqacode = true; bodo prikazani vsi ID-ji za vsako vprašanje in odgovor, če so uporabljeni; ti ID-ji se ujemajo s stolpci glave pri tabeli Lime_survey_12345, ki vsebuje odgovore za določene ankete. Ti ID-ji se lahko uporabljajo za knjigo šifer za ročne poizvedbe v podatkovni zbirki.
• {IMG(attId="79",height="200",width="400")}

LDAP nastavitve

To obsežno poglavje LDAP nastavitve smo prestavili na drugo stran.

Preverjanje pristnosti (avtentikacija)

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.

Dodelitev pristnosti spletnemu strežniku

Sistemski skrbniki bi morda želeli svojim "anketnim skrbnikom" omogočiti preverjanje pristnosti z osrednjim sistemom (AD, openLdap, Radius, ...) raje kot z uporabo interne LimeSurvey-eve baze podatkov. Da to omogočimo na enostaven način, je potrebno nastaviti vaš strežniški program za uporabo tega zunanjega sistema za preverjanje pristnosti in potem nastaviti LimeSurvey da zaupa uporabniškim podatkom, ki jih je pridobil od spletnega strežnika. Da omogočite to funkcionalnost, je potrebno:

• nastaviti auth_webserver na resnično (true) v datoteki config.php
• omogočiti avtentikacijo na strani spletnega strežnika

Prosimo ne pozabite da:

• LimeSurvey bo v tem primeru zaobšel svoj sistem za preverjanje pristnosti (z uporabo uporabniškega imena, ki ga bo pridobil iz izbranega spletnega strežnika za avtentikacijo, brez spraševanja po geslu)
• na ta način lahko zamenjate zgolj sistem za preverjanje pristnosti uporabnikov/skrbnikov, ki delajo v odzadju LimeSurvey-a in ne tudi anketnega sistema za povabila (vmesnika za anketirance)

Prenos pooblastil ob preverjanju pristnosti brez samodejnega uvažanja uporabnikov

Ne pozabite, da v tem primeru po privzetih nastavitvah prenos pooblastil pri preverjanju pristnosti ne zaobide LimeSurvey-evega sistema za avtentikacijo: to pomeni, da čeprav ni potrebno upravljati gesel v LimeSurvey-ju, je še vedno potrebno določiti uporabnike v LimeSurvey-evi podatkovni zbirki in jim dodeliti ustrezne pravice, da lahko dostopajo do virov anketnega sistema.

Uporabniku je omogočen dostop do LimeSurvey-a če in samo če:

• je bil odobren s strani spletnega strežnika za preverjanje pristnosti
• je njegovo uporabniško ime določeno kot uporabnik v LimeSurvey-evi podatkovni zbirki uporabnikov (uporabniku so omogočene pravice, ki jih ima dodeljene uporabnik določen v LimeSurvey-evi podatkovni zbirki uporabnikov).

Prenos pooblastil ob preverjanju pristnosti s samodejnim uvažanjem uporabnikov

Kadar imamo opravka z večjo podatkovno zbirko uporabnikov, je lažje samodejno uvoziti uporabnike v LimeSurvey-evo podatkovno bazo.

• auth_webserver_autocreate_user: če se nastavi na resnično (true), bo LimeSurvey poskušal samodejno uvoziti uporabnike, ki so potrjeni s strani izbranega spletnega strežnika za preverjanje pristnosti in se še ne nahajajo v njeni podatkovni zbirki uporabnikov
• auth_webserver_autocreate_profile: seznam predpisanega privzetega opisa, ki se nanaša na uporabnike (vključuje namišljeno ime in priimek, e-pošto, pravice)

Če želite prilagoditi opis (ang. profile) uporabnikov, da se bo ujemal s prijavljenimi uporabniki, boste morali uporabiti enostavno funkcijo, ki se imenuje hook_get_autouserprofile. Iz osrednje podatkovne zbirke uporabniških računov (na primer iz LDAP-a) lahko s to funkcijo pridobite pravo ime in priimek ter e-poštni naslov za posameznega uporabnika. Lahko celo prilagodite njegove pravice na sistemu glede na njegovo skupino v zunanji podatkovni zbirki.

Hook_get_auth_webserver_profile funkcija vzame uporabniško ime kot edini podatek in lahko vrne:

• napačno (False) ali prazen niz: v tem primeru uporabnik nima pravice dostopa do LimeSurvey-a
• niz vsebuje vse skupne vnose uporabnikovega opisa, kot je opisano pri $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.

Prepisovanje uporabniških imen

V nekaterih primerih imajo uporabniki neko zunanje uporabniško ime, ki je drugačno kot je želeno uporabniško ime v LimeSurvey-u. V takšnih primerih boste morda želeli uporabiti možnost prepisa uporabniškega imena. V LimeSurvey-u se to naredi s pomočjo uporabe parametra auth_webserver_user_map. Za primer si predstavljate, da nimate ustvarjenega uporabniškega imena 'admin' v zunanji podatkovni bazi za preverjanje pristnosti. Da se lahko prijavite v LimeSurvey kot admin, boste morali prepisati zunanje uporabniško ime recimo 'mojeime' z uporabniškim imenom admin v LimeSurvey-u. Ustrezna nastavitev je:

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

Po uspešnemu preverjanju pristnosti na spletnem strežniku za avtentikacijo z imenom 'mojeime' boste neposredno pooblaščeni za uporabo LimeSurvey-a kot 'admin' uporabnik.

To je očitno varnostno zelo resna grožnja, zato jo uporabljajte s previdnostjo, in prosimo zaščitite vašo datoteko config.php pred pisanjem iz spletnih strežnikov.

Uporaba gesel za enkratno uporabo

Uporabnik lahko kliče LimeSurvey-evo prijavo na povezavi /limesurvey/admin in preskoči uporabniško ime in geslo za enkratno uporabo, ki je bilo pred tem zapisano v tabelo uporabnikov (stolpec one_time_pw) s pomočjo zunanjega programa.

Da omogočite uporabo gesel za enkratno uporabo, jo morate vklopiti z nastavitvijo use_one_time_passwords => true (privzeto je izklopljena). Več informacij lahko najdete na povezavi "upravljanje uporabnikov".

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.

Napredno nastavljanje poti

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