Opcionális beállítások

A következő rész azoknak szól, akik szeretnék szerkeszteni azokat a konfigurációs beállításokat, amelyeket a LimeSurvey telepítés GUI (Graphical User Interface) segítségével nem lehetett módosítani. Ne feledje, hogy a LimeSurvey gyökérkönyvtárában végrehajtott összes módosítást saját felelősségére hajtja végre. Mindazonáltal, ha problémákat tapasztal/további útmutatásra van szüksége, csatlakozzon a vitafórumokhoz vagy az IRC-hez csatorna segítségért a LimeSurvey közösségtől.

Bevezetés

A telepítés konfigurációs beállításainak módosításához módosítania kell az opcionális beállításokat. Ezek a /application/config/config-defaults.php fájlban találhatók, amely a LimeSurvey gyökérkönyvtárában található. A szabványos telepítés alapértelmezett beállításai a config-defaults.php fájlban találhatók. Némelyikük felülírható a globális beállítások párbeszédablakban, míg a többit manuálisan kell szerkeszteni.

Frissítéskor csak a config-defaults.php beállításai módosulnak. Ezért a config.php fájl szerkesztése elmenti az egyéni beállításokat.

A LimeSurvey beállításainak frissítéséhez/hozzáadásához a /application/config/config.php fájlban frissítenie kell a config tömböt:

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Új érték', // Frissítse itt az alapértelmezett LimeSurvey konfigurációt
 )

Yii beállítások

A LimeSurvey a Yii keretrendszert használja, amelynek saját konfigurációs paraméterei vannak az application/config/internal.php és az application/config/config.php fájlban. A LimeSurvey bizonyos konfigurációs beállításait a Yii konfiguráción keresztül is elérheti.

Mivel a config.php tömb a teljes konfigurációba van egyesítve, a config.php fájlban bármilyen Yii paramétert lecserélhet.

A Yii specifikus beállítások a komponensek tömbjében vannak megadva:

 
 'components' => array(
 'db' => array(
 ....
 ),
 'Specifikus beállítások'=>tömb(
 ....
  ),
 ),

Adatbázis beállítások

Az adatbázis-beállításokat a telepítőfájl írja be a config.php fájlba, amikor először telepíti a LimeSurvey-t. Ha szükséges, frissítheti a config.php fájl ezen részét. Kérjük, ne feledje, hogy ezt a saját felelősségére teszi Nézze meg még a Yii dokumentációt, és kérjük, ne feledje, hogy a LimeSurvey csak a következő típusú adatbázisokat támogatja: mysql, pgsql, dblib, mssql és sqlsrv.

Munkamenet beállításai

Néhány munkamenet-paramétert beállíthat a config.php-ben (nézze meg a két példát lentebb). A szükséges részt a config.php-ben törölheti/adhatja hozzá. További beállításokért tekintse meg a Yii dokumentációt.

  Ha frissítenie kell a munkamenet beállításait, hogy több LimeSurvey példány futhasson ugyanazon a szerveren, ellenőrizze, hogy nem kell-e frissítenie a request settings-t a crsf cookie-hoz.

Táblázatalapú munkamenetek használata

A LimeSurvey tábla alapú szekciókat is tud használni, az alapértelmezett config.php által generált fájlban talál egy megjegyzéssel ellátott részt. Táblázatalapú munkamenet használatához távolítsa el a // jelet minden sor előtt.

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

  A táblázat alapú munkamenetek jelenleg nem támogatottak az MSSQL szerveren.

Egyéb munkamenetek frissítése

Ha SSL-t ('https') használ a LimeSurvey telepítéséhez, a következő sorok hozzáadása a config.php fájlhoz növeli a munkamenet biztonságát:

 // Állítsa be a cookie-t SSL-n keresztül
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // használjon SSL-t a cookie-khoz
 'httponly' => true // A cookie-kat nem használhatja egyéb protokollok - kísérleti
 ),
 ),

Ha ki szeretné javítani a tartományt egy cookie számára, használja a következő szintaxist a config.php fájlban:

 // Állítsa be a tartományt a cookie számára
 'session' => array (
 'cookieParams' => array(
 'domain' => '.example.org',
 ),
 ),

Ha ugyanazon a kiszolgálón több példányt is telepít, akkor gyorsabb és egyszerűbb lehet más-más szekciónevet beállítani minden LimeSurvey-példányhoz. Erre bizonyos körülmények között szükség lehet az IE11-hez (lásd issue 12083)

 // Állítsd be a munkamenet nevét
 'session' => array (
 'sessionName' => "LimeSurveyN1",
 ),

Kérés beállításai

A kérés beállításai fontosak, de az alapértelmezett beállítások már optimalizálva vannak a LimeSurvey használatához. Ha többet szeretne megtudni róluk, tekintse meg a Yii dokumentációt.

Például a LimeSurvey kérésbeállítások konfigurációja a következő módon módosítható (saját felelősségére):

 // Kapcsolja ki a CSRF védelmet
 'request' => array(
 'enableCsrfValidation'=>false, 
 ),

 // Egy bizonyos URL-alap kényszerítése 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Állítsa be a cookie tartomány nevét és elérési útját a CSRF védelemhez, az elérési út akkor használatos, ha ugyanazon a tartományon más példány van
 'request' => array(
 'csrfCookie' => array( 
 'domain' => '.example.com',
 'útvonal' => '/limesurvey/',
 ) 
 ),

Ha csak a token e-mailek URL-jét kell frissítenie, állítsa be az publicurl értéket a config.php fájlban.

Felmérések használatának engedélyezése iframe-ben

A Iframe beágyazás engedélyezése után a 100%-ban megbízható megoldás csak akkor garantálható, ha a keretező webhely ugyanazt a gyökérdomaint használja. Ha a LimeSurvey Cloud szolgáltatást használja, ezt a használatával érheti el. szükséges domain aliasing

URL beállítások

  Ha csak a token és egyéb e-mailek URL-jét kell frissítenie, állítsa be az publicurl-et a config.php fájlban.

Az alapértelmezett URL-beállítások módosításához frissítse az urlManager:

 // Használjon rövid URL-t
 'urlManager' => array(
 'urlFormat' => 'útvonal',
 'showScriptName' => false,
 ),

A felmérés azonosítója után .html is hozzáadható a következő módon:

 // Használjon rövid URL-t
 'urlManager' => array(
 'urlFormat' => 'útvonal',
 'rules' => array (
'<sid:\d+> ' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => false,
 ),

További információért tekintse meg a Yii dokumentációt.

Naplóbeállítások

A Yii különféle megoldásokat kínál a naplók generálására. Ha többet szeretne megtudni róluk, tekintse meg a naplózás speciális témakörét. A LimeSurvey alapértelmezés szerint „1” vagy „2” értéket használ, ami lehetővé teszi, hogy minden webfelhasználó megtekintse a naplókat. Közvetlenül a Yii használatával létrehozhatja saját beállításait.

Például egy gyors megoldás a hibák és figyelmeztetések naplózására a fájlokban:

 
return array(
 'components' => array(
 /* Más komponens része itt 'db' például */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'figyelmeztetés, hiba',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* Egyéb összetevő itt az 'urlManager' például */
 ),
 /* Utolsó rész (a ' karakterrel runtimePath' 'config' például) */
);

 Hint: A fájl alapértelmezés szerint a következő helyre kerül mentésre: <code>limesurvey/tmp/runtime/application.log</code> , amely a LimeSurvey gyökérmappájában található.

  A Yii futásidejű elérési utat használ. Alapértelmezés szerint a naplók interneten elérhetők. Sok információt tartalmazhatnak a szerverről. Jobb, ha olyan könyvtárat használunk, amely nem érhető el az interneten keresztül. Beállíthatja az útvonalakban vagy a Futtatási útvonal.

.

Futtatási útvonal

A A futási útvonal a „webfelhasználó” számára olvasható és írható könyvtárnak kell lennie. A futási útvonal azonban potenciális biztonsági információkat tartalmazó fájlokat tartalmaz, amelyek a nyilvános webelérési területen találhatók. A LimeSurvey ezeket a fájlokat a LimeSurvey gyökérkönyvtárának ideiglenes könyvtárába gyűjti. Az ilyen fontos adatokhoz való hozzáférés kiküszöbölése érdekében a /application/config/config.php fájl megfelelő sorainak szerkesztésével beállíthatja a futásidejű elérési utat a nyilvános webes hozzáférésen kívül:

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

Általános beállítások

• sitename: Nevet ad a felmérési webhelynek. Ez a név megjelenik a felmérési lista áttekintésében és az adminisztrációs fejlécben. Az alapértelmezett érték a 'LimeSurvey', és felülírható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php fájlban.
• siteadminemail: Ez az alapértelmezett e-mail cím a webhely rendszergazdája, és rendszerüzenetekhez és kapcsolatfelvételi lehetőségekhez használható. Ez a beállítás csak alapértelmezett értékként használható, és a globális beállítások párbeszédpanelen felülírható.
• siteadminbounce: Ez az az e-mail cím, amelyre a visszapattanó e-maileket küldik. Ez a beállítás csak alapértelmezett értékként használható, és a globális beállítások párbeszédpanelen felülírható.
• siteadminname: A webhely rendszergazdájának valódi neve. Ez a beállítás csak alapértelmezett értékként használatos, és a globális beállítások párbeszédpanelen felülírható.
• proxy_host_name: Ez a proxyszerver gazdagépneve meg kell említeni, ha proxy mögött áll, és frissíteni szeretné a LimeSurvey-t a ComfortUpdate segítségével).
• proxy_host_port: Ez a proxyszerver portja (meg kell, hogy legyen megemlítve, ha proxy mögött áll, és frissíteni szeretné a LimeSurvey-t a ComfortUpdate segítségével).

Biztonság

• maxLoginAttempt: A felhasználónak hányszor kell megadnia a helyes jelszót, mielőtt letiltja vagy kizárja az IP-címét. Az alapértelmezett érték 3, és a config.php fájlból módosítható.
• timeOutTime: Ha a felhasználó helytelenül adja meg a jelszót<maxLoginAttempt> , ezért ki van zárva<timeOutTime> másodpercig. Az alapértelmezett érték 10 perc, és módosítható a config.php.
• maxLoginAttemptParticipants: A résztvevőknek hányszor kell érvényes tokent beírnia, mielőtt megkapja a tokent. Az IP-cím blokkolva/kizárva. Az alapértelmezett érték 3, és a config.php fájlból módosítható.
• timeOutParticipants: Ha a résztvevő helytelenül adja meg a tokent<maxLoginAttemptParticipants> , ezért ki van zárva<timeOutParticipants> másodpercig. Az alapértelmezett érték 10 perc, és a config.php.
• fájlból módosítható surveyPreview_require_Auth: Alapértelmezés szerint igaz. Ha ezt „hamis” értékre állítja, bárki tesztelheti a felmérést a felmérés URL-címével anélkül, hogy be kellene jelentkeznie az adminisztrációs panelre, és először aktiválnia kellene a felmérést. Ez a beállítás egy alapértelmezett érték, és felülírható a globális beállítások párbeszédpanelen, vagy szerkeszthető a config.php.
• usercontrolSameGroupPolicy: Alapértelmezés szerint igazra állítva. Alapértelmezés szerint a LimeSurvey kezelőfelületén definiált nem adminisztrátor felhasználók csak az általuk létrehozott vagy legalább egy csoporthoz tartozó felhasználókat láthatják. Az alapértelmezett érték felülírható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php-ban.
• filterxsshtml: Ez a beállítás lehetővé teszi a felmérésekben található gyanús html címkék szűrését, csoportok, illetve kérdések és válaszok szövegei az adminisztrációs felületen. Hagyja ezt "hamis" értékre, ha teljes mértékben megbízik a LimeSurvey adminisztrációjához létrehozott felhasználókban, és engedélyezni szeretné, hogy ezek a felhasználók Javascriptet, Flash Movies-t stb. használhassanak. A kiemelt adminisztrátorok HTML-kódját soha nem szűrik ki . Az alapértelmezett érték felülírható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php-ban.
• demoMode: Ha ez az opció 'true'-ra van állítva a config.php fájlban , akkor a LimeSurvey demó módba lép. A demó mód a következő dolgokat változtatja meg:
  • Letiltja az adminisztrátor felhasználói adatait és jelszavának megváltoztatását;
  • Letiltja a fájlok feltöltését a sablonszerkesztőben;
  • Letiltja az e-mailes meghívók és emlékeztetők küldését;!N !** Letiltja az adatbázis dump létrehozását;
  • Letiltja a következő globális beállítások módosításának lehetőségét: webhelynév, alapértelmezett nyelv, alapértelmezett HTML-szerkesztő mód, XSS-szűrő.
• forcedsuperadmin:' Felhasználói azonosítók tömbje az összes LimeSurvey összes jogával. Ez a beállítás csak a config.php fájlban frissíthető. Ennek a felhasználónak a jogait a global permissions for a user még más kényszerített kiemelt rendszergazda sem szerkesztheti. Alapértelmezés szerint : ezzel a jogosultsággal rendelkező felhasználó a következő azonosítójú felhasználó: 1. Az első felhasználó, aki közvetlenül a telepítés után jött létre.
• force_ssl: arra kényszeríti a LimeSurveyt, hogy HTTPS-en keresztül fusson, vagy blokkolja a HTTPS-t. Lásd: Force HTTPS a globális beállítások adminisztrátori grafikus felületén.
• ssl_emergency_override: Ez a beállítás kikapcsolja az SSL-t. Ha bekapcsolta a HTTPS/SSL-t a globális beállításokban, de a kiszolgálón nincs engedélyezve a HTTPS, akkor csak úgy kapcsolhatja ki, ha közvetlenül módosít egy értéket az adatbázisban. Ez lehetővé teszi a HTTPS kényszerített kikapcsolását, miközben módosítja a Force Secure globális beállításait. Ennek mindig hamisnak kell lennie, kivéve vészhelyzetekben, amikor igazra változtatja, amíg meg nem oldja a problémát. Ez a beállítás csak a config.php fájlon keresztül állítható be.
• ssl_disable_alert: Tiltsa le a szuperadminisztrátor figyelmeztetését a nem kényszerített SSL-ről, ha valóban nem tudja vagy nem akarja kényszeríteni az ssl-t. Ez a beállítás csak a config.php fájlon keresztül állítható be.

Erőforrások

• sessionlifetime: Meghatározza azt az időt másodpercben, amely után a felmérési munkamenet lejár. Csak akkor érvényes, ha adatbázis-munkameneteket használ. Ha adatbázis-munkameneteket használ, módosítsa a paramétert a config.php fájlban, vagy írja felül az alapértelmezett értéket a globális beállítások párbeszédablakban.
• memorylimit: Ez határozza meg, hogy mennyi memória LimeSurvey hozzáférhet. '128 MB' az ajánlott minimum (MB=Megabyte). Ha időtúllépési hibákat kap, vagy problémái vannak a statisztikák létrehozásával vagy a fájlok exportálásával, növelje ezt a korlátot „256 MB”-ra vagy magasabbra. Ha a webszerver magasabb korlátot állított be a config.php fájlban, akkor ezt a beállítást a rendszer figyelmen kívül hagyja.

'Kérjük, ne feledje, hogy az ilyen helyi beállításokat a globális beállítások párbeszédpanelen végrehajtott változtatások mindig felülbírálhatják.

A memóriakorlát 128 millióra növeléséhez megpróbálhatja hozzáadni:

• memory_limit = 128M a szerver fő php.ini fájljához (ajánlott, ha van hozzáférése)
• memory_limit = 128M a php.ini fájlhoz a LimeSurvey gyökér
• php_value memória_korlátja 128M egy .htaccess fájlban a LimeSurvey gyökérben

• max_execution_time: Állítsa be, hogy egy szkript hány másodpercig futhasson. Ha ezt elérjük, a szkript végzetes hibát ad vissza. A nagy felmérési adatok és statisztikák exportálása érdekében a LimeSurvey megpróbálja alapértelmezés szerint 1200 másodpercre állítani. Ha szükséges, beállíthat nagyobb vagy alacsonyabb időt. Csak php konfigurációs fájlon keresztül érhető el.

Megjelenés

• dropdownthreshold ^{(Obsolete since 2.50)}: Ha az "R" van kiválasztva $dropdowns beállításnál, a rendszergazda beállíthatja a rádiógombokként megjelenő opciók maximális számát , mielőtt visszaváltana egy legördülő listába. Ha van egy kérdés, amelynél sok lehetőség van, akkor ezek mindegyikének rádiógombként való egyszerre történő megjelenítése nehézkesnek tűnhet, és a felhasználók számára ellentmondásossá válhat. Ha ezt maximumra állítja, mondjuk 25-re (ez az alapértelmezett), azt jelenti, hogy a nagy listákat könnyebben használhatják az adminisztrátorok a felmérésben résztvevő számára.
• repeatheadings: Az Array kérdéstípussal, gyakran sok alkérdése lesz, amelyek - ha megjelennek a képernyőn - egynél több oldalt foglalnak el. Ez a beállítás lehetővé teszi annak eldöntését, hogy hány alkérdés jelenjen meg, mielőtt megismételné a fejléc információit a kérdéshez. A megfelelő beállítás ehhez a 15 körüli érték. Ha nem szeretné, hogy a címsorok ismétlődjenek, állítsa ezt 0-ra. Ez a beállítás felülbírálható a globális beállítások párbeszédpanelen ^{(New in 2.05 )} .
• minrepeatheadings: A fennmaradó részkérdések minimális száma, amely szükséges a fejlécek megismétléséhez a tömbkérdésekben. Az alapértelmezett érték 3, és a config.php fájlban szerkeszthető.
• defaulttemplate: Ez a beállítás határozza meg a felmérések 'nyilvános listájához' használt alapértelmezett témát. Ez a beállítás felülbírálható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php-ban.
• defaulthtmleditormode: Beállítja az integrált HTML-szerkesztő alapértelmezett módját. Ez a beállítás felülbírálható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php fájlban. Az érvényes beállítások:
  • 'inline' - A mezők soron belüli cseréje HTML-szerkesztővel. Lassú, de kényelmes és felhasználóbarát;
  • 'felugró ablak' – Ikont ad hozzá, amely szükség esetén felugró ablakban futtatja a HTML-szerkesztőt. Gyorsabb, de a HTML kód a következő formában jelenik meg:
  • 'none'- Nincs HTML-szerkesztő;
• column_style: Meghatározza, hogyan jelenjenek meg az oszlopok a felmérés válaszaihoz display_columns. A config.php fájlban szerkeszthető. Az érvényes beállítások a következők:
  • 'css' - a különféle CSS-módszerek egyikét használja oszlopok létrehozásához (a részletekért lásd a sablonstíluslapot);
  • 'ul' - az oszlopok többszörösként jelennek meg lebegtetett rendezetlen listák (alapértelmezett);
  • 'tábla' - hagyományos tábla alapú elrendezést használ;
  • NULL - letiltja az oszlopok használatát.

Nyelv és idő

• defaultlang: Ezt az adminisztrációs szkriptekben használt alapértelmezett nyelvre kell beállítani, valamint a nyilvános felmérések listáján szereplő nyelv alapértelmezett nyelvére. Ez a beállítás felülbírálható a globális beállítások párbeszédpanelen, vagy szerkeszthető a config.php.
• timeadjust: Ha a webszerver más időzónában van, mint ahol felmérései alapulnak majd, ide írja be a szerver és az otthoni időzóna közötti különbséget. Például Ausztráliában élek, de amerikai webszervert használok. A webszerver 14 órával a helyi időzónám mögött van. Tehát itt a beállításom "14". Más szavakkal, 14 órával növeli a webszerverek idejét. Ez a beállítás különösen fontos, ha a felmérések időbélyeggel látják el a válaszokat. Ez a beállítás felülbírálható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php fájlban.

Felmérés viselkedése

• deletenonvalues: Óvatosan használja ezt a funkciót. Alapértelmezés szerint (1-es érték) az irreleváns kérdések NULL-ként jelennek meg az adatbázisban. Ez biztosítja, hogy az adatbázisban lévő adatok belsőleg konzisztensek legyenek. Vannak azonban olyan ritka esetek, amikor érdemes ragaszkodni az irreleváns értékekhez, ebben az esetben beállíthatja az értéket 0-ra. Például megkérdezi egy férfi nemét, aki véletlenül azt mondja, hogy „nő”, majd egy nőnek válaszol. -specifikus kérdések (olyan kérdések, amelyek női léthez kötöttek, tehát csak nők számára relevánsak). Aztán rájön a hibájára, hátrál, a nemet „férfi”-re állítja, és folytatja a felmérést. Nos, a nőkre vonatkozó kérdések lényegtelenek. Ha $deletenonvalues==1 , akkor az irreleváns értékek törlődnek (NULLed) az adatbázisban. Ha $deletenonvalues==0 , akkor a hibás válaszai nem törlődnek, így azok továbbra is jelen lesznek az adatbázisban az elemzés során.
• shownoanswer: Ha a szerkeszthető válaszokat (pl.: lista, tömbkérdések) tartalmazó választógomb/kiválasztó típusú kérdés nem kötelező, és a 'shownoanswer' értéke 1, egy további "Nincs válasz" bejegyzés látható – így a résztvevők dönthetnek úgy, hogy nem válaszolnak a kérdésre. Vannak, akik jobban szeretik, ha ez nem elérhető. Ez a beállítás felülbírálható a globális beállítások párbeszédablakban, vagy szerkeszthető a config.php fájlban. Az érvényes értékek:
  • '0': Nem;
  • '1': Igen;
  • '2': A felmérés adminisztrátora választhat.
• printanswershonorsconditions: Ez a beállítás határozza meg, hogy a nyomtatási válaszok szolgáltatás megjelenítse-e a feltételek elágazása által rejtett kérdések bejegyzéseit (alapértelmezett: 1 = válaszok elrejtése a feltételek által elrejtett kérdésekből).
• ' hide_groupdescr_allinone:' Ez a beállítás a feltételeket használó többfunkciós felmérések esetén releváns. Ha ez „igaz” értékre van állítva, a csoport neve és leírása el van rejtve, ha a csoport összes kérdése el van rejtve. Az alapértelmezett érték „true” – elrejti a csoport nevét és leírását, ha a csoport összes kérdése el van rejtve a feltételek miatt. A config.php-ban szerkeszthető.
• showpopups: Felugró üzenetek megjelenítése, ha a kötelező vagy feltételes kérdésekre nem válaszoltak helyesen:
  • '2' = a téma opció határozza meg (alapértelmezett )
  • '1'= felugró üzenet megjelenítése;
  • '0'= üzenet megjelenítése az oldalon;
  • '-1'= egyáltalán nem jeleníti meg az üzenetet (ebben az esetben , a felhasználók továbbra is látni fogják a kérdésspecifikus tippeket, amelyek jelzik, hogy mely kérdésekre kell válaszolni).

Numerikus kérdéstípus viselkedés

• bFixNumAuto: A numerikus mezők automatikusan szűrhetők az összes nem numerikus érték eltávolításához. Alapértelmezés szerint ez engedélyezve van, globálisan letilthatja. Ez a beállítás az alapvető témabeállítások „Automatikus numerikus érték javítása” részéhez kapcsolódik. Engedélyezve volt „Igen” esetén, letiltva a „Csak kifejezésre” és „Nem” esetén.
• bNumRealValue: A kifejezéskezelőben használt numerikus mezők javíthatók vagy nem. Alapértelmezés szerint rögzítve van. Ha a NUMERIC egy numerikus kérdés: tiltsa le vagy 0: {NUMERIC} rossz karakterekkel küldje el '' , engedélyezése vagy 1 : {NUMERIC} elküldi az összes beírt karaktert. Ez a beállítás az alapvető témabeállítások „Automatikus numerikus érték javítása” részéhez kapcsolódik. Engedélyezve volt az „Igen” és a „Csak kifejezéshez”, a „Nem” esetén pedig letiltva.

Fejlesztés és hibakeresés

• debug: Ezzel a beállítással a PHP hibajelentést E_ALL-ra állítod. Ez azt jelenti, hogy a szkripttel kapcsolatos minden apró megjegyzés, figyelmeztetés vagy hiba megjelenik. Ezt a beállítást csak akkor kell „1”-re állítani, ha valamilyen okból megpróbálja hibakeresni az alkalmazást. Ha Ön fejlesztő, váltson „2”-re. Éles környezetben ne állítsa „1” vagy „2” értékre, mert az elérési út felfedését okozhatja. Az alapértelmezett érték '0', és a config.php fájlban szerkeszthető.
• debugsql: Aktiválja ezt a beállítást, ha meg szeretné jeleníteni a szkripthez végrehajtott összes SQL lekérdezést az egyes oldalak alján. Nagyon hasznos a lekérdezések számának optimalizálásához. Az aktiváláshoz módosítsa az alapértelmezett értéket '1'-re a config.php fájlból.
• use_asset_manager: Alapértelmezés szerint : hibakeresési mód letiltása eszközkezelő, engedélyezheti az eszközkezelő használatát. hibakeresési mód engedélyezésével.

Abban az esetben, ha hibát észlel az alkalmazásban, erősen javasoljuk a hibakeresési beállítás aktiválását, hogy részletesebb hibaüzenetet kapjon, amelyet a hibajelentéssel együtt elküldhet:

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

Ha a beépülő modulon dolgozik, és gyors módra van szüksége a változók képernyőre való kiírásához: használhatja a traceVar funkciót. Ha a debug be van állítva: ez a funkció a CWebLogRoute-ot használja a HTML oldalon való megjelenítéshez. Használat traceVar($MyVariable)

E-mail beállítások

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.