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|rå}}</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.
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.
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.
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:
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:
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:
Bemærk: Før 1.92 var kun klasserne .mandatory og .input-error tilgængelige.
Disse gælder for hjælpe- og/eller valideringstip-meddelelserne, så hver type kan styles individuelt.
Indstillingerne .hide-tip og .input-error interagerer som standard, så du kan have valideringstip skjult. De vises dog, når der er valideringsfejl og forsvinder igen, når disse fejl er rettet.
Alle disse er designet til at eliminere behovet for pop-up advarsler. I stedet kan tip vises/forsvinde efter behov og er farvekodede for at angive, om svarene opfylder valideringskriterierne.
Ydermere, når du første gang besøger en side, der har uopfyldte valideringskriterier, kan du farvekode tipsene i en behagelig farve for at vise, hvilke valideringskriterier der endnu ikke er blevet opfyldt; vis derefter siden igen med en hårdere farve, hvis personen indsender siden med vedvarende valideringsfejl.
Formål
CSS-klasse
Beskrivelse
Obligatorisk
.obligatorisk
spørgsmålet er obligatorisk
Brugerindtastningsfejl
.input-error
spørgsmålet havde mindst én valideringsfejl
Skjul tip
.hide-tip
tilføjet hvis du bruger hide_tip-indstillingen
standardtype
.em_default
for standard tipsæt (numerisk værdi osv. …)
Antal svar
.em_num_svar
for for min_svar og max_svar
Værdiområde
.em_value_range
for min/max_num_value_n og multiflexible_min/max
Sumområde
.em_sum_range
for min/ max/equals_num_value
Regex-validering
.em_regex_validation
for regulært udtryksvalidering af spørgsmålet
Spørgsmålsniveauvalideringsfunktion
.em_q_fn_validation
for em_validation_q option
Valideringsfunktion på underspørgsmål
.em_sq_fn_validation
for em_validation_sq optionen
Anden kommentar obligatorisk
.em_other_comment_mandatory
for other_comment_mandatory option - viser hvornår "andet" er valgt, men tilhørende kommentar mangler.
Import af stilarter til din brugerdefinerede skabelon
De tilpassede spørgsmålsstile er tæt på bunden af hver skabelons CSS-fil og starter med:
Hvis du styler din egen brugerdefinerede skabelon, bør du være i stand til at kopiere alt efter ovenstående fra templates/default/template.css (til tabelbaserede layouts) eller /templates/limespired/template. css (for CSS-baserede layouts) ind i dit eget typografiark uden nogen indvirkning på dine andre stilarter.
Internet Explorer Betingede Style Sheets
På grund af de markante uoverensstemmelser i gengivelsen mellem IE6 & IE7 og de andre browsere, er der særlige IE betingede typografiark inkluderet for hver skabelon.
Du bør inkludere ovenstående kode i din startpage.pstpl og kopier af både IE-typografiarkene fra enten /templates/default/ eller /templates/limespired for Tables baselayout og CSS baseret layout hhv.
Bemærk: Hvis du kopierer stilene til dit eget typografiark, bliver du næsten helt sikkert nødt til at tilpasse dem.
Alternativ løsning til Internet Explorer
Du kan sætte en betinget klasse til body i startpage.pstpl og bruge denne klasse i din template.css. Denne metode bruges i citronade-skabelonen (Obsolete since 2.06). Tilføjelse af en js / no-js klasse for at have javascript / intet javascript system.
.ie6{/*specifik for Internet Explorer 6*/}.ielt8{/*specifik for Internet Explorer 6 og 7*/}.ie{/*specifik for alle Internet Explorer */}
Højre-til-venstre (RTL) sprog og retfærdiggøre
Teksteditoren i LimeSurvey er i stand til at formatere RTL-tekst. Imidlertid viser editoren selv RTL-sproget i venstre mod højre format, når det er berettiget. Dette er kun et problem med redigeringsvisning. RTL og det begrundede spørgsmål eller tekst vil blive vist korrekt fra højre mod venstre, selv når det er begrundet, i din undersøgelse eller på forhåndsvisning.
Nøgleord i en skabelonfil bliver erstattet af de aktuelle undersøgelsesoplysninger. De er omgivet af krøllede parenteser, for eksempel: {SURVEYNAME}.
Følgende strenge vil blive erstattet af LimeSurvey, når skabelonfilen analyseres og præsenteres for brugere af undersøgelsen. Disse feltstrenge vil fungere på næsten alle skabeloner undtagen den 'fuldførte side'. (De fleste af disse strenge kan findes i common.php-filen. Hvis den ikke er der, så kig i index.php-filen.)
Søgeord
Skabelonfiler
Beskrivelse
{SURVEYNAME}
Alle Filer
Undersøgelsestitlen
{SURVEYDESCRIPTION}
Alle filer
Undersøgelsesbeskrivelsen
{WELCOME}
Alle filer (hovedsagelig for welcome.pstpl)
Undersøgelsens 'velkommen' tekst
{PERCENTCOMPLETE}
survey.pstpl
En lille graf, der viser procentdelen af den gennemførte undersøgelse
Viser det samlede antal spørgsmål i undersøgelsen (kun antallet)
{THEREAREEXQUESTIONS}
velkommen. pstpl
Viser sætningen "Der er X spørgsmål i denne undersøgelse" - fra den relevante sprogfil. X'et erstattes med antallet af spørgsmål. Bemærk, at dette også vil fungere passende for ental eller flertal. Hvis der kun er 1 spørgsmål, udskrives "Der er 1 spørgsmål i denne undersøgelse".
{CHECKJAVASCRIPT}
Alle filer (hovedsageligt for welcome.pstpl)
Advarselsmeddelelse, når end- brugerbrowser har deaktiveret javascript
{QUESTION}
Question.pstpl
-
{ANSWER}
question.pstpl, print_question.pstpl
præsenterer svarformularen til det aktuelle spørgsmål
{SGQ}
question.pstpl, spørgsmålstekst
Kan bruges i selve spørgsmålsteksten til at referere til spørgsmålets inputfelt dynamisk ved at vise Survey-Group-Question-id'et for det aktuelle spørgsmål. (fra svn build 9755)
{QUESTIONHELP}
question.pstpl, print_question.pstpl
Viser hjælpetekst (foruddefineret tip til spørgsmålstype) for det aktuelle spørgsmål
{QUESTION_CLASS}
question.pstpl, print_question.pstpl
unik klasse for hver spørgsmålstype. (Skal inkluderet i spørgsmålets indpakningstag.)
{QUESTION_CODE}
question.pstpl, print_question.pstpl
Viser den aktuelle spørgsmålskode
{QUESTION_ESSENTIALS }
question.pstpl
spørgsmåls-id'et og (hvis et spørgsmål er betinget), 'style="display:none;"'. (Skal inkluderet i spørgsmålets indpakningstag.)
{QUESTION_HELP}
question.pstp, question_start.pstpl
Viser den brugerdefinerede hjælpetekst til det aktuelle spørgsmål
{QUESTION_TYPE_HELP}
print_question.pstp
Viser den brugerdefinerede hjælpetekst til det aktuelle spørgsmål
{QUESTION_INPUT_ERROR_CLASS}
question.pstp, question_start.pstpl
Giver en klasse, hvis der var brugerindtastningsfejl
{QUESTION_ID}
print_question.pstp
Giver et unikt ID for hvert spørgsmål for at tillade styling af specifikke spørgsmål
Viser den oversatte gyldige hjælpemeddelelsestekst for det aktuelle spørgsmål
{QUESTION_SCENARIO}
print_question.pstp
Udskriver 'scenarie'-teksten for betingede spørgsmål.
{NAVIGATOR}
navigator.pstpl
Viser navigationsknapper (næste, forrige, sidste)
{CLEARALL}
Alle filer (men beregnet til navigator.pstpl)
Viser "Afslut og ryd resultater"-link
{COMPLETED}
completed.pstpl
Viser 'fuldført'-meddelelsen til registrering, vil ændre sig afhængigt af, om felterne attribut_1 og attribut_2 er indstillet.
{URL}
completed.pstpl
Viser undersøgelsens 'url' og 'url-tekst'
{PRIVACYMESSAGE}
privacy.pstpl
Beskeden om beskyttelse af personlige oplysninger vises, hvis du indstiller din undersøgelse til at være anonym. Teksten kan redigeres/oversættes i sprogfilerne. Dette kan også ændres manuelt ved at redigere den privacy.pstpl-skabelon, du ønsker at bruge.
{TEMPLATEURL}
Alle filer
-
{SUBMITCOMPLETE}
endpage.pstpl
Erklæringen (fra sprogfilerne), der fortæller brugeren, at de har gennemført undersøgelsen, og at trykke på "Send"-knappen
{SUBMITREVIEW}
survey.pstpl
Sætningen (fra sprogfilerne), der fortæller brugeren, at de kan gennemgå/ændre de svar, de har lavet ved at klikke på "<< forrige"
{SAVEDID}
Alle filer
Viser 'Svar-ID' for bruger
{QUEXMLPDF}
Alle filer
Viser knap for at eksportere queXML PDF'en af spørgeskemaet, inklusive svar indtastet indtil det punkt, der er afsluttet i undersøgelsen.
{TOKEN:FIRSTNAME}
Alle filer
***Hvis undersøgelsessvarene IKKE er ANONYME - erstattes med brugerne først navn fra tokens-tabellen
{TOKEN:LASTNAME}
Alle filer
***Hvis undersøgelsessvar IKKE er ANONYME - erstattes med brugerens efternavn fra token-tabellen***
{TOKEN:EMAIL}
Alle filer
***Hvis undersøgelsessvar IKKE er ANONYME - erstattes med brugerens e-mail fra tokens-tabellen***
{TOKEN:ATTRIBUTE_1}
Alle filer
***Hvis undersøgelsessvar IKKE er ANONYME - erstattes med brugerattributten_1 fra token-tabellen***
|Alle filer
***Hvis undersøgelsessvar IKKE er ANONYME - bliver erstattet med brugerattributten_2 fra tokens-tabellen***
{ANSWERSCLEARED}
Fortrinsvis i navigator.pstpl
"Answers Cleared"-erklæring fra sprogfilerne
{RESTART}
clearall.pstpl
URL for at genstarte undersøgelsen
{REGISTERERROR}
register.pstpl
Viser eventuelle fejlmeddelelser på registreringssiden (dvs.: "Du skal inkludere en e-mailadresse")
{REGISTERMESSAGE1}
register.pstpl
Udsagnet "Du skal være registreret for at fuldføre denne undersøgelse" fra sprogfilerne
{REGISTERMESSAGE2}
register.pstpl
Detaljer om registrering fra sprogfilerne
{REGISTERFORM}
register.pstpl
Den faktiske registreringsform ændres afhængigt af, om felterne attribut_1 og attribut_2 er indstillet.
{SAVE}
Fungerer egnet på navigator.pstpl
Viser 'Gem dine svar, så langt' for at tilbyde brugeren at gemme og vende tilbage senere for at fortsætte undersøgelsen. Hvis indstillingen Gem er deaktiveret i undersøgelsesegenskaberne, vil tagget ikke blive vist og ignoreret.
{LANGUAGECHANGER}
survey.pstpl
Viser et skifte i flersprogede undersøgelser for at ændre spørgsmålet.
Input/knapper
Hver "input"-type i en undersøgelse har fået sit eget klassenavn, så du kan tilføje CSS til din "startpage.pstpl"-fil og have en vis kontrol over udseendet af formularknapper og input. Disse klassenavne er som følger:
submit (Send-knapper)
tekst (Tekstinput - for kort fritekst, dato og numerisk type)
svartekst (Tekst af svar)
radio (Radioknapper)
afkrydsningsfelt (afkrydsningsfelter)
"vælg"" (link)
rang (Spørgsmålet om rangeringsstil. Angiver ikke farven på valgfeltet eller tekstboksene, men det tillader ændring af baggrundsfarve, tekstfarve, størrelse osv. ., for resten af rangeringsspørgsmålet)
graf (den "procentdel fuldførte" graftabel)
innergraph (Tabellen inde i graftabellen - denne indeholder 0% og 100% tekst. Brug dette til at ændre størrelsen på denne tekst)
spørgsmål (Generelle indstillinger for ethvert spørgsmål, der vises i en tabel. Generelt bør du bruge dette til at sørg for, at deres skriftstørrelse og farve er den samme, som du har brugt andre steder som standard)
obligatorisk (obligatoriske spørgsmål)
input-fejl (Bruger inputfejl - for hvis en bruger har lavet en fejl med et obligatorisk spørgsmål eller spørgsmål med validering)
array1 og array2 (Disse to stilarter cykles, når udvalget af svar på et spørgsmål af matrixtype. Dette giver dig mulighed for at indstille en skiftende baggrundsfarve for disse spørgsmålstyper. Array1 bruges også til kolonneoverskrifterne i disse spørgsmålstyper)
errormandatory (Indstiller farven og stilen for "Dette spørgsmål er obligatorisk" fejlmeddelelsen)
*warningjs (Indstiller farven og stilen på den advarselsmeddelelse, der vises, hvis deltagerens browser har deaktiveret javascript)
Der er også nogle elementer, der kan tilgås ved hjælp af elementets ID (#ID i CSS):
surveycontact (Kontaktmeddelelsen vist på startsiden)
tokenmessage (bruges til meddelelser inde i undersøgelsen, f.eks. sessionen udløbet fejlmeddelelse)
Fordi du kan redigere alle HTML-aspekterne, er der ingen grund til at omgive dine skabeloner med et
<divclass='new_name'></div>
og definer derefter en css for den nye_navn-klasse.
Stylering af statuslinjen
Statuslinjens udseende kan ændres med CSS.
For at ændre baggrundsfarven på bjælken skal du tilføje noget i stil med følgende til slutningen af din custom.css-fil (eksempel på frugtagtigt tema):
.frugtbar.progress-bar{baggrundsfarve:#3300FF;}
For at ændre bjælkens kantfarve skal du tilføje noget i stil med følgende til slutningen af din custom.css-fil (eksempel på frugtagtigt tema):
.frugtbar.progress-bar{kant:1pxfast#FF0000;}
Avancerede funktioner tilgængelige for udviklere
LimeSurvey har integreret nogle brugerlavede patches, der tillader nogle specielle ændringer. Disse meget avancerede funktioner kræver (generelt) ændringer af den underliggende kodebase i LimeSurvey og bør gøres omhyggeligt for ikke at indføre sikkerhedshuller.
Support til dine egne Javascript-funktioner
Nogle brugere skal muligvis køre Javascript på undersøgelsessiderne, men kaldet checkconditions() i BODY-elementet gjorde det umuligt at gøre det. Dette kald er blevet erstattet med en lille JavaScript-funktion i HEAD, der sniffer efter eksistensen af checkconditions() og template_onload(), før de kaldes. På denne måde kan en skabelonforfatter oprette sin egen template_onload()-funktion i HEAD, der erstatter standardfunktionen.
Deaktiver XSS-filter - i Globale indstillinger -> Sikkerhed, indstil "Filter HTML for XSS" til No.
Indtast dit script i kilden til et spørgsmål eller gruppebeskrivelse.
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.
Nedenfor er der to hjælpesætninger på fransk og engelsk. Læg dette på endpage.pstpl:
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.
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 $defaulttemplate = 'yourtemplatename'; .
Import/eksport af skabeloner: Mac-brugere
Mac-brugere , bemærk venligst, at Mac OSX-standardarkiveringsværktøjet kan have problemer med zip-mapper "genereret i farten".
En løsning er at pakke unix'er ud fra kommandolinjen:
$ unzip template.zip -d skabelon
Arkiv: template.zip
oppustning: skabelon/startside
oppustning:...
En anden løsning er at bruge scripts i deres mac-kompilerede modstykker.
Brug den samme skabelon med forskellige logoer
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:
<imgsrc="{TEMPLATEURL}files/logoImage-{SID}.png">
Vis tilpasset favicon
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:
Opret et favicon - Du kan bruge Google til at finde masser af gratis favicon-generatorer.
Navngiv dit nye favicon "favicon.ico" og placer det i din skabelon /filer mappe.
Tilføj følgende kode til din startpage.pstpl før</head> tag.
Anderledes udseende for undersøgelses-/spørgsmålssider
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.
Et eksempel fra standardskabelonen til LimeSurvey 1.91+:
header_separator bruges til at adressere separatoren for overskriften "td". "dual_scale_separator" bruges til at adressere separatorkolonnen i dobbeltskala-arrayet.
Tilføjelse af dit eget logo til undersøgelseslisten
Åbn først temaeditoren for det tema, du kan lide at bruge.
Vi anbefaler at bruge frugtagtig, det er vores bedste tema i øjeblikket.
Udvid derefter temaet og giv det et navn, du vil genkende.
I den følgende visning kan du uploade det logo, du vil bruge.
Vælg redigeringsskærmen `Survey List' i rullemenuen Skærm i øverste højre hjørne.
Vælg derefter `layout_survey_list.twig´ i menuen til venstre.
Rul i editoren til linje 126 og skift den markerede del til filnavnet på det billede, du uploadede til temaet før.
Gem din fil.
Skift standardtema til dit udvidede tema.
Juster logoet til midten af undersøgelsessiden
Dette eksempel er til "extends_fruity" skabelonen. For andre skabeloner kan den påkrævede CSS være anderledes.
Log ind på LimeSurvey-administrationsområdet
Gå til temaeditoren: Konfiguration > Temaer
Find "LimeSurvey Fruity Theme" på listen, og klik på " Theme Editor"-knap
Klik på "custom.css" i fillisten til venstre nederst på siden
Kopier følgende CSS ind i den fil, og tryk på "Gem ændringer"
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.
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.
I application/config/config.php, find 'config'=>array og tilføj denne linje til arrayet: 'allow_templates_to_overwrite_views'=>1
I /{your_template}/config.xml, sæt "overwrite_question_views" til true
Kopiér application/views/survey/* til template/{your_view_directory}/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/
Indsæt tilpassede CSS- eller JavaScript-filer til skabelon
Fra version 2.50 kan du bruge filen config.xml til automatisk at indlæse plugin-filer.
Upload dine filer til skabelonen /css eller /scripts mappen
I /{din_skabelon}/config.xml skal du tilføje filstierne til<css> eller<js> blokke, noget som dette:
Opmærksomhed : Et tema, der ikke er korrekt konstrueret, kan forårsage, at en undersøgelse (der bruger den respektive skabelon) bliver ubrugelig.
