Optional settings/da

Det følgende afsnit er rettet til dem af jer, der gerne vil redigere de konfigurationsindstillinger, der ikke kunne ændres ved hjælp af GUI (Graphical User Interface) i LimeSurvey-installationen. Vær venligst opmærksom på, at alle ændringer fra LimeSurvey-rodmappen sker på egen risiko. Ikke desto mindre, hvis du oplever problemer/har brug for yderligere vejledning, skal du deltage i diskussionsfora eller IRC kanal for 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(
 ....
 ),
 ),

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 har brug for at opdatere sessionsindstillinger for at have flere LimeSurvey-forekomster kørende på den samme server, skal du kontrollere, om du ikke skal opdatere request settings for crsf-cookie.

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',
 ),
 ),

Hvis du har flere installationer på den samme server, kan det være hurtigere og nemmere at indstille forskellige sessionsnavne for hver LimeSurvey-instans. Dette kan være nødvendigt for IE11 i en eller anden tilstand (se issue 12083)

 // Indstil navnet på sessionen
 'session' => array (
 'sessionName' => "LimeSurveyN1",
 ),

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 LimeSurvey-anmodningsindstillingernes konfiguration ændres på følgende måde (på eget ansvar) :

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

 // Håndhæv en bestemt URL-base 
 'request' => array(
 'hostInfo' => 'http://www.example.org/' 
 ),

 // Indstil cookie-domænenavnet og stien til CSRF-beskyttelse, stien bruges hvis du har en anden instans på samme domæne
 '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 ^{(New in 3.24.3 )}

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.

Tillad sessionstart i iframe

Sessionen skal være sikker (gyldig https), httponly og samesite to None. Alle indstillinger skal indstilles til alle 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

Samme som session: skal være sikker og samesite indstillet til Ingen. Hele arrayet skal tilføjes 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: Filen gemmes som standard til <code>limesurvey/tmp/runtime/application.log</code> , som er placeret i LimeSurvey-rodmappen.

  Yii bruger runtime-sti. Som standard er logfilerne tilgængelige på 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 indstille det i ruter eller ved at opdatere Runtime-sti.

.

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.

Ressourcer

• sessionlifetime: Definerer tiden i sekunder, hvorefter en undersøgelsessession udløber. Det gælder kun, hvis du bruger databasesessioner. Hvis du bruger databasesessioner, skal du ændre parameteren i config.php eller tilsidesætte standardværdien fra dialogboksen globale indstillinger.
• memorylimit: Dette bestemmer, hvor meget hukommelse LimeSurvey kan få adgang. '128 MB' er det anbefalede minimum (MB=Megabyte). Hvis du modtager timeout-fejl eller har problemer med at generere statistik eller eksportere filer, skal du hæve denne grænse til '256 MB' eller højere. Hvis din webserver har sat en højere grænse i config.php, vil denne indstilling blive ignoreret.

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 indstiller du PHP-fejlrapporteringen til E_ALL. Det betyder, at hver lille meddelelse, advarsel eller fejl relateret til scriptet vises. Denne indstilling bør kun skiftes til '1', hvis du forsøger at fejlsøge programmet af en eller anden grund. Hvis du er en udvikler, skal du skifte til '2'. Skift det ikke til '1' eller '2' i produktionen, da det kan forårsage afsløring af stien. Standardværdien er '0' og den kan redigeres i config.php.
• debugsql: Aktiver denne indstilling, hvis du ønsker at vise alle SQL-forespørgsler udført for scriptet nederst på hver side. Meget nyttig til optimering af antallet af forespørgsler. For at aktivere det, skal du ændre standardværdien til '1' fra config.php-filen.
• use_asset_manager: Som standard: debug mode deaktiver asset manager, du kan tillade dig at bruge asse manager med debug-tilstand aktiveret.

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 indstillinger fra neden kan tilsidesættes i dialogen globale indstillinger.

• 'emailmethod: Dette bestemmer, hvordan e-mails sendes. Følgende muligheder er tilgængelige:
  • 'mail:' den bruger intern PHP-mailer;
  • 'sendmail:' den bruger sendmail-mailer;
  • 'smtp:' den 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 , så skal du sætte din SMTP-server her. Hvis du bruger Google mail, skal du muligvis tilføje portnummeret som $emailsmtphost = 'smtp.gmail.com:465'.
• emailsmtpuser: Hvis din SMTP-server har brug for godkendelse, skal du indstille dette til din brugernavn, ellers skal det være tomt.
• emailsmtppassword: Hvis din SMTP-server har brug for godkendelse, så sæt dette til dit password, ellers skal det være tomt.
• emailsmtpssl: Indstil dette til 'ssl' eller 'tls' for at bruge SSL/TLS til SMTP-forbindelse.
• maxemails: Når du sender invitationer eller påmindelser til undersøgelsesdeltagere, bruges denne indstilling til at bestemme, hvor mange e-mails der kan sendes i en flok. Forskellige webservere har forskellige e-mail-kapaciteter, og hvis dit script tager for lang tid at sende en masse e-mails, kan scriptet time-out og forårsage fejl. De fleste webservere kan sende 100 e-mails ad gangen inden for standardtiden på 30 sekunder for et PHP-script. Hvis du får script-timeout-fejl, når du sender et stort antal e-mails, skal du reducere antallet i denne indstilling. Ved at klikke på knappen 'send e-mail-invitation' fra tokenkontrolværktøjslinjen (ikke knappen placeret til højre for hvert token) sendes<maxemails> antal invitationer, så viser den en liste over modtagernes adresser og en advarsel om, at der er flere e-mails afventende, end der kunne sendes i én batch. Fortsæt med at sende e-mails ved at klikke nedenfor. Der er ### e-mails, der stadig skal sendes. og giver en "fortsæt-knap" for at fortsætte med næste batch. Dvs. brugeren bestemmer, hvornår den næste batch skal sendes, efter at hver batch er blevet e-mailet. Det er ikke nødvendigt at vente med denne skærm aktiv. Administratoren kunne logge ud og komme tilbage på et senere tidspunkt for at sende den næste batch af invitationer.

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.