Actions

Theme editor/da: Difference between revisions

From LimeSurvey Manual

(Created page with "Hvis du vil have en sprogspecifik sætning i en undersøgelse, for eksempel hjælp i slutningen af hver side, kan du tilføje en .pstl-fil til en sætning og skjule den for de...")
(Created page with "===checkbox-text-item=== {|class=wikitable !'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer''' |- |multiplechoice_with_comments|| P || li |- |multiplechoice|| M || l...")
 
(41 intermediate revisions by the same user not shown)
Line 855: Line 855:
Hvis du vil have en sprogspecifik sætning i en undersøgelse, for eksempel hjælp i slutningen af hver side, kan du tilføje en .pstl-fil til en sætning og skjule den for det andet sprog. Hvis vi skjuler det i template.css, kan vi bruge pseudovælgeren :lang, men vi bruger en eller anden klasse for bedre kompatibilitet.
Hvis du vil have en sprogspecifik sætning i en undersøgelse, for eksempel hjælp i slutningen af hver side, kan du tilføje en .pstl-fil til en sætning og skjule den for det andet sprog. Hvis vi skjuler det i template.css, kan vi bruge pseudovælgeren :lang, men vi bruger en eller anden klasse for bedre kompatibilitet.


Below, there are two help sentences, in French and English. Put this on endpage.pstpl:
Nedenfor er der to hjælpesætninger på fransk og engelsk. Læg dette på endpage.pstpl:


<syntaxhighlight lang="php"><div class="fr" lang="fr">Pour de l'aide en direct appelez le 000000</div>
<syntaxhighlight lang="php"><div class="fr" lang="fr">Pour de l'aide en direct appelez le 000000</div>  
<div class="en" lang="en">For some help, please call 000000</div></syntaxhighlight>
<div class="en" lang="en"> For lidt hjælp, ring venligst på 000000</div></syntaxhighlight>


and in template.css:
og i template.css:


<syntaxhighlight lang="php">.lang-fr .en{display:none}
<syntaxhighlight lang="php">.lang-fr .en{display:none}
.lang-en .fr{display:none}</syntaxhighlight>
.lang-en .fr{display:none}</syntaxhighlight>


===Change the layout of the survey page===
===Skift layoutet på undersøgelsessiden===


After editing and saving a template, it applies to a survey list page only if it is selected from the settings of the survey. To make it the default template, go under the '''General tab''' located in the '''Global settings''' of your LimeSurvey installation and choose the desired template. From this point on, all the templates that use the "default" option as template, plus the ones that are going to be newly created, will use the newly selected default template.
Efter at have redigeret og gemt en skabelon, gælder den kun for en undersøgelseslisteside, hvis den er valgt fra undersøgelsens indstillinger. For at gøre det til standardskabelonen skal du gå under fanen '''Generelt''' i '''Globale indstillinger''' i din LimeSurvey-installation og vælge den ønskede skabelon. Fra dette tidspunkt vil alle skabeloner, der bruger "standard"-indstillingen som skabelon, plus dem, der skal oprettes for nylig, bruge den nyligt valgte standardskabelon.


To use your current template for this page, you must change the appropriate setting from '''Global settings'''. In older versions, this change can be done by editing the $defaulttemplate setting from the config file: copy this setting from config-defaults.php to config.php which overrides config-defaults.php and edit this setting to <code lang="html">$defaulttemplate = 'yourtemplatename';</code>.
For at bruge din nuværende skabelon til denne side, skal du ændre den relevante indstilling fra '''Globale indstillinger'''. I ældre versioner kan denne ændring udføres ved at redigere $defaulttemplate indstillingen fra config filen: kopier denne indstilling fra config-defaults.php til config.php, som tilsidesætter config-defaults.php og rediger denne indstilling til <code lang="html">$defaulttemplate = 'yourtemplatename';</code> .


===Import/Export of templates: Mac users===
===Import/eksport af skabeloner: Mac-brugere===


<u>Mac users</u>, please note that the Mac OSX default archive utility may have problems with zip folders "generated on the fly".
<u>Mac-brugere</u> , bemærk venligst, at Mac OSX-standardarkiveringsværktøjet kan have problemer med zip-mapper "genereret i farten".


A workaround is to unix'es unzip from the command line:
En løsning er at pakke unix'er ud fra kommandolinjen:


$ unzip template.zip -d template
$ unzip template.zip -d skabelon


Archive: template.zip
Arkiv: template.zip


 inflating: template/startpage
oppustning: skabelon/startside


 inflating: ...
oppustning:...


Another workaround is to use scripts in their mac-compiled counterparts.
En anden løsning er at bruge scripts i deres mac-kompilerede modstykker.


===Use the same template with different logos===
===Brug den samme skabelon med forskellige logoer===


If you want to use the same template for all surveys and just want to change the logo for each survey, you can use the {SID} placeholder in the template .pstpl file and thereby refer to different images:
Hvis du vil bruge den samme skabelon til alle undersøgelser og blot vil ændre logoet for hver undersøgelse, kan du bruge pladsholderen {SID} i skabelonen .pstpl-fil og derved henvise til forskellige billeder:


<syntaxhighlight lang="php"><img src="{TEMPLATEURL}files/logoImage-{SID}.png"></syntaxhighlight>
<syntaxhighlight lang="php"><img src="{TEMPLATEURL}files/logoImage-{SID}.png"></syntaxhighlight>


=== Display custom favicon===
=== Vis tilpasset favicon===


A favicon is the little icon you see in the browser's address bar, list of bookmarks or tab. You can display your own icon as follows:
Et favicon er det lille ikon, du ser i browserens adresselinje, liste over bogmærker eller fane. Du kan vise dit eget ikon som følger:
#Create a favicon - You can use Google to find lots of free favicon generators.
#Opret et favicon - Du kan bruge Google til at finde masser af gratis favicon-generatorer.
#Name your new favicon "favicon.ico" and place it in your template /files directory.
#Navngiv dit nye favicon "favicon.ico" og placer det i din skabelon /filer mappe.
#Add the following code to your '''startpage.pstpl''' before the </head> tag.
#Tilføj følgende kode til din '''startpage.pstpl''' før</head> tag.


<syntaxhighlight lang="html4strict"><link rel="shortcut icon" href="{TEMPLATEURL}files/favicon.ico" type="image/x-icon">
<syntaxhighlight lang="html4strict"><link rel="shortcut icon" href="{TEMPLATEURL}files/favicon.ico" type="image/x-icon">  
<link rel="icon" href="{TEMPLATEURL}files/favicon.ico" type="image/x-icon"></syntaxhighlight>
<link rel="icon" href="{TEMPLATEURL}files/favicon.ico" type="image/x-icon"></syntaxhighlight>


=== Different appearance for survey-/question-pages===
=== Anderledes udseende for undersøgelses-/spørgsmålssider===


If you want LimeSurvey to change the appearance of every second page (i.e., even and odd survey pages), you can use '''.page-odd''' class in your CSS file to change the appearance of odd pages.
Hvis du ønsker, at LimeSurvey skal ændre udseendet af hver anden side (dvs. lige og ulige undersøgelsessider), kan du bruge klassen '''.page-odd''' i din CSS-fil til at ændre udseendet af ulige sider.


An example from default template of LimeSurvey 1.91+:
Et eksempel fra standardskabelonen til LimeSurvey 1.91+:


<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
.page-odd table.question-group {
.side-ulige tabel.spørgsmålsgruppe {
 background-color: #D2F2D3;
baggrundsfarve: #D2F2D3;
}</syntaxhighlight>
}</syntaxhighlight>


If you do '''not''' want differentiate even and odd pages, find all instances of ''.page-odd'' in template.css and remove those styles.
Hvis du '''ikke''' ønsker at skelne lige og ulige sider, skal du finde alle forekomster af ''.side-ulige'' i template.css og fjerne disse typografier.


===Create a vertical separator border for dual scale array===
===Opret en lodret separatorramme for dobbeltskala-array===


To create a vertical separator border for a dual scale array, you can add the following lines to your '''template.css'''-file.
For at oprette en lodret adskillelsesramme for et dobbeltskala-array, kan du tilføje følgende linjer til din '''template.css'''-fil.


<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
Line 924: Line 924:
table.question tbody td.dual_scale_separator
table.question tbody td.dual_scale_separator
{
{
   border-right:solid 1px #00A8E1;
border-right:solid 1px #00A8E1;
}
}
</syntaxhighlight>
</syntaxhighlight>


''header_separator'' is used to adress the separator for the header "td". The "dual_scale_separator" is used to address the separator column in the dual scale array.
''header_separator'' bruges til at adressere separatoren for overskriften "td". "dual_scale_separator" bruges til at adressere separatorkolonnen i dobbeltskala-arrayet.


===Adding your own logo to the survey list===  
===Tilføjelse af dit eget logo til undersøgelseslisten===  


# First please open the theme editor for the theme you like to use. [[File:OpenThemeEditor.jpg]]
# Åbn først temaeditoren for det tema, du kan lide at bruge. [[File:OpenThemeEditor.jpg]]
# We recommend to use fruity, it is our best theme currently.  
# Vi anbefaler at bruge frugtagtig, det er vores bedste tema i øjeblikket.  
# Then extend the theme and give it a name you will recognize. [[File:ExtendTheme.jpg]]
# Udvid derefter temaet og giv det et navn, du vil genkende. [[File:ExtendTheme.jpg]]
# In the following view you may upload the logo you want to use. [[File:UploadFileTheme.jpg]]
# I den følgende visning kan du uploade det logo, du vil bruge. [[File:UploadFileTheme.jpg]]
# Select the editor screen `Survey List´ in the Screen dropdown in the top right corner. [[File:OpenScreenSurveyList.jpg]]
# Vælg redigeringsskærmen `Survey List' i rullemenuen Skærm i øverste højre hjørne. [[File:OpenScreenSurveyList.jpg]]
# Then select `layout_survey_list.twig´ in the left side menu. [[File:EditLayoutSurveyListTwig.jpg]]
# Vælg derefter `layout_survey_list.twig´ i menuen til venstre. [[File:EditLayoutSurveyListTwig.jpg]]
# In the editor scroll to line 126 and change the marked part to the filename of the image you uploaded to the theme before. [[File:ChangeSurveyListHeaderImageEditor.jpg]]
# Rul i editoren til linje 126 og skift den markerede del til filnavnet på det billede, du uploadede til temaet før. [[File:ChangeSurveyListHeaderImageEditor.jpg]]
# Save your file. [[File:ThemeEditorSaveChanges.jpg]]
# Gem din fil. [[File:ThemeEditorSaveChanges.jpg]]
# Change default theme to your extended theme. [[File:ChangeDefaultTheme.jpg]]
# Skift standardtema til dit udvidede tema. [[File:ChangeDefaultTheme.jpg]]


=== Align logo to the centre of the survey page===
=== Juster logoet til midten af undersøgelsessiden===
This example is for the "extends_fruity" template. For other templates the required CSS may be different.
Dette eksempel er til "extends_fruity" skabelonen. For andre skabeloner kan den påkrævede CSS være anderledes.
# Login to the LimeSurvey admin area
# Log ind på LimeSurvey-administrationsområdet
# Browse to the theme editor: Configuration > Themes
# Gå til temaeditoren: Konfiguration > Temaer
# Find "LimeSurvey Fruity Theme" in the list and click the "Theme Editor" button
# Find "LimeSurvey Fruity Theme" på listen, og klik på " Theme Editor"-knap
# Click "custom.css" in the files list on the left at near the bottom of the page
# Klik på "custom.css" i fillisten til venstre nederst på siden
# Copy the following CSS into that file and press "Save Changes"
# Kopier følgende CSS ind i den fil, og tryk på "Gem ændringer"


<syntaxhighlight lang="css">
<syntaxhighlight lang="css">
.navbar-fixed-top > div.navbar-header {
.navbar-fixed-top > div.navbar-header {
    width: 100% !important;
bredde: 100 % !vigtigt;
}
}


.navbar-fixed-top > div.navbar-header > div {
.navbar-fixed-top > div.navbar-header > div {
    width: 100% !important;
bredde: 100 % !vigtigt;
}
}


.navbar-fixed-top > div.navbar-header > div > img {
.navbar-fixed-top > div.navbar-header > div > img {
    margin: 0 auto 0 auto !important;
margin: 0 auto 0 auto !vigtigt;
}
}
</syntaxhighlight>
</syntaxhighlight>
Line 966: Line 966:




==Custom question views {{NewIn|3.0}}==  
==Tilpassede spørgsmålsvisninger {{NewIn|3.0}}==  


<div class="simplebox">'''Note:''' This is a temporary feature to be replaced in the future by question object (it will be very easy to move custom views to question object). It is disabled by default.</div>
<div class="simplebox">'''Bemærk:''' Dette er en midlertidig funktion, der i fremtiden skal erstattes af spørgsmålsobjekt (det vil være meget nemt at flytte tilpassede visninger til spørgsmålsobjekt). Den er som standard deaktiveret.</div>


As of version 2.5, you can create template-specific custom views for questions and some of their incorporated elements. This is useful if you want to modify the HTML layout of a particular question type for one or more surveys.
Fra version 2.5 kan du oprette skabelonspecifikke brugerdefinerede visninger til spørgsmål og nogle af deres indbyggede elementer. Dette er nyttigt, hvis du ønsker at ændre HTML-layoutet for en bestemt spørgsmålstype for en eller flere undersøgelser.


*In application/config/config.php, find 'config'=>array and add this line to the array : 'allow_templates_to_overwrite_views'=>1
*I application/config/config.php, find 'config'=>array og tilføj denne linje til arrayet: 'allow_templates_to_overwrite_views'=>1
*In /{your_template}/config.xml, set "overwrite_question_views" to true
*I /{your_template}/config.xml, sæt "overwrite_question_views" til true
*Copy application/views/survey/* to template/{your_view_directory}/survey/
*Kopiér application/views/survey/* til template/{your_view_directory}/survey/
*Note that you only need to copy the files that you intend to modify but the file structure must remain the same as in application/views/survey/
*Bemærk, at du kun behøver at kopiere de filer, du har til hensigt at ændre, men filstrukturen skal forblive den samme som i applikation/visninger/undersøgelse/


==Insert custom CSS or JavaScript files for template==  
==Indsæt tilpassede CSS- eller JavaScript-filer til skabelon==  


As of version 2.50, you can use the config.xml File to Automatically Load Plugin Files.
Fra version 2.50 kan du bruge filen config.xml til automatisk at indlæse plugin-filer.


*Upload your files to the template /css or /scripts folder
*Upload dine filer til skabelonen /css eller /scripts mappen
*In /{your_template}/config.xml, add the file paths to the <css> or <js> blocks, something like this:<syntaxhighlight lang="xml"><css>
*I /{din_skabelon}/config.xml skal du tilføje filstierne til<css> eller<js> blokke, noget som dette:<syntaxhighlight lang="xml"><css>  
<filename>css/jquery-ui-custom.css</filename>
<filename> css/jquery-ui-custom.css</filename>  
<filename>css/bootstrap-slider.css</filename>
<filename> css/bootstrap-slider.css</filename>


<filename>css/awesome-bootstrap-checkbox/awesome-bootstrap-checkbox.css</filename>
<filename>css/awesome-bootstrap-checkbox/awesome-bootstrap-checkbox.css</filename>  
<filename>css/flat_and_modern.css</filename>
<filename> css/flat_and_modern.css</filename>


<filename>css/template.css</filename>
<filename>css/skabelon.css</filename>


<filename>css/myCustomPlugin.css</filename>
<filename>css/myCustomPlugin.css</filename>  
</css>
</css>  
<js>
<js>  
<filename>scripts/template.js</filename>
<filename> scripts/template.js</filename>  
<filename>scripts/bootstrap-slider.js</filename>
<filename> scripts/bootstrap-slider.js</filename>


<filename>scripts/myCustomPlugin.js</filename>
<filename>scripts/myCustomPlugin.js</filename>  
</js>
</js>  
</syntaxhighlight>
</syntaxhighlight>


==Class definitions (for Developers)==
==Klassedefinitioner (for udviklere)==


===answer-list===
===answer-list===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
|arrays/5point || A || tr
|arrays/5point || A || tr
|-
|-
Line 1,013: Line 1,013:
|arrays/array || F || tr
|arrays/array || F || tr
|-
|-
|arrays/column || H || tr and col
|arrays/kolonne || H || tr og col
|-
|-
|arrays/dualscale || 1 || tr
|arrays/dualscale || 1 || tr
|-
|-
|arrays/increasesamedecrease || E || tr
|arrays/forøg sammereducering || E || tr
|-
|-
|arrays/yesnouncertain || C || tr
|arrays/yesnouncertain || C || tr
|-
|-
|gender || G || div and ul
|køn || G || div og ul
|-
|-
|list_with_comment || O || div
|liste_med_kommentar || O || div
|-
|-
|ranking || R || ul and div
|rangering || R || ul og div
|-
|-
|yesno || Y || ul and div
|yesno || Y || ul og div
|-
|-
|ranking_advanced || R || ul and div
|ranking_avanceret || R || ul og div
|-
|-
|listradio || L || div
|listradio || L || div
|-
|-
|5pointchoice || 5 || ul
|5pointvalg || 5 || ul
|-
|-
|multiplechoice || M || div
|multiplechoice || M || div
Line 1,040: Line 1,040:




===radio-list===
===radio-liste===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
| yesno || Y || ul
| ja nej || Y || ul
|-
|-
|gender || G || ul
|køn || G || ul
|-
|-
|arrays/yesnouncertain || C || tr
|arrays/yesnouncertain || C || tr
|-
|-
|arrays/increasesamedecrease || E || tr
|arrays/forøg sammereducering || E || tr
|-
|-
|arrays/dualscale || 1 || tr
|arrays/dualscale || 1 || tr
|-
|-
|arrays/5point || A || table and tr
|arrays/5point || A || tabel og tr
|-
|-
|arrays/10point || B || tr
|arrays/10point || B || tr
Line 1,060: Line 1,060:
|arrays/array || F || tr
|arrays/array || F || tr
|-
|-
|arrays/column || H || col
|arrays/kolonne || H || col
|-
|-
|listradio || L || div
|listradio || L || div
|-
|-
|list_with_comment || O || div followed by ul
|liste_med_kommentar || O || div efterfulgt af ul
|-
|-
|}
|}
Line 1,070: Line 1,070:
===radio-item===
===radio-item===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
|arrays/yesnouncertain || C || td
|arrays/yesnouncertain || C || td
|-
|-
|5pointchoice || 5 || li
|5pointvalg || 5 || li
|-
|-
|arrays/10point || B || td
|arrays/10point || B || td
Line 1,082: Line 1,082:
|arrays/array || F || td
|arrays/array || F || td
|-
|-
|arrays/column || H || td
|arrays/kolonne || H || td
|-
|-
|arrays/dualscale || 1 || td
|arrays/dualscale || 1 || td
|-
|-
|arrays/increasesamedecrease || E || td
|arrays/forøg sammereduktion || E || td
|-
|-
|gender || G || li
|køn || G || li
|-
|-
|listradio || L || li
|listradio || L || li
|-
|-
|yesno || Y || li
|ja nej || Y || li
|-
|-
|listradio || L || li and div
|listradio || L || li og div
|-
|-
|image_select-listradio || L || li and div
|image_select-listradio || L || li og div
|-
|-
|list_with_comment || 0 || li
|liste_med_kommentar || 0 || li
|-
|-
|}
|}


===list-group===
===liste-gruppe===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|janej || Y || ul
|-
|-
|yesno || Y || ul
|5pointvalg || 5 || ul
|-
|-
|5pointchoice || 5 || ul
|køn || G || ul
|-
|-
|gender || G || ul
|rangering || R || ul
|-
|-
|ranking || R || ul
|ranking_avanceret || R || ul og div
|-
|-
|ranking_advanced || R || ul and div
|question_index_group_buttons || || div
|-
|-
|question_index_group_buttons ||  || div
|question_index_questions_buttons || || div
|-
|question_index_questions_buttons || || div
|-
|-
|}
|}


===list-group-horizontal===
===liste-gruppe-horisontal===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer''' ! N!|-
|janej || Y || ul
|-
|-
|yesno || Y || ul
|5pointvalg || 5 || ul
|-
|-
|5pointchoice || 5 || ul
|køn || G || ul
|-
|gender || G || ul
|-
|-
|}
|}


===list-unstyled===
===liste-unstyled===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
|list_with_comment || 0 || ul
|liste_med_kommentar || 0 || ul
|-
|-
|listradio|| L || ul
|listradio|| L || ul
Line 1,150: Line 1,149:
|multipleshorttext|| Q || ul
|multipleshorttext|| Q || ul
|-
|-
|ranking|| R || ul
|rangering|| R || ul
|-
|-
|ranking_advanced|| R || ul
|ranking_avanceret|| R || ul
|-
|-
|bootstrap_buttons_multi|| M || ul
|bootstrap_buttons_multi|| M || ul
Line 1,160: Line 1,159:
|inputondemand/multipleshorttext || Q || ul
|inputondemand/multipleshorttext || Q || ul
|-
|-
|register_error|| || ul
|register_fejl|| || ul
|-
|-
|register_message|| || ul
|register_meddelelse|| || ul
|-
|-
|layout_survey_list || || ul
|layout_survey_list || || ul
|-
|-
|load|| || ul
|load|| || ul
|-
|-
|save|| || ul
|gem|| || ul
|-
|-
|captcha|| || ul
|captcha|| || ul
|-
|-
|}
|}
Line 1,176: Line 1,175:
===select-list===
===select-list===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|rangering|| R || ul
|-
|-
|ranking|| R || ul
|ranking_avanceret|| R || ul
|-
|ranking_advanced|| R || ul
|-
|-
|}
|}
Line 1,186: Line 1,185:
===checkbox-item===
===checkbox-item===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
|multiflexi (Array numbers)|| : || td
|multiflexi (matrixnumre)|| : || td
|-
|-
|multiplechoice|| M || li
|multiplechoice|| M || li
Line 1,196: Line 1,195:
|image_select-listradio|| L || li
|image_select-listradio|| L || li
|-
|-
|image_select-multiplechoice|| M || li and div
|image_select-multiplechoice|| M || li og div
|-
|-
|navigator|| || span
|navigator|| || span
|-
|-
|}
|}
Line 1,204: Line 1,203:
===checkbox-text-item===
===checkbox-text-item===
{|class=wikitable  
{|class=wikitable  
!'''Question'''!!'''Question Type'''!!'''elements'''  
!'''Spørgsmål'''!!'''Spørgsmålstype'''!!'''elementer'''  
|-
|-
|multiplechoice_with_comments|| P || li
|multiplechoice_with_comments|| P || li

Latest revision as of 14:08, 29 December 2023

Introduktion

LimeSurvey har et avanceret tema- og stilsystem, der giver udviklere en effektiv måde at tilpasse undersøgelsens udseende. Siden LS3 er udtrykket "skabeloner" blevet erstattet med udtrykket "temaer". Temaer tillader kontrol over stilen på siderne i en undersøgelse. En undersøgelsesadministrator kan vælge et standardtema, der vil blive brugt til hver undersøgelse for yderligere at personliggøre den. Temaer kommer med muligheder, der giver en administrator uden kodefærdigheder en enkel måde at tilføje et logo på velkomstsiden, ændre baggrundsfarverne, vælge en skrifttype osv.


LimeSurvey kommer med 3 temaer. Disse indledende temaer er defineret af mapper placeret i LimeSurvey installationen "themes/survey/" bibliotek. Hvert tema har sin egen mappe. I hovedbiblioteket for et tema finder du en konfigurationsfil i XML og adskillige mapper, der indeholder visningerne temaer (.twig), cascading style sheets (.css), 'scripts, billeder ('.jpg eller .png), og måske andre.


Siden LimeSurvey 2.50 bruger temamotoren Bootstrap 3 som CSS-ramme. Da Bootstrap 3 er en standardramme, vil udviklere finde en masse dokumentation, tutorials og forumtråde om det på internettet.


Siden LimeSurvey 3 bruger temamotoren Twig, så temaudviklerne kan ændre logikken i undersøgelsesgengivelsen på en sikker og nem måde. Twig erstatter det gamle system med erstatningssøgeord, der blev brugt i de tidligere versioner. Logikken, der blev brugt til at generere HTML-koden for søgeordene, er nu tilgængelig i temaets visninger.


Uddrag fra Vanilla Theme:

 <div class="{{ aSurveyInfo.class.answercontainer }} col-xs-12" {{ aSurveyInfo.attr.answercontainer }}> 
 {# BEMÆRK: Hvis du vil tilpasse gengivelsen af spørgsmålet, skal du bruge et spørgsmålstema #}
 {{ aQuestion.answer |  }}
</div>

Temaer, som er HTML og Twig-kode, har en tendens til at definere placeringen og typen af tekst, der skal vises, og lignende strukturelle funktioner på siden. De henviser ofte til eller inkluderer andre filer. De fleste af dem refererer til en CSS-fil (common cascading style sheets), der definerer skrifttypestil, farve, størrelse, baggrund og lignende parametre, der er fælles for alle sider i undersøgelsen. Typografiark refererer til HTML klasse-parametre, der er knyttet til de forskellige typer objekter i HTML-koden. Dette gør det muligt for typografiarket at definere, hvordan hver af de mange typer tekst eller andre objekter, der kan vises flere steder, vises. Der er unikke klasser for hver spørgsmålstype i LimeSurvey og giver dermed detaljeret kontrol over udseendet af hvert spørgsmål. Billedfiler, som logoer eller specielle fremskridtslinje-konstruktører, kan også henvises til i temafilen. Til sidst erstattes specielle søgeord i krøllede klammer med tekst defineret i undersøgelsen for hver sprogoversættelseskorrespondent (f.eks. 'Survey Title' eller 'Spørgsmålstekst' for hvert defineret sprog).

Hvis du opretter et nyt brugerdefineret tema, skal du overveje at bidrage med det tilbage til LimeSurvey-fællesskabet og gøre det tilgængeligt for andre. Med din hjælp kan vi udvide vores lager af temaer, undersøgelser og andre tilføjelser for at gøre LimeSurvey endnu bedre! Se vores LimeSurvey skabelonlager, hvor du kan dele dine skabeloner.

Oprettelse af et nyt tema

For at kunne oprette et nyt tema (eller redigere et eksisterende tema), skal du have Skabelonredigering brugertilladelse i LimeSurvey samt tilladelse til at manipulere filerne i den underliggende operation system, der hoster din LimeSurvey-installation.

Bemærkning om advarsel: Hvis du ændrer temaer, kan du også påvirke alle de allerede eksisterende undersøgelser fra din LimeSurvey-installation. Temaer er en avanceret funktion, der kræver erfaring og HTML-kendskab.

Den foretrukne måde at oprette et nyt tema på er gennem Theme Editor (se nedenfor), som er placeret under Configuration på den øverste værktøjslinje. Nogle brugere foretrækker at arbejde direkte med temafiler, så de kan bruge deres foretrukne teksteditor i stedet for webgrænsefladen. I dette tilfælde skal du stadig bruge Theme Editor til først at oprette dit nye tema. Dette vil oprette et nyt basistema med alle de filer, du har brug for i mappen LimeSurvey_web_root/upload/themes/survey/your_new_template. Derfra kan du bruge din teksteditor til manuelt at justere skabelonfilerne.

Tilladelser Bemærk: på unix/linux-systemer vil disse temafiler være ejet af gruppen og brugeren, hvor webserveren kører (kan være "www" for nogle systemer). Så sørg for at du har de rigtige tilladelser til at redigere disse filer. Når du gemmer dem, så sørg for at de ikke ændrer ejerskab! På denne måde kan du stadig bruge grænsefladen til redigering af webtemaer, hvis det er nødvendigt.


En række 'offentlige' elementer i LimeSurvey kan justeres efter en række temaer. Det næste afsnit giver en meget kort forklaring af disse skabeloner.

Template:Bemærk

The LimeSurvey tema editor

Temaeditor: Konfiguration > Temaer> Temaeditor Temaeditoren er kun tilgængelig for brugere med tilladelsen Skabeloner og til superadministratorer.


  Opmærksomhed : Et tema, der ikke er korrekt konstrueret, kan forårsage, at en undersøgelse (der bruger den respektive skabelon) bliver ubrugelig.



LimeSurvey-temaeditoren giver dig mulighed for at redigere indholdet af dine temaer online. For at starte temaeditoren: klik på Temaer i menuen Konfiguration, og klik derefter på knappen Temaeditor ved siden af det tema, du vil redigere eller udvide.


Knappen til at få adgang til temaeditoren for Bootswatch-tema


Skabelonredigeringssiden giver dig mulighed for at vælge den skabelon, du ønsker at redigere/se.



Følgende muligheder er tilgængelige:


  • Opret: Giver dig mulighed for at oprette en ny skabelon. For ikke at starte fra bunden kopieres skabelonen 'default'.
  • Import: Giver dig mulighed for at importere en skabelon fra en ZIP-fil.
  • Eksporter : Giver dig mulighed for at eksportere den aktuelle skabelon til en ZIP-fil.
  • Kopier: Giver dig mulighed for at lave en ny skabelon ved at kopiere den nuværende.
  • Omdøb: Giver dig mulighed for at ændre navnet på skabelonen. Det bruges generelt efter kopiering eller import af en skabelon.
  • Skabelon: En rulleliste, der viser alle de tilgængelige skabeloner, der er placeret i din LimeSurvey-installation.
  • Skærm: En rulleliste, som giver dig mulighed for at vælge, hvilken undersøgelsesside i den skabelon, du vil se.
  • Vend tilbage til admin panel.

Importér/eksportér/kopiér en skabelon

Når du eksporterer en skabelon, oprettes et ZIP-filarkiv med alle skabelonfiler (.pstpl-filer, billeder, css-filer, ...). Du kan importere den eksporterede zip-fil til en anden LimeSurvey-installation ved at bruge importfunktionen, eller du kan manuelt kopiere arkivet til en anden LimeSurvey-installation og udpakke det til den tilsvarende skabelon mappe der.

Det er dog bedst at bruge LimeSurveys skabelon import/eksport/kopier funktioner i skabeloneditoren.

Sidestruktur / Skabelonbrug

  • Velkomstsiden: startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
  • 'Spørgsmålssiderne:' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
  • Den sidste side: startside .pstpl, assessment.pstpl, completed.pstpl, endpage.pstpl

Skabelonfiler

Følgende skabelonfiler bruges til at producere din offentlige undersøgelse og skal eksistere i enhver ny skabelonmappe, du opretter:

  • startpage.pstpl: Fremstiller starten på hver html-side. Det starter ved "<head> " tag, og bør ikke indeholde "<html> " tag. Denne 'meget begyndelsen' af en standard html-side er skrevet af scripts. Sørg for, at dine startpage.pstpl-filer indeholder en<body> tag. Selvom mange browsere ikke kræver streng overholdelse af W3 HTML-standarderne, skal LimeSurvey-scriptet finde et tag for at køre visse javascript-elementer. Det er ikke almindeligt at se mange 'søgeord' brugt i startpage.pstpl filen. Det kan dog være, du ønsker at indsætte {SURVEYNAME} i titlen. Startpage.pstpl-filen kan indeholde kode, der ender i den tilsvarende endpage.pstpl-fil. For eksempel kan du starte en tabel i denne fil og lukke tabellen i endpage.pstpl-filen. Startpage.pstpl- og endpage.pstpl-filerne omslutter alle mulige sider, der bruges af LimeSurvey.
  • survey.pstpl: Denne skabelon er den anden, der bruges på de fleste sider og giver plads til at indsætte undersøgelsesnavnet og beskrivelse. Denne skabelon har ikke en tilsvarende 'lukkende' skabelon, og efterfølgende bør du lukke alle tags, der er åbnet i denne skabelonfil (dvs.: lad ikke en tabel stå åben her, fordi der ikke er andre steder at lukke den).
  • ' welcome.pstpl:' Denne skabelon bruges kun i velkomstskærmen (som også er på hovedsiden for 'alt i én'-undersøgelser). Du kan bruge dette til at udskrive velkomstteksten og andre oplysninger, der bør gives i introduktionen. Ligesom filen 'survey.pstpl' er der ingen tilsvarende 'lukkende' skabelon, så alle tags, der åbnes i denne skabelonfil, bør også lukkes.
  • startgroup.pstpl: Denne skabelon kan give et 'resumé'-omslag for spørgsmål inden for en gruppe. Den har en matchende 'endgroup.pstpl'-skabelon, der kan bruges til at lukke alle åbnede tags i denne fil, så du kan åbne en tabel i denne.
  • groupdescription.pstpl: Denne skabelonfil er bruges til at vise en beskrivelse af en gruppe. Bemærk venligst, at du i undersøgelsesindstillingerne (få adgang til Præsentations- og navigationsindstillinger ved at klikke på fanen Presentation) kan indstille, om gruppebeskrivelsen skal vises eller ej. Hvis ikke, er denne fil slet ikke inkluderet.
  • question.pstpl: Denne fil indeholder spørgsmål, svar og hjælpetekstsektioner i din undersøgelse. I undersøgelserne "gruppe for gruppe" og "alt i én" cykles denne skabelon gentagne gange med hvert spørgsmål. Der er ingen tilsvarende afsluttende fil til dette, og alle tags bør lukkes.
  • question_start.pstpl: Denne fil indeholder de individuelle elementer, der findes i starten af et spørgsmål. Det er inkluderet i 'question.pstpl' via søgeordet {QUESTION}. Det er beregnet til at give skabelondesignere mere kontrol over layoutet af et spørgsmål. Denne skabelon ligger uden for det normale skabelonsystem og blev erstattet (fra LimeSurvey 1.87). Alle søgeord fra denne skabelon er nu tilgængelige direkte i question.pstpl.
  • completed.pstpl: Denne side vises som den sidste side, når undersøgelsens svar er blevet gemt, og undersøgelsen er slut. Den kan bruges til at vise et "videresendelseslink" som angivet i undersøgelsesopsætningen.
  • endgroup.pstpl: Denne fil lukker gruppen og kan bruges til at lukke alle tags, der er åbnet i startgroup.pstpl fil
  • navigator.pstpl: Denne fil indeholder de knapper, der navigerer gennem undersøgelsen, "næste", "forrige", "sidste", "send", "gem indtil videre" og linket "ryd alt". Den bruges på alle sider undtagen den udfyldte side.
  • printanswers.pstpl: Denne fil har den HTML-indpakning, der er nødvendig for den trykte version af undersøgelsen.
  • print_group.pstpl : Denne fil er den samme som startgroup.pstpl og endgroup.pstpl, men for den trykte version af undersøgelsen.
  • print_question.pstpl: Denne fil er den samme som question.pstpl , men for den trykte version af undersøgelsen.
  • print_survey.pstpl: Denne fil er den samme som survey.pstpl, men for den trykte version af undersøgelsen.

CSS og Javascript

To filer, der altid bruges i en skabelon, er template.css (til CSS) og template.js (til Javascript).

  • {TEMPLATECSS}: Tilføj linjer til standard css, template.css, og template-rtl.css for rtl-sprog.
  • {TEMPLATEJS}: Tilføj linjer til standard javascript-filer, template.js og alle js-filer, der er nødvendige for LimeSurvey.

Brug af Bootstrap

LimeSurvey har Bootstrap 3 indlejret, så du kan style alle dine skabeloner med de veldokumenterede Bootstrap-klasser. For mere information henvises til Bootstrap dokumentation.

Pluginnet Awesome-Bootstrap-Checkbox er også inkluderet. Med den kan du bruge de typiske Bootstrap-farveklasser (info, advarsel, fare, osv.) også med suffikset "-checkbox" eller "-radio", dog stil afkrydsningsfelter og radioer, som du foretrækker.

Erstatter standard CSS eller Javascript

Nogle spørgsmål bruger specifikke filer til Javascript eller CSS. Hvis du skal udskifte en funktion, skal du bruge et kaskadesystem. For javascript-funktion er den sidst læste funktion den anvendte funktion.

Andre skabelonfiler

privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl og confirmationemail.pstpl bruges ikke længere af LimeSurvey, og standardindstillingerne er i stedet indstilles i de relevante sprogfiler. E-mail-beskederne kan nu redigeres på en undersøgelse for undersøgelse.

Standardsider

Der er ti standardsider, som en undersøgelsesdeltager kan se i løbet af at tage eller få adgang til LimeSurvey-applikationen. Hver er konstrueret ud fra et antal almindelige Skabelon-filer fra Skabelonen angivet i indstillingerne for undersøgelsen. Tabellen nedenfor angiver, hvilke skabelonfiler der bruges til at konstruere hver af disse sider.

Undersøgelsessider/
Skabelonfiler
Survey
Liste
Velkommen Spørgsmål Udført Slet alle Tilmeld Indlæs Gem Udskriv
Svar
Udskriv
Survey
SurveyList
Velkommen
Beskyttelse af personlige oplysninger
Navigator
Survey
Startgruppe
Gruppebeskrivelse
Spørgsmål *
EndGroup
Vurdering
Udført
ClearAll
Tilmeld
Load
Gem
PrintAnswers
Udskriv undersøgelse
Udskriftsgruppe
Udskriv spørgsmål
Startside
Slutside
Template.css

* BEMÆRK: I version 1.90+ erstatter dette question.pstpl OG question_start.pstpl. Hvis du bruger en gammel brugerdefineret skabelon, skal du tilføje følgende linje til begyndelsen af question.pstpl:

<div {QUESTION_ESSENTIALS} class="{QUESTION_CLASS}{QUESTION_MAN_CLASS}{QUESTION_INPUT_ERROR_CLASS}">

Og tilføj derefter det tilsvarende afsluttende tag til slutningen af question.pstpl:

</div>

* BEMÆRK: I version 1.91 og tidligere er LimeSurvey js-filer ikke inkluderet i skabelonen. I version 2, skal du bruge {TEMPLATEJS} i en af dine skabelonfiler for at tilføje linket til js-filen. Du kan tilføje det i startpage.pstpl eller i endpage.pstpl. Du kan fjerne linjen {TEMPLATEURL}/template.js, og du skal erstatte med {TEMPLATEJS} for at opdatere en personlig skabelon.

Filkontrolafsnittet

I vinduet "filkontrol" til venstre kan du klikke på en af skabelonfilerne, der bruges til at kompilere siden. Du kan se Skærmdelen, JavaScript og CSS-filer. HTML-koden for den pågældende fil vises derefter i vinduet "Redigering nu" i midten. Hvis skabelonen er redigerbar (bestemt af mappetilladelser), kan du derefter foretage eventuelle ændringer og gemme dem.


Vinduet "Andre filer" viser en liste over alle andre filer fra skabelonmappen. Du kan bruge højre side til at uploade og vælge billedfiler (dine billeder, logoer,...) eller andre filer, der er nødvendige for at oprette din skabelon.


I stedet for at bruge et link til hvert billede, skal du bruge feltstrengen {TEMPLATEURL}. Så i stedet for:

img src='/limesurvey/templates/yourtemplate/files/mypicture.jpg'

Du kan bruge (New in 2.50 ):

 img src='{TEMPLATEURL}filer/mitbillede.jpg'

I LimeSurvey-versioner før 2.50 brug:

 img src='{TEMPLATEURL}mitbillede.jpg'

Et "eksempel" af skabelonsiden, du redigerer, vil være synligt nederst på skærmen. Der er ingen måde at slette en skabelon fra skabeloneditoren. Dette skal gøres ved at tilgå den underliggende mappe og manuelt slette filerne derfra. Du har også mulighed for at vælge forskellige skærmopløsninger for bedre at kunne vurdere skabelonens fornemmelse og udseende.

Bemærk: De afsendte skabeloner kan ikke redigeres ved hjælp af skabeloneditoren. Hvis du vil ændre dem, skal du først oprette en kopi og redigere kopien.

Skabelonfilers placering

LimeSurvey gemmer hver af 'standard'-skabelonerne i deres egen særskilte undermappe i /templates-mappen, der opbevares i den offentlige mappe med de andre offentlige LimeSurvey-filer. Tilpassede brugerskabeloner er gemt i mappen /upload/skabeloner.

Der skal ALTID være en "standard" mappe i skabelonmappen. Denne skabelon bruges som standard og som en reserve, hvis en skabelonmappe ikke findes eller ikke kan findes. Det kommer installeret som standard.

Du kan bruge alle billedfiler, som du uploader til skabelonstyringsområdet ved hjælp af denne syntaks:

{TEMPLATEURL}filnavn.xyz

Stylingspørgsmål med CSS

Styling af spørgsmål i CSS er blevet meget nemmere. Hver spørgsmålstype har nu en unik klasse. De obligatoriske spørgsmål har en ekstra obligatorisk klasse. For eksempel for et ikke-obligatorisk spørgsmål:

<div id="question5" class="gender">
...
</div>

og hvis spørgsmålet er obligatorisk:

<div id="question5" class="gender mandatory">
...
</div>

og hvis spørgsmålet er obligatorisk, men brugeren ikke besvarede det, eller hvis der er validering på et spørgsmål:

<div id="question5" class="gender mandatory input-error">
...
</div>

og hvis spørgsmålet har valideret, men brugeren ikke har svaret korrekt:

<div id="question6" class="text-short input-error">
...
</div>

Globale klasser for spørgsmålsdelen

Disse klasser bruges til hver spørgsmålstype. Nogle spørgsmålstyper bruger kun en eller to klasser, mens andre kan bruge meget mere.

Globale klasser
Klassenavn Del Spørgsmålstype Eksempler Bemærk
.spørgsmål (Obsolete since 3.0) Alle spørgsmål blok Alle spørgsmålstype

,

    ,
    .ls-svar (New in 3.0 ) Alle spørgsmål blok Alle spørgsmålstype
    ,
      ,
      .subquestions-list Liste over underspørgsmål Flervalgsspørgsmål, matrixspørgsmålstype
        ,
        .questions-list bruges også
        .svar-liste Liste over svar Enkeltvalgsspørgsmål, array-spørgsmålstype, Multi-input tekstspørgsmål
          ,
          .svar-punkt Svardelen: ét svar Enkeltvalgsspørgsmål, array-spørgsmålstype, Multi-input tekstspørgsmål
        • ,
        • .intet svar-emne Svardelen for intet svar Enkeltvalgsspørgsmål, matrixspørgsmålstype
        • ,
        • Intet svar er også et svar, så hav dobbelt klasse intet svar-punkt og svar-punkt
          .spørgsmål Spørgsmålsdelen: ét spørgsmål Multitekstspørgsmål, matrixspørgsmålstype
        • ,
        • Nogle svar er også spørgsmål. Så har vi en masse class="question-item answer-item"
          .knap-liste En liste over knap Ja nej og kønsspørgsmål
          .knap-emne Svardelen med en knap Ja nej og kønsspørgsmål
        • .checkbox-list En liste over checkbox Flervalgsspørgsmål, matrixnummer (afkrydsningsfelt) spørgsmålstype
            ,
          Nogle spørgsmålstyper bruger multi-list klasse, som afkrydsningsfelt med kommentar: class="checkbox-list text-list"
          .checkbox-array (New in 3.0 ) En række afkrydsningsfelter Array (tal) med mulighed for afkrydsningsfelt
          .checkbox-item Svardelen med et afkrydsningsfelt Flervalgsspørgsmål, matrixnummer (afkrydsningsfelt) spørgsmålstype
        • ,
        • .radio-liste En liste over radioelementer Enkeltvalgsspørgsmål, matrixspørgsmålstype (hver række)
            ,
          .radio-array (New in 3.0 ) En række radioelementer Matrixspørgsmålstype
          .radio-item Svardelen med en radio Enkeltvalgsspørgsmål, matrixspørgsmålstype
        • ,
        • .tekst-liste En liste over tekstinput Multitekst spørgsmålstype, række af tekst
            ,
          .tekst-item Svardelen af en tekstinput Multitekst spørgsmålstype, række af tekst
        • ,
        • .numeric-list En liste over tekstinput med kun numerisk svar Multinumerisk spørgsmålstype, række af tal
            ,
          .number-list En liste over tekstinput med kun numerisk svar (hver række) Multinumerisk spørgsmålstype, række af tal
            ,
          .number-array (New in 3.0 ) Svardelen af et numerisk input Array af nummer
          .select-list (Obsolete since 2.50) En liste over udvalgte Array-numre, Dobbeltskala-array (vælg)
          .dropdown-liste (New in 2.50 ) En liste over udvalgte Array-numre, Dobbeltskala-array (vælg) (hver række)