Optional settings/sl

OPOMBA

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.

Splošne nastavitve

• sitename: določi ime vaši anketi. To ime se bo pojavilo pri pogledu na seznam anket in v glavi strani za skrbnike. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• siteadminemail: privzeti elektronski naslov skrbnika anketnega sistema, ki se uporablja za sistemska obvestila ter za kontaktni naslov. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• siteadminbounce: elektronski naslov za nedostavljena sporočila. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• siteadminname: resnično ime skrbnika anketnega sistema. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)

Varnost

• surveyPreview_require_Auth: privzeto nastavljeno na resnično (true). Če nastavite to možnost na neresnično (false), boste omogočili vsakemu uporabniku preizkušanje vaše ankete z uporabo spletnega naslova ankete (URL)- brez predhodne prijave na skrbniško stran in brez predhodne aktivacije ankete. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• usercontrolSameGroupPolicy : privzeto nastavljeno na resnično (true). Privzeto bodo lahko edino uporabniki, ki niso določeni kot administratorji v LimeSurvay-evem sistemu za upravljanje, videli ostale uporabnike. Pri tem mora ta uporabnik spadati v vsaj eno skupino uporabnikov, v kateri je iskani uporabnik. To je nastavljeno z naslednjo nastavitvijo:
• filterxsshtml: nastavitev omogoča filtriranje sumljivih html oznak v anketi, skupini, vprašanjih in besedilih odgovorov v skrbniškem vmesniku. To nastavitev pustite na neresnično (false) le v primeru, če popolnoma zaupate uporabnikom, ki ste jim dodelili skrbniške pravice in če želite dovoliti tem uporabnikom, da bodo lahko uporabljali Javascript, Flash Movies, itd. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• demoModeOnly: če je ta možnost nastavljena na resnično (true), bo LimeSurvey deloval v demonstracijskem načinu. Demonstracijski način povzroči naslednje spremembe:
  • Onemogoči spreminjanje podrobnosti in gesel skrbnikov
  • Onemogoči nalaganje datotek v urejevalnik predlog
  • Onemogoči pošiljanje povabil in opomnikov v obliki elektronskih sporočil
  • Onemogoči odlaganje podatkovnih zbirk
  • Onemogoči zmožnost shranjevanja naslednjih globalnih nastavitev: Ime strani, privzeti jezik, privzet način HTML urejevalnika, XSS filter

Viri

• sessionlifetime: določi čas v sekundah za trajanje seje ankete. Privzeto: $sessionlifetime    =  3600; (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• memorylimit: določi velikost spomina, do katerega lahko LimeSurvay dostopa. Priporoča se najmanj '32'(M=MB). Če sistem sporoča napake o prekinitvah (time out errors) ali se pojavljajo težave pri ustvarjanju statističnih podatkov ali pri izvažanju datotek, potem je potrebno dvigniti to mejo na '128' ali '256'.

Ne pozabite, da so lahko takšne lokalne nastavitve s pomočjo aplikacije vedno ovržene z globalnimi nastavitvami strežnika. Za povečanje velikosti meje spomina na 128M je smiselno poskusiti dodati še:

• memory_limit = 128M v glavno datoteko php.ini na vašem strežniku (priporočljivo, če imate dostop)
• memory_limit = 128M v datoteko php.ini file v korenski mapi LimeSurvay-a (LimeSurvey root)
• php_value memory_limit 128M v datoteko .htaccess v korenski mapi LimeSurvay-a (LimeSurvey root)

Izgled

• $lwcdropdowns: lahko je nastavljeno na "L" ali "R". Nastavitev na "R" bo povzročila v vprašanju tipa 'Seznam s komentarjem', da se bo seznam možnih odgovorov prikazal v obliki radijskih gumbov, medtem ko bo nastavitev na "L" povzročila v tem tipu vprašanja prikaz v obliki spustnega seznama. (Neaktualno v verziji 2.0)
• $dropdownthreshold: če izberete "R" za $dropdowns, vam ta nastavitev omogoča izbrati največje število možnosti, ki se bodo prikazala kot radijski gumbi, preden se bo spremenila v spustni seznam. V kolikor imate vprašanje, ki vsebuje večje število možnih odgovorov, bi bil prikaz v obliki radijskih gumbov nepregleden. Nastavitev na največje število npr. 25 (kar je tudi privzeta nastavitev) bi pomenila, da je večji seznam anketirancem enostavnejši za uporabo.
• $repeatheadings: pri vprašanju v obliki lestvice imamo pogosto veliko odgovorov, ki jih je nemogoče prikazati na enem zaslonu. S to nastavitvijo določite, koliko odgovorov se prikaže preden se ponovi glava z informacijami o vprašanju. Smiselna nastavitev je okoli števila 15. Če ne želite, da se glava ponavlja, nastavite to nastavitev na 0 (kar je privzeta nastavitev).
• $minrepeatheadings: zahtevano najmanjše število odgovorov pri vprašanju v obliki lestvice, ko se glava lestvice začne ponavljati.
• $addTitleToLinks: če je ta možnost nastavljena na resnično (true), potem bo LimeSurvey dodal html značko 'title' vsem povezavam uporabljenim v menijih. To pomaga zaslonskim bralnikom pri analiziranju menijev. To možnost nastavite na resnično le v primeru, če uporabljate zaslonski bralnik, ker se prekrijejo z namigi o orodjih.
• $defaulttemplate: ta nastavitev določi privzeto temo, ki se uporablja za 'javni seznam' anket. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• $defaulthtmleditormode: nastavi privzet način za vključen HTML urejevalnik. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev). Veljavne nastavitve so: inline (privzeto), popup and none:
  • inline: polja obrazca se zamenjajo s HTML urejevalnikom. Ta način je sicer počasnejši vendar primernejši in uporabniku bolj prijazen
  • popup: doda ikono, ki odpre novo okno s HTML urejevalnikom. Ta način je hitrejši, vendar se v obrazcu prikaže html oblika zapisa
  • none: brez HTML urejevalnika

Jezik in čas

• $defaultlang: ta možnost naj bo nastavljena na privzet jezik, ki se bo uporabljal tako v skrbniških ukaznih datotekah (admin scripts) kot tudi za javne ankete. To nastavitev za javne ankete lahko spremenite tudi na principu kopiranja iz ankete na anketo s pomočjo skrbniških ukaznih datotek. (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• $timeadjust: če se nahaja vaš spletni strežnik za anketiranje v drugačnem časovnem območju, kot je območje, kjer se bo anketiranje izvajalo, nastavite pri tej možnosti časovno razliko. Na primer jaz živim v Sloveniji vendar uporabljam spletni strežnik iz ZDA. Spletni strežnik je v časovnem pasu, ki zaostaja za 8 ur za mojim časovnim pasom. Tako to možnost nastavim na "8". Z drugimi besedami ta nastavitev povzroči dodajanje 8 ur času, ki ga sistem pridobi na strežniku. Ta nastavitev je pomembna za časovne žige pri anketiranjih.(začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• $modrewrite: (Pomni: ta nastavitev je zastarela za različice >=2.0) če je nastavljena na 1, se zažene uporabna URL pretvorba (Primer: http://survey.example.com/123456/lang-fr/tk-sdlfkjozeiru namesto http://survey.example.com/index.php?sid=123456⟨=fr&token;=sdlfkjozeiru). Pred prvo uporabo te nastavitve je potrebno preimenovati "htaccess.txt" datoteko v ".htaccess". Potrebno je zagnati Apache spletni strežnik s pravilno nameščenim mod_rewrite modulom.

Odzivanje anket

• $allowmandbackwards: če je ta možnost nastavljena na 1, se bodo anketiranci lahko premikali na prejšnje vprašanje tudi če niso odgovorili na predpisano vprašanje. Če pa je nastavljeno na 0, pa bodo morali anketiranci najprej odgovoriti na predpisano vprašanje tudi če se bodo želeli le premakniti na prejšnje vprašanje.
• $deletenonvalues: uporabite to nastavitev previdno. Privzeto (vrednost 1) bodo vsa nepomembna vprašanja v podatkovni zbirki izničena. S tem je zagotovljeno, da so podatki v celotni podatkovni zbirki povsem usklajeni. Obstajajo pa redki primeri, kadar bi morda želeli obdržati nepomembne vrednosti (v tem primeru mora biti ta možnost nastavljena na 0). Recimo da sprašujete anketirance po spolu in anketiranec pomotoma odgovori 'ženski' ter nato odgovarja na nekaj tipičnih vprašanj postavljenih za anketiranke (vprašanja, ki so pogojno postavljena samo anketirankam in so tako smiselna samo za ženske). Nato se anketiranec zave svoje napake in se vrne na prejšnja vprašanja ter popravi odgovor pri vprašanju o spolu na 'moški'. Ko v tem primeru nadaljuje z reševanjem ankete, postanejo odgovori na vprašanja za anketiranke nepomembni. Če je možnost $deletenonvalues nastavljena na 1, bodo te nepomembne vrednosti v podatkovni zbirki izničene.  Če pa je nastavljeno $deletenonvalues==0, njegovi zmotni odgovori ne bodo izbrisani in bodo prisotni v podatkovni bazi pri analizi rezultatov.
• $shownoanswer: če je ta možnost nastavljena na 1, se bo pri vprašanjih izbirnega tipa radijski gumbi, ki vsebujejo odgovore z možnostjo urejanja (vprašanja tipa seznam, tabala) ki niso predpisana, prikazala dodatna vrednost "N/A". Tako se bodo lahko anketiranci odločili, da na to vprašanje ne bodo odgovorili. V kolikor tega ne želite omogočiti, postavite to vrednost na 0 da jo izklopite (začenši z 1.87 se ta nastavitev prepiše v oknu Globalnih nastavitev)
• $printanswershonorsconditions: ta možnost določa ali bo aplikacija za tiskanje odgovorov prikazala vnose za vprašanja, ki so bila skrita s pomočjo pogojevanja. (Privzeto: 1 = skrije odgovore vprašanj, ki so skrita s pomočjo pogojev)
• $hide_groupdescr_allinone: ta nastavitev je pomembna za vse ankete, ki uporabljajo pogoje uvedenimi z LimeSurvey-em 1.85RC3. Kadar je ta možnost nastavljena na resnično (true), potem je ime skupine in opis skrit, če so tudi vsa vprašanja v skupini skrita (privzeto: true (skrij ime skupine in opis, kadar so vsa vprašanja v skupini skrita s pogoji))
• $showpopups:  prikaže pojavno okno s sporočilom, če na predpisano ali pogojno vprašanje ni bilo danega pravilnega odgovora. 1=prikaže pojavno okno s sporočilom (privzeto), 0=Prikaže sporočilo na isti strani, -1=Ne prikaže nobenega sporočila (v tem primeru bodo anketiranci še vedno videli posebne namige pri vprašanjih, na katera je potrebno odgovoriti).

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)

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. Uporabi to možnost, 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: kadar anketirancem pošiljate povabila ali opomnike, 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 on the token control toolbar, (not the button on the right of each token), sends the maxemails number of invitations, then displays a list of the addresses sent to 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 off and come back at a later time to send the next batch of invites.

Statistics and Response Browsing

• usejpgraph: (< 1.8) The JPGraph-library lets you display the results of your survey in the statistics part of LimeSurvey  in bar- and pie charts. If you have a correctly configured jpgraph class set up on your server, you can turn this feature on or off (1=on, 0=off). Please have a look, every version of PHP needs another version of JPGraph! This feature is currently in development, so expect a few weird outcomes.
• jpgraphdir: (< 1.8) The physical disk location of the jpgraph class scripts. This setting is only required if $usejpgraph is equal to 1.
• jpgraphfont: (< 1.8) The font to use with graphs. A failsafe setting would be "FF_FONT1"
• embedded: If you want to integrate LimeSurvey into another page then you can turn off sending HTML headers by using this setting and point instead to the header method of a custom function. This is a dirty hack but should work for a quick integration.
• filterout_incomplete_answers: Control the default behaviour of  filtering incomplete answers when browsing or analyzing responses. For a discussion on incomplete Responses see Browsing survey results. Since these records can corrupt the statistics, an option is given to switch this filter on or off in several GUI forms. This parameter config.php is just the default state for the incomplete answer filter. The following options are available:
  • show: Show both complete and incomplete answers
  • filter: Show only complete answers
  • incomplete: Show only incomplete answers
• strip_query_from_referer_url: This setting determine if the referrer URL saves parameter or not. Default value is "false" (in this case referrer URL saves all parameter). Alternatively this value can be set to "true" and the parameter part of the referrer URL will be removed.
• showaggregateddata: (>=1.8) When activated there are additional values like arithmetic mean and standard deviation at statistics. Furthermore data is aggregated to get a faster overview e.g. 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: (>1.85) This feature activates PDF export for printable survey and Print Answers. The PDF export is totally experimental. The output is mostly ugly. At this point no support can be given - if you want to help to fix it please get in touch with us.
  • usepdfexport: Set 0 to disable; 1 to enable
  • pdfdefaultfont: Default font for the pdf Export
  • pdffontsize: Fontsize for normal text; Surveytitle is +4; grouptitle is +2
  • notsupportlanguages = array('zh-Hant-TW','zh-Hant-HK','zh-Hans','ja','th');
  • pdforientation: Set L for Landscape or P for portrait format
• $showsgqacode: (>1.91) This setting is used at the printable survey feature {IMG(attId="78",height="16",width="16")} and defaults to false. If you set showsgqacode = true; the IDs for 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.
• {IMG(attId="79",height="200",width="400")}

LDAP nastavitve

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

Preverjanje pristnosti (avtentikacija)

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

Please note that:

• LimeSurvey will then bypass its own authentication process (by using the login name reported by the webserver 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 however than by default Authentication Delegation doesn't bypass the LimeSurvey authorization system: this means 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 survey resources.

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

• he has been authenticated to the webserver
• 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 huge user database, it is sometimes easier to auto-import user in the LimeSurvey database.

• auth_webserver_autocreate_user: if set to true LimeSurvey will try to autoimport users authenticated by the webserver 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 fake First and Last name, email, 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 an LDAP directory), the true First&Last; names and email of a particular user. You can even customize his privileges on the system based on his groups on the external DB.

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

An example of using a hook with Atlassian's Crowd as a backend is available here.

User name mapping

In case 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' username defined in your external authentication database. Then in order to login to LimeSurvey as admin, you'll have to map your external username let's call it 'myname' to the admin login name ine LimeSurvey. The corresponding setup is :

$config['auth_webserver_user_map'] = Array ('myname' => 'admin');

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

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

Use one time passwords

(since 1.81)

A user can call the limesurvey login at /limesurvey/admin and pass username and a 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 (use_one_time_passwords => true) to enable the usage of one time passwords (default = false). More information can be found at "Manage Users"}.

Advanced Path Settings

If possible do no touch these settings. Additionally these settings can only be adjusted on config-defaults.php.

• $homeurl: This should be set to the URL location of your administration scripts. These are the scripts in the /limesurvey/admin folder. This should be set to the WEB URL location - for example "http://www.mydomain.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.
• $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).
• $tempurl: This should be set to the URL location of your "/limesurvey/tmp" directory - or a directory which you would like LimeSurvey to use to store temporary files, including uploads. This directory must be set to read & write for your webserver (e.g. chmod 755)
• $imagefiles: By default you should leave this pointing to the URL location of /limesurvey/admin/images - where the images are installed initially. You may, however, prefer to move these images to another location and if so point this to the URL directory where they are stored.
• $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.
• $fckeditordir: url of the fckeditor script
• $fckeditexpandtoolbar: defines if the FCKeditor toolbar should be opened by default
• $pdfexportdir: Directory with the tcpdf.php extensiontcpdf.php
• $pdffonts: Directory for the TCPDF fonts