Opcionális beállítások
From LimeSurvey Manual
A következő rész azoknak szól, akik szeretnék módosítani azokat a konfigurációs beállításokat, amelyeket a LimeSurvey telepítés grafikus felhasználói felületén (GUI) keresztül nem lehet szerkeszteni. Ne feledje, hogy a LimeSurvey gyökérkönyvtárában végrehajtott összes módosítást saját felelősségére végzi. Ha mégis problémákat tapasztal, vagy további útmutatásra van szüksége, csatlakozzon a vitafórumokhoz, ahol a LimeSurvey közösségtől kérhet segítséget.
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.
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} }',
),
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',
),
),
Az ugyanazon a domainen futó minden LimeSurvey példánynak saját munkamenetnévre van szüksége. Ellenkező esetben az egyik példányba való bejelentkezés kijelentkeztet a másikból. A telepítő véletlenszerű munkamenetnevet állít be a config.php fájlban. Ha a config.php fájlt egy másik példányból másolta, vagy a config.php fájl a LimeSurvey 4.0-nál régebbi verzióból származik, adja hozzá vagy módosítsa a sessionName sort a meglévő session szakaszban, és minden példányhoz különböző értéket használjon:
// Set the name of the session
'session' => array (
'sessionName' => 'LS-ABCDEFGHIJKLMNOP',
),
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éseinek beállításai a következő módon módosíthatók (saját felelősségére):
// Disable CSRF protection
'request' => array(
'enableCsrfValidation'=>false,
),
// Enforce a certain URL base
'request' => array(
'hostInfo' => 'http://www.example.org/'
),
// Set the cookie domain name and path for CSRF protection
'request' => array(
'csrfCookie' => array(
'domain' => '.example.com',
'path' => '/limesurvey/',
)
),
Ha csak a token e-mailek URL-jét kell frissítenie, állítsa be az publicurl értéket a config.php fájlban.
A munkamenet és a CSRF-érvényesítés használatának engedélyezése iFrame-ben
A Iframe beágyazás engedélyezése után frissítenie kell néhány konfigurációs részt. Figyelem, minden beállítás mellett is: az iframe-ben az engedélyezési forma egyes böngészőkön elromolhat. Ezt a beállítást Firefox 81.0.2 és Chromium 85.0.4183.121 verziókkal tesztelték.
Munkamenet indításának engedélyezése iframe-ben
A munkamenet sütijének biztonságosnak (érvényes HTTPS-kapcsolatot igényel) és httponly típusúnak kell lennie, a samesite értékét pedig None-ra kell állítani. A cookieParams kulcsait csupa kisbetűvel kell írni.
'session' => array (
'sessionName'=>'LS-VBXZZORFJZCAKGYI',
// Ha tábla alapú munkamenetekre van szüksége, törölje a megjegyzéseket a következő sorokból.
// Megjegyzés: A tábla alapú szekciók jelenleg nem támogatott az MSSQL szerveren.
// 'class' => 'application.core.web.DbHttpSession',
// 'connectionID' => 'db',
// 'sessionTableName' = > '{{sessions}}',
'cookieParams' => array(
'secure' => true,
'httponly' => true,
'samesite' => 'Nincs' ,
),
),
Csrf cookie engedélyezése iframe-ben
A munkamenet sütijéhez hasonlóan a CSRF-sütinek is biztonságosnak kell lennie, a sameSite értékét pedig None-ra kell állítani. Vegye figyelembe, hogy itt a kulcs sameSite alakban szerepel. A teljes request tömböt a session tömbbel azonos szintre kell beilleszteni.
'request' => array(
'enableCsrfValidation'=>true,
'csrfCookie' => array(
'sameSite' => 'Nincs',
'secure' => igaz,
),
),
URL beállítások
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) */
);
application.controller.customInit.max_execution_time és az application.controller.customInit.memory_limit kategóriák a PHP-beállítások módosítására irányuló kísérletek naplózására szolgálnak.
Ha tisztában van ezekkel a naplóüzenetekkel, és ki szeretné zárni őket a naplókból, hozzáadhatja ezeket a kategóriákat a naplóútvonal-beállítás except opciójához, az alábbiak szerint:
'except' => [
'exception.CHttpException.404',
'application.controller.customInit.max_execution_time',
'application.controller.customInit.memory_limit',
],
limesurvey/tmp/runtime/application.log helyre kerül mentésre, amely a LimeSurvey gyökérmappájában található. Más fájlnevet is megadhat a logFile használatával..
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.
Webhelyek közötti szkriptelés (XSS) elleni védelem
A LimeSurvey az adminisztrációs oldalon nem engedélyez semmilyen felhasználói szkriptet. Ha találna módot arra, hogy egy felhasználó XSS-szkriptet helyezzen el az adminisztrációs oldalon, kérjük, olvassa el a biztonsági irányelveinket.
A nyilvános oldalak szkriptjeit az XSS-szűrő beállításai kezelik.
- filterxsshtml: Ez a beállítás engedélyezi a gyanús HTML-címkék szűrését az adminisztrációs felületen a kérdőívekben, csoportokban, valamint a kérdések és válaszok szövegeiben. Csak akkor hagyja 'false' értéken, ha teljes mértékben megbízik a LimeSurvey adminisztrációjához létrehozott felhasználókban, és engedélyezni szeretné nekik a Javascript, Flash filmek stb. használatát. A szuperadminisztrátorok HTML-kódját a rendszer soha nem szűri. Az alapértelmezett érték felülbírálható a globális beállítások párbeszédpanelen.
- filterxsshtml_forcedall: A
filterxsshtmlértékét minden felhasználó esetén kényszerítetten true-ra állítja, és letiltja a módosítást az adminisztrációs felületen. A gyanús HTML-címkék szűrését a szuperadminisztrátorra is bekapcsolja. - filterxsshtml_allowforcedsuperadmin: Csak akkor használatos, ha a
filterxsshtml_forcedallértéke true. Lehetővé teszi tetszőleges szkript és HTML hozzáadását aforcedsuperadminszámára (alapértelmezés szerint az 1-es azonosítójú admin felhasználó). - disablescriptwithxss: Lehetővé teszi a kérdésben lévő szkript módosítását: alapértelmezés szerint true: az XSS-szabályok érvényesek; állítsa false értékre, hogy minden felhasználó számára engedélyezett legyen. Az alapértelmezett érték felülbírálható a globális beállítások párbeszédpanelen.
- filterxsshtml_enablescript: Csak akkor használatos, ha a filterxsshtml_forcedall értéke true. Engedélyezi a kérdésszkriptet adott felhasználó számára:
gui: a beállítás módosítása a grafikus felületen keresztül engedélyezett;superadmin: csak a szuperadminisztrátor;forcedsuperadmin: csak a kényszerített szuperadminisztrátor; alapértelmezés szerint: egyetlen felhasználó sem, és a grafikus felületen keresztüli módosítás sem engedélyezett
Engedélyezett fájlfeltöltés
- allowedthemeimageformats : A témák szekcióban feltölthető képfájltípusok. Az SVG fájlok alapértelmezés szerint le vannak tiltva a lehetséges XSS-támadás miatt.
- allowedthemeuploads : A témák szekcióban feltölthető egyéb fájltípusok (zip fájl)
- allowedresourcesuploads : Az erőforrások szekcióban és a HTML szerkesztővel feltölthető fájltípusok
- allowedpluginuploads : Bővítmény zip fájl feltöltésekor engedélyezett fájltípus.
Egyszerűen adja meg a kiterjesztéseket vesszővel elválasztva. Például:
'allowedthemeimageformats' => 'jpg,jpeg,gif,png,webm,svg',
Figyelmeztetés: A fájlfeltöltések engedélyezésekor mindig legyen óvatos. Rosszindulatú tevékenységekre lehet számítani.
Bővítmények
- usePluginWhitelist : Ha értéke true, az engedélyezési listán (lásd: 'pluginWhitelist') nem szereplő bővítmények nem telepíthetők és nem tölthetők be. Ez letilthatja a már telepített bővítményeket.
- pluginWhitelist : A telepíthető és betölthető bővítmények neveinek listája, ha a 'usePluginWhitelist' értéke true. A core bővítmények automatikusan szerepelnek az engedélyezési listán.
- corePluginBlacklist : A tiltott core bővítmények neveinek listája, ha a 'usePluginWhitelist' értéke true.
- disablePluginUpload : Ha ez a beállítás true, a „Bővítmény feltöltése” funkció le van tiltva
Gazdagép-vezérlés
- allowedHosts : A Host Header Injection elkerülése érdekében megadhatja az összes művelethez engedélyezett gazdagépeket. Ha a nyilvános oldalhoz és az adminisztrációs oldalhoz eltérő gazdagépet használ, mindkettőt engedélyezett gazdagépként kell megadnia.
'config'=>array(
....
, // Update default LimeSurvey config here
'allowedHosts' => [
'survey.example.org',
'proxy.survey.example.com',
'example.limesurvey.org',
],
),
Erőforrások
- iSessionExpirationTime: Meghatározza, hogy hány másodperc után jár le a kérdőív munkamenete. Csak akkor érvényes, ha adatbázis-alapú munkameneteket használ. Ha adatbázis-alapú munkameneteket használ, módosítsa a paramétert a config.php fájlban, vagy bírálja felül az alapértelmezett értéket a globális beállítások párbeszédpanelen.
- memory_limit: Ez határozza meg, hogy a LimeSurvey mennyi memóriát érhet el megabájtban. Az alapértelmezett érték '256'. Ha időtúllépési hibákat kap, vagy problémái vannak a statisztikák generálásával vagy a fájlok exportálásával, emelje ezt a korlátot '512'-re vagy magasabbra. Ha a webszerver a php.ini fájlban magasabb korlátot állított be, akkor ez a beállítás figyelmen kívül marad.
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
$dropdownsbeá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íthatja. Ez azt jelenti, hogy a szkripttel kapcsolatos minden apró értesítés, figyelmeztetés vagy hiba megjelenik. Ezt a beállítást csak akkor kapcsolja „1”-re, ha valamilyen okból hibakeresést szeretne végezni az alkalmazásban. Fejlesztőként állítsa „2”-re. Éles környezetben ne állítsa „1” vagy „2” értékre, mert az elérési út felfedéséhez vezethet. 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 szkript által 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ájlban.
- use_asset_manager: Alapértelmezés szerint a hibakeresési mód letiltja az eszközkezelőt (asset manager), de engedélyezheti annak használatát bekapcsolt hibakeresési módban is.
- rpc_log: (New in 7.9.0 ) Állítsa
trueértékre, ha minden RemoteControl hívást naplózni szeretne atmp/runtime/remotecontrol.logfájlba. Minden sor tartalmazza a meghívott metódust, annak paramétereit, a kliens IP-címét, az időtartamot és a válasz elejét. A jelszavak eltávolításra kerülnek, a munkamenetkulcsokat rövid hash váltja fel, a hosszú értékeket pedig lerövidíti a rendszer. A napló továbbra is tartalmazza az elküldött és fogadott kérdőív-, résztvevői és kitöltési adatokat, ezért csak akkor engedélyezze, amíg hibát keres. Az alapértelmezett értékfalse.
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
Az összes alábbi beállítás felülírható a globális beállítások párbeszédablakban.
- 'emailmethod: Ez határozza meg az e-mail üzenetek küldésének módját. A következő lehetőségek állnak rendelkezésre:
- 'mail:' a belső PHP levelezőt használja;
- 'sendmail:' a sendmail levelezőt használja;
- 'smtp:' SMTP-továbbítást használ. Akkor használja ezt a beállítást, ha a LimeSurvey olyan gazdagépen fut, amely nem az Ön levelezőszervere.
- 'emailsmtphost: Ha az 'smtp'-t használja
$emailmethodértékként, akkor itt kell megadnia az SMTP-szervert. Ha Google levelezőt használ, előfordulhat, hogy hozzá kell adnia a portszámot, például $emailsmtphost = 'smtp.gmail.com:465'. - emailsmtpuser: Ha az SMTP-szerver hitelesítést igényel, adja meg itt a felhasználónevét, ellenkező esetben hagyja üresen.
- emailsmtppassword: Ha az SMTP-szerver hitelesítést igényel, adja meg itt a jelszavát, ellenkező esetben hagyja üresen.
- emailsmtpssl: Állítsa 'ssl' vagy 'tls' értékre az SSL/TLS használatához az SMTP-kapcsolatnál.
- maxemails: Amikor meghívókat vagy emlékeztetőket küld a kérdőív résztvevőinek, ez a beállítás határozza meg, hogy hány e-mail küldhető el egy csomagban. A különböző webszerverek eltérő e-mail-kapacitással rendelkeznek, és ha a szkript túl sokáig tart egy e-mailcsomag elküldésével, időtúllépés és hibák léphetnek fel. A legtöbb webszerver egyszerre 100 e-mailt tud elküldeni a PHP-szkriptekre vonatkozó alapértelmezett 30 másodperces időkorláton belül. Ha nagy számú e-mail küldésekor szkript-időtúllépési hibákat kap, csökkentse a számot ebben a beállításban. Ha a token-vezérlő eszköztáron az „E-mail-meghívó küldése” gombra kattint (nem az egyes tokenek jobb oldalán található gombra), a rendszer elküld <maxemails> számú meghívót, majd megjeleníti a címzettek címeinek listáját és egy figyelmeztetést, hogy több függőben lévő e-mail van, mint amennyi egy csomagban elküldhető. Folytassa az e-mailek küldését az alábbi gombra kattintva. Még ### e-mailt kell elküldeni. Ezután egy „folytatás” gombbal léphet tovább a következő csomagra. Vagyis a felhasználó dönti el, hogy mikor küldi el a következő csomagot, miután az előző csomag e-mailjei elmentek. Nem szükséges ezen a képernyőn várakozni. Az üzemeltető kijelentkezhet, és egy későbbi időpontban visszatérhet, hogy elküldje a meghívók következő csomagját.
- send_error_saving_results_email: (New in 7.8.0 ) Ha egy kitöltést nem sikerül menteni, a LimeSurvey e-mailben elküldi a válaszokat a kérdőív üzemeltetőjének „Hiba az eredmények mentése közben” tárggyal. Állítsa
falseértékre, ha le szeretné állítani ezeket az e-maileket. A résztvevők továbbra is látják a hibaüzenetet. Az alapértelmezett értéktrue. Ez a beállítás csak a config.php fájlban módosítható.
Statisztikák és kitöltések böngészése
- filterout_incomplete_answers: Szabályozza a befejezetlen válaszok szűrésének alapértelmezett viselkedését a kitöltések böngészésekor vagy elemzésekor. A befejezetlen kitöltésekről szóló részletesebb leírást a kérdőív eredményeinek böngészésével foglalkozó wikioldalon találja. Mivel ezek a rekordok eltorzíthatják a statisztikákat, több grafikus felületen is lehetőség van a szűrő be- vagy kikapcsolására. A paraméter a config.php fájlban módosítható. A következő lehetőségek állnak rendelkezésre:
- 'all': Lehetővé teszi mind a teljes, mind a befejezetlen válaszok megjelenítését;
- 'complete': Csak a teljes válaszokat jeleníti meg;
- 'incomplete': Csak a befejezetlen válaszokat jeleníti meg.
- strip_query_from_referer_url: Ez a beállítás határozza meg, hogy a hivatkozó URL elmenti-e a paramétert. Az alapértelmezett érték 'false' (ebben az esetben a hivatkozó URL az összes paramétert elmenti). Ez az érték 'true'-ra is állítható, ekkor a hivatkozó URL paraméteres része eltávolításra kerül.
- showaggregateddata: Ha be van kapcsolva, további statisztikai értékek, például a számtani átlag és a szórás is megjelennek. Emellett az adatok összesítésre kerülnek a gyorsabb áttekintés érdekében. Például az 1+2 és a 4+5 skálaértékek eredményei összeadódnak, hogy általános rangsor jöjjön létre, például „jó” (1/2), „átlagos” (3) és „rossz” (4/5). Ez csak az „A” (5 pontos tömb) és az „5” (5 pontos választás) kérdéstípusokat érinti.
- PDF exportálási beállítások: Ez a funkció aktiválja a PDF exportálást a nyomtatható kérdőívekhez és a válaszok nyomtatásához. A PDF exportálási funkció teljesen kísérleti jellegű, és a kimenet még messze nem tökéletes. Sajnos jelenleg nem tudunk támogatást nyújtani – ha segíteni szeretne a javításában, kérjük, vegye fel velünk a kapcsolatot.
- 'pdfdefaultfont': A PDF exportálási funkció által használt alapértelmezett betűtípus. Az alapértelmezett érték 'auto'. A módosításhoz a PDF alapbetűtípusok egyikére kell állítania.
- 'alternatepdffontfile': Egy tömb nyelvi kulcsokkal és a hozzájuk tartozó betűtípussal. Az egyes nyelvek alapértelmezett betűtípusa a config.php fájlban cserélhető le;
- 'pdffontsize': A normál szövegek betűmérete; a kérdőív címe esetén <pdffontsize>+4, a csoport címe esetén <pdffontsize>+2. A config.php fájlban vagy a globális beállítások párbeszédpanelen módosítható.
- Grafikon beállítása
- 'chartfontfile': Beállítja a statisztikai diagramok létrehozásához használt betűtípusfájl nevét. A fájlnak a LimeSurvey gyökérmappájában található fonts könyvtárban kell lennie. A config.php fájlban módosítható;
- 'alternatechartfontfile': Egy tömb nyelvi kulcsokkal és a hozzájuk tartozó betűtípussal. A config.php fájlban módosítható.
- showsgqacode: Ezt a beállítást a nyomtatható kérdőív funkció használja, alapértelmezés szerint 'false'. Ha a showsgqacode = 'true'; értéket állítja be, minden kérdés – és adott esetben a válasz – azonosítója megjelenik. Ezek az azonosítók megegyeznek a Lime_survey_12345 tábla oszlopfejléceivel, amely egy adott kérdőív válaszadatait tartalmazza. Ezek az azonosítók felhasználhatók kódkönyvként a kézi adatbázis-lekérdezésekhez.
LDAP beállítások
Mivel ez egy kiterjedt téma, áthelyeztük az LDAP beállítások egy másik oldalra.
Hitelesítés
A LimeSurvey 2.05-től kezdve a hitelesítést pluginek fogják kezelni. Ennek eredményeként az alábbi információk elavultak lehetnek. A legfrissebb információkért lásd a the plugins wiki-t.
Hitelesítés delegálása a webszerverre
A rendszergazdák szeretnék, ha a kérdőív-adminisztrátoraik hitelesítése egy központi hitelesítési rendszeren (Active Directory, openLdap, Radius stb.) keresztül történne a belső LimeSurvey adatbázis használata helyett. Ennek egyszerű módja, ha beállítja a webszerver szoftverét ennek a külső hitelesítési rendszernek a használatára, majd megkéri a LimeSurvey-t, hogy bízzon a webszerver által jelentett felhasználói identitásban. A funkció engedélyezéséhez a következőket kell tennie:
- aktiválja a Webszerver bővítményt a Rendszerbeállítások > Bővítmények menüben, és a bővítmény beállításaiban adja meg azt a szerverkulcsot, amely a felhasználónevet tartalmazza (alapértelmezés: REMOTE_USER);
- engedélyezze a hitelesítést a webszerver oldalán.
Kérjük, vegye figyelembe, hogy:
- A LimeSurvey ekkor megkerüli saját hitelesítési folyamatát (a webszerver által jelentett bejelentkezési név használatával jelszó kérése nélkül);
- ez csak a LimeSurvey grafikus felhasználói felület hitelesítési rendszerét helyettesítheti, 'nem a felmérési meghívó rendszer (résztvevői felület).
Hitelesítési delegálás automatikus felhasználóimportálás nélkül
Felhívjuk figyelmét, hogy a hitelesítési delegálás alapértelmezés szerint nem kerüli meg a LimeSurvey engedélyezési rendszert – ami azt jelenti, hogy még ha nem is kell jelszavakat kezelnie a LimeSurvey-ben, akkor is meg kell határoznia a felhasználókat a LimeSurvey adatbázisban, és hozzá kell rendelnie a megfelelő jogokat, hogy hozzáférhessenek az adminisztrációs panelhez.
A felhasználó akkor és csak akkor kap hozzáférést a LimeSurvey-hez, ha:
- hitelesítették a webszerveren;
- a bejelentkezési neve felhasználóként szerepel a LimeSurvey felhasználói adatbázisában (a felhasználó ekkor megkapja a LimeSurvey felhasználói adatbázisban megadott felhasználó jogosultságait);
- rendelkezik a Webszerver hitelesítés használata globális jogosultsággal.
Hitelesítési delegálás automatikus felhasználóimportálással
Nagy felhasználói adatbázis kezelésekor néha egyszerűbb a felhasználókat automatikusan importálni a LimeSurvey adatbázisába:
- auth_webserver_autocreate_user: Ha 'true' értékre van állítva, a LimeSurvey megpróbálja automatikusan importálni azokat a felhasználókat, akiket a webszerver hitelesített, de még nem szerepelnek a felhasználói adatbázisában.
- auth_webserver_autocreate_profile: A felhasználóhoz rendelt alapértelmezett profilt leíró tömb: a teljes (kitalált) név, az e-mail cím és a nyelv.
- auth_webserver_autocreate_permissions: A felhasználóhoz rendelt globális jogosultságokat tartalmazó tömb.
Ha testre szeretné szabni a felhasználói profilt, hogy az megfeleljen a bejelentkezett felhasználónak, a config.php fájlban egy egyszerű, hook_get_auth_webserver_profile nevű függvényt kell létrehoznia – ezzel a függvénnyel egy központi felhasználói fiókadatbázisból (például egy LDAP címtárból) lekérheti egy adott felhasználó valódi teljes nevét, e-mail címét és nyelvét.
A hook_get_auth_webserver_profile függvény egyetlen argumentumként a felhasználó bejelentkezési nevét kapja, és a következőket adhatja vissza:
- False vagy üres tömb – ebben az esetben a felhasználó nem kap hozzáférést a LimeSurvey-hez;
- az
auth_webserver_autocreate_profilebejegyzéseivel azonos bejegyzéseket tartalmazó tömb.
function hook_get_auth_webserver_profile($user_name)
{
// Retrieve user's data from your database backend (for instance LDAP) here
// ... get $user_name_from_backend
// ... get $user_email_from_backend
// ... get $user_lang_from_backend
return array(
'full_name' => $user_name_from_backend,
'email' => $user_email_from_backend,
'lang' => $user_lang_from_backend,
);
}
// If user should be denied access, return an empty array
// return array();
Felhasználónév-leképezés
Abban az esetben, ha néhány felhasználó külső felhasználóneve eltér a LimeSurvey felhasználónevétől, hasznos lehet a felhasználónév-leképezés használata. Ez a LimeSurveyben az auth_webserver_user_map paraméter használatával történik. Képzelje el például, hogy nincs megadva „admin” felhasználónév a külső hitelesítési adatbázisban. Ezután ahhoz, hogy adminisztrátorként jelentkezzen be a LimeSurvey-be, hozzá kell rendelnie külső felhasználónevét (nevezzük 'myname'-nek) a LimeSurvey rendszergazdai bejelentkezési nevéhez. A megfelelő beállítás a következő:
'config'=>array(
...
'auth_webserver_user_map' => array ('myname' => 'admin');
)
A „myname” bejelentkezési névvel és a webszerver jelszavával végzett sikeres hitelesítés után közvetlenül jogosult lesz a LimeSurvey „admin” felhasználóként való használatára.
Ennek komoly biztonsági következményei vannak, ezért óvatosan használja. Ezenkívül védje a config.php fájlt a webszerver írási hozzáférésétől.
Egyszeri jelszavak használata
A felhasználó megnyithatja a LimeSurvey bejelentkezési oldalát a default.com/limesurvey/admin címen, és beírhatja a felhasználónevet és az egyszeri jelszót, amelyet korábban egy külső alkalmazás írt be a felhasználók táblázatába (egy_time_pw oszlop).
Ezt a beállítást be kell kapcsolni a config.php fájlban az egyszeri jelszavak használatának engedélyezéséhez (alapértelmezett = false).
'config'=>array(
'debug'=>0,
'debugsql'=>0,
'use_one_time_passwords'=>true,
)
További információ a "Felhasználók kezelése" szakaszban található.
Titkosítási beállítások
A funkcióval kapcsolatos részletekért lásd az adattitkosítás című részt.
- encryptionkeypair
- encryptionpublickey
- encryptionsecretkey
- encryptionnonce
- encryptionsecretboxkey
Speciális URL-beállítások
- publicurl: Ezt a 'nyilvános szkriptek' URL-címére kell beállítani. A nyilvános szkriptek azok, amelyek a "limesurvey" mappában találhatók (vagy abban a könyvtárban, amelynek bármilyen nevet adott, és amelyben az összes többi szkript és könyvtár van). Ez a beállítás a config.php fájlban érhető el, és akkor használatos, ha a LimeSurvey-nek abszolút URL-re van szüksége (például a token e-mailek küldésekor).
- tempurl: Ezt a "/limesurvey/tmp" könyvtár URL-címére kell beállítani – vagy egy olyan könyvtáréra, amelyet a LimeSurvey az ideiglenes fájlok kiszolgálására használni fog.
- uploadurl: Ezt a "/limesurvey/upload" könyvtár URL-címére kell beállítani – vagy egy olyan könyvtáréra, amelyet a LimeSurvey a feltöltött fájlok kiszolgálására használni fog. Ez lehetővé teszi, hogy a feltöltött fájlok egy másik URL-tartományon legyenek.
Speciális elérési út beállítások
- homedir: Ezt az adminisztrációs szkriptek fizikai lemezhelyére kell beállítani - például "/home/usr/htdocs/limesurvey/admin". Ne írjon perjelet a bejegyzés végére. A config.php alapértelmezett beállítása a
{$_SERVER['DOCUMENT_ROOT']}php változó segítségével próbálja észlelni az összes dokumentum alapértelmezett gyökérútvonalát. A legtöbb esetben ezt meghagyhatja, és csak a karakterlánc fennmaradó részét módosítsa úgy, hogy megfeleljen annak a könyvtárnévnek, amelybe a LimeSurvey szkripteket helyezte. - publicdir: Ezt a „nyilvános szkriptjei” fizikai lemezhelyére kell beállítani.
- tempdir: Ezt a /limesurvey/tmp könyvtár fizikai lemezhelyére kell beállítani, hogy a szkript tudjon fájlokat olvasni és írni.
- uploaddir: Ezt a /limesurvey/upload könyvtár fizikai lemezhelyére kell beállítani, hogy a szkript tudjon fájlokat olvasni és írni.
- sCKEditorURL: a CKEditor szkript URL-je.
Egyéb speciális beállítások
Fájlok feltöltése
- magic_database: Lehetővé teszi másik MIME-adatbázis használatát a következőhöz: finfo_open. Csak a config.php fájlban frissíthető. Példa:
/usr/share/misc/magic.mgcredhat alapú linuxhoz. - magic_file: Lehetővé teszi, hogy a MIME-típus szerinti kiterjesztéstömb lekéréséhez a mellékelt fájltól eltérő fájlt használjon. PHP-fájlnak kell lennie, amely egy tömböt ad vissza. Csak a config.php fájlban frissíthető.
Frissítés
- updatable: Ez a beállítás a version.php fájlban található. Lehet igaz vagy hamis. Ha igazra állítja: ha egy kiemelt rendszergazda bejelentkezik: a LimeSurvey ellenőrzi, hogy elérhető-e frissítés, és figyelmeztetést jelenít meg. Ha hamis értékre van állítva: nem történik ellenőrzés, és a ComfortUpdate nem használható.
Tokenek
- allowedcharacters_pattern_token : Ezek a beállítások lehetővé teszik a reguláris kifejezés mintájának megadását a tokenek szűrésekor.