Valgfrie indstillinger

Det følgende afsnit henvender sig til dem af jer, der gerne vil redigere de konfigurationsindstillinger, som ikke kan ændres via GUI'en (Graphical User Interface) i LimeSurvey-installationen. Vær opmærksom på, at alle ændringer i LimeSurvey-rodmappen sker på eget ansvar. Hvis du oplever problemer eller har brug for yderligere vejledning, kan du dog deltage i diskussionsforummerne for at få hjælp fra LimeSurvey-fællesskabet.

Introduktion

For at ændre installationens konfigurationsindstillinger skal du redigere de valgfrie indstillinger. De kan findes i /application/config/config-defaults.php, som er placeret i LimeSurvey-rodmappen. Standardindstillingerne for standardinstallationen kan findes i config-defaults.php. Nogle af dem kan tilsidesættes ved at bruge dialogen globale indstillinger, mens de andre skal redigeres manuelt.

  Hvis du vil ændre disse indstillinger, så lad være med at ændre dem i config-defaults.php, men kopier den bestemte indstilling/linje til /application/config/config.php i 'config'=>array( ) og ændre det der. Alle de nyligt ændrede/indførte indstillinger fra config.php-filen vil tilsidesætte standardværdierne fra config-defaults.php.

Når en opgradering sker, ændres kun indstillingerne for config-defaults.php. Derfor vil redigering af config.php filen gemme dine tilpassede indstillinger.

For at opdatere/tilføje LimeSurvey-indstillingerne i /application/config/config.php, skal du opdatere config-arrayet:

 
 'config'=>array(
 'debug'=>0,
 'debugsql'=>0,
 'LimeSurveySetting'=>'Ny værdi', // Opdater standard LimeSurvey-konfiguration her
 )

Yii indstillinger

LimeSurvey bruger Yii frameworket, som har sine egne konfigurationsparametre i application/config/internal.php og application/config/config.php fil. Du kan også få adgang til nogle specifikke konfigurationsindstillinger af LimeSurvey via Yii-konfigurationen.

Da config.php-arrayet er flettet til hele konfigurationen, kan du erstatte alle Yii-parametre i config.php-filen.

De Yii-specifikke indstillinger er indstillet i komponentarrayet:

 
 'components' => array(
 'db' => array(
 ....
 ),
 'Specific settings'=>array(
 ....
 ),
 ),

For mere information om Yii-frameworket, se følgende link.

Databaseindstillinger

Databaseindstillingerne skrives til config.php af installationsfilen, når du installerer LimeSurvey for første gang. Hvis det er nødvendigt, kan du opdatere denne del af filen config.php. Husk at du gør dette på egen risiko! Se også Yii-dokumentationen og venligst husk, at LimeSurvey kun understøtter følgende typer databaser: mysql, pgsql, dblib, mssql og sqlsrv.

Sessionsindstillinger

Du kan indstille nogle sessionsparametre i config.php (tjek de to eksempler nedenfor). Du kan fjerne kommentarer/tilføje den nødvendige del i config.php. Se Yii-dokumentationen for andre indstillinger.

  Hvis du kører flere LimeSurvey-instanser på det samme domæne, skal du give hver af dem sit eget sessionsnavn. Du behøver ikke at ændre sessionscookiens sti eller indstillingerne for CSRF-cookien.

Brug tabelbaserede sessioner

LimeSurvey kan bruge tabel-baserede sessioner, du finder en kommenteret del på den standard config.php genererede fil. For at bruge tabelbaseret session skal du fjerne // før hver linje.

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

  Tabelbaserede sessioner understøttes i øjeblikket ikke på MSSQL-serveren.

Opdatering af andre sessioner

Hvis du bruger SSL ('https') til din LimeSurvey-installation, vil tilføjelse af følgende linjer til din config.php øge sikkerheden for sessionen:

 // Indstil cookien via SSL
 'session' => array (
 'cookieParams' => array(
 'secure' => true, // brug SSL til cookies
 'httponly' => true // Cookies må ikke bruges af andre protokoller - eksperimentelle
 ),
 ),

Hvis du vil rette domænet til en cookie, skal du bruge følgende syntaks i config.php:

 // Indstil domænet til cookie
 'session' => array (
 'cookieParams' => array(
 'domain' => '.example.org',
 ),
 ),

Hver LimeSurvey-instans på det samme domæne skal have sit eget sessionsnavn. Ellers bliver du logget ud af den ene instans, når du logger ind på den anden. Installationsprogrammet angiver et tilfældigt sessionsnavn i config.php. Hvis du har kopieret config.php fra en anden instans, eller din config.php stammer fra en version ældre end LimeSurvey 4.0, skal du tilføje eller ændre linjen sessionName i den eksisterende session-sektion og bruge en forskellig værdi for hver instans:

        // Set the name of the session
        'session' => array (
            'sessionName' => 'LS-ABCDEFGHIJKLMNOP',
            ),

Anmodningsindstillinger

Anmodningsindstillingerne er vigtige, men standardindstillingerne er allerede optimeret til LimeSurvey-brug. For at læse mere om dem, se Yii Documentation.

For eksempel kan konfigurationen af LimeSurvey-anmodningsindstillingerne ændres på følgende måde (på eget ansvar) :

        // Deaktiver CSRF-beskyttelse
        'request' => array(
            'enableCsrfValidation'=>false,    
            ),

        // Gennemtving en bestemt URL-base 
        'request' => array(
            'hostInfo' => 'http://www.example.org/'  
            ),

        // Angiv cookiens domænenavn og sti til CSRF-beskyttelse
        'request' => array(
            'csrfCookie' => array( 
                'domain' => '.example.com',
                'path' => '/limesurvey/',
            )
        ),

Hvis du kun skal opdatere url'en for token-e-mails, skal du indstille din publicurl i din config.php-fil.

Tillad brug af session og CSRF-validering i iFrame

Efter at have tilladt Iframe-indlejring skal du opdatere en eller anden konfigurationsdel. Bemærk, selv med alle indstillinger: tillad form i iframe kan gå i stykker på nogle browsere. Disse indstillinger blev testet med Firefox 81.0.2 og Chromium 85.0.4183.121.

  Selv med alle disse indstillinger kan undersøgelser i en iframe stadig fejle i nogle browsere eller med visse browserindstillinger, for eksempel i privat browsing-tilstand, eller når tredjepartscookies er blokeret. Disse indstillinger er testet med Firefox 81.0.2 til 115, Chromium 85.0.4183.121 til 119 og Edge 119 med deres standardindstillinger. LimeSurvey yder ikke support til denne opsætning, der er kun support fra fællesskabet.

Tillad sessionstart i iframe

Session-cookien skal være sikker (kræver en gyldig HTTPS-forbindelse) og httponly, og samesite skal sættes til None. Nøglerne i cookieParams skal skrives med udelukkende små bogstaver.

'session' => array (
 'sessionName'=>'LS-VBXZZORFJZCAKGYI',
 // Fjern kommentarer på følgende linjer, hvis du har brug for tabelbaserede sessioner.
 // Bemærk: Tabelbaserede sessioner er i øjeblikket ikke understøttet på MSSQL-serveren.
 // 'class' => 'application.core.web.DbHttpSession',
 // 'connectionID' => 'db',
 // 'sessionTableName' = > '{{sessions}}',
 'cookieParams' => array(
 'secure' => sand,
 'httponly' => sand,
 'samesite' => 'Ingen' ,
 ),
 ),

Tillad csrf-cookie i iframe

Ligesom med session-cookien skal CSRF-cookien være sikker, og sameSite skal sættes til None. Bemærk, at nøglen her skrives sameSite. Tilføj hele request-arrayet på samme niveau som session.

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

URL-indstillinger

  Hvis du kun har brug for at opdatere url'en for token og andre e-mails, skal du indstille din publicurl i din config.php-fil.

For at ændre standard-URL-indstillingerne skal du opdatere urlManager:

 // Brug kort URL
 'urlManager' => array(
 'urlFormat' => 'sti',
 'showScriptName' => falsk,
 ),

Du kan også tilføje .html efter undersøgelses-id'et på følgende måde:

 // Brug kort URL
 'urlManager' => array(
 'urlFormat' => 'sti',
 'rules' => array (
 '<sid:\d+> ' => array('survey/index','urlSuffix'=>'.html','matchValue'=>true),
 ),
 'showScriptName' => falsk,
 ),

For mere information, se Yii-dokumentationen.

Logningsindstillinger

Yii tilbyder forskellige løsninger til at generere logfiler. For at finde ud af mere om dem, tjek special topic. LimeSurvey bruger som standard '1' eller '2', hvilket giver enhver webbruger mulighed for at se logfilerne. Du kan oprette dine egne indstillinger ved at bruge Yii direkte.

For eksempel er en hurtig løsning til at logge fejl og advarsler i filer:

 
retur array(
 'components' => array(
 /* Anden komponentdel her 'db' for eksempel */
 'log' => array(
 'routes' => array(
 'fileError' => array(
 'class' => 'CFileLogRoute',
 'levels' => 'advarsel, fejl',
 'except' => 'exception.CHttpException .404',
 ),
 ),
 ),
 /* Anden komponentdel her 'urlManager' for eksempel */
 ),
 /* Sidste del (med ' runtimePath' 'config' for eksempel) */
);

 Hint: Kategorierne application.controller.customInit.max_execution_time og application.controller.customInit.memory_limit bruges til at logge forsøg på at ændre PHP-indstillinger.

Hvis du er opmærksom på disse logbeskeder og vil udelukke dem fra loggene, kan du tilføje disse kategorier til indstillingen except i din konfiguration af logruten, som vist nedenfor:

'except' => [
    'exception.CHttpException.404',
    'application.controller.customInit.max_execution_time',
    'application.controller.customInit.memory_limit',
],

 Hint: Filen gemmes som standard i limesurvey/tmp/runtime/application.log, som er placeret i LimeSurvey-rodmappen. Du kan angive et andet filnavn ved hjælp af logFile.

  Yii bruger runtime-stien. Som standard er logfilerne tilgængelige via nettet. De kan indeholde en masse information fra din server. Det er bedre at bruge en mappe, der ikke kan tilgås via internettet. Du kan angive den i logPath eller ved at opdatere runtime-stien.

.

Kørselssti

Runtime-stien skal være en læsbar og skrivbar mappe for "webbrugeren". Runtimestien indeholder dog filer med potentielle sikkerhedsoplysninger, der er placeret i det offentlige webadgangsområde. LimeSurvey samler disse filer i temp-mappen i LimeSurvey-rodmappen. For at eliminere adgangen til sådanne vigtige data, kan du indstille runtime-stien uden for den offentlige webadgang ved at redigere de respektive linjer i filen /application/config/config.php:

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

Generelle indstillinger

• sitename: Giver dit undersøgelsessted et navn. Dette navn vil fremgå af undersøgelseslisteoversigten og i administrationshovedet. Standardværdien er 'LimeSurvey', og den kan tilsidesættes i globale indstillinger-dialogen eller redigeres i config.php.
• siteadminemail: Dette er standard-e-mailadressen for webstedsadministratoren, og den bruges til systemmeddelelser og kontaktmuligheder. Denne indstilling bruges kun som standardværdi og kan tilsidesættes i dialogen globale indstillinger.
• siteadminbounce: Dette er den e-mail-adresse, hvor afviste e-mails vil blive sendt til. Denne indstilling bruges kun som standardværdi og kan tilsidesættes af dialogen globale indstillinger.
• siteadminname: Det rigtige navn på webstedsadministratoren. Denne indstilling bruges kun som standardværdi og kan tilsidesættes i dialogboksen globale indstillinger).
• proxy_host_name: Dette er værtsnavnet på din proxyserver (den har skal nævnes, hvis du står bag en proxy, og du vil opdatere LimeSurvey ved hjælp af ComfortUpdate).
• proxy_host_port: Dette er porten på din proxyserver (det skal være nævnt, hvis du står bag en proxy, og du ønsker at opdatere LimeSurvey ved hjælp af ComfortUpdate).

Sikkerhed

• maxLoginAttempt: Dette er antallet af forsøg en bruger skal indtaste den korrekte adgangskode, før han eller hun får sin IP-adresse blokeret/låst ude. Standardværdien er 3, og den kan ændres fra config.php.
• timeOutTime: Hvis brugeren indtaster adgangskoden forkert til<maxLoginAttempt> , bliver hun eller han låst ude for<timeOutTime> sekunder. Standardværdien er 10 minutter, og den kan ændres fra config.php.
• maxLoginAttemptParticipants: Dette er antallet af forsøg en deltager skal indtaste et gyldigt token, før han eller hun får sit IP-adresse blokeret/låst ude. Standardværdien er 3, og den kan ændres fra config.php.
• timeOutParticipants: Hvis deltageren indtaster tokenet forkert for<maxLoginAttemptParticipants> , bliver hun eller han låst ude for<timeOutParticipants> sekunder. Standardværdien er 10 minutter, og den kan ændres fra config.php.
• surveyPreview_require_Auth: Indstillet til sand som standard. Hvis du indstiller dette til 'false', kan enhver person teste din undersøgelse ved hjælp af undersøgelsens URL, uden at logge ind på administrationspanelet og uden at skulle aktivere undersøgelsen først. Denne indstilling er en standardværdi og kan tilsidesættes i dialogen globale indstillinger eller redigeres i config.php.
• usercontrolSameGroupPolicy: Indstillet til sand som standard. Som standard vil ikke-administratorbrugere, der er defineret i LimeSurvey-administrationsgrænsefladen, kun kunne se brugere, de opretter, eller brugere, der tilhører mindst én samme gruppe. Standardværdien kan tilsidesættes i dialogen globale indstillinger eller redigeres i config.php.
• filterxsshtml: Denne indstilling muliggør filtrering af mistænkelige html-tags placeret i undersøgelser, grupper, og spørgsmål og svar tekster i administrationsgrænsefladen. Lad kun dette være 'false', hvis du absolut stoler på de brugere, du har oprettet til administrationen af LimeSurvey, og hvis du vil tillade, at disse brugere kan bruge Javascript, Flash Movies osv.. Superadministratorerne får aldrig deres HTML filtreret . Standardværdien kan tilsidesættes i dialogen globale indstillinger eller redigeres i config.php.
• demoMode: Hvis denne indstilling er sat til 'true' i config.php , så går LimeSurvey i demotilstand. Demotilstanden ændrer følgende ting:
  • Deaktiverer adminbrugerens detaljer og adgangskodeændring;
  • Deaktiverer upload af filer på skabeloneditoren;
  • Deaktiverer afsendelse af e-mailinvitationer og påmindelser;!N !** Deaktiverer oprettelsen af en database-dump;
  • Deaktiverer muligheden for at ændre følgende globale indstillinger: webstedsnavn, standardsprog, standard HTML-redigeringstilstand, XSS-filter.
• 'forcedsuperadmin:' Array af bruger-id med alle rettigheder på alle LimeSurvey. Disse indstillinger kan kun opdateres i filen config.php. Denne brugers rettigheder kan ikke redigeres i globale tilladelser for en bruger selv af andre tvungne superadministratorer. Som standard: bruger med disse rettigheder er bruger med id: 1. Den første bruger oprettet lige efter installationen.
• force_ssl: tvinger LimeSurvey til at køre gennem HTTPS eller til at blokere HTTPS. Se Force HTTPS i globale indstillinger admin GUI.
• ssl_emergency_override: Denne indstilling tvinger SSL fra. Hvis du har slået HTTPS/SSL til i de globale indstillinger, men din server ikke har HTTPS aktiveret, er den eneste måde at slå det fra ved at ændre en værdi i databasen direkte. Dette giver dig mulighed for at tvinge HTTPS fra, mens du ændrer de globale indstillinger for Force Secure. Dette bør altid være falsk undtagen i nødstilfælde, hvor du ændrer det til sandt, indtil du løser problemet. Denne indstilling kan kun indstilles via config.php fil.
• ssl_disable_alert: Deaktiver alarm for super-admin om utvunget SSL, hvis du virkelig ikke kan eller ikke vil tvinge ssl. Denne indstilling kan kun indstilles via filen config.php.

Beskyttelse mod cross-site scripting (XSS)

LimeSurvey tillader ikke brugerscripts på administrationssiden. Hvis du finder en måde, hvor en bruger kan tilføje et XSS-script på administrationssiden, bedes du se vores sikkerhedspolitik.

Scripts på de offentlige sider styres af XSS-filterindstillingerne.

• filterxsshtml: Denne indstilling aktiverer filtrering af mistænkelige html-tags i undersøgelser, grupper samt spørgsmåls- og svartekster i administrationsgrænsefladen. Lad den være på 'false' kun hvis du har absolut tillid til de brugere, du har oprettet til administration af LimeSurvey, og du vil give dem mulighed for at bruge Javascript, Flash-film osv. Superadministratorers HTML bliver aldrig filtreret. Standardværdien kan tilsidesættes i dialogen globale indstillinger.
• filterxsshtml_forcedall: Tving filterxsshtml til true for alle brugere, og deaktiver ændringer i administrations-GUI'en. Aktiverer også filtrering af mistænkelige HTML-tags for superadministratoren.
• filterxsshtml_allowforcedsuperadmin: Bruges kun, hvis filterxsshtml_forcedall er true. Tillad tilføjelse af vilkårligt script og HTML via forcedsuperadmin (som standard administratorbruger nr. 1).
• disablescriptwithxss: Tillad opdatering af script i spørgsmål: som standard true, hvilket følger XSS-reglerne; sæt til false for at tillade det for alle brugere. Standardværdien kan tilsidesættes i dialogen globale indstillinger.
• filterxsshtml_enablescript: Bruges kun, hvis filterxsshtml_forcedall er true. Aktiver spørgsmålsscript for specifikke brugere: gui: tillad opdatering af indstillingen via GUI; superadmin: kun superadministratorer; forcedsuperadmin: kun forcedsuperadmin; som standard: ingen bruger, og opdatering via GUI er ikke tilladt

Tilladt filupload

• allowedthemeimageformats : Billedfiltyper, der må uploades i temasektionen. Som standard er SVG-filer deaktiveret på grund af risikoen for XSS-angreb.
• allowedthemeuploads : Andre filtyper, der må uploades i temasektionen (zip-fil)
• allowedresourcesuploads : Filtyper, der må uploades i ressourcesektionerne og med HTML-editoren
• allowedpluginuploads : Filtyper, der er tilladt ved upload af plugin-zip-fil.

Indtast blot en streng med kommaseparerede filendelser. For eksempel:

'allowedthemeimageformats' => 'jpg,jpeg,gif,png,webm,svg',

Advarsel: Vær altid forsigtig, når du tillader filuploads. Der kan forekomme ondsindede aktiviteter.

Plugins

• usePluginWhitelist : Hvis true, kan plugins, der ikke er på tilladelseslisten (se 'pluginWhitelist'), hverken installeres eller indlæses. Dette kan deaktivere allerede installerede plugins.
• pluginWhitelist : Liste over plugin-navne, der må installeres og indlæses, når 'usePluginWhitelist' er true. Kerne-plugins er implicit på tilladelseslisten.
• corePluginBlacklist : Liste over kerne-plugin-navne, der er forbudt, når 'usePluginWhitelist' er true.
• disablePluginUpload : Når denne indstilling er true, er funktionen "Plugin Upload" deaktiveret

Værtskontrol

• allowedHosts : For at undgå Host Header Injection kan du angive de tilladte værter for alle handlinger. Hvis du bruger forskellige værter til den offentlige side og administrationssiden, skal du angive begge som tilladte værter.

    'config'=>array(
            ....
,		// Update default LimeSurvey config here
		'allowedHosts' => [
			'survey.example.org',
			'proxy.survey.example.com',
			'example.limesurvey.org',
		],
    ),

Ressourcer

• iSessionExpirationTime: Angiver den tid i sekunder, hvorefter en undersøgelsessession udløber. Gælder kun, hvis du bruger databasesessioner. Hvis du bruger databasesessioner, skal du ændre parameteren i config.php eller tilsidesætte standardværdien i dialogen globale indstillinger.
• memory_limit: Dette bestemmer, hvor meget hukommelse LimeSurvey kan bruge, i megabyte. Standardværdien er '256'. Hvis du får timeout-fejl eller har problemer med at generere statistik eller eksportere filer, skal du hæve denne grænse til '512' eller højere. Hvis din webserver har en højere grænse i php.ini, ignoreres denne indstilling.

Husk venligst, at sådanne lokale indstillinger altid kan tilsidesættes af ændringerne i den globale indstillingsdialog.

For at øge hukommelsesgrænsen til 128M kan du også prøve at tilføje:

• memory_limit = 128M til din servers php.ini-hovedfil (anbefales, hvis du har adgang)
• memory_limit = 128M til en php.ini-fil i LimeSurvey-roden
• php_value memory_limit 128M i en .htaccess-fil i LimeSurvey-roden

• max_execution_time: Indstil antallet af sekunder et script må køre. Hvis dette nås, returnerer scriptet en fatal fejl. For at få lov til at eksportere store undersøgelsesdata og statistikker, forsøger LimeSurvey at indstille det som standard til 1200 sekunder. Du kan indstille en større tid eller en lavere tid, hvis det er nødvendigt. Kun tilgængelig via php-konfigurationsfil.

Udseende

• dropdownthreshold ^{(Obsolete since 2.50)}: Når "R" er valgt for $dropdowns , har administratoren tilladelse til at indstille et maksimalt antal muligheder, der vil blive vist som alternativknapper , før du konverterer tilbage til en rulleliste. Hvis der er et spørgsmål, der har et stort antal muligheder, kan det se uhåndterligt ud at vise dem alle på én gang som radioknapper, og det kan blive kontraintuitivt for brugerne. Hvis du indstiller dette til et maksimum på f.eks. 25 (som er standard), betyder det, at store lister er nemmere at bruge af administratorerne for undersøgelsesdeltageren.
• repeatheadings: Med Array-spørgsmålstypen, du vil ofte have en masse underspørgsmål, som - når de vises på skærmen - fylder mere end én side. Denne indstilling giver dig mulighed for at bestemme, hvor mange underspørgsmål der skal vises, før du gentager headeroplysningerne for spørgsmålet. En god indstilling til dette er omkring 15. Hvis du slet ikke ønsker, at overskrifterne skal gentages, skal du indstille denne til 0. Denne indstilling tilsidesættes i dialogboksen globale indstillinger ^{(New in 2.05 )} .
• minrepeatheadings: Det mindste antal resterende underspørgsmål, der kræves, før du gentager overskrifterne i Array-spørgsmål. Standardværdien er 3, og den kan redigeres i config.php.
• defaulttemplate: Denne indstilling specificerer standardtemaet, der bruges til den 'offentlige liste' over undersøgelser. Denne indstilling kan tilsidesættes i dialogen globale indstillinger eller redigeres i config.php.
• defaulthtmleditormode: Indstiller standardtilstanden for den integrerede HTML-editor. Denne indstilling kan tilsidesættes i globale indstillinger dialogen eller redigeres i config.php. De gyldige indstillinger er:
  • 'inline' - Inline udskiftning af felter med en HTML-editor. Langsomt, men bekvemt og brugervenligt;
  • 'popup' - Tilføjer et ikon, der kører HTML-editoren i en popup, hvis det er nødvendigt. Hurtigere, men HTML-kode vises i formen;
  • 'none'- Ingen HTML-editor;
• column_style: Definerer, hvordan kolonner gengives for undersøgelsessvar ved brug af display_columns. Det kan redigeres i filen config.php. De gyldige indstillinger er:
  • 'css' - den bruger en af de forskellige CSS-metoder til at oprette kolonner (se skabelonen stilarket for detaljer);
  • 'ul' - kolonnerne gengives som flere flydende uordnede lister (standard);
  • 'tabel' - det bruger konventionelt-tabeller-baseret layout;
  • NULL - det deaktiverer brugen af kolonner.

Sprog & tid

• defaultlang: Dette bør indstilles til standardsproget, der skal bruges i dine administrationsscripts, og også standardindstillingen for sprog i den offentlige undersøgelsesliste. Denne indstilling kan tilsidesættes i dialogen globale indstillinger eller redigeres i config.php.
• timeadjust: Hvis din webserver er i en anden tidszone end den placering, hvor dine undersøgelser vil være baseret, angiv forskellen mellem din server og din hjemmetidszone her. For eksempel bor jeg i Australien, men jeg bruger en amerikansk webserver. Webserveren er 14 timer efter min lokale tidszone. Så min indstilling her er "14". Med andre ord tilføjer det 14 timer til webserverens tid. Denne indstilling er især vigtig, når undersøgelser tidsstempler svarene. Denne indstilling kan tilsidesættes i globale indstillinger dialogen eller redigeres i config.php.

Survey adfærd

• deletenonvalues: Brug denne funktion med forsigtighed. Som standard (en værdi på 1) er irrelevante spørgsmål NULLed i databasen. Dette sikrer, at dataene i din database er internt konsistente. Der er dog sjældne tilfælde, hvor du måske vil holde fast i irrelevante værdier, og i så fald kan du sætte værdien til 0. For eksempel spørger du en mandlig person om hans køn, og han siger ved et uheld 'kvinde' og svarer så en kvinde. -specifikke spørgsmål (spørgsmål, der er betinget af at være kvinde, så er kun relevante for kvinder). Så indser han sin fejl, bakker op, indstiller kønnet til 'mand' og fortsætter med undersøgelsen. Nu er de kvindespecifikke spørgsmål irrelevante. Hvis $deletenonvalues==1 , vil disse irrelevante værdier blive ryddet (NULLed) i databasen. Hvis $deletenonvalues==0 , vil hans fejlagtige svar ikke blive slettet, så de vil stadig være til stede i databasen, når du analyserer den.
• shownoanswer: Når en alternativknap/vælg typespørgsmål, der indeholder redigerbare svar (dvs.: Liste, Array-spørgsmål) ikke er obligatorisk, og 'shownoanswer' er sat til 1, er der et yderligere 'Intet svar' indgang vises - så deltagerne kan vælge ikke at besvare spørgsmålet. Nogle mennesker foretrækker, at dette ikke er tilgængeligt. Denne indstilling kan tilsidesættes fra globale indstillinger dialogen eller redigeres i config.php. Gyldige værdier er:
  • '0': Nej;
  • '1': Ja;
  • '2': Undersøgelsesadministratoren kan vælge.
• print hide_groupdescr_allinone: Denne indstilling er relevant for alt-i-en undersøgelser, der bruger betingelser . Når dette er sat til 'sand', skjules gruppenavnet og beskrivelsen, hvis alle spørgsmål i gruppen er skjult. Standardværdien er 'true' - skjuler gruppenavn og beskrivelse, når alle spørgsmål i gruppen er skjult af betingelser. Det kan redigeres i config.php.
• showpopups: Vis popup-meddelelser, hvis obligatoriske eller betingede spørgsmål ikke er blevet besvaret korrekt:
  • '2' = defineret af temaindstillingen (standardindstilling)
  • '1'= vis popup-besked;
  • '0'= vis besked på siden i stedet;
  • '-1'= vis slet ikke beskeden (i dette tilfælde , vil brugerne stadig se de spørgsmålsspecifikke tip, der angiver, hvilke spørgsmål der skal besvares).

Numerisk spørgsmålstype adfærd

• bFixNumAuto: Numeriske felter kan automatisk filtreres for at fjerne alle ikke-numeriske værdier. Som standard er dette aktiveret, du kan deaktivere det globalt. Disse indstillinger er relateret til Ret automatisk numerisk værdi i kernetemaindstillinger. Det blev aktiveret for Ja, deaktiveret for Kun for udtryk og Nej.
• bNumRealValue: Numeriske felter, der bruges i udtrykshåndtering, kan rettes eller ej. Det er rettet som standard. Hvis NUMERIC er et numerisk spørgsmål: deaktiver eller 0: {NUMERIC} med dårlige tegn send '' , aktiver eller 1 : {NUMERIC} send alle indtastede tegn. Disse indstillinger er relateret til Ret automatisk numerisk værdi i kernetemaindstillinger. Det var aktiveret for Ja og Kun for udtryk og deaktiveret for Nej.

Udvikling og fejlretning

• debug: Med denne indstilling sætter du PHP-fejlrapporteringen til E_ALL. Det betyder, at hver eneste notits, advarsel eller fejl, der er relateret til scriptet, vises. Denne indstilling bør kun sættes til '1', hvis du af en eller anden grund forsøger at fejlsøge programmet. Hvis du er udvikler, skal du sætte den til '2'. Sæt den ikke til '1' eller '2' i produktion, da det kan medføre afsløring af stier. Standardværdien er '0', og den kan redigeres i config.php.
• debugsql: Aktiver denne indstilling, hvis du vil vise alle SQL-forespørgsler, der er udført for scriptet, nederst på hver side. Meget nyttig til at optimere antallet af forespørgsler. For at aktivere den skal du ændre standardværdien til '1' i filen config.php.
• use_asset_manager: Som standard deaktiverer fejlretningstilstand asset manager. Du kan tillade, at asset manager bruges, selv når fejlretningstilstand er aktiveret.
• rpc_log: ^{(New in 7.9.0 )} Sæt den til true for at logge hvert RemoteControl-kald til tmp/runtime/remotecontrol.log. Hver linje indeholder den kaldte metode, dens parametre, klientens IP-adresse, varigheden og starten af svaret. Adgangskoder fjernes, sessionsnøgler erstattes af en kort hash, og lange værdier forkortes. Loggen indeholder stadig de undersøgelses-, deltager- og besvarelsesdata, der er sendt og modtaget, så aktiver den kun, mens du leder efter et problem. Standardværdien er false.

I det tilfælde, hvor du oplever en fejl i applikationen, anbefaler vi kraftigt at aktivere fejlretningsindstillingen for at få en mere detaljeret fejl, som du kan indsende sammen med fejlrapporten:

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

Hvis du arbejder på plugin og har brug for en hurtig måde at dumpe variable på skærmen: du kan bruge traceVar-funktionen. Hvis debug er indstillet: denne funktion bruger CWebLogRoute til at blive vist på HTML-siden. Brug traceVar($MyVariable)

E-mail-indstillinger

Alle indstillingerne herunder kan tilsidesættes i dialogen globale indstillinger.

• 'emailmethod: Dette bestemmer, hvordan e-mails sendes. Følgende muligheder er tilgængelige:
  • 'mail:' bruger den interne PHP-mailer;
  • 'sendmail:' bruger sendmail-maileren;
  • 'smtp:' bruger SMTP-relæ. Brug denne indstilling, når du kører LimeSurvey på en vært, der ikke er din mailserver.
• 'emailsmtphost: Hvis du bruger 'smtp' som $emailmethod, skal du angive din SMTP-server her. Hvis du bruger Google mail, kan du være nødt til at tilføje portnummeret, f.eks. $emailsmtphost = 'smtp.gmail.com:465'.
• emailsmtpuser: Hvis din SMTP-server kræver godkendelse, skal du sætte dette til dit brugernavn, ellers skal det være tomt.
• emailsmtppassword: Hvis din SMTP-server kræver godkendelse, skal du sætte dette til din adgangskode, ellers skal det være tomt.
• emailsmtpssl: Sæt dette til 'ssl' eller 'tls' for at bruge SSL/TLS til SMTP-forbindelsen.
• maxemails: Når du sender invitationer eller påmindelser til deltagere i undersøgelsen, bruges denne indstilling til at bestemme, hvor mange e-mails der kan sendes i ét parti. Forskellige webservere har forskellig e-mailkapacitet, og hvis dit script bruger for lang tid på at sende et parti e-mails, kan scriptet løbe ud i en timeout og give fejl. De fleste webservere kan sende 100 e-mails ad gangen inden for standardtidsbegrænsningen på 30 sekunder for et PHP-script. Hvis du får timeoutfejl i scriptet, når du sender store mængder e-mails, skal du reducere tallet i denne indstilling. Når du klikker på knappen 'Send invitationsmail' i værktøjslinjen til tokenstyring (ikke knappen til højre for hvert token), sendes <maxemails> invitationer. Derefter vises en liste over modtagernes adresser og en advarsel om, at der er flere e-mails i kø, end der kunne sendes i ét parti. Fortsæt med at sende e-mails ved at klikke nedenfor. Der er ### e-mails, som stadig skal sendes. sammen med en "fortsæt-knap", så du kan gå videre til næste parti. Det vil sige, at brugeren selv bestemmer, hvornår næste parti sendes, efter at hvert parti er sendt. Det er ikke nødvendigt at vente med denne skærm aktiv. Administratoren kan logge ud og komme tilbage på et senere tidspunkt for at sende næste parti invitationer.
• send_error_saving_results_email: ^{(New in 7.8.0 )} Hvis en besvarelse ikke kan gemmes, sender LimeSurvey svarene til undersøgelsens administrator i en e-mail med emnet "Error saving results". Sæt den til false for at stoppe disse e-mails. Deltagerne ser stadig fejlmeddelelsen. Standardværdien er true. Denne indstilling kan kun ændres i config.php.

Statistik og gennemgang af besvarelser

• filterout_incomplete_answers: Styrer standardadfærden for filtrering af ufuldstændige svar, når du gennemser eller analyserer besvarelser. For en gennemgang af ufuldstændige besvarelser, se vores wiki om gennemgang af undersøgelsesresultater. Da disse poster kan forvrænge statistikken, er der mulighed for at slå dette filter til eller fra i flere GUI-formularer. Parameteren kan redigeres i config.php. Følgende muligheder er tilgængelige:
  • 'all': Giver dig mulighed for at se både komplette og ufuldstændige svar;
  • 'complete': Viser kun komplette svar;
  • 'incomplete': Viser kun ufuldstændige svar.
• strip_query_from_referer_url: Denne indstilling bestemmer, om den henvisende URL gemmer parameteren eller ej. Standardværdien er 'false' (i dette tilfælde gemmer den henvisende URL alle parametre). Alternativt kan værdien sættes til 'true', og parameterdelen af den henvisende URL fjernes.
• showaggregateddata: Når den er aktiveret, vises yderligere statistiske værdier som den numeriske middelværdi og standardafvigelsen. Desuden aggregeres dataene for at give et hurtigere overblik. For eksempel lægges resultater for skala 1+2 og 4+5 sammen for at få en generel rangordning som "god" (1/2), "gennemsnit" (3) og "dårlig" (4/5). Dette påvirker kun spørgsmålstyperne "A" (5 punkts matrix) og "5" (5 punkts valg).
• PDF-eksportindstillinger: Denne funktion aktiverer PDF-eksport for printbare undersøgelser og Udskriv svar. PDF-eksportfunktionen er helt eksperimentel, og outputtet er langt fra perfekt. Desværre kan der i øjeblikket ikke gives support - hvis du vil hjælpe med at rette det, bedes du kontakte os.
  • 'pdfdefaultfont': Angiver den standardskrifttype, der bruges af PDF-eksportfunktionen. Standardværdien er 'auto'. For at ændre den skal du sætte den til en af PDF-kerneskrifttyperne.
  • 'alternatepdffontfile': Et array med sprognøgler og deres tilsvarende skrifttype. Standardskrifttypen for hvert sprog kan erstattes i filen config.php;
  • 'pdffontsize': Angiver skriftstørrelsen for normale tekster; for undersøgelsens titel er den <pdffontsize>+4, mens den for gruppetitlen er <pdffontsize>+2. Den kan redigeres i filen config.php eller i dialogen globale indstillinger.
• Grafindstilling
  • 'chartfontfile': Angiver filnavnet på den skrifttype, der bruges til at oprette de statistiske diagrammer. Filen skal ligge i mappen fonts i LimeSurvey-rodmappen. Den kan redigeres i filen config.php;
  • 'alternatechartfontfile': Et array med sprognøgler og deres tilsvarende skrifttype. Det kan redigeres i filen config.php.
• showsgqacode: Denne indstilling bruges i funktionen printbar undersøgelse og er som standard 'false. Hvis du sætter showsgqacode = 'true';, vises ID'erne for hvert spørgsmål - og svar, hvis det er relevant. Disse ID'er svarer til kolonneoverskrifterne i tabellen Lime_survey_12345, som indeholder svardataene for en bestemt undersøgelse. Disse ID'er kan bruges til en kodebog til manuelle databaseforespørgsler.

LDAP-indstillinger

Da dette er et omfattende emne, har vi flyttet LDAP-indstillinger til en anden side.

Godkendelse

Fra og med LimeSurvey 2.05 vil godkendelse blive håndteret af plugins. Som følge heraf kan oplysningerne nedenfor være forældede. Se plugins wiki for de mest opdaterede oplysninger.

Godkendelsesdelegering til webserveren

Systemadministratorer ønsker måske at få deres undersøgelsesadministratorer godkendt mod et centralt godkendelsessystem (Active Directory, openLdap, Radius, ...) i stedet for at bruge den interne LimeSurvey-database. En nem måde at gøre dette på er at konfigurere din webserver-software til at bruge dette eksterne godkendelsessystem og derefter bede LimeSurvey om at stole på den brugeridentitet, som webserveren rapporterer. For at aktivere denne funktion skal du:

• aktivere pluginet Webserver under Konfiguration > Plugins og angive den servernøgle, der indeholder brugernavnet (standard: REMOTE_USER), i plugin-indstillingerne;
• aktivere godkendelse på webserversiden.

Bemærk venligst, at:

• LimeSurvey så vil omgå sin egen godkendelsesproces (ved at bruge login-navnet rapporteret af webserveren uden at bede om en adgangskode);
• dette kan kun erstatte LimeSurvey GUI-godkendelsessystemet, 'ikke undersøgelsesinvitationssystemet' (deltagergrænseflade).

Godkendelsesdelegering uden automatisk brugerimport

Bemærk venligst, at Authentication Delegation ikke omgår LimeSurvey-autorisationssystemet som standard - hvilket betyder, at selvom du ikke skal administrere adgangskoder i LimeSurvey, skal du stadig definere brugerne i LimeSurvey-databasen og tildele dem det korrekte sæt af rettigheder for at give dem adgang til administrationspanelet.

En bruger får kun adgang til LimeSurvey, hvis og kun hvis:

• brugeren er blevet godkendt af webserveren;
• brugerens loginnavn er defineret som en bruger i LimeSurvey-brugerdatabasen (brugeren får derefter de rettigheder, som brugeren i LimeSurvey-brugerdatabasen har);
• brugeren har den globale tilladelse Bruge webserver godkendelse.

Godkendelsesdelegering med automatisk brugerimport

Når du administrerer en stor brugerdatabase, er det nogle gange nemmere at importere brugere automatisk til LimeSurvey-databasen:

• auth_webserver_autocreate_user: Hvis den er sat til 'true', forsøger LimeSurvey automatisk at importere brugere, der er godkendt af webserveren, men som endnu ikke findes i brugerdatabasen.
• auth_webserver_autocreate_profile: Et array, der beskriver standardprofilen, som tildeles brugeren: det fulde (falske) navn, e-mail og sprog.
• auth_webserver_autocreate_permissions: Et array med de globale tilladelser, som tildeles brugeren.

Hvis du vil tilpasse brugerprofilen, så den matcher den loggede bruger, skal du udvikle en simpel funktion kaldet hook_get_auth_webserver_profile i config.php - med denne funktion kan du fra en central brugerkontodatabase (for eksempel et LDAP-katalog) hente det rigtige fulde navn, e-mail og sprog for en bestemt bruger.

Funktionen hook_get_auth_webserver_profile tager brugerens loginnavn som eneste argument og kan returnere:

• False eller et tomt array - i dette tilfælde nægtes brugeren adgang til LimeSurvey;
• et array, der indeholder de samme poster som auth_webserver_autocreate_profile.

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

  Den valgfrie 'hook_get_auth_webserver_profile'-funktion er kun til avanceret brugerbrug! For yderligere detaljer, læs venligst kommentarerne fra filen config-defaults.php.

Brugernavnstilknytning

I det tilfælde, hvor nogle brugere har et eksternt brugernavn, der er forskelligt fra deres LimeSurvey-brugernavn, kan det være nyttigt at bruge en brugernavnstilknytning. Dette gøres i LimeSurvey ved at bruge parameteren auth_webserver_user_map. Forestil dig for eksempel, at du ikke har et 'admin'-brugernavn defineret i din eksterne godkendelsesdatabase. Derefter, for at logge ind på LimeSurvey som admin, skal du tilknytte dit eksterne brugernavn (lad os kalde det 'mitnavn') til admin-loginnavnet i LimeSurvey. Den tilsvarende opsætning er:

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

Efter en vellykket godkendelse med 'mitnavn'-login og webserver-adgangskode, vil du blive direkte autoriseret til at bruge LimeSurvey som 'admin'-bruger.

Dette har alvorlige sikkerhedsmæssige konsekvenser, så brug det med omtanke. Beskyt også din config.php mod skriveadgang fra webserveren.

Brug engangsadgangskoder

En bruger kan åbne LimeSurvey login-siden på default.com/limesurvey/admin og indtaste brugernavnet og engangsadgangskoden, som tidligere blev skrevet ind i brugertabellen (kolonne one_time_pw) af en ekstern applikation.

Denne indstilling skal være slået til config.php-filen for at muliggøre brugen af engangsadgangskoder (standard = falsk).

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

Yderligere oplysninger kan findes i "Administrer brugere" sektion.

Krypteringsindstillinger

  Når krypteringsnøglerne er indstillet, bør de aldrig ændres, ellers kan alle krypterede data gå tabt!

Ved opdatering eller installation, blev disse parametre genereret af LimeSurvey og sat i application/config/security.php fil. Du kan flytte disse indstillinger i config.php, hvis du vil, eller lade være i security.php.

Se datakryptering for detaljer om denne funktion.

• encryptionkeypair
• encryptionpublickey
• encryptionsecretkey
• encryptionnonce
• encryptionsecretboxkey

Avancerede url-indstillinger

• publicurl: Dette bør angives som URL-placeringen af dine 'offentlige scripts'. De offentlige scripts er dem, der ligger i mappen "limesurvey" (eller hvad du nu har kaldt den mappe, som alle de andre scripts og mapper ligger i). Denne indstilling findes i config.php, og den bruges, når LimeSurvey har brug for en absolut URL (for eksempel når token-e-mails sendes).
• tempurl: Dette bør angives som URL-placeringen af din mappe "/limesurvey/tmp" - eller en mappe, som LimeSurvey skal bruge til at levere midlertidige filer.
• uploadurl: Dette bør angives som URL-placeringen af din mappe "/limesurvey/upload" - eller en mappe, som LimeSurvey skal bruge til at levere uploadede filer. Dette giver dig mulighed for at placere uploadede filer på et andet URL-domæne.

Avancerede stiindstillinger

• homedir: Dette bør indstilles til den fysiske diskplacering af dine administrationsscripts - for eksempel "/home/usr/htdocs/limesurvey/admin". Tilføj ikke en afsluttende skråstreg til denne post. Standardindstillingen i config.php forsøger at finde rodstien til alle dine dokumenter ved hjælp af php-variablen {$_SERVER['DOCUMENT_ROOT']}. I de fleste tilfælde kan du lade denne være og blot ændre resten af denne streng, så den matcher det mappenavn, du har lagt LimeSurvey-scripts i.
• publicdir: Dette bør indstilles til den fysiske diskplacering af dine 'offentlige scripts'.
• tempdir: Dette bør indstilles til den fysiske diskplacering af din /limesurvey/tmp-mappe, så scriptet kan læse og skrive filer.
• uploaddir: Dette bør indstilles til den fysiske diskplacering af din /limesurvey/upload-mappe, så scriptet kan læse og skrive filer.
• sCKEditorURL: URL til CKEditor-scriptet.

Andre avancerede indstillinger

Upload filer

• magic_database: Tillader brug af en anden MIME-database til finfo_open. Kan kun opdateres i filen config.php. Eksempel: /usr/share/misc/magic.mgc til redhat-baseret linux.
• magic_file: Tillader brug af en anden fil til at hente matrixen med filtypenavne efter MIME-type end den medfølgende. Skal være en PHP-fil, der returnerer en matrix. Kan kun opdateres i filen config.php.

Opdatering

• updatable: Denne indstilling er i version.php. Kan være sandt eller falsk. Hvis du indstiller til sand : når en superadministrator bruger logger ind : LimeSurvey kontrollerer, om en opdatering er tilgængelig, og viser dig en advarsel. Hvis indstillet til falsk: ingen kontrol udføres, og du kan ikke bruge ComfortUpdate.

Tokens

• allowedcharacters_pattern_token : Disse indstillinger gør det muligt at angive regexp-mønsteret, når token filtreres.