Actions

Theme editor/sl: Difference between revisions

From LimeSurvey Manual

No edit summary
(Created page with "===checkbox-text-item=== {|class=wikitable !''''Vprašanje''''!!''''Vrsta vprašanja''''!!''''elementi'''' |- |več možnosti_s_komentarji|| P || li |- |več izbir|| M || li...")
 
(217 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages />  
<languages />  
=Predstavitev=
==Uvod==


LimeSurvey ima osnovni sistem za predloge in stile, ki omogoča tematsko prilagoditev aplikacije za uporabo v številnih brskalnikih.  Tukaj jih enostavno imenujemo '''Predloge'''.  Predloge omogočajo upravljanje z izgledom in občutkom pri anketiranju. Skrbnik lahko izbere predlogo, jo uporabi za vsako anketo in tako prilagodi izgled ter občutek anket svojim potrebam. Spremembe na predlogah so lahko tako enostavne, kot je dodajanje posebnega logotipa na pozdravno stran, menjava barv odzadja ali morda nova barva besedila za določene tipe vprašanj.
LimeSurvey ima napreden sistem tem in stilov, ki razvijalcem zagotavlja učinkovit način prilagajanja videza ankete. Od LS3 je bil izraz '''"predloge"''' nadomeščen z izrazom '''"teme"'''. '''Teme''' omogočajo nadzor nad slogom strani ankete. Skrbnik ankete lahko izbere privzeto temo, ki bo uporabljena za vsako anketo, da jo dodatno prilagodi. '''Teme''' so opremljene z možnostmi, ki skrbniku brez spretnosti kodiranja omogočajo preprost način dodajanja logotipa na pozdravno stran, spreminjanje barv ozadja, izbiro pisave itd.


Z LimeSurvey-em dobite komplet predlog.Te prvotne predloge se nahajajo v imenikih znotraj LimeSurvey-eve namestitve v mapi "templates". Vsaka predloga ima svojo lastno mapo. Znotraj glavne mape vsake predloge se nahaja kopica datotek: '''predloge (.pstpl)''', '''oblikovni stili (.css)''', '''slike''' ('''.jpg''' ali '''.png''') in morda še druge.


Kot pri ostalih sistemih, ki temeljijo na temah, so deli HTML kode shranjeni v datotekah predlog (.pstpl). Ta koda je prebrana in uporabljena za izgradnjo strani za prikaz anketirancem med anketiranjem. Pogosto se uporabljajo '''ključne besede''', obdane z zavitimi oklepaji, ki so vključene v datoteke in se nato zamenjajo s pravim besedilom.  Poglejmo si primer takšne vsebine datoteke predloge in njen rezultat pri prikazu na strani za anketiranje:
LimeSurvey ima 3 teme. Te začetne teme definirajo imeniki, ki se nahajajo v imeniku "themes/survey/" namestitve LimeSurvey. Vsaka tema ima svoj imenik. Znotraj glavnega imenika teme boste našli konfiguracijsko datoteko v XML in številne imenike, ki vsebujejo poglede '''teme (.twig)''', '''kaskadne slogovne liste (.css)''', '' 'skripte''', '''slike''' (''''.jpg''' ali '''.png''') in morda druge.
 
 
Od LimeSurvey 2.50 mehanizem za teme uporablja [http://getbootstrap.com/docs/3.3/ Bootstrap 3] kot ogrodje CSS. Ker je Bootstrap 3 standardno ogrodje, bodo razvijalci o njem na internetu našli veliko dokumentacije, vadnic in forumov.
 
 
Od LimeSurvey 3 dalje mehanizem za teme uporablja [https://twig.symfony.com Twig], tako da lahko razvijalci tem spremenijo logiko upodabljanja ankete na varen in enostaven način. Twig je nadomestil stari sistem nadomestnih ključnih besed, ki je bil uporabljen v prejšnjih različicah. Logika, ki je bila uporabljena za ustvarjanje HTML-ja ključnih besed, je zdaj na voljo znotraj pogledov teme.


<syntaxhighlight lang="php" enclose="div"><center><font face='verdana' color='red'>{SURVEYNAME}</font><br />
<font face='verdana' color='blue'><u>{SURVEYDESCRIPTION}</u></center>
</syntaxhighlight>


Anketiranec vidi stran podobno tej:
Delček iz teme Vanilla:


<div class="simplebox"><center>'''<span style='color:red'>Moja nova anketa</span>'''</center>
<syntaxhighlight lang="twig">
<center><u><span style='color:#0000ff'>To je moja anketa, s katero raziskujem vrsto čokolade, ki jo imajo ljudje najraje.</span></u></center></div>
<div class="{{ aSurveyInfo.class.answercontainer }} col-xs-12" {{ aSurveyInfo.attr.answercontainer }}>  
{# OPOMBA: Če želite prilagoditi upodobitev vprašanja, uporabite temo vprašanja #}
{{ aVprašanje.odgovor | surovo }}
</div>  
</syntaxhighlight>


Predloge, sestavljene iz HTML kode, skrbijo za opredelitev položaja in vrsto prikazanega besedila ter podobne strukturne značilnosti strani. Pogosto vključujejo ali se sklicujejo na druge datoteke. Večina sklicevanj je na datoteke za oblikovne stile (CSS-je), ki opredeljujejo slog pisave, barvo, velikost, ozadje in podobne parametre, skupne vsem stranem ankete. HTML parametri za sklicevanja na '''CSS''' oblikovne stile so povezani z različnimi vrstami predmetov v HTML kodi. To omogoča oblikovnim stilom enkraten opis, kako naj prikaže vsakega od mnogih vrst pisav za besedilo ali druge predmete, ki se lahko prikažejo na več mestih. Obstajajo edinstveni razredi za vsak LimeSurvey-ev tip vprašanja, ki s tem omogočajo podroben nadzor nad videzom posameznega vprašanja. Datoteke predlog se lahko prav tako sklicujejo na datoteke slik, kot so logotipi ali gradniki za vrstico s prikazom napredka. Tudi posebne ključne besede med zavitimi oklepaji se zamenjajo z besedilom, ki je opredeljen v anketi za vsak pripadajoč prevod jezika (na primer naslov ankete ali besedilo vprašanja za vsak opredeljen jezik).
Teme, ki so koda HTML in Twig, običajno določajo položaj in vrsto besedila, ki bo prikazano, ter podobne strukturne značilnosti strani. Pogosto se sklicujejo ali vključujejo druge datoteke. Večina se jih sklicuje na običajno datoteko kaskadnih slogov (CSS), ki določa slog pisave, barvo, velikost, ozadje in podobne parametre, skupne vsem stranem v anketi. Liste slogov se sklicujejo na parametre '''razreda''' HTML, ki so povezani z različnimi tipi predmetov v kodi HTML. To omogoča, da slogovni list definira, kako prikazati vsako od številnih vrst besedila ali drugih predmetov, ki se lahko pojavijo na več mestih. Za vsako vrsto vprašanja v LimeSurvey obstajajo edinstveni razredi, ki omogočajo podroben nadzor nad videzom vsakega. V datoteki teme se lahko sklicujete tudi na slikovne datoteke, kot so logotipi ali posebni konstruktorji vrstice napredka. Končno so posebne ključne besede v zavitih oklepajih nadomeščene z besedilom, opredeljenim v anketi za vsakega korespondenta prevoda v jezik (na primer 'Naslov ankete' ali 'Besedilo vprašanja' za vsak definiran jezik).


Če ustvarite novo predlogo po meri, prosimo razmislite o prispevanju nazaj v LimeSurvey-evo skupnost in jo tako omogočite za uporabo drugim uporabnikom. Z vašo pomočjo lahko raste naša zbirka predlog, anket in drugih dodatkov ter tako skupaj naredimo LimeSurvey še boljši! Poglejte si obstoječo [http://www.limesurvey.org/en/download-limesurvey-design-templates/com_josetta_menu_control_panel/viewcategory/9-survey-design-templates zbirko predlog]
Če ustvarite novo predlogo po meri, prosimo razmislite o prispevanju nazaj v LimeSurvey-evo skupnost in jo tako omogočite za uporabo drugim uporabnikom. Z vašo pomočjo lahko raste naša zbirka predlog, anket in drugih dodatkov ter tako skupaj naredimo LimeSurvey še boljši! Poglejte si obstoječo [http://www.limesurvey.org/en/download-limesurvey-design-templates/com_josetta_menu_control_panel/viewcategory/9-survey-design-templates zbirko predlog]


=Ustvarjanje nove predloge=
==Ustvarjanje nove teme==


Da lahko ustvarite novo predlogo (ali uredite obstoječo), potrebujete na anketnem sistemu kot uporabnik pravico za urejanje predlog in prav tako pravico za delo z datotekami v osnovnem operacijskem sistemu, na katerem gosti vaš anketni sistem.
Da lahko ustvarite novo predlogo (ali uredite obstoječo), potrebujete na anketnem sistemu kot uporabnik pravico za urejanje predlog in prav tako pravico za delo z datotekami v osnovnem operacijskem sistemu, na katerem gosti vaš anketni sistem.


<div class="simplebox">'''Opozorilo:'''Ker lahko spremembe vplivajo na vse obstoječe ankete v anketnem sistemu, je smiselno omejiti pravico urejanja predlog na uporabnike, ki so usposobljeni in ki razumejo splošno zamisel kodnega zapisa. Predloge so napredne oblike HTML datotek, ki ne dovoljujejo preizkušanja tistim, ki niso seznanjeni s takšnim delom.</div>
<div class="simplebox"><span style='color:red'>'''Opozorilo:'''</span> Če spremenite teme, lahko vplivate tudi na vse že obstoječe ankete iz vaše namestitve LimeSurvey. Teme so napredna funkcija, ki zahteva izkušnje in znanje HTML.</div>


Zaželeni način za izdelavo nove predloge je s pomočjo urejevalnika predlog (glej v nadaljevanju) preko spletnega vmesnika za skrbnike. Nekateri uporabniki bi morda raje delali neposredno z datotekami predlog, da bi lahko uporabljali svoj priljubljeni urejevalnik besedila namesto spletnega vmesnika. Tudi v tem primeru je potrebno najprej uporabiti urejevalnik predlog, da z njim izdelate novo predlogo. Tako se bodo ustvarile nove osnove za predlogo z vsemi potrebnimi datotekami v mapi LimeSurvey-ev_spletni_koren/upload/templates/vaša_nova_predloga. Od tu naprej lahko uporabljate vaš priljubljeni urejevalnik besedila za ročno prilagajanje datotek predloge.
Najprimernejši način za ustvarjanje nove teme je prek '''Urejevalnika tem''' (glejte spodaj), ki se nahaja pod '''Konfiguracija''' v zgornji orodni vrstici. Nekateri uporabniki raje delajo neposredno s tematskimi datotekami, tako da lahko namesto spletnega vmesnika uporabljajo svoj najljubši urejevalnik besedil. V tem primeru vseeno uporabite urejevalnik tem, da najprej ustvarite novo temo. To bo ustvarilo novo osnovno temo z vsemi datotekami, ki jih potrebujete v imeniku ''LimeSurvey_web_root/upload/themes/survey/your_new_template''. Od tam lahko z urejevalnikom besedila ročno prilagodite datoteke predloge.


<div class="simplebox">'''Opozorilo glede dovoljenj:''' na sistemih unix/linux bodo te datoteke predlog v lastništvu skupine in uporabnika, ki poganja spletni strežnik (na nekaterih sistemih je to "www"). Prepričajte se, da imate dostop za urejanje teh datotek in da pri shranjevanju ne zamenjajo lastništva (da jih bo mogoče kasneje urejati z urejevalnikom predlog, če bo to potrebno).</div>
<div class="simplebox">'''Opomba o dovoljenjih:''' v sistemih unix/linux bodo te datoteke tem v lasti skupine in uporabnika, kjer se izvaja spletni strežnik (lahko "www" za nekatere sisteme). Zato se prepričajte, da imate ustrezna dovoljenja za urejanje teh datotek. Ko jih shranite, se prepričajte, da ne spremenijo lastništva! Tako lahko po potrebi še vedno uporabljate vmesnik za urejanje spletnih tem.</div><br />


Morda datoteke predlog zgledajo na prvi pogled zapletene. Dobro je razumeti HTML označevalni jezik, po možnosti še CSS oblikovanje in imeti dostop do osnovnih namestitvenih datotek anketnega sistema, če datoteke in mape predlog ni mogoče urejati. Da si lažje razjasnite koncept predlog, se malce poigrajte z njeno vsebino. Pred tem ne pozabite ustvariti kopijo obstoječe predloge v novo mapo.
Številne LimeSurvey-eve 'javne' elemente je možno nastaviti z vrsto predlog. V tem razdelku je prikazana zelo kratka razlaga takšnih predlog.


Številne LimeSurvey-eve 'javne' elemente je možno nastaviti z vrsto predlog. V tem razdelku je prikazana zelo kratka razlaga takšnih predlog.
{{Opomba|Datoteke s temami so kompleksna funkcija. Poleg HTML-ja morate poznati tudi CSS, Twig in JavaScript.}}


=LimeSurvey-ev urejevalnik predlog=
=LimeSurvey-ev urejevalnik predlog=


Za lažje razumevanje in hitro posodobitev predlog LimeSurvey omogoča uporabo '''urejevalnika predlog''', dosegljivega v glavni '''skrbniški''' orodni vrstici anketnega sistema. Ta urejevalnik predlog je na voljo le uporabnikom z dano pravico v varnostnih nastavitvah uporabnikov. Predloge vplivajo na vse ankete in lahko povzročijo, da je anketa neuporabna, če niso pravilno urejene. Zato je smiselno omejiti urejanje predlog zgolj na del uporabnikov, ki to delo res obvladajo. Imeti pravico za vstop v urejevalnik besedil ni dovolj.
'''Urejevalnik tem''': '''Konfiguracija''' > '''Teme'''> '''Urejevalnik tem'''
Urejevalnik tem je na voljo samo uporabnikom [[Manage users#Set globalna dovoljenja za uporabnika|z dovoljenjem Predloge]] in superskrbnikom.
 
 
{{Alert|title=Pozor|text=Tema, ki ni pravilno sestavljena, lahko povzroči nedelovanje ankete (ki uporablja ustrezno predlogo). }}
 
 
Urejevalnik tem LimeSurvey vam omogoča urejanje vsebine vaših tem na spletu. Če želite zagnati urejevalnik tem: kliknite '''Teme''' v meniju '''Konfiguracija''' in nato kliknite gumb '''Urejevalnik tem'''' poleg teme, ki jo želite urediti ali razširiti.
 
 
[[Datoteka:Themes menu.png]]
[[Datoteka:Theme editor button.png|''Gumb za dostop do urejevalnika tem za temo Bootswatch'']]
 


Stran urejevalnika predlog vam omogoča, da izberete predlogo, ki jo želite urediti/ogledati.


LimeSurvey-ev urejevalnik besedil vam dovoljuje urejanje vsebine predlog neposredno na spletu. V urejevalnik predlog vstopite s klikom na ikono "Urejevalnik predlog" [[File:templates.png]] v LimeSurvey-evi skrbniški orodni vrstici. Glavno okno je podobno LimeSurvey-evemu oknu za delo z anketami. Omogoča vam izbiro predloge za urejanje ali ogled. Ko ste izbrali predlogo, lahko izbirate med številnimi zasloni ankete, ki se prikazujejo anketirancem. Predstavi se vam seznam datotek izbrane predloge, ki sestavljajo ta izbran zaslon.


[[File:Template-editor-2013-7-10_11_38_16.png|center]]
[[File:Template-editor-2013-7-10_11_38_16.png|center]]


==Meni za delo s predlogami==


*'''Ikona za urejanje:''' ikona za "urejanje" nakazuje ali je predlogo možno urejati ali ne. Nejasna ikona nakazuje, da je predloga le za branje, med tem ko izpostavljena/obarvana ikona pomeni, da je možno predlogo spreminjati. Za spreminjanje ikone iz zamegljene v obarvano je potrebno spremeniti dovoljenja predloge.
Na voljo so naslednje možnosti:
*'''Uvozi predlogo:''' omogoča uvažanje predlog.
 
*'''Izvozi predlogo:''' omogoča izboz trenutne predloge v datoteko oblike .zip.
*'''Kopiraj to predlogo:'''omogoča ustvarjanje nove predloge, ki je kopija trenutno izbrane.
*'''Preimenuj to predlogo:''' omogoča spreminjanje imena izbrane predloge. Običajno se uporablja po kopiranju obstoječe predloge ali po uvažanju predloge za spreminjanje map v ozadju predlog.


Spustni seznam "Zaslon" na desni strani vam omogoča izbiro določenega dela ankete, ki ga želite videti.
*''''Ustvari'''': Omogoča ustvarjanje nove predloge. Da ne bi začeli iz nič, je predloga 'default' kopirana.
*'''Import''': Omogoča vam uvoz predloge iz datoteke ZIP.
*'''Export''' : Omogoča izvoz trenutne predloge v datoteko ZIP.
*'''Kopiraj''': Omogoča ustvarjanje nove predloge s kopiranjem trenutne.
*'''Preimenuj''': Omogoča spreminjanje imena predloge. Običajno se uporablja po kopiranju ali uvozu predloge.
*'''Predloga''': Spustni seznam, ki prikazuje vse razpoložljive predloge, ki se nahajajo v vaši namestitvi LimeSurvey.


==Uvažanje/izvažanje/kopiranje predloge==
*''''Zaslon'''': Spustni seznam, ki vam omogoča, da izberete, katero stran ankete te predloge si želite ogledati.
*''''Nazaj na skrbniško ploščo''''.


Kadar predlogo '''izvozite''', s tem ustvarite arhiv v obliki zip datoteke, v kateri se nahajajo vse datoteke, ki sestavljajo predlogo (.pstpl datoteke, slike, css datoteke, ...). Izvoženo zip datoteko lahko enostavno '''uvozite''' v drug LimeSurvey-ev anketni sistem z uporabo njene funkcionalnosti za uvažanje ali s pomočjo ročnega kopiranja arhivske datoteke v namestitvene mape drugega anketnega sistema ter razpakiranjem v njeno ustrezno mapo za predloge. Če kopirate predlogo na isti anketni sistem, boste morali preimenovati mapo z drugim imenom kopije te predloge.
===Uvozi/Izvozi/Kopiraj predlogo===


V kolikor vaše pravice za dostop do LimeSurvey-evih datotek in map vključujejo pravico branja in pisanja, potem lahko za ustvarjanje lokalne kopije predloge uporabite programa '''copy''' in '''rename'''.
Ko '''izvozite '''predlogo, bo ustvarjen arhiv ZIP-datoteke z vsemi vašimi datotekami predlog (datoteke .pstpl, slike, datoteke css, ...). Izvoženo datoteko zip lahko '''uvozite''' v drugo namestitev LimeSurvey z uporabo funkcije uvoza ali pa ročno prekopirate arhiv v drugo namestitev LimeSurvey in jo ekstrahirate v ustrezno [[Theme editor#Template files location|template imenik tam]].  


==Zgradba strani / uporaba v predlogah==
Najbolje pa je uporabiti funkcije za uvoz/izvoz/kopiranje predloge LimeSurvey v urejevalniku predlog.
*'''Pozdravna stran:''' startpage.pstpl, welcome.pstpl, privacy.pstpl,  navigator.pstpl, endpage.pstpl
*'''Strani z vprašanji:''' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl
*'''Stran za oddajo ankete:''' startpage.pstpl, survey.pstpl, submit.pstpl, (privacy.pstpl), navigator.pstpl, endpage.pstpl
*'''Zaključna stran:''' startpage.pstpl, assessment.pstpl, completed.pstpl, endpage.pstpl


==Datoteke predlog==
===Struktura strani / uporaba predloge===
*'''Pozdravna stran:''' startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
*'' 'Strani z vprašanji:'''' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
*''''Končna stran:'''' začetna stran .pstpl, ocena.pstpl, dokončano.pstpl, končna stran.pstpl


Sledi seznam datotek za predloge, ki se uporabljajo za izgradnjo javne ankete in ki morajo obstajati v vsaki novo ustvarjeni mapi za predloge:
===Datoteke predloge===
*'''startpage.pstpl:''' oblikuje začetek vsake html strani. Prične se pri oznaki "<head>" in ne sme vsebovati oznake "<html>". Ta 'sam začetek' standardne html strani je napisan s pomočjo ukaznih datotek (skript). Prosimo poskrbite, da vaše datoteke startpage.pstpl vsebujejo oznako <body>, kljub temu da z upoštevanjem W3 HTML standarov tega številni brskalniki ne zahtevajo striktno. Za zagon določenih javascript elementov morajo to oznako <body> najti LimeSurvey-eve ukazne datoteke. Ne pričakuje se, da se bodo v datoteki startpage.pstpl uporabljale številne 'ključne besede', najbrž pa si boste želeli v naslov vstaviti {SURVEYNAME}. Datoteka startpage.pstpl lahko vsebuje oznake, ki se zaključijo v ustrezni datoteki endpage.pstpl. Tako lahko začnete tabelo v tej datoteki in jo zaključite v datoteki endpage.pstpl. Datoteki startpage.pstpl in endpage.pstpl objameta vse možne datoteke, ki jih uporablja LimeSurvey.
*'''survey.pstpl:''' ta datoteka je druga najpogosteje uporabljena na večini anketnih straneh in zagotavlja prostor za umestitev imena in opisa ankete. Ta datoteka nima ustrezne 'zaključne' datoteke in je tako posledično potrebno zapreti vse odprte oznake v tej datoteki (oziroma ne puščajte odprtih tabel v tej datoteki, ker jih ni mogoče nikjer drugje zaključiti)
*'''welcome.pstpl:''' ta datoteka se uporablja le na pozdravni strani (kar je tudi glavna stran za ankete v obliki 'Vse skupaj'). To datoteko lahko uporabite, če želite natisniti pozdravno besedilo in ostale informacije, ki se naj bi nahajale v uvodni predstavitvi. Podobno kot pri datoteki 'survey.pstpl' za to datoteko ne obstaja ustrezna  'zaključna' datoteka, zato je potrebno prav tako zapreti vse odprte oznake v tej datoteki.
*'''startgroup.pstpl:''' ta datoteka nudi  'povzetek' za vprašanja znotraj skupine. Ima ustrezno zaključno datoteko 'endgroup.pstpl', ki jo lahko uporabimo za zapiranje odprtih oznak v tej datoteki, zato lahko odpremo tabelo znotraj te datoteke.
*'''groupdescription.pstpl:''' ta datoteka predloge se uporablja za prikaz opisa skupine. Je ločena od datoteke startgroup.pstpl, ker je v anketi oblike  "Po vprašanjih" prikazana na svoji strani med skupinami, medtem ko v anketi oblike "Po skupinah" ali "Vse skupaj" ta datoteka skrbi za glavo za naslednja vprašanja. Datoteka groupdescription.pstpl nima ustrezne 'zaključne' datoteke, zato morajo biti vse oznake ustrezno zaključene.
*'''question.pstpl:''' ta datoteka vsebuje vaše anketno vprašanje, njen odgovor in območje za besedilo pomoči. Pri anketah oblike "Po skupinah" in "Vse skupaj" se ta datoteka predloge ciklično ponavlja za vsako vprašanje. Zanjo ni ustrezne zaključne datoteke, zato morajo biti vse oznake ustrezno zaključene.
*'''question_start.pstpl:''' ta datoteka vsebuje posamezne elemente, ki se nahajajo na začetku vprašanja. Vključena je znotraj datoteke 'question.pstpl' preko ključne besede {QUESTION}. To naj bi omogočilo oblikovalcem predlog več nadzora nad izgledom vprašanja. Ta del predloge se nahaja zunaj običajnega sistema predlog in '''je bila nadomeščena (od LS1.87 naprej)'''. Vse ključne besede iz tega dela predloge so sedaj na voljo neposredno v datoteki question.pstpl. Opozorilo: predloge, ki uporabljajo datoteko question_start.pstpl, bodo še vedno delovale vsaj za nekaj nadaljnjih različic LS 1.x
*'''submit.pstpl (in privacy.pstpl):''' ta stran je predzadnja stran za vse oblike anket (razen za obliko "Vse skupaj"), kjer je anketirancu ponujena možnost pregleda vprašanj pred oddajo njihovih odzivov. Zagotavlja podatke o zasebnosti, kadar je anketa anonimna, ki jih izlušči iz datoteke '''privacy.pstpl'''.
*'''completed.pstpl:''' ta stran se prikaže kot končna stran, ko so odzivi na anketo shranjeni in je anketa zaključena. Uporabi se lahko za prikaz  "povezave za posredovanje", katera se navede v nastavitvah ankete.
*'''endgroup.pstpl:''' ta datoteka zaključi skupino in se lahko uporabi za zaključevanje morebitnih odprtih oznak v datoteki startgroup.pstpl.
*'''navigator.pstpl:''' ta datoteka vsebuje gumbe za navigacijo po anketi (povezave "naslednja", "prejšnja", "zadnja", "oddaj", "shrani" in "počisti vse"). Uporablja se na vseh straneh razen na zaključni strani.
*'''printanswers.pstpl:''' ta datoteka vsebuje HTML sveženj za tiskanje ankete.
*'''print_group.pstpl:''' ta datoteka je enaka kot  startgroup.pstpl in endgroup.pstpl skupaj,vendar je namenjena za tiskanje ankete.
*'''print_question.pstpl:''' ta datoteka je enake kot question.pstpl, vendar je namenjena za tiskanje ankete.
*'''print_survey.pstpl:''' ta datoteka je enaka kot survey.pstpl, vendar je namenjena za tiskanje ankete.


== CSS in Javascript==
Naslednje datoteke s predlogami se uporabljajo za izdelavo vaše javne ankete in morajo obstajati v kateri koli novi mapi s predlogami, ki jo ustvarite:
*'''startpage.pstpl:''' Ustvari začetek vsake strani html. Začne se pri "<head> " in ne sme vsebovati "<html> ". Ta 'pravi začetek' standardne strani html napišejo skripti. Prepričajte se, da vaše datoteke startpage.pstpl vsebujejo<body> oznaka. Čeprav mnogi brskalniki ne zahtevajo strogega upoštevanja standardov W3 HTML, mora skript LimeSurvey najti oznako za izvajanje določenih elementov javascript. V datoteki startpage.pstpl ni pogosto videti veliko 'ključnih besed'. Vendar pa boste morda želeli v naslov dodati {SURVEYNAME}. Datoteka startpage.pstpl lahko vsebuje kodo, ki se konča v ustrezni datoteki endpage.pstpl. Na primer, lahko začnete tabelo v tej datoteki in zaprete tabelo v datoteki endpage.pstpl. Datoteki startpage.pstpl in endpage.pstpl se zavijeta okoli vseh možnih strani, ki jih uporablja LimeSurvey.
*''''survey.pstpl:'''' Ta predloga je druga uporabljena na večini strani in ponuja prostor za ime ankete in opis. Ta predloga nima ustrezne 'zapiralne' predloge, zato bi morali zapreti vse oznake, odprte v tej datoteki predloge (tj.: ne puščajte odprte tabele tukaj, ker je ni nikjer drugje za zapreti).
*' ''welcome.pstpl:'' Ta predloga se uporablja samo na pozdravnem zaslonu (ki je tudi na glavni strani za ankete 'vse v enem'). To lahko uporabite za natis pozdravnega besedila in drugih informacij, ki jih je treba navesti v uvodu. Tako kot datoteka 'survey.pstpl', ni ustrezne 'zapiralne' predloge, zato je treba zapreti tudi vse oznake, odprte v tej datoteki predloge.
*''''startgroup.pstpl:'''' Ta predloga lahko zagotovi "povzetek" za vprašanja znotraj skupine. Ima ujemajočo se predlogo 'endgroup.pstpl', ki jo lahko uporabite za zapiranje vseh odprtih oznak v tej datoteki, tako da lahko odprete tabelo znotraj te.
*'''groupdescription.pstpl:''' Ta datoteka predloge je uporablja se za prikaz opisa skupine. Upoštevajte, da lahko v nastavitvah ankete (dostopite do »Nastavitve predstavitve in navigacije« s klikom na zavihek »Predstavitev«) nastavite, ali naj bo opis skupine prikazan ali ne. Če ne, potem ta datoteka sploh ni vključena.
*'''question.pstpl:''' Ta datoteka vsebuje razdelke besedila vprašanj, odgovorov in pomoči vaše ankete. V anketah »skupina po skupini« in »vse v enem« se ta predloga ponavlja z vsakim vprašanjem. Za to ni ustrezne zaključne datoteke in vse oznake bi morale biti zaprte.
*'''question_start.pstpl:''' Ta datoteka vsebuje posamezne elemente, najdene na začetku vprašanja. Vključen je v 'question.pstpl' prek ključne besede {QUESTION}. Oblikovalcem predlog omogoča večji nadzor nad postavitvijo vprašanja. Ta predloga je zunaj običajnega sistema predlog in '''je bila nadomeščena (od LimeSurvey 1.87)'''. Vse ključne besede iz te predloge so zdaj na voljo neposredno v question.pstpl.
*'''completed.pstpl:''' Ta stran je prikazana kot zadnja stran, ko so odgovori na anketo shranjeni in je anketa končana. Uporablja se lahko za prikaz "posredovalne povezave", kot je nastavljena v nastavitvah ankete.
*'''endgroup.pstpl:'''' Ta datoteka zapre skupino in jo lahko uporabite za zapiranje vseh oznak, odprtih v datoteka startgroup.pstpl
*'''navigator.pstpl:''' Ta datoteka vsebuje gumbe za krmarjenje po anketi, "naslednja", "prejšnja", "zadnja", "pošlji", "shrani doslej" in povezavo "počisti vse". Uporablja se na vseh straneh, razen na izpolnjeni strani.
*'''printanswers.pstpl:''' Ta datoteka ima ovoj HTML, potreben za tiskano različico ankete.
*'''print_group.pstpl :''' Ta datoteka je enaka startgroup.pstpl in endgroup.pstpl, vendar za tiskano različico ankete.
*'''print_question.pstpl:'''' Ta datoteka je enaka question.pstpl , vendar za tiskano različico ankete.
*'''print_survey.pstpl:''' Ta datoteka je enaka anketi.pstpl, vendar za tiskano različico ankete.
 
=== CSS in Javascript===


Za predlogo se vedno uporabljata dve datoteki: template.css za css in template.js za javascript.
Za predlogo se vedno uporabljata dve datoteki: template.css za css in template.js za javascript.
Line 91: Line 111:
*'''{TEMPLATEJS}:''' doda vrstice za privzete datoteke javascript-a, template.js in vse datoteke oblike js, ki jih potrebuje LimeSurvey.
*'''{TEMPLATEJS}:''' doda vrstice za privzete datoteke javascript-a, template.js in vse datoteke oblike js, ki jih potrebuje LimeSurvey.


=== Zamenjava privzetega css-ja ali javascript-a===
=== Uporaba Bootstrapa===
LimeSurvey ima vdelan Bootstrap 3, tako da lahko oblikujete vse svoje predloge z dobro dokumentiranimi razredi Bootstrap.
Za več informacij si oglejte [https://getbootstrap.com Bootstrap dokumentacija].
 
Vključen je tudi vtičnik [https://github.com/flatlogic/awesome-bootstrap-checkbox Awesome-Bootstrap-Checkbox]. Z njim lahko uporabite tipične barvne razrede Bootstrap (informacije, opozorilo, nevarnost itd.) tudi s pripono "-checkbox" ali "-radio", čeprav stilizirate potrditvena polja in radie po želji.
 
==== Zamenjava privzetega CSS ali Javascripta====


Nekatera vprašanja uporabljajo posebne datoteke za javascript ali css. Lahko uporabite tudi svoje datoteke. Vse uporabljene datoteke v vaši anketi vključene v ./scripts ali v .//styles-public so lahko zamenjane. Potrebno je samo dodati datoteko z enakim imenom v vašo predlogo.
Nekatera vprašanja uporabljajo posebne datoteke za javascript ali css. Lahko uporabite tudi svoje datoteke. Vse uporabljene datoteke v vaši anketi vključene v ./scripts ali v .//styles-public so lahko zamenjane. Potrebno je samo dodati datoteko z enakim imenom v vašo predlogo.


==Druge datoteke predloge==
===Druge datoteke predlog===


Datotek '''privacy.pstpl''', '''invitationemail.pstpl''', '''reminderemail.pstpl''' in '''confirmationemail.pstpl''' LimeSurvey več ne uporablja. Namesto tega je vsebina privzeto nastavljena v ustreznih jezikovnih datotekah. Elektronska sporočila se lahko tako zdaj urejajo v anketi na nivoju ankete.
Datotek '''privacy.pstpl''', '''invitationemail.pstpl''', '''reminderemail.pstpl''' in '''confirmationemail.pstpl''' LimeSurvey več ne uporablja. Namesto tega je vsebina privzeto nastavljena v ustreznih jezikovnih datotekah. Elektronska sporočila se lahko tako zdaj urejajo v anketi na nivoju ankete.


==Standardne datoteke==
===Standardne strani===


Obstaja deset standardnih strani, ki jih lahko anketiranec vidi med anketiranjem ali dostopanjem do anketnega sistema. Vsaka stran je sestavljena iz več skupnih datotek '''predloge''', ki je določena v nastavitvah ankete. Spodnja tabela nakazuje katere datoteke predlog se uporabljajo pri sestavljanju posamezne strani.
Obstaja deset standardnih strani, ki jih lahko anketiranec vidi med anketiranjem ali dostopanjem do anketnega sistema. Vsaka stran je sestavljena iz več skupnih datotek '''predloge''', ki je določena v nastavitvah ankete. Spodnja tabela nakazuje katere datoteke predlog se uporabljajo pri sestavljanju posamezne strani.
Line 147: Line 173:
|}
|}


<span style='color:red'>'''*'''</span>Opomba: v različici 1.90 in višji ta nadomešča question.pstpl in question_start.pstpl. Če uporabljate starejšo predlogo po meri, boste morali na začetek datoteke question.pstpl dodati naslednje vrstice:<syntaxhighlight lang="php" enclose="div"><div {QUESTION_ESSENTIALS} class="{QUESTION_CLASS}{QUESTION_MAN_CLASS}{QUESTION_INPUT_ERROR_CLASS}"></syntaxhighlight> In potem dodajte še ustrezne zaključne oznake na konec datoteke question.pstpl:<syntaxhighlight lang="php" enclose="div"></div></syntaxhighlight>
<span style='color:red'>'''*'''</span> OPOMBA: V različici 1.90+ to nadomesti question.pstpl IN question_start.pstpl. Če uporabljate staro predlogo po meri, morate na začetek question.pstpl dodati naslednjo vrstico: <syntaxhighlight lang="php"><div {QUESTION_ESSENTIALS} class="{QUESTION_CLASS}{QUESTION_MAN_CLASS}{QUESTION_INPUT_ERROR_CLASS}"></syntaxhighlight> In nato dodajte ustrezno zaključno oznako na konec question.pstpl:<syntaxhighlight lang="php"></div></syntaxhighlight>


<span style='color:red'>'''*'''</span>Opomba: LimeSurvey-eve js datoteke v različici 1.91 in prejšnjih niso vključene s predlogo. V različici 2 '''morate uporabiti ključno besedo {TEMPLATEJS} v eni izmed vaših datotek predloge''', da s tem dodate povezavo do js datoteke. Lahko jo dodate v datoteki startpage.pstpl ali v datoteki endpage.pstpl. Odstranite lahko vrstico {TEMPLATEURL}/template.js in jo nadomestite z {TEMPLATEJS}, da s tem posodobite osebno predlogo.
<span style='color:red'>'''*'''</span>Opomba: LimeSurvey-eve js datoteke v različici 1.91 in prejšnjih niso vključene s predlogo. V različici 2 '''morate uporabiti ključno besedo {TEMPLATEJS} v eni izmed vaših datotek predloge''', da s tem dodate povezavo do js datoteke. Lahko jo dodate v datoteki startpage.pstpl ali v datoteki endpage.pstpl. Odstranite lahko vrstico {TEMPLATEURL}/template.js in jo nadomestite z {TEMPLATEJS}, da s tem posodobite osebno predlogo.


==Področje za kontrolo datotek==
===Razdelek za nadzor datotek===
 
V oknu "nadzor datotek" na levi lahko kliknete eno od datotek predloge, ki se uporablja za prevajanje strani. Ogledate si lahko datoteke ''Screen del'', JavaScript in CSS. Koda HTML za to datoteko se bo nato pojavila v oknu »Trenutno urejanje« na sredini. Če je predlogo mogoče urejati (določeno z dovoljenji imenika), lahko naredite kakršne koli spremembe in jih shranite.
 
<center>[[Datoteka:File Control Section.png|center]]</center>
 


V oknu za "kontrolo datotek" na levi lahko izberete eno od datotek predloge, ki se uporablja za sestavo strani. HTML koda za to datoteko se bo potem prikazala na sredini v oknu "Sedaj urejam". Če je predloga na voljo za urejanje (določeno s pravicami map), lahko spreminjate vsebino datotek in jih potem shranite.
V oknu "Druge datoteke" je prikazan seznam vseh drugih datotek, ki se nahajajo v mapi predloge. Desno stran lahko uporabite za '''nalaganje in izbiranje slikovnih datotek (vaših slik, logotipov,...) ali drugih datotek, ki so potrebni za izgradnjo vaše predloge'''. Opomba: namesto neposrednih povezav do vsake slike v vaši predlogi lahko uporabite ključno besedo {TEMPLATEURL}. Tako namesto:


V oknu "Druge datoteke" je prikazan seznam vseh drugih datotek, ki se nahajajo v mapi predloge. Desno stran lahko uporabite za '''nalaganje in izbiranje slikovnih datotek (vaših slik, logotipov,...) ali drugih datotek, ki so potrebni za izgradnjo vaše predloge'''. Opomba: namesto neposrednih povezav do vsake slike v vaši predlogi lahko uporabite ključno besedo {TEMPLATEURL}. Tako namesto:


<syntaxhighlight lang="html4strict" enclose="div">img src='/limesurvey/templates/yourtemplate/mypicture.jpg'</syntaxhighlight>  
Namesto povezave za vsako sliko uporabite niz polja {TEMPLATEURL}. Torej, namesto:
Lahko uporabite:
 
<syntaxhighlight lang="html4strict" enclose="div">img src='{TEMPLATEURL}mypicture.jpg'</syntaxhighlight>
<syntaxhighlight lang="html4strict">img src='/limesurvey/templates/yourtemplate/files/mypicture.jpg'</syntaxhighlight>  
Lahko uporabite {{NewIn|2.50}}:
<syntaxhighlight lang="html4strict"> img src='{TEMPLATEURL}datoteke/moja slika.jpg'</syntaxhighlight>
 
V različicah LimeSurvey pred 2.50 uporabite:
<syntaxhighlight lang="html4strict"> img src='{TEMPLATEURL}moja slika.jpg'</syntaxhighlight>


"Primer" strani predloge, ki jo urejate, je viden na dnu okna. Na noben način predloge ne morete izbrisati iz urejevalnika predlog. To mora biti narejeno z dostopom do sistemskih map in brisanjem datotek na tem nivoju.
"Primer" strani predloge, ki jo urejate, je viden na dnu okna. Na noben način predloge ne morete izbrisati iz urejevalnika predlog. To mora biti narejeno z dostopom do sistemskih map in brisanjem datotek na tem nivoju.
Line 165: Line 200:
<div class="simplebox">'''Opomba:''' poslanih predlog ni mogoče urejati z urejevalnikom predlog in jih tudi naj nebi spreminjali. Če jih želite spreminjati, najprej ustvarite kopijo, na kateri delajte spremembe.</div>
<div class="simplebox">'''Opomba:''' poslanih predlog ni mogoče urejati z urejevalnikom predlog in jih tudi naj nebi spreminjali. Če jih želite spreminjati, najprej ustvarite kopijo, na kateri delajte spremembe.</div>


==Mesto datotek predloge==
===Lokacija datotek predloge===


LimeSurvey shranjuje vse 'standardne' predloge v njihove lastne različne podmape znotraj mape /templates, ki se nahaja v javni mapiz ostalimi LimeSurvey-evimi javnimi datotekami. Prilagojene predloge uporabnika se shranijo v mapo /upload/templates.
LimeSurvey shranjuje vse 'standardne' predloge v njihove lastne različne podmape znotraj mape /templates, ki se nahaja v javni mapiz ostalimi LimeSurvey-evimi javnimi datotekami. Prilagojene predloge uporabnika se shranijo v mapo /upload/templates.
Da ustvarite novo predlogo, morate izbrati ustrezno ikono v urejevalniku predlog.


VEDNO mora obstajati mapa "default" v mapi predlog. Ta predloga se privzeto uporablja in se uporabi kot nadomestna, če mapa predloge ne obstaja ali je ni mogoče najti. Mapa "default" je vključena v paket za namestitev sistema.
VEDNO mora obstajati mapa "default" v mapi predlog. Ta predloga se privzeto uporablja in se uporabi kot nadomestna, če mapa predloge ne obstaja ali je ni mogoče najti. Mapa "default" je vključena v paket za namestitev sistema.
Line 175: Line 208:
Uporabite lahko poljubno sliko, ki ste jo naložili v območje za upravljanje predloge, z uporabo zapisa podobnega temu:
Uporabite lahko poljubno sliko, ki ste jo naložili v območje za upravljanje predloge, z uporabo zapisa podobnega temu:


<syntaxhighlight lang="php" enclose="div">{TEMPLATEURL}imedatoteke.xyz</syntaxhighlight>
<syntaxhighlight lang="php">{TEMPLATEURL}ime datoteke.xyz</syntaxhighlight>


=CSS oblikovanje vprašanj=
==Slogovna vprašanja s CSS==


Oblikovanje vprašanj je z uporaba CSS-ja postalo veliko enostavnejše. Vsak tip vprašanj ime sedaj svoj edinstven razred. Obvezna vprašanja imajo prav tako dodaten obvezni razred. Primer za neobvezno vprašanje:
Oblikovanje vprašanj je z uporaba CSS-ja postalo veliko enostavnejše. Vsak tip vprašanj ime sedaj svoj edinstven razred. Obvezna vprašanja imajo prav tako dodaten obvezni razred. Primer za neobvezno vprašanje:


<syntaxhighlight lang="html4strict" enclose="div"><div id="question5" class="gender">
<syntaxhighlight lang="html4strict"><div id="question5" class="gender">
...
...
</div></syntaxhighlight>
</div></syntaxhighlight>
Line 187: Line 220:
in v kolikor je vprašanje obvezno
in v kolikor je vprašanje obvezno


<syntaxhighlight lang="html4strict" enclose="div"><div id="question5" class="gender mandatory">
<syntaxhighlight lang="html4strict"><div id="question5" class="gender mandatory">
...
...
</div></syntaxhighlight>
</div></syntaxhighlight>
Line 193: Line 226:
in če uporabnik ni odgovoril na obvezno vprašanje ali če je za vprašanje predvidena potrditev
in če uporabnik ni odgovoril na obvezno vprašanje ali če je za vprašanje predvidena potrditev


<syntaxhighlight lang="html4strict" enclose="div"><div id="question5" class="gender mandatory input-error">
<syntaxhighlight lang="html4strict"><div id="question5" class="gender mandatory input-error">
...
...
</div></syntaxhighlight>
</div></syntaxhighlight>
Line 199: Line 232:
in če ima vprašanje predvideno preverjanje, vendar je anketiranec napačno odgovoril
in če ima vprašanje predvideno preverjanje, vendar je anketiranec napačno odgovoril


<syntaxhighlight lang="html4strict" enclose="div"><div id="question6" class="text-short input-error">
<syntaxhighlight lang="html4strict"><div id="question6" class="text-short input-error">
...
...
</div></syntaxhighlight>
</div></syntaxhighlight>
Line 373: Line 406:
|}
|}


=== Nekateri primeri vprašanj z razredi===
==== Nekaj primerov vprašanj z razredi====


'''Vprašanje vrste kratkega besedila:'''<source lang="html4strict">
'''Vprašanje vrste kratkega besedila:'''<source lang="html4strict">
Line 419: Line 452:
</table>
</table>
</source>
</source>
==Celotni seznam razredov vprašanj==
===Celoten seznam razredov vprašanj===


{|
{|
Line 481: Line 514:
|}
|}


==Celoten seznam razredov za potrjevanje==
===Celoten seznam validacijskih razredov===


<div class="simplebox">Opomba:  Pred različico 1.92 sta bila na voljo le razreda .mandatory in .input-error.</div>
<div class="simplebox">Opomba:  Pred različico 1.92 sta bila na voljo le razreda .mandatory in .input-error.</div>
Line 519: Line 552:
|}
|}


==Uvažanje stilov v vašo prilagojeno predlogo==
===Uvoz slogov v vašo predlogo po meri===


Prilagojene oblike vprašanja so proti koncu vsake CSS datoteke predloge in se pričnejo z:<syntaxhighlight lang="php" enclose="div">/* --------------------------- START: Question styles  ------------------------------ */</syntaxhighlight>
Slogi vprašanj po meri so blizu dna datoteke CSS vsake predloge in se začnejo z:<syntaxhighlight lang="php"> /* --------------------------- ZAČETEK: slogi vprašanj ----------------- ------------- */</syntaxhighlight>


Če oblikujete svojo prilagojeno predlogo, lahko kopirate vse iz templates/default/template.css (postavitve na osnovi tabel) ali /templates/limespired/template.css (postavitve na osnovi CSS-ja) v vaš lasten oblikovni slog brez kakršnega koli vplivanja na vaše druge oblike.
Če oblikujete svojo prilagojeno predlogo, lahko kopirate vse iz templates/default/template.css (postavitve na osnovi tabel) ali /templates/limespired/template.css (postavitve na osnovi CSS-ja) v vaš lasten oblikovni slog brez kakršnega koli vplivanja na vaše druge oblike.


==Pogojne oblike slogov za Internet Explorer==
===Internet Explorer Conditional Style Sheets===


Zaradi izrazitega neskladja pri usklajevanju med IE6, IE7 in večine drugih brskalnikov, obstajajo posebne pogojne oblike slogov za IE  vključene v vsako predlogo.
Zaradi izrazitega neskladja pri usklajevanju med IE6, IE7 in večine drugih brskalnikov, obstajajo posebne pogojne oblike slogov za IE  vključene v vsako predlogo.


<source lang="html4strict" enclose="div">
<source lang="html4strict">
<!--[if IE]>
<!--[if IE]>
   <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_all-versions.css" />
   <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_all-versions.css" />
<![endif]-->
<![endif]-->  
<!--[if lt IE 7]>
<!--[if lt IE 7]>
   <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_older-than-7.css" />
   <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_older-than-7.css" />
<![endif]-->
<![endif]-->  
<!--[if IE 8]>
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}ie_fix_8.css" />
<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}ie_fix_8.css" />
<![endif]-->
<![endif]-->  
</source>
</source>


Line 545: Line 578:
<div class="simplebox">'''Opomba:''' če kopirate oblike v vašo lastno obliko slogov, jih boste skoraj zagotovo morali popravljati.</div>
<div class="simplebox">'''Opomba:''' če kopirate oblike v vašo lastno obliko slogov, jih boste skoraj zagotovo morali popravljati.</div>


===Druge rešitve za Internet Explorer===
====Alternativna rešitev za Internet Explorer====


V datoteko startpage.pstpl lahko vstavite pogojni razred za telo in uporabite ta razred v vapi datoteki template.css. Ta metoda je uporabljena v predlogi citronade.
V datoteko startpage.pstpl lahko vstavite pogojni razred za telo in uporabite ta razred v vapi datoteki template.css. Ta metoda je uporabljena v predlogi citronade.
Line 562: Line 595:
.ie{/*posebej za vse različice internet explorerja */}</source>
.ie{/*posebej za vse različice internet explorerja */}</source>


== Jeziki od desne-proti-levi (RTL(right-to-left)) in poravnave==
=== Jeziki od desne proti levi (RTL) in utemelji ===


LimeSurvey-ev urejevalnik besedila je zmožen oblikovati RTL besedilo. Sam urejevalnik kaže RTL jezik v obliki od leve proti desni, kadar je poravnano. To je zgolj stvar prikaza urejevalnika. Od desne proti levi in poravnano vprašanje ali besedilo se bo v vaši anketi ali v predogledu prikazalo pravilno od desne proti levi tudi če je poravnano.
LimeSurvey-ev urejevalnik besedila je zmožen oblikovati RTL besedilo. Sam urejevalnik kaže RTL jezik v obliki od leve proti desni, kadar je poravnano. To je zgolj stvar prikaza urejevalnika. Od desne proti levi in poravnano vprašanje ali besedilo se bo v vaši anketi ali v predogledu prikazalo pravilno od desne proti levi tudi če je poravnano.


==Ključne besede==
===Ključne besede===
 
{{Zastarelo|3.0}}


Ključne besede, ki se nahajajo znotraj datotek predloge, bodo zamenjane s trenutnimi podatki ankete. Obdane so z zavitimi oklepaji, na primer: {SURVEYNAME}
Ključne besede, ki se nahajajo znotraj datotek predloge, bodo zamenjane s trenutnimi podatki ankete. Obdane so z zavitimi oklepaji, na primer: {SURVEYNAME}
Line 678: Line 713:
|}
|}


==Vnos/Gumbi==
===Vnos/Gumbi===


Vsaki vrsti "vnosa" v anketi je bilo dano svoje ime razreda. Tako lahko dodate CSS v vašo datoteko "startpage.pstpl" in imate nekaj možnosti vplivanja  na prikaz oblike gumbov in vnosov. Ta imena razredov so sledeča:
Vsaki vrsti "vnosa" v anketi je bilo dano svoje lastno ime razreda. Tako lahko dodate CSS kodo v vašo datoteko "startpage.pstpl" in imate z njo nekaj možnosti vplivanja  na prikaz oblike gumbov in vnosov. Ta imena razredov so sledeča:
*'''submit''' (Gumbi za oddajo)
*'''submit''' (Gumbi za oddajo)
*'''text''' (Besedilni vnosi - za kratko besedilo, datum in številke)
*'''text''' (Besedilni vnosi - za kratko besedilo, datum in številke)
Line 686: Line 721:
*'''radio''' (Radijski gumbi)
*'''radio''' (Radijski gumbi)
*'''checkbox''' (Potrditvena polja)
*'''checkbox''' (Potrditvena polja)
*'''select''' (Select / List Boxes)
*'''select''' (Izbirna polja/Seznam)
*'''textarea''' (Large text inputs - for long free text)
*'''textarea''' (Večji tekstovni vnosi - za daljše prosto besedilo)
*'''clearall''' (The "Exit and Clear Survey" link)
*'''clearall''' (Povezava za "Izhod in počisti anketo")
*'''rank''' (The rank style question. Doesn't set the colour of the select box or the text boxes (these are set by relevant section above) but does allow changing of background colour, text colour and size etc for the rest of the ranking question)
*'''rank''' (Oblika prednostnega vprašanja. Ne nastavi barve izbranega polja ali polj za besedilo (to se nastavi z ustreznim razdelkom zgoraj), vendar omogoča menjavo barve ozadja, barva besedila, velikosti itd. za preostala prednostna vprašanja)
*'''graph''' (The "percentage completed" graph table)
*'''graph''' (Tabela v obliki slike za "procent opravljene ankete")
*'''innergraph''' (The table inside the graph table - this contains the 0% and 100% text. Use this for changing the size of this text)
*'''innergraph''' (Tabela znotraj tabele za prikaz procenta opravljene ankete - ta vsebuje besedilo 0% in 100%. To uporabite za spreminjanje velikosti tega besedila)
*'''question''' (General settings for any question that is displayed within a table. Generally you should use this to make sure that their font size and colour is the same as you have used elsewhere as a default)
*'''question''' (Osnovne nastavitve za vsako vprašanje, ki se prikaže znotraj tabele. V splošnem bi morali uporabiti ta razred, da zagotovite enako velike črke in barvo kot ste jo uporabili drugod kot privzeto)
*'''mandatory'''  (Mandatory questions)
*'''mandatory'''  (Obvezna vprašanja)
*'''input-error''' (User input error - for if a user has made a mistake with a mandatory question or question with validation)
*'''input-error''' (Uporabnik je vnesel napako - v primeru ko uporabnik naredi napako pri obveznem vprašanju ali vprašanju, ki se potrjuje)
*'''array1''' and '''array2''' (These two styles are cycled when presenting the range of answers for an array type question. This allows you to set an alternating background colour for these question types. '''Array1''' is also used for the column headings in these question types)
*'''array1''' in '''array2''' (Ti obliki se menjata, ko se prikazuje nek razpon odgovorov za vprašanja tipa polja. To vam omogoča, da nastavite menjajočo barvo ozadja za te tipe vprašanj. '''Array1''' se prav tako uporablja za naslovno vrstico v tabeli pri teh tipih vprašanj)
*'''errormandatory''' (Sets the colour and style of the "This question is mandatory" error message)
*'''errormandatory''' (Nastavljanje barv in oblik pri prikazu sporočila z napako "To vprašanje je obvezno")
*'''warningjs''' (Sets the colour and style of the warning message displayed if the participant's browser has javascript disabled)
*'''warningjs''' (Nastavljanje barve in oblike prikazanega sporočila z napako, če ima anketiranec v svojem brskalniku izklopljen javascript)
 
There are also some elements that can be accessed using the ID of the element ('''#ID''' in CSS):
*'''surveycontact''' (The contact message shown on the start page)
*'''tokenmessage''' (used for messages inside the survey, e.g. the session expired error message)
 
An example of using these classes with style sheets can be found in the "bubblegum" template that comes with the LimeSurvey application.
 
Because you can edit all the HTML aspects, there's no reason to surround your templates with a <div class='new_name'> and then define a css for that new_name class.
 
==Styling the progress bar==


'''Before version 1.87:'''
Obstaja tudi nekaj elementov, ki se jih lahko uporablja z uporabo ID-ja elementa ('''#ID''' v CSS):
*'''surveycontact''' (Sporočilo o stiku, ki se prikaže na uvodni strani)
*'''tokenmessage''' (Uporablja se za sporočila znotraj ankete t.i. sporočilo o napaki, da je seja potekla)


The chart.jpg file is a simple one pixel image file which is used to create the progress bar image in the 'PERCENTCOMPLETE' table. If the file does not exist, LimeSurvey will use the default 'maroon' coloured image in the public directory. If you want to create a bar to match your own colour scheme, then you should save the color in this file. Remember it should be a '''JPEG''' file, 1 pixel x 1 pixel, in the colour desired.
Ker lahko urejate vse vidike HTML, ni razloga, da svoje predloge obdate z
<syntaxhighlight lang="php"><div class='new_name'></div></syntaxhighlight>
in nato definirajte css za ta razred new_name.


'''Version 1.87 and newer:'''
==Oblikovanje vrstice o napredovanju==


The progress bar appearance can be modified with CSS.
Prikaz vrstice napredka se lahko spreminja s CSS-jem.


To change the background colour of the bar, add something like the following to the end of your template.css file.
Če želite spremeniti barvo ozadja vrstice, na konec datoteke custom.css dodajte nekaj podobnega temu (primer za sadno temo):


<syntaxhighlight lang="php" enclose="div">#progress-wrapper .ui-widget-header {
<syntaxhighlight lang="php">.sadno .progress-bar {
 background-color: #3300FF;
barva ozadja: #3300FF;
}</syntaxhighlight>
}</syntaxhighlight>


To change the border colour of the bar, add something like the following to the end of your template.css file.
Če želite spremeniti barvo obrobe vrstice, na konec datoteke custom.css dodajte nekaj podobnega temu (primer za sadno temo):


<syntaxhighlight lang="php" enclose="div">#progress-wrapper .ui-widget-content,
<syntaxhighlight lang="php">.sadno .progress-bar {
#progress-wrapper .ui-widget-header {
obroba: 1px polna #FF0000;
 border: 1px solid #FF0000;
}</syntaxhighlight>
}</syntaxhighlight>


==Advanced Features Available to Developers==
==Napredne funkcije, ki so na voljo razvijalcem==
 
Starting with version 0.99, LimeSurvey has integrated some user-made patches that allow for some special changes.  These very advanced features generally require changes to the underlying code base of LimeSurvey and should be done carefully so as not to introduce security holes.
 
===Basic CMS Integration support===
 
<div class="simplebox">Deprecated: This function is not available anymore in version 2.0 or later</div>
 
To be able to integrate LimeSurvey into another CMS, use the following options in '''config.php''':


// Set $embedded to true and specify the header and footer functions if the survey is to be displayed embedded in a CMS
Začenši z različico 0.99 je LimeSurvey integriral nekaj dodatkov, narejenih s strani uporabnikov, ki omogočajo nekaj posebnih sprememb. Te zelo napredne funkcije v splošnem zahtevajo spremembe v osnovni kodi LimeSurvey-a in jih je potrebno opraviti zelo previdno, da ne ustvarite varnostne luknje.


<nowiki>
====Podpora za vaše lastne funkcije Javascript====
$embedded = false;
$embedded_inc = "";               // path to the header to include if any
$embedded_headerfunc = "";        // e.g. COM_siteHeader for geeklog
$embedded_footerfunc = "";        // e.g. COM_siteFooter for geeklog
</nowiki>


Set '''$embedded = true;''' to enable CMS-embedding. By using the '''$embedded_inc''' variable one can include their own '''.php''' files.  By setting '''$embedded_headerfunc''' or '''$embedded_footerfunc''', one can call functions from within included files that output the relevant headers or footers instead of LimeSurveys default ones.
Nekateri uporabniki bodo morda želeli poganjati  Javascript na straneh ankete, vendar klicanje '''checkconditions()''' v BODY elementu to onemogoča.  To lahko nadomestite z manjšimi  JavaScript funkcijami v glavi (HEAD), ki preiščejo obstoj '''checkconditions()''' in '''template_onload()''' preden kliče posamezno funkcijo.  Na ta način lahko avtor predlogeustvari svojo lastno funkcijo '''template_onload()''' v glavi (HEAD), ki zamenjajo privzete.


===Support for your own Javascript functions===
'''Različica 1.87 in novejša:'''
*Onemogočite XSS filter - v Globalnih nastavitvah -> Varnostno opozorilo, nastavite "Filtriraj HTML za XSS" na Ne.
*Vstavite vašo skripto v jedro vprašanja ali opis skupine.
*Več podrobnosti najdete v [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?/sl|temi o tipičnih problemih]].


Some users may need to run Javascript on the survey pages, but calling '''checkconditions()''' in the BODY element made it impossible to do so.  This call has been replaced with a small JavaScript function in the HEAD that sniffs for the existence of '''checkconditions()''' and '''template_onload()''' before calling each.  This way a template author can create their own '''template_onload()''' function in the HEAD that replaces the default one.
{{Opomba|Za nadaljnje podrobnosti si oglejte [[Nadomestne rešitve: Manipuliranje ankete med izvajanjem z uporabo Javascript#Kako uporabljati skript (npr. JavaScript itd.) v LimeSurvey|oddelek za nadomestne rešitve]].}}


'''Version 1.87 and newer:'''
*Disable XSS filter - in Global settings -> Security, set "Filter HTML for XSS" to No.
*Enter your script in the source of a question or group description.
*There are more details in the [[Workarounds: Manipulating a survey at runtime using Javascript#How to use Script (eg. JavaScript etc.) in LimeSurvey?|workaround section]].


=Videos on Templates=
==Namigi in triki==


This video will demonstrate the basic and advanced template functions that are available to all LimeSurvey users. This includes changing the appearance of certain forms and inserting custom graphics. Additionally, it will thoroughly walk you through on how to edit and preview specific page templates, importing/exporting templates, modify appearance of questions in the CSS, customizing survey description page, and completed page.
===Element, specifičen za jezik===


[http://youtu.be/Uk3FQyDTIY0 LimeSurvey training video - template customization]
Če želite v anketi imeti stavek za določen jezik, na primer pomoč na koncu vsake strani, lahko dodate datoteko .pstl za stavek in ga skrijete za drug jezik. Če ga skrijemo v template.css, lahko uporabimo psevdo izbirnik :lang, vendar za boljšo združljivost uporabimo kakšen razred.


=Tips & Tricks=
Primer: za besedilo pomoči na koncu strani v francoščini in angleščini je potrebno dodati sledeče v datoteko endpage.pstpl:


==Some language specific element==
<syntaxhighlight lang="php"><div class="fr" lang="fr">Pour de l'aide en direct appelez le 000000</div>
<div class="en" lang="en"> Za pomoč pokličite 000000</div></syntaxhighlight>


If you want to have some language specific sentence in a survey, for example a help at end of each page, you can add in a .pstl file a sentence and hidding it for other language. And hidding it in the template.css, we can use the pseudo selector :lang, but for best compatibility, we use some class.
in v datoteko template.css


Example for a help sentence at bottom of the page, in french and english, put this on endpage.pstpl:
<syntaxhighlight lang="php">.lang-fr .en{display:none}
 
<syntaxhighlight lang="php" enclose="div"><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>
 
and in template.css
 
<syntaxhighlight lang="php" enclose="div">.lang-fr .en{display:none}
.lang-en .fr{display:none}</syntaxhighlight>
.lang-en .fr{display:none}</syntaxhighlight>


You can use it to for other sentence in your question before 1.92 ( in 1.92, there are better solutions).
===Spremenite postavitev anketne strani===


==Change the layout of the survey page==
Po urejanju in shranjevanju predloge velja za stran s seznamom anket samo, če je izbrana v nastavitvah ankete. Če želite to narediti kot privzeto predlogo, pojdite pod '''Zavihek Splošno'', ki se nahaja v '''Globalnih nastavitvah''' vaše namestitve LimeSurvey in izberite želeno predlogo. Od te točke naprej bodo vse predloge, ki kot predlogo uporabljajo možnost »privzeto«, in tiste, ki bodo na novo ustvarjene, uporabljale novo izbrano privzeto predlogo.


When editing a template this template can be assigned to a single survey while the survey list page, which is shown at www.yourdomain.org/limesurveyinstallfolder, lists all your surveys.
Če želite uporabiti vašo trenutno predlogo za to stran, morate spremeniti ustrezno nastavitev v '''Globalnih nastavitvah'''. V starejših različicah lahko to spremembo izvedete tako, da uredite nastavitev $defaulttemplate iz konfiguracijske datoteke: kopirajte to nastavitev iz config-defaults.php v config.php, ki preglasi config-defaults.php, in uredite to nastavitev v <code lang="html">$defaulttemplate = 'yourtemplatename';</code> .


To use your current template for this page you have change the according setting at the Global Settings screen; at older versions this change can be done by editing the $defaulttemplate setting at the config file: Copy this setting from config-defaults.php to config.php which overrides config-defaults.php and edit this setting to $defaulttemplate = 'yourtemplatename';
===Uvoz/izvoz predlog: uporabniki Mac===


==Import/Export of templates: Mac users==
Mac uporabniki si prosimo zapomnite: Mac OSX osnovna uporaba arhiva lahko ima nekatere probleme z ustvarjenimi zip mapami.


Mac users, please note: Mac OSX default archive utility may have problems with zip folders "generated on the fly".
da obidete težavo uporabite unix-ov unzip iz ukazne vrstice:
 
a work around is to unix'es unzip from the command line:


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


Archive: template.zip
Arhiv: template.zip


 inflating: template/startpage
 inflating: template/startpage
Line 804: Line 810:
 inflating: ...
 inflating: ...


or scripts in their mac-compiled counterparts:
ali skripte v njihovem delu za mac-prevode:


http://homepage.mac.com/roger_jolly/software/
===Uporabi isto predlogo z različnimi logotipi===


==Changing your templates traffic light from red to green==
Če želite uporabiti enako predlogo za vse ankete in želite le spremeniti logotip v vsaki anketi, lahko uporabite značko {SID} datoteki predloge .pstpl in se s tem navezujete na različne slike:


If you haven't already, set the admin directory to read/write/execute (777). The files within it, however, may be set to read/execute only (chmod 755).
<syntaxhighlight lang="php"><img src="{TEMPLATEURL}files/logoImage-{SID}.png"></syntaxhighlight>


GO to file directory ie file manager, find templates directory.
=== Prikaži priljubljeno ikono po meri===


1 change permission on eg"vallendar" (or any template of your choice) directory to read 777
Favicon je majhna ikona, ki jo vidite v naslovni vrstici brskalnika, na seznamu zaznamkov ali na zavihku. Svojo lastno ikono lahko prikažete na naslednji način:
#Ustvarite ikono priljubljenih strani – z Googlom lahko poiščete veliko brezplačnih generatorjev ikon priljubljenih strani.
#Poimenujte svojo novo ikono priljubljenih strani »favicon.ico« in jo postavite v svojo predlogo /datoteke imenik.
#Dodajte naslednjo kodo vaši '''startpage.pstpl''' pred</head> oznaka.


2 voila! the red traffic light on "vallendar" is now green.
<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>


3 NOTE: to restrict access for safety, when finished editing template files, change all templates files back to what they were eg 644
=== Drugačen videz strani z anketami/vprašanji===


==Replacing the help icon==
Če želite, da LimeSurvey spremeni videz vsake druge strani (tj. sode in lihe anketne strani), lahko uporabite razred '''.page-odd'''' v vaši datoteki CSS, da spremenite videz lihih strani.


When a question help text is shown then an help.gif image is used from the default template folder.
primer iz privzete predloge za LimeSurvey 1.91+


You can replace this image by uploading a new help.gif, help.png or help.jpg in your custom template folder. It then will be automatically used instead of the default help icon.
<syntaxhighlight lang="php">
 
.page-odd table.question-group {
==Replacing an existing logo==
barva ozadja: #D2F2D3;
 
'''Note''': Before uploading a new logo always delete the old, existing one!
 
1. To edit the logo go to the &bdquo;<u>template.css</u>&rdquo; file which you can find it here:
 
[[File:t1.PNG|200px]]
 
2. Click the search button to find occurrences of logo related styles.
 
[[File:2.png|200px]]
 
3. Search for <u>#logo</u>
 
[[File:3.PNG|200px]]
 
4. Edit the main style file
 
You will see something similar to:
 
[[File:t4.PNG|500px]]
 
 
If you want to change the image just replace logo.gif with another image link. Example: (<u>logo.png</u> or <u>logo.jpg</u>).
 
 
If you want change the image size adjust width and height (in pixels) like this:
 
<syntaxhighlight lang="php" enclose="div">width:100px; height:100px;</syntaxhighlight>
 
==Adding your own logo==
 
1. Find and open the &bdquo;<u>startpage.pstpl</u>&rdquo; template file.
 
[[File:5.PNG|200px]]
 
 
2. After the <source lang="html4strict" ><body ... ></source> tag add this line to &bdquo;<u>startpage.pstpl</u>&rdquo;:
<source lang="html4strict"><img id="page_logo" src="{TEMPLATEURL}logo.png"><br></source>
 
 
3. To add logo go to &bdquo;<u>template.css</u>&rdquo;, you can find it here (see in screen):
 
[[File:6.PNG|500px]]
 
 
3.1 Then go to the end of the main &bdquo;<u>template.css</u>&rdquo; style file.
 
 
3.2 To align the logo add...
 
 
'''If you want the logo to be placed at left side:'''
 
<syntaxhighlight lang="php" enclose="div">#page_logo{
   float:left;
}</syntaxhighlight>
}</syntaxhighlight>


Da '''ne''' spreminjate sodih in lihih strani v (privzeti) predlogi, poiščite vse primere uporabe ''.page-odd'' v datoteki template.css in jih odstranite.


'''If you want the logo to be placed at right side:'''
===Ustvarite navpično ločilno obrobo za niz z dvojnim merilom===


<syntaxhighlight lang="php" enclose="div">#page_logo{
Za izdelavo navpičnega razmejitvenega roba za dvojne velikosti polja lahko dodate naslednje vrstice v vašo datoteko '''template.css'''.
   float:right;
}</syntaxhighlight>


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


'''If you want to center the logo'''
header_separator se uporablja za ločevanje v glavi tabele "td" in "dual_scale_separator" se uporablja za ločevanje v stolpcih pri dvojnih velikostih polj.


<syntaxhighlight lang="php" enclose="div">#page_logo{
===Dodajanje lastnega logotipa na anketni seznam===
   display: block;
   margin-left: auto;
   margin-right: auto;
}</syntaxhighlight>


==Use the same template with different logos==
# Najprej odprite urejevalnik tem za temo, ki jo želite uporabljati. [[Datoteka:OpenThemeEditor.jpg]]
# Priporočamo uporabo sadne teme, to je trenutno naša najboljša tema.
# Nato razširite temo in ji dajte ime, ki ga boste prepoznali. [[File:ExtendTheme.jpg]]
# V naslednjem pogledu lahko naložite logotip, ki ga želite uporabiti. [[File:UploadFileTheme.jpg]]
# Izberite zaslon urejevalnika `Survey List´ v spustnem meniju Zaslon v zgornjem desnem kotu. [[File:OpenScreenSurveyList.jpg]]
# Nato izberite `layout_survey_list.twig´ v levem stranskem meniju. [[File:EditLayoutSurveyListTwig.jpg]]
# V urejevalniku se pomaknite do vrstice 126 in spremenite označeni del v ime datoteke slike, ki ste jo prej naložili v temo. [[File:ChangeSurveyListHeaderImageEditor.jpg]]
# Shranite datoteko. [[File:ThemeEditorSaveChanges.jpg]]
# Spremenite privzeto temo v svojo razširjeno temo. [[Datoteka:ChangeDefaultTheme.jpg]]


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:
=== Poravnajte logotip na sredino anketne strani===
Ta primer je za predlogo "extends_fruity". Za druge predloge je lahko zahtevani CSS drugačen.
# Prijavite se v skrbniško območje LimeSurvey
# Pobrskajte do urejevalnika tem: Konfiguracija > Teme
# Poiščite "LimeSurvey Fruity Theme" na seznamu in kliknite " Gumb "Urejevalnik tem"
# Kliknite "custom.css" na seznamu datotek na levi strani blizu dna strani
# Kopirajte naslednji CSS v to datoteko in pritisnite "Shrani spremembe"


<syntaxhighlight lang="php" enclose="div"><img src="{TEMPLATEURL}logoImage-{SID}.png"></syntaxhighlight>
<syntaxhighlight lang="css">
.navbar-fixed-top > div.navbar-header {
širina: 100 % !pomembno;
}


==Remove the default help to all question (hide_tip)==
.navbar-fixed-top > div.navbar-header > div {
širina: 100 % !pomembno;
}


There are 3 solutions to remove the default help:
.navbar-fixed-top > div.navbar-header > div > img {
# like a [[Advanced question settings#hide_tip|hide_tip attribute]] but for all question and survey.
rob: 0 samodejno 0 samodejno !pomembno;
# you can remove the {QUESTIONHELP} and is container from the file question.pstl, but it can be a bad idea for screenreader.
}
# for the default template and some other, add this at the end of tempate.css
</syntaxhighlight>


<syntaxhighlight lang="php" enclose="div">span.questionhelp{display:none;}</syntaxhighlight>


== Display custom 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:
==Pogledi vprašanj po meri {{NewIn|3.0}}==
#Create a favicon - google will find you lots of free favicon generators
#Name your new favicon "favicon.ico" and place it in your template directory
#Add the following code to your '''startpage.pstpl''' before the </head> tag


<syntaxhighlight lang="html4strict" enclose="div"><link rel="shortcut icon" href="{TEMPLATEURL}favicon.ico" type="image/x-icon">
<div class="simplebox">'''Opomba:''' To je začasna funkcija, ki bo v prihodnosti nadomeščena z objektom vprašanja (zelo enostavno bo premakniti poglede po meri na objekt vprašanja). Privzeto je onemogočen.</div>
<link rel="icon" href="{TEMPLATEURL}favicon.ico" type="image/x-icon"></syntaxhighlight>


== Different appearance for survey-/question-pages==
Od različice 2.5 naprej lahko ustvarite posebne poglede po meri za vprašanja in nekatere njihove vključene elemente. To je uporabno, če želite spremeniti postavitev HTML določene vrste vprašanja za eno ali več anket.


(''Version 1.91 and newer'')
*V aplikaciji/config/config.php poiščite 'config'=>array in matriki dodajte to vrstico: 'allow_templates_to_overwrite_views'=>1
*V /{your_template}/config.xml nastavite »overwrite_question_views« na res
*Kopiraj application/views/survey/* v template/{your_view_directory}/survey/
*Upoštevajte, da morate kopirati samo datoteke, ki jih nameravate spremeniti, vendar mora struktura datoteke ostati enaka kot v aplikacija/ogledi/anketa/


If you want LimeSurvey to change the appearance of every second page (i.e. of even and odd survey pages) you can use '''.page-odd''' class in your css file to change the appearance of odd pages.
==Vstavite datoteke CSS ali JavaScript po meri za predlogo==


example from default template of LimeSurvey 1.91+
Od različice 2.50 naprej lahko uporabite datoteko config.xml za samodejno nalaganje datotek vtičnikov.


<syntaxhighlight lang="php" enclose="div">
*Naložite svoje datoteke v mapo predloge /css ali /scripts
.page-odd table.question-group {
*V /{your_template}/config.xml dodajte poti datotek v<css> oz<js> bloki, nekaj takega:<syntaxhighlight lang="xml"><css>  
 background-color: #D2F2D3;
<filename> css/jquery-ui-custom.css</filename>
}</syntaxhighlight>
<filename> css/bootstrap-slider.css</filename>


To '''not''' differentiate even and odd pages at the (default) template find all instances of ''.page-odd'' in template.css and remove those styles.
<filename>css/awesome-bootstrap-checkbox/awesome-bootstrap-checkbox.css</filename>
<filename> css/flat_and_modern.css</filename>


==Create a vertical separator  border for dual scale array==
<filename>css/template.css</filename>


To create a vertical separator border for a dual scale array you can add the following lines to your '''template.css'''-file.
<filename>css/myCustomPlugin.css</filename>
</css>
<js>
<filename> skripte/template.js</filename>
<filename> skripti/bootstrap-slider.js</filename>


<syntaxhighlight lang="php" enclose="div">
<filename>skripte/myCustomPlugin.js</filename>
table.question thead td.header_separator,
</js>
table.question tbody td.dual_scale_separator
{
   border-right:solid 1px #00A8E1;
}
</syntaxhighlight>
</syntaxhighlight>


header_separator is used to adress the separator for the header "td" and "dual_scale_separator" is used to adress the separator column in the dual scale array.
==Definicije razredov (za razvijalce)==


==Hide the survey contact message shown on the start page/survey list==
===answer-list===
{|class=wikitable
!'''Vprašanje'''!!'''Vrsta vprašanja'''!!'''elementi'''
|-
|nizov/5 točk || A || tr
|-
|nizov/10točk|| B|| tr
|-
|nizi/matrika || F || tr
|-
|nizi/stolpec || H || tr in col
|-
|matri/dualscale || 1 || tr
|-
|matri/povečanjeistozmanjšanje || E || tr
|-
|nizi/danegotovo || C || tr
|-
|spol || G || div in ul
|-
|seznam_s_komentarjem || O || div
|-
|razvrstitev || R || ul in div
|-
|dasno || Y || ul in div
|-
|ranking_advanced || R || ul in div
|-
|listradio || L || div
|-
|5točkovna izbira || 5 || ul
|-
|več izbir || M || div
|-
|}


To hide the "Please contact ..." message on the start page (with the survey list) you can add the following to the '''$(document).ready''' function in the '''template.js''' of your used design template:


<syntaxhighlight lang="php" enclose="div">
===radio-list===
{|class=wikitable
!'''Vprašanje'''!!'''Vrsta vprašanja'''!!'''elementi'''
|-
| da || Y || ul
|-
|spol || G || ul
|-
|nizi/danegotovo || C || tr
|-
|matri/povečanjeistozmanjšanje || E || tr
|-
|matri/dualscale || 1 || tr
|-
|nizov/5točk || A || tabela in tr
|-
|nizi/10točka || B || tr
|-
|nizi/matrika || F || tr
|-
|nizi/stolpec || H || col
|-
|listradio || L || div
|-
|seznam_s_komentarjem || O || div, ki mu sledi ul
|-
|}


$('#surveycontact').hide(); //Hides the survey contact message
===radio-item===
{|class=wikitable
!'''Vprašanje'''!!''''Vrsta vprašanja'''!!''''elementi''''
|-
|matri/danonegotov || C || td
|-
|5točkovna izbira || 5 || li
|-
|niz/10točka || B || td
|-
|nizov/5točk || A || td
|-
|nizi/matrika || F || td
|-
|nizi/stolpec || H || td
|-
|matri/dualscale || 1 || td
|-
|matri/povečanjeistozmanjšanje || E || td
|-
|spol || G || li
|-
|listradio || L || li
|-
|da no || Y || li
|-
|listradio || L || li in div
|-
|image_select-listradio || L || li in div
|-
|seznam_s_komentarjem || 0 || li
|-
|}


</syntaxhighlight>
===list-group===
{|class=wikitable
!'''Vprašanje'''!!'''Vrsta vprašanja'''!!'''elementi'''
|-
|da || Y || ul
|-
|5točkovna izbira || 5 || ul
|-
|spol || G || ul
|-
|razvrstitev || R || ul
|-
|ranking_advanced || R || ul in div
|-
|gumbi_skupine_indeksa_vprašanj || || div
|-
|indeks_vprašanj_gumbi_vprašanj || || div
|-
|}


==Remove the survey contact message shown on error messages==
===list-group-horizontal===
{|class=wikitable
!''''Vprašanje''''!!''''Vrsta vprašanja''''!!''''elementi''''
|-
|da no || Y || ul
|-
|5točkovna izbira || 5 || ul
|-
|spol || G || ul
|-
|}


If you want to remove the survey contact message from error messages it'll be trickier. You can add the following function call to the '''$(document).ready''' function in the '''template.css''' of your used design template:
===list-unstyled===
{|class=wikitable
!'''Vprašanje'''!!''''Vrsta vprašanja''''!!''''elementi''''
|-
|seznam_s_komentarjem || 0 || ul
|-
|listradio|| L || ul
|-
|več izbir|| M || ul
|-
|več izbire_s_komentarji|| P || ul
|-
|večštevilski|| K || ul
|-
|multipleshorttext|| Q || ul
|-
|razvrstitev|| R || ul
|-
|ranking_advanced|| R || ul
|-
|bootstrap_buttons_multi|| M || ul
|-
|image_select-multiplechoice|| M || ul
|-
|inputondemand/multipleshorttext || Q || ul
|-
|register_error|| || ul
|-
|registrirano_sporočilo|| || ul
|-
|postavitev_seznama_anket || || ul
|-
|naloži|| || ul
|-
|shrani|| || ul
|-
|captcha|| || ul
|-
|}


<syntaxhighlight lang="php" enclose="div">
===select-list===
removeContactAdressFromMessage(); //Removes the survey contact message from error messages
{|class=wikitable
</syntaxhighlight>
!'''Vprašanje'''!!''''Vrsta vprašanja'''!!''''elementi''''
|-
|razvrstitev|| R || ul
|-
|ranking_advanced|| R || ul
|-
|}


and add the following function to your *template.js* file
===checkbox-item===
{|class=wikitable
!'''Vprašanje'''!!''''Vrsta vprašanja''''!!''''elementi''''
|-
|multiflexi (Matrika številk)|| : || td
|-
|več možnosti|| M || li
|-
|več izbire_s_komentarji|| P || div
|-
|image_select-listradio|| L || li
|-
|image_select-multiplechoice|| M || li in div
|-
|navigator|| || razpon
|-
|}


<syntaxhighlight lang="php" enclose="div">
===checkbox-text-item===
function removeContactAdressFromMessage()
{|class=wikitable
{
!''''Vprašanje''''!!''''Vrsta vprašanja''''!!''''elementi''''
if ($('#tokenmessage').length > 0)
|-
   {
|več možnosti_s_komentarji|| P || li
   var oldMessage = $('#tokenmessage').html();
|-
   var indexContact = oldMessage.indexOf('Bitte kontaktieren');
|več izbir|| M || li
   var newMessage = oldMessage.substr(0, indexContact);
|-
   $('#tokenmessage').html(newMessage);
|image_select-multiplechoice|| M || li
   }
|-
}
</syntaxhighlight>


It will probably not work for an englisch survey and have to be extended when using for multilingual surveys. But it's an idea/tip how to solve this.
|}
 
==How to deal with multilingual question attributes (before version 2.0 at which those were added)==
 
If you have a multilingual survey and e. g. want to use a different string for the "other" field, this could only be done for the base language (until this feature was added at LimeSurvey 2.0). To work around this, paste in the field to change the label for "other"
 
<syntaxhighlight lang="php" enclose="div"><span class="en">New label</span><span class="fr">Nouveau label</span></syntaxhighlight>
 
At the template.css of your template (at /limesurvey/upload/templates/<yourtemplatename>/template.css) add:


<syntaxhighlight lang="php" enclose="div">html:lang(en) .fr{display:none}
[[Category:Theme]]
html:lang(fr) .en{display:none}</syntaxhighlight>
[[Category:Twig]]

Latest revision as of 10:41, 14 December 2023

Uvod

LimeSurvey ima napreden sistem tem in stilov, ki razvijalcem zagotavlja učinkovit način prilagajanja videza ankete. Od LS3 je bil izraz "predloge" nadomeščen z izrazom "teme". Teme omogočajo nadzor nad slogom strani ankete. Skrbnik ankete lahko izbere privzeto temo, ki bo uporabljena za vsako anketo, da jo dodatno prilagodi. Teme so opremljene z možnostmi, ki skrbniku brez spretnosti kodiranja omogočajo preprost način dodajanja logotipa na pozdravno stran, spreminjanje barv ozadja, izbiro pisave itd.


LimeSurvey ima 3 teme. Te začetne teme definirajo imeniki, ki se nahajajo v imeniku "themes/survey/" namestitve LimeSurvey. Vsaka tema ima svoj imenik. Znotraj glavnega imenika teme boste našli konfiguracijsko datoteko v XML in številne imenike, ki vsebujejo poglede teme (.twig)', kaskadne slogovne liste (.css), 'skripte, slike ('.jpg ali .png) in morda druge.


Od LimeSurvey 2.50 mehanizem za teme uporablja Bootstrap 3 kot ogrodje CSS. Ker je Bootstrap 3 standardno ogrodje, bodo razvijalci o njem na internetu našli veliko dokumentacije, vadnic in forumov.


Od LimeSurvey 3 dalje mehanizem za teme uporablja Twig, tako da lahko razvijalci tem spremenijo logiko upodabljanja ankete na varen in enostaven način. Twig je nadomestil stari sistem nadomestnih ključnih besed, ki je bil uporabljen v prejšnjih različicah. Logika, ki je bila uporabljena za ustvarjanje HTML-ja ključnih besed, je zdaj na voljo znotraj pogledov teme.


Delček iz teme Vanilla:

 <div class="{{ aSurveyInfo.class.answercontainer }} col-xs-12" {{ aSurveyInfo.attr.answercontainer }}> 
 {# OPOMBA: Če želite prilagoditi upodobitev vprašanja, uporabite temo vprašanja #}
 {{ aVprašanje.odgovor | surovo }}
</div>

Teme, ki so koda HTML in Twig, običajno določajo položaj in vrsto besedila, ki bo prikazano, ter podobne strukturne značilnosti strani. Pogosto se sklicujejo ali vključujejo druge datoteke. Večina se jih sklicuje na običajno datoteko kaskadnih slogov (CSS), ki določa slog pisave, barvo, velikost, ozadje in podobne parametre, skupne vsem stranem v anketi. Liste slogov se sklicujejo na parametre razreda HTML, ki so povezani z različnimi tipi predmetov v kodi HTML. To omogoča, da slogovni list definira, kako prikazati vsako od številnih vrst besedila ali drugih predmetov, ki se lahko pojavijo na več mestih. Za vsako vrsto vprašanja v LimeSurvey obstajajo edinstveni razredi, ki omogočajo podroben nadzor nad videzom vsakega. V datoteki teme se lahko sklicujete tudi na slikovne datoteke, kot so logotipi ali posebni konstruktorji vrstice napredka. Končno so posebne ključne besede v zavitih oklepajih nadomeščene z besedilom, opredeljenim v anketi za vsakega korespondenta prevoda v jezik (na primer 'Naslov ankete' ali 'Besedilo vprašanja' za vsak definiran jezik).

Če ustvarite novo predlogo po meri, prosimo razmislite o prispevanju nazaj v LimeSurvey-evo skupnost in jo tako omogočite za uporabo drugim uporabnikom. Z vašo pomočjo lahko raste naša zbirka predlog, anket in drugih dodatkov ter tako skupaj naredimo LimeSurvey še boljši! Poglejte si obstoječo zbirko predlog

Ustvarjanje nove teme

Da lahko ustvarite novo predlogo (ali uredite obstoječo), potrebujete na anketnem sistemu kot uporabnik pravico za urejanje predlog in prav tako pravico za delo z datotekami v osnovnem operacijskem sistemu, na katerem gosti vaš anketni sistem.

Opozorilo: Če spremenite teme, lahko vplivate tudi na vse že obstoječe ankete iz vaše namestitve LimeSurvey. Teme so napredna funkcija, ki zahteva izkušnje in znanje HTML.

Najprimernejši način za ustvarjanje nove teme je prek Urejevalnika tem (glejte spodaj), ki se nahaja pod Konfiguracija v zgornji orodni vrstici. Nekateri uporabniki raje delajo neposredno s tematskimi datotekami, tako da lahko namesto spletnega vmesnika uporabljajo svoj najljubši urejevalnik besedil. V tem primeru vseeno uporabite urejevalnik tem, da najprej ustvarite novo temo. To bo ustvarilo novo osnovno temo z vsemi datotekami, ki jih potrebujete v imeniku LimeSurvey_web_root/upload/themes/survey/your_new_template. Od tam lahko z urejevalnikom besedila ročno prilagodite datoteke predloge.

Opomba o dovoljenjih: v sistemih unix/linux bodo te datoteke tem v lasti skupine in uporabnika, kjer se izvaja spletni strežnik (lahko "www" za nekatere sisteme). Zato se prepričajte, da imate ustrezna dovoljenja za urejanje teh datotek. Ko jih shranite, se prepričajte, da ne spremenijo lastništva! Tako lahko po potrebi še vedno uporabljate vmesnik za urejanje spletnih tem.


Številne LimeSurvey-eve 'javne' elemente je možno nastaviti z vrsto predlog. V tem razdelku je prikazana zelo kratka razlaga takšnih predlog.

Template:Opomba

LimeSurvey-ev urejevalnik predlog

Urejevalnik tem: Konfiguracija > Teme> Urejevalnik tem Urejevalnik tem je na voljo samo uporabnikom z dovoljenjem Predloge in superskrbnikom.


  Pozor : Tema, ki ni pravilno sestavljena, lahko povzroči nedelovanje ankete (ki uporablja ustrezno predlogo).



Urejevalnik tem LimeSurvey vam omogoča urejanje vsebine vaših tem na spletu. Če želite zagnati urejevalnik tem: kliknite Teme v meniju Konfiguracija in nato kliknite gumb Urejevalnik tem' poleg teme, ki jo želite urediti ali razširiti.


Datoteka:Themes menu.png Gumb za dostop do urejevalnika tem za temo Bootswatch


Stran urejevalnika predlog vam omogoča, da izberete predlogo, ki jo želite urediti/ogledati.



Na voljo so naslednje možnosti:


  • 'Ustvari': Omogoča ustvarjanje nove predloge. Da ne bi začeli iz nič, je predloga 'default' kopirana.
  • Import: Omogoča vam uvoz predloge iz datoteke ZIP.
  • Export : Omogoča izvoz trenutne predloge v datoteko ZIP.
  • Kopiraj: Omogoča ustvarjanje nove predloge s kopiranjem trenutne.
  • Preimenuj: Omogoča spreminjanje imena predloge. Običajno se uporablja po kopiranju ali uvozu predloge.
  • Predloga: Spustni seznam, ki prikazuje vse razpoložljive predloge, ki se nahajajo v vaši namestitvi LimeSurvey.
  • 'Zaslon': Spustni seznam, ki vam omogoča, da izberete, katero stran ankete te predloge si želite ogledati.
  • 'Nazaj na skrbniško ploščo'.

Ko izvozite predlogo, bo ustvarjen arhiv ZIP-datoteke z vsemi vašimi datotekami predlog (datoteke .pstpl, slike, datoteke css, ...). Izvoženo datoteko zip lahko uvozite v drugo namestitev LimeSurvey z uporabo funkcije uvoza ali pa ročno prekopirate arhiv v drugo namestitev LimeSurvey in jo ekstrahirate v ustrezno template imenik tam.

Najbolje pa je uporabiti funkcije za uvoz/izvoz/kopiranje predloge LimeSurvey v urejevalniku predlog.

Struktura strani / uporaba predloge

  • Pozdravna stran: startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
  • 'Strani z vprašanji:'' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
  • 'Končna stran:' začetna stran .pstpl, ocena.pstpl, dokončano.pstpl, končna stran.pstpl

Datoteke predloge

Naslednje datoteke s predlogami se uporabljajo za izdelavo vaše javne ankete in morajo obstajati v kateri koli novi mapi s predlogami, ki jo ustvarite:

  • startpage.pstpl: Ustvari začetek vsake strani html. Začne se pri "<head> " in ne sme vsebovati "<html> ". Ta 'pravi začetek' standardne strani html napišejo skripti. Prepričajte se, da vaše datoteke startpage.pstpl vsebujejo<body> oznaka. Čeprav mnogi brskalniki ne zahtevajo strogega upoštevanja standardov W3 HTML, mora skript LimeSurvey najti oznako za izvajanje določenih elementov javascript. V datoteki startpage.pstpl ni pogosto videti veliko 'ključnih besed'. Vendar pa boste morda želeli v naslov dodati {SURVEYNAME}. Datoteka startpage.pstpl lahko vsebuje kodo, ki se konča v ustrezni datoteki endpage.pstpl. Na primer, lahko začnete tabelo v tej datoteki in zaprete tabelo v datoteki endpage.pstpl. Datoteki startpage.pstpl in endpage.pstpl se zavijeta okoli vseh možnih strani, ki jih uporablja LimeSurvey.
  • 'survey.pstpl:' Ta predloga je druga uporabljena na večini strani in ponuja prostor za ime ankete in opis. Ta predloga nima ustrezne 'zapiralne' predloge, zato bi morali zapreti vse oznake, odprte v tej datoteki predloge (tj.: ne puščajte odprte tabele tukaj, ker je ni nikjer drugje za zapreti).
  • ' welcome.pstpl: Ta predloga se uporablja samo na pozdravnem zaslonu (ki je tudi na glavni strani za ankete 'vse v enem'). To lahko uporabite za natis pozdravnega besedila in drugih informacij, ki jih je treba navesti v uvodu. Tako kot datoteka 'survey.pstpl', ni ustrezne 'zapiralne' predloge, zato je treba zapreti tudi vse oznake, odprte v tej datoteki predloge.
  • 'startgroup.pstpl:' Ta predloga lahko zagotovi "povzetek" za vprašanja znotraj skupine. Ima ujemajočo se predlogo 'endgroup.pstpl', ki jo lahko uporabite za zapiranje vseh odprtih oznak v tej datoteki, tako da lahko odprete tabelo znotraj te.
  • groupdescription.pstpl: Ta datoteka predloge je uporablja se za prikaz opisa skupine. Upoštevajte, da lahko v nastavitvah ankete (dostopite do »Nastavitve predstavitve in navigacije« s klikom na zavihek »Predstavitev«) nastavite, ali naj bo opis skupine prikazan ali ne. Če ne, potem ta datoteka sploh ni vključena.
  • question.pstpl: Ta datoteka vsebuje razdelke besedila vprašanj, odgovorov in pomoči vaše ankete. V anketah »skupina po skupini« in »vse v enem« se ta predloga ponavlja z vsakim vprašanjem. Za to ni ustrezne zaključne datoteke in vse oznake bi morale biti zaprte.
  • question_start.pstpl: Ta datoteka vsebuje posamezne elemente, najdene na začetku vprašanja. Vključen je v 'question.pstpl' prek ključne besede {QUESTION}. Oblikovalcem predlog omogoča večji nadzor nad postavitvijo vprašanja. Ta predloga je zunaj običajnega sistema predlog in je bila nadomeščena (od LimeSurvey 1.87). Vse ključne besede iz te predloge so zdaj na voljo neposredno v question.pstpl.
  • completed.pstpl: Ta stran je prikazana kot zadnja stran, ko so odgovori na anketo shranjeni in je anketa končana. Uporablja se lahko za prikaz "posredovalne povezave", kot je nastavljena v nastavitvah ankete.
  • endgroup.pstpl:' Ta datoteka zapre skupino in jo lahko uporabite za zapiranje vseh oznak, odprtih v datoteka startgroup.pstpl
  • navigator.pstpl: Ta datoteka vsebuje gumbe za krmarjenje po anketi, "naslednja", "prejšnja", "zadnja", "pošlji", "shrani doslej" in povezavo "počisti vse". Uporablja se na vseh straneh, razen na izpolnjeni strani.
  • printanswers.pstpl: Ta datoteka ima ovoj HTML, potreben za tiskano različico ankete.
  • print_group.pstpl : Ta datoteka je enaka startgroup.pstpl in endgroup.pstpl, vendar za tiskano različico ankete.
  • print_question.pstpl:' Ta datoteka je enaka question.pstpl , vendar za tiskano različico ankete.
  • print_survey.pstpl: Ta datoteka je enaka anketi.pstpl, vendar za tiskano različico ankete.

CSS in Javascript

Za predlogo se vedno uporabljata dve datoteki: template.css za css in template.js za javascript.

  • {TEMPLATECSS}: doda vrstice za privzeto obliko css, template.css in template-rtl.css za rtl jezik.
  • {TEMPLATEJS}: doda vrstice za privzete datoteke javascript-a, template.js in vse datoteke oblike js, ki jih potrebuje LimeSurvey.

Uporaba Bootstrapa

LimeSurvey ima vdelan Bootstrap 3, tako da lahko oblikujete vse svoje predloge z dobro dokumentiranimi razredi Bootstrap. Za več informacij si oglejte Bootstrap dokumentacija.

Vključen je tudi vtičnik Awesome-Bootstrap-Checkbox. Z njim lahko uporabite tipične barvne razrede Bootstrap (informacije, opozorilo, nevarnost itd.) tudi s pripono "-checkbox" ali "-radio", čeprav stilizirate potrditvena polja in radie po želji.

Zamenjava privzetega CSS ali Javascripta

Nekatera vprašanja uporabljajo posebne datoteke za javascript ali css. Lahko uporabite tudi svoje datoteke. Vse uporabljene datoteke v vaši anketi vključene v ./scripts ali v .//styles-public so lahko zamenjane. Potrebno je samo dodati datoteko z enakim imenom v vašo predlogo.

Druge datoteke predlog

Datotek privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl in confirmationemail.pstpl LimeSurvey več ne uporablja. Namesto tega je vsebina privzeto nastavljena v ustreznih jezikovnih datotekah. Elektronska sporočila se lahko tako zdaj urejajo v anketi na nivoju ankete.

Standardne strani

Obstaja deset standardnih strani, ki jih lahko anketiranec vidi med anketiranjem ali dostopanjem do anketnega sistema. Vsaka stran je sestavljena iz več skupnih datotek predloge, ki je določena v nastavitvah ankete. Spodnja tabela nakazuje katere datoteke predlog se uporabljajo pri sestavljanju posamezne strani.

Strani ankete:
Datoteke predloge
Anketa
Seznam
Dobrodošlica Vprašanje Zaključeno Počisti vse Registracija Naloži Shrani Natisni
Odgovori
Natisni
Anketa
Anketni seznam
Dobrodošlica
Zasebnost
Navigacija
Anketa
Uvodna skupina
Opis skupine
Vprašanje*
Končna skupina
Ocena
Zaključeno
Počisti vse
Registracija
Naloži
Shrani
Natisni odgovore
Natisni anketo
Natisni skupino
Natisni vprašanje
Začetna stran
Zaključna stran
Template.css

* OPOMBA: V različici 1.90+ to nadomesti question.pstpl IN question_start.pstpl. Če uporabljate staro predlogo po meri, morate na začetek question.pstpl dodati naslednjo vrstico:

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

In nato dodajte ustrezno zaključno oznako na konec question.pstpl:

</div>

*Opomba: LimeSurvey-eve js datoteke v različici 1.91 in prejšnjih niso vključene s predlogo. V različici 2 morate uporabiti ključno besedo {TEMPLATEJS} v eni izmed vaših datotek predloge, da s tem dodate povezavo do js datoteke. Lahko jo dodate v datoteki startpage.pstpl ali v datoteki endpage.pstpl. Odstranite lahko vrstico {TEMPLATEURL}/template.js in jo nadomestite z {TEMPLATEJS}, da s tem posodobite osebno predlogo.

Razdelek za nadzor datotek

V oknu "nadzor datotek" na levi lahko kliknete eno od datotek predloge, ki se uporablja za prevajanje strani. Ogledate si lahko datoteke Screen del, JavaScript in CSS. Koda HTML za to datoteko se bo nato pojavila v oknu »Trenutno urejanje« na sredini. Če je predlogo mogoče urejati (določeno z dovoljenji imenika), lahko naredite kakršne koli spremembe in jih shranite.

center


V oknu "Druge datoteke" je prikazan seznam vseh drugih datotek, ki se nahajajo v mapi predloge. Desno stran lahko uporabite za nalaganje in izbiranje slikovnih datotek (vaših slik, logotipov,...) ali drugih datotek, ki so potrebni za izgradnjo vaše predloge. Opomba: namesto neposrednih povezav do vsake slike v vaši predlogi lahko uporabite ključno besedo {TEMPLATEURL}. Tako namesto:


Namesto povezave za vsako sliko uporabite niz polja {TEMPLATEURL}. Torej, namesto:

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

Lahko uporabite (New in 2.50 ):

 img src='{TEMPLATEURL}datoteke/moja slika.jpg'

V različicah LimeSurvey pred 2.50 uporabite:

 img src='{TEMPLATEURL}moja slika.jpg'

"Primer" strani predloge, ki jo urejate, je viden na dnu okna. Na noben način predloge ne morete izbrisati iz urejevalnika predlog. To mora biti narejeno z dostopom do sistemskih map in brisanjem datotek na tem nivoju.

Opomba: poslanih predlog ni mogoče urejati z urejevalnikom predlog in jih tudi naj nebi spreminjali. Če jih želite spreminjati, najprej ustvarite kopijo, na kateri delajte spremembe.

Lokacija datotek predloge

LimeSurvey shranjuje vse 'standardne' predloge v njihove lastne različne podmape znotraj mape /templates, ki se nahaja v javni mapiz ostalimi LimeSurvey-evimi javnimi datotekami. Prilagojene predloge uporabnika se shranijo v mapo /upload/templates.

VEDNO mora obstajati mapa "default" v mapi predlog. Ta predloga se privzeto uporablja in se uporabi kot nadomestna, če mapa predloge ne obstaja ali je ni mogoče najti. Mapa "default" je vključena v paket za namestitev sistema.

Uporabite lahko poljubno sliko, ki ste jo naložili v območje za upravljanje predloge, z uporabo zapisa podobnega temu:

{TEMPLATEURL}ime datoteke.xyz

Slogovna vprašanja s CSS

Oblikovanje vprašanj je z uporaba CSS-ja postalo veliko enostavnejše. Vsak tip vprašanj ime sedaj svoj edinstven razred. Obvezna vprašanja imajo prav tako dodaten obvezni razred. Primer za neobvezno vprašanje:

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

in v kolikor je vprašanje obvezno

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

in če uporabnik ni odgovoril na obvezno vprašanje ali če je za vprašanje predvidena potrditev

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

in če ima vprašanje predvideno preverjanje, vendar je anketiranec napačno odgovoril

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

Globalni razredi, ki se nanašajo na vprašanja

Ti razredi se uporabljajo za vsako vrsto vprašanja. Nekatere vrste vprašanj uporabljajo samo enega ali dva razreda, nekateri pa jih lahko uporabljajo več.

Globalni razredi
Ime razreda Območje Vrsta vprašanja Primeri Opomba
.question Celoten blok vprašanja Vse vrste vprašanj <p class="question">, <ul class="question">, <table class="question">
.subquestions-list Seznam podvprašanj Več izbir, lestvica <ul class="subquestions-list">, <table class="subquestions-list"> uporablja se tudi .questions-list
.answers-list Seznam vprašanj Vprašanja z eno izbiro, lestvice, vprašanja za več vnosov besedil <ul class="answers-list">, <table class="answers-list">
.answer-item Nanaša se na odgovore: en odgovor Vprašanje z eno izbiro, lestvica, vprašanje za več vnosov besedil <li class="answer-item">, <td class="answer-item">
.noanswer-item Nanaša se na odgovore: brez odgovora Vprašanje z eno izbiro, lestvica <li class="noanswer-item">, <td class="noanswer-item"> Tudi če ni odgovora, je to prav tako odgovor. V tem primeru imamo dvojni razred noanswer-item in answer-item
.question-item Nanaša se na vprašanje: eno vprašanje Vprašanje z več besedila, lestvica <li class="question-item">, <tr class="question-item"> Nekateri odgovori so prav tako vprašanja. V tem primeru imamo veliko razredov="question-item answer-item"
.checkbox-list Seznam potrditvenih polj Več izbir, tabela številk (potrditvena polja) <ul class="checkbox-list">, <tr class="checkbox-list"> Nekatere vrste vprašanj imajo razred večih seznamov: kot seznam s komentarjem: razred="checkbox-list text-list"
.checkbox-item Nanaša se na odgovore s potrditvenimi polji Več izbir, tabela številk (potrditvena polja) <li class="checkbox-item">, <td class="checkbox-item">
.radio-list Seznam izbirni gumbi Vprašanje z eno izbiro, lestvica <ul class="radio-list">, <tr class="radio-list">
.radio-item Nanaša se na odgovore s potrditvenimi polji Vprašanje z eno izbiro, lestvica <li class="radio-item">,
.text-list Seznam za vnos besedila Vprašanje z več besedila, besedilna lestvica <ul class="text-list">, <tr class="text-list">
.text-item Nanaša se na odgovore za besedilni vnos Vprašanje z več besedila, besedilna lestvica <li class="text-item">,
.numeric-list Seznam vnosa besedila le s številčnimi odgovori Več številskih odgovorov, lestvica s številkami <ul class="text-list numeric-list">, <tr class="text-list numeric-list">
.numeric-item Nanaša se na odgovore za vnos številk Več številskih odgovorov, lestvica s številkami <li class="numeric-item">, <td class="numeric-item">
.select-list Seznam izbir Lestvica številk, dvojna lestvica izbir <table class="select-list">
.select-item Nanaša se na odgovore z izbirami Lestvica številk, dvojna lestvica izbir, ena možnost z izbiranjem <p class="select-item">, <td class="select-item">
.hide Uporablja se za dostopnost: skrito s css-jem vendar berljivo z bralnikom zaslona Kratko besedilo <label class="hide"> Lahko se uporablja za druge namene
.dontread Uporablja se za dostopnost: ni berljivo z bralniki zaslonov Lestvica <th class="dontread">
.checkbox vnos[vrsta=potrditveno polje] Vprašanje s potrditvenimi polji <input type="checkbox" class="checkbox"> Skupaj s sodobnim brsklanikom: ni potrebno vendar nekateri starejši brskalniki ga potrebujejo
.radio vnos[tip=izbirni gumbi] Vprašanje z izbirnimi gumbi <input type="radio" class="radio"> Skupaj s sodobnim brsklanikom: ni potrebno vendar nekateri starejši brskalniki ga potrebujejo
.text vnos[vrsta=besedilo] Vprašanje za vnos besedila <textarea class="text">
.answertext Lestvica Nanaša se ne odgovor lestvica <th class="answertext">
.col-answers Lestvica Stolpec odgovorov <col class="col-answers">
.odd .even Lestvica Menjava za stolpec <col class="odd">
.odd .even Lestvica Menjava za stolpec <col class="odd">
.array1 .array2 Lestvica Menjava za stolpec <tr class="array1">

Nekaj primerov vprašanj z razredi

Vprašanje vrste kratkega besedila:

<p class="question answer-item text-item ">
<label class="hide label" for="answerSGQA">Answer</label><input type="text" value="" id="answerSGQA" name="SGQA" size="50" class="text  empty">
</p>

Večkratno kratko besedilo

<ul class="subquestions-list questions-list text-list">
  <li class="question-item answer-item text-item" id="javatbdSGQA">
    <label for="answerSGQA">Some example subquestion</label>
     <span><input type="text" value="" id="answerSGQA" name="SGQA" size="20" class="text empty"></span>
  </li>
</ul>

Vprašanje vrste lestvica

<table class="question subquestion-list questions-list ">
	<caption class="hide read">Some explanation for accessibility.</caption>
	<colgroup class="col-responses">
		<col width="50%" class="col-answers">
		<col width="25%" class="odd">
		<col width="13.3%" class="col-no-answer even">
	</colgroup>
	<thead>
		<tr class="array1 dontread">
			<td>&nbsp;</td>
			<th>1</th>
			<th>No answer</th>
		</tr>
	</thead>
	<tbody>
		<tr class="array2 answers-list radio-list" id="javatbdSGQ">
			<th width="20%" class="answertext">Some example subquestion
			</th>
			<td class="answer_cell_001 answer-item radio-item">
				<label for="answerSGQA" class="hide read">1</label>
				<input type="radio" value="1" id="answerSGQA" name="SGQA" class="radio">
			</td>
			<td class="answer-item radio-item noanswer-item">
				<label for="answerSGQA" class="hide read">No answer</label>
				<input type="radio" value="" id="answerSGQA" name="SGQA" class="radio">
			</td>
		</tr>
	</tbody>
</table>

Celoten seznam razredov vprašanj

Vrsta vprašanja Razred vprašanja ID vprašanja
Pet stopenjska lestvica .choice-5-pt-radio 5
Lestvica (10 stopenjska) .array-10-pt B
Lestvica (5 stopenjska) .array-5-pt A
Dvojna velikost polja .array-flexible-duel-scale 1
Lestvica (povečalo, ostalo enako, zmanjšalo) .array-increase-same-decrease E
Array (Multi Flexible) (Numbers) .array-multi-flexi :
Polja (besedila) .array-multi-flexi-text ;
Lestvica (da/ne/neodločen) .array-yes-uncertain-no C
Polje .array-flexible-row F
Polje po stolpcih .array-flexible-column H
Maskirano vprašanje .boilerplate X
Datum .date D
Spol .gender G
Ogromno besedilo .text-huge U
Zamenjava jezika .language I
Seznam (izbirni seznam) .list-dropdown !
Seznam (izbirni gumbi) .list-radio L
Seznam s komentarjem .list-with-comment O
Dolgo besedilo .text-long T
Več številskih odgovorov .numeric-multi K
Več možnosti .multiple-opt M
Več možnosti s komentarjem .multiple-opt-comments P
Več kratkih besedilnih vnosov .multiple-short-txt Q
Številski vnos .numeric N
Razvrščanje .ranking R
Kratko besedilo .text-short S
da/ne .yes-no Y

Celoten seznam validacijskih razredov

Opomba:  Pred različico 1.92 sta bila na voljo le razreda .mandatory in .input-error.

To se nanaša na sporočila za pomoč in/ali preverjanje, tako da je lahko vsaka vrsta posebej oblikovana.

Možnosti .hide-tip in .input-error privzeto sodelujeta, tako da lahko imate na začetku namige za preverjanje skrite. Pokažejo se, ko pride do napake pri preverjanju in ponovno izginejo, ko so te napake odpravljene.

Vse to je narejeno za to, da se odpravi potreba po opozorilih, ki bi se prikazovala v novih oknih. Namesto tega se lahko namigi prikažejo ali izginejo po potrebi in so kodirana z barvami. Tako lahko nakažejo če odgovori opravijo kriterije preverjanja.

Poleg tega kadar prvič obiščete stran, ki ne zadošča kriteriju preverjanja, lahko nasvete barvno kodirate v želeni barvi, da izpostavite kateri kriterij preverjanja ni bil izpolnjen. Potem ponovno prikažete stran z uporabo poudarjene barve, če anketiranec oddaja stran s ponavljajočimi napakami pri preverjanju.

Namen CSS razred Opis
Obvezno .mandatory vprašanje je obvezno
Napačen vnos s strani anketiranca .input-error vprašanje ima vsaj eno napako pri preverjanju
Skrij namig .hide-tip dodano, če uporabljate možnost hide_tip
Številčni odgovori .em_num_answers za min_answers in max_answers
Razpon vrednosti .em_value_range za min/max_num_value_n in multiflexible_min/max
Razpon vsote .em_sum_range za min/max/equals_num_value
Regex preverjanje .em_regex_validation za preverjanje regularnosti izrazov v vprašanju
Funkcija preverjanja stopnje vprašanja .em_q_fn_validation za možnost em_validation_q
Funkcija preverjanja stopnje podvprašanja .em_sq_fn_validation za možnost em_validation_sq
Ostali obvezni komentarji .em_other_comment_mandatory za ostele možnosti obveznih komentarjev - prikažejo se, kadar je izbrana možnost "drugo", vendar manjka povezan komentar.

Uvoz slogov v vašo predlogo po meri

Slogi vprašanj po meri so blizu dna datoteke CSS vsake predloge in se začnejo z:

 /* --------------------------- ZAČETEK: slogi vprašanj ----------------- ------------- */

Če oblikujete svojo prilagojeno predlogo, lahko kopirate vse iz templates/default/template.css (postavitve na osnovi tabel) ali /templates/limespired/template.css (postavitve na osnovi CSS-ja) v vaš lasten oblikovni slog brez kakršnega koli vplivanja na vaše druge oblike.

Internet Explorer Conditional Style Sheets

Zaradi izrazitega neskladja pri usklajevanju med IE6, IE7 in večine drugih brskalnikov, obstajajo posebne pogojne oblike slogov za IE vključene v vsako predlogo.

 <!--[if IE]>
  <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_all-versions.css" />
<![endif]--> 
 <!--[if lt IE 7]>
  <link rel="stylesheet" type="text/css" href="{TEMPLATEURL}IE_fix_older-than-7.css" />
<![endif]--> 
 <!--[if IE 8]>
		<link rel="stylesheet" type="text/css" href="{TEMPLATEURL}ie_fix_8.css" />
<![endif]-->

Zgornjo kodo morate vključiti v vašo datoteko startpage.pstpl in kopije obeh oblik slogov bodisi iz /templates/default/ ali /templates/limespired za razporeditev na osnovi tabel in CSS-jev.

Opomba: če kopirate oblike v vašo lastno obliko slogov, jih boste skoraj zagotovo morali popravljati.

Alternativna rešitev za Internet Explorer

V datoteko startpage.pstpl lahko vstavite pogojni razred za telo in uporabite ta razred v vapi datoteki template.css. Ta metoda je uporabljena v predlogi citronade.

<!--[if lt IE 7 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie6 ielt7 ielt8 ielt9 no-js"> <![endif]-->
<!--[if IE 7 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie7 ielt8 ielt9 no-js"> <![endif]-->
<!--[if IE 8 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie8 ielt9  no-js"> <![endif]-->
<!--[if IE 9 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie9 no-js"> <![endif]-->
<!--[if gt IE 9]><!--><body id="body" class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} no-js"><!--<![endif]-->
<script type='text/javascript'>/*<![CDATA[*/(function(H){ H.className=H.className.replace(/\bno-js\b/,'js') })(document.getElementsByTagName('body')[0]);/*]]>*/</script>

In v uporabi template.css

.ie6{/*posebej za internet explorer 6*/}
.ielt8{/*posebej za internet explorer 6 in 7*/}
.ie{/*posebej za vse različice internet explorerja */}

Jeziki od desne proti levi (RTL) in utemelji

LimeSurvey-ev urejevalnik besedila je zmožen oblikovati RTL besedilo. Sam urejevalnik kaže RTL jezik v obliki od leve proti desni, kadar je poravnano. To je zgolj stvar prikaza urejevalnika. Od desne proti levi in poravnano vprašanje ali besedilo se bo v vaši anketi ali v predogledu prikazalo pravilno od desne proti levi tudi če je poravnano.

Ključne besede

Template:Zastarelo

Ključne besede, ki se nahajajo znotraj datotek predloge, bodo zamenjane s trenutnimi podatki ankete. Obdane so z zavitimi oklepaji, na primer: {SURVEYNAME}

Naslednje nize bo LimeSurvey zamenjal, ko bo razčlenjeval datoteke predloge in rezultate predstavil anketirancem. Ta polja nizov bodo delovala na skoraj vseh straneh predloge razen na 'zaključni strani'. (Večino teh nizov lahko najdemo v datoteki common.php. Če je tam ne najdete, poglejte v datoteko index.php)

Ključna beseda Datoteke predloge Opis
{SURVEYNAME} Vse datoteke Naslov ankete
{SURVEYDESCRIPTION} Vse datoteke Opis ankete
{WELCOME} Vse datoteke (večinoma za welcome.pstpl) 'Pozdravno' besedilo ankete
{PERCENTCOMPLETE} survey.pstpl Majhen graf, ki prikaže procent opravljene ankete
{GROUPNAME} startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl Prikaže ime trenutne skupine
{GROUPDESCRIPTION} startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl Prikaže opis trenutne skupine
{NUMBEROFQUESTIONS} welcome.pstpl Prikaže celotno število vprašanj v anketi (le številko)
{THEREAREXQUESTIONS} welcome.pstpl Prikaže stavek "V anketi je X vprašanj" - iz datoteke ustreznega jezika. X je zamenjan s številom vprašanj. Vedite da bo ta del pravilno prikazan za ednino ali množino. Če je v anketi le eno vprašanje, se prikaže napis "V anketi je 1 vprašanje".
{CHECKJAVASCRIPT} Vse datoteke (večinoma za welcome.pstpl) Prikaže se opozorilo, kadar ima brskalnik anketiranca izklopljen javascript
{QUESTION} Question.pstpl (Je bilo zamenjano s ključnimi besedami {QUESTION_...} od različice LS1.87 naprej) Prikaže besedilo trenutnega vprašanja (oblika {QUESTION} se lahko prilagodi z urejanjem datoteke 'question_start.pstpl'). Namesto {QUESTION} uporabite sledeče: {QUESTION_TEXT}, {QUESTION_MANDATORY}, {QUESTION_HELP}, {QUESTION_MAN_MESSAGE}, {QUESTION_VALID_MESSAGE}, {QUESTION_INPUT_ERROR_CLASS} in ustrezne HTML oznake
{ANSWER} question.pstpl, print_question.pstpl Prikaže obrazec za trenutno vprašanje
{SGQ} question.pstpl, besedilo vprašanja Lahko se uporabi v samem besedilu vprašanja, da dinamično poveže polje za vnos odgovora na vprašanje s prikazom id-ja vprašanja za trenutno vprašanje.
{QUESTIONHELP} question.pstpl, print_question.pstpl Prikaže besedilo pomoči (vnaprej določen tip za vprašanja) za trenutno vprašanje
{QUESTION_CLASS} question.pstpl, print_question.pstpl Edinstven razred za vsako vrsto vprašanja. (Da bo vključena pri vprašanju v oznako z zavitim oklepajem.)
{QUESTION_CODE} question.pstpl, print_question.pstpl Prikaže kodo trenutnega vprašanja
{QUESTION_ESSENTIALS} question.pstpl ID vprašanja in (če je pogojno vprašanje), 'style="display:none;"'. (Da bo pri vprašanju vključena v oznako z zavitim oklepajem.)
{QUESTION_HELP} question.pstp, question_start.pstpl Prikaže besedilo pomoči določeno za uporabnika pri trenutnem vprašanju
{QUESTION_TYPE_HELP} print_question.pstp Prikaže besedilo pomoči določeno za uporabnika pri trenutnem vprašanju
{QUESTION_INPUT_ERROR_CLASS} question.pstp, question_start.pstpl Ponuja razred, če je bila napaka pri vnosu s strani uporabnika
{QUESTION_ID} print_question.pstp Ponuja edinstven ID za vsako vprašanje, da se omogoči oblikovanje za specifična vprašanja
{QUESTION_TEXT} question.pstp, print_question.pstp, question_start.pstpl Prikaže besedilo za trenutno vprašanje
{QUESTION_MANDATORY} question.pstp, print_question.pstp, question_start.pstpl Prikaže prevedeno 'obvezno' besedilo za trenutno vprašanje
{QUESTION_MAN_CLASS} question.pstpl, print_question.pstpl Razred, če je vprašanje obvezno. (Da bo pri vprašanju vključena v oznako z zavitim oklepajem.)
{QUESTION_MAN_MESSAGE} question.pstp, print_question.pstp, question_start.pstpl Prikaže prevedeno 'obvezno' besedilo za trenutno vprašanje
{QUESTION_NUMBER} print_question.pstpl Število vprašanj.
{QUESTION_VALID_MESSAGE} question.pstp, print_question.pstp, question_start.pstpl Prikaže prevedeno veljavno besedilo pomoči sporočila za trenutno vprašanje
{QUESTION_SCENARIO} print_question.pstp Natisne besedilo v obliki 'scenarija' za pogojna vprašanja.
{NAVIGATOR} navigator.pstpl Prikaže navigacijske gumbe (naslednji, prejšnji, zadnji)
{CLEARALL} Vse datoteke (vendar namenjeno za navigator.pstpl) Prikaže povezave za "Končaj in počisti rezultate"
{SUBMITBUTTON} submit.pstpl Prikaže končni gumb za oddajo
{COMPLETED} completed.pstpl Prikaže sporočilo o 'opravljeni' registraciji, ki se spreminja glede na nastavitve polj attribute_1 in attribute_2.
{URL} completed.pstpl Prikaže 'url' ankete in 'url besedilo'
{PRIVACY} submit.pstpl Prikaže informacije o zasebnosti, kadar je anketa anonimna
{PRIVACYMESSAGE} privacy.pstpl Prikaže se sporočilo o zasebnosti, če nastavite anketo na anonimno. Besedilo se lahko ureja/prevede v datotekah jezikov. Lahko se tudi ročno spremeni z urejanjem datoteke privacy.pstpl v predlogi, ki jo želite uporabiti.
{TEMPLATEURL} Vse datoteke URL na trenutno mesto predloge (uporabno za sklicujoče datoteke slik v vaši predlogi)
{SUBMITCOMPLETE} endpage.pstpl Izjava (iz datotek jezikov), ki uporabniku pove, da je zaključil z anketo in da mora klikniti na gumb "Pošlji"
{SUBMITREVIEW} survey.pstpl Izjava (iz datotek jezikov), ki uporabniku pove, da lahko pregleda/spremeni odgovore, ki so jih naredili, s klikom na "<< prejšnja"
{TOKEN:FIRSTNAME} Vse datoteke ***Če odgovori ankete NISO ANONIMNI - se zamenjajo z imenom uporabnikov iz tabele žetonov
{TOKEN:LASTNAME} Vse datoteke ***Če odgovori ankete NISO ANONIMNI - se zamenjajo s priimkom iz tabele žetonov***
{TOKEN:EMAIL} Vse datoteke ***Če odgovori ankete NISO ANONIMNI - se zamenjajo z elektronskim naslovom iz tabele žetonov***
{TOKEN:ATTRIBUTE_1} All Files ***Če odgovori ankete NISO ANONIMNI - se zamenjajo z atributom 1 iz tabele žetonov***
{TOKEN:ATTRIBUTE_2} All Files ***Če odgovori ankete NISO ANONIMNI - se zamenjajo z atributom 2 iz tabele žetonov***
{ANSWERSCLEARED} Zaželjeno v navigator.pstpl Izjava za "Ponastavljanje odgovorov" iz jezikovne datoteke
{RESTART} clearall.pstpl URL za ponovni zagon ankete
{CLOSEWINDOW} Vse datoteke (Zaželjeno v navigator.pstpl) URL za izhod iz trenutnega okna
{REGISTERERROR} register.pstpl Shows any error messages in the register page (ie: "You must include an email address")
{REGISTERMESSAGE1} register.pstpl The statement "You must be registered to complete this survey" from the language files
{REGISTERMESSAGE2} register.pstpl Details about registering from the language files
{REGISTERFORM} register.pstpl The actual form for registering, will change depending on whether the attribute_1 and attribute_2 fields are set.
{SAVE} Works suitable on navigator.pstpl Displays the 'Save your responses so far' button to offer the user to save and come back later to continue the survey. If the Save option is deactivated in the survey properties the tag will not be shown and ignored.
{LANGUAGECHANGER} survey.pstpl Displays a switch in multilingual surveys to change the question.

Vnos/Gumbi

Vsaki vrsti "vnosa" v anketi je bilo dano svoje lastno ime razreda. Tako lahko dodate CSS kodo v vašo datoteko "startpage.pstpl" in imate z njo nekaj možnosti vplivanja na prikaz oblike gumbov in vnosov. Ta imena razredov so sledeča:

  • submit (Gumbi za oddajo)
  • text (Besedilni vnosi - za kratko besedilo, datum in številke)
  • answertext (Besedilo odgovorov)
  • radio (Radijski gumbi)
  • checkbox (Potrditvena polja)
  • select (Izbirna polja/Seznam)
  • textarea (Večji tekstovni vnosi - za daljše prosto besedilo)
  • clearall (Povezava za "Izhod in počisti anketo")
  • rank (Oblika prednostnega vprašanja. Ne nastavi barve izbranega polja ali polj za besedilo (to se nastavi z ustreznim razdelkom zgoraj), vendar omogoča menjavo barve ozadja, barva besedila, velikosti itd. za preostala prednostna vprašanja)
  • graph (Tabela v obliki slike za "procent opravljene ankete")
  • innergraph (Tabela znotraj tabele za prikaz procenta opravljene ankete - ta vsebuje besedilo 0% in 100%. To uporabite za spreminjanje velikosti tega besedila)
  • question (Osnovne nastavitve za vsako vprašanje, ki se prikaže znotraj tabele. V splošnem bi morali uporabiti ta razred, da zagotovite enako velike črke in barvo kot ste jo uporabili drugod kot privzeto)
  • mandatory  (Obvezna vprašanja)
  • input-error (Uporabnik je vnesel napako - v primeru ko uporabnik naredi napako pri obveznem vprašanju ali vprašanju, ki se potrjuje)
  • array1 in array2 (Ti obliki se menjata, ko se prikazuje nek razpon odgovorov za vprašanja tipa polja. To vam omogoča, da nastavite menjajočo barvo ozadja za te tipe vprašanj. Array1 se prav tako uporablja za naslovno vrstico v tabeli pri teh tipih vprašanj)
  • errormandatory (Nastavljanje barv in oblik pri prikazu sporočila z napako "To vprašanje je obvezno")
  • warningjs (Nastavljanje barve in oblike prikazanega sporočila z napako, če ima anketiranec v svojem brskalniku izklopljen javascript)

Obstaja tudi nekaj elementov, ki se jih lahko uporablja z uporabo ID-ja elementa (#ID v CSS):

  • surveycontact (Sporočilo o stiku, ki se prikaže na uvodni strani)
  • tokenmessage (Uporablja se za sporočila znotraj ankete t.i. sporočilo o napaki, da je seja potekla)

Ker lahko urejate vse vidike HTML, ni razloga, da svoje predloge obdate z

<div class='new_name'></div>

in nato definirajte css za ta razred new_name.

Oblikovanje vrstice o napredovanju

Prikaz vrstice napredka se lahko spreminja s CSS-jem.

Če želite spremeniti barvo ozadja vrstice, na konec datoteke custom.css dodajte nekaj podobnega temu (primer za sadno temo):

.sadno .progress-bar {
 barva ozadja: #3300FF;
}

Če želite spremeniti barvo obrobe vrstice, na konec datoteke custom.css dodajte nekaj podobnega temu (primer za sadno temo):

.sadno .progress-bar {
 obroba: 1px polna #FF0000;
}

Napredne funkcije, ki so na voljo razvijalcem

Začenši z različico 0.99 je LimeSurvey integriral nekaj dodatkov, narejenih s strani uporabnikov, ki omogočajo nekaj posebnih sprememb. Te zelo napredne funkcije v splošnem zahtevajo spremembe v osnovni kodi LimeSurvey-a in jih je potrebno opraviti zelo previdno, da ne ustvarite varnostne luknje.

Podpora za vaše lastne funkcije Javascript

Nekateri uporabniki bodo morda želeli poganjati Javascript na straneh ankete, vendar klicanje checkconditions() v BODY elementu to onemogoča.  To lahko nadomestite z manjšimi JavaScript funkcijami v glavi (HEAD), ki preiščejo obstoj checkconditions() in template_onload() preden kliče posamezno funkcijo.  Na ta način lahko avtor predlogeustvari svojo lastno funkcijo template_onload() v glavi (HEAD), ki zamenjajo privzete.

Različica 1.87 in novejša:

  • Onemogočite XSS filter - v Globalnih nastavitvah -> Varnostno opozorilo, nastavite "Filtriraj HTML za XSS" na Ne.
  • Vstavite vašo skripto v jedro vprašanja ali opis skupine.
  • Več podrobnosti najdete v temi o tipičnih problemih.

Template:Opomba


Namigi in triki

Element, specifičen za jezik

Če želite v anketi imeti stavek za določen jezik, na primer pomoč na koncu vsake strani, lahko dodate datoteko .pstl za stavek in ga skrijete za drug jezik. Če ga skrijemo v template.css, lahko uporabimo psevdo izbirnik :lang, vendar za boljšo združljivost uporabimo kakšen razred.

Primer: za besedilo pomoči na koncu strani v francoščini in angleščini je potrebno dodati sledeče v datoteko endpage.pstpl:

<div class="fr" lang="fr">Pour de l'aide en direct appelez le 000000</div> 
<div class="en" lang="en"> Za pomoč pokličite 000000</div>

in v datoteko template.css

.lang-fr .en{display:none}
.lang-en .fr{display:none}

Spremenite postavitev anketne strani

Po urejanju in shranjevanju predloge velja za stran s seznamom anket samo, če je izbrana v nastavitvah ankete. Če želite to narediti kot privzeto predlogo, pojdite pod Zavihek Splošno, ki se nahaja v Globalnih nastavitvah' vaše namestitve LimeSurvey in izberite želeno predlogo. Od te točke naprej bodo vse predloge, ki kot predlogo uporabljajo možnost »privzeto«, in tiste, ki bodo na novo ustvarjene, uporabljale novo izbrano privzeto predlogo.

Če želite uporabiti vašo trenutno predlogo za to stran, morate spremeniti ustrezno nastavitev v Globalnih nastavitvah. V starejših različicah lahko to spremembo izvedete tako, da uredite nastavitev $defaulttemplate iz konfiguracijske datoteke: kopirajte to nastavitev iz config-defaults.php v config.php, ki preglasi config-defaults.php, in uredite to nastavitev v $defaulttemplate = 'yourtemplatename'; .

Uvoz/izvoz predlog: uporabniki Mac

Mac uporabniki si prosimo zapomnite: Mac OSX osnovna uporaba arhiva lahko ima nekatere probleme z ustvarjenimi zip mapami.

da obidete težavo uporabite unix-ov unzip iz ukazne vrstice:

$ unzip template.zip -d template

Arhiv: template.zip

 inflating: template/startpage

 inflating: ...

ali skripte v njihovem delu za mac-prevode:

Uporabi isto predlogo z različnimi logotipi

Če želite uporabiti enako predlogo za vse ankete in želite le spremeniti logotip v vsaki anketi, lahko uporabite značko {SID} datoteki predloge .pstpl in se s tem navezujete na različne slike:

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

Prikaži priljubljeno ikono po meri

Favicon je majhna ikona, ki jo vidite v naslovni vrstici brskalnika, na seznamu zaznamkov ali na zavihku. Svojo lastno ikono lahko prikažete na naslednji način:

  1. Ustvarite ikono priljubljenih strani – z Googlom lahko poiščete veliko brezplačnih generatorjev ikon priljubljenih strani.
  2. Poimenujte svojo novo ikono priljubljenih strani »favicon.ico« in jo postavite v svojo predlogo /datoteke imenik.
  3. Dodajte naslednjo kodo vaši startpage.pstpl pred</head> oznaka.
<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">

Drugačen videz strani z anketami/vprašanji

Če želite, da LimeSurvey spremeni videz vsake druge strani (tj. sode in lihe anketne strani), lahko uporabite razred .page-odd' v vaši datoteki CSS, da spremenite videz lihih strani.

primer iz privzete predloge za LimeSurvey 1.91+

.page-odd table.question-group {
 barva ozadja: #D2F2D3;
}

Da ne spreminjate sodih in lihih strani v (privzeti) predlogi, poiščite vse primere uporabe .page-odd v datoteki template.css in jih odstranite.

Ustvarite navpično ločilno obrobo za niz z dvojnim merilom

Za izdelavo navpičnega razmejitvenega roba za dvojne velikosti polja lahko dodate naslednje vrstice v vašo datoteko template.css.

table.question thead td.header_separator,
table.question tbody td.dual_scale_separator
{
 border-right:solid 1px #00A8E1;
}

header_separator se uporablja za ločevanje v glavi tabele "td" in "dual_scale_separator" se uporablja za ločevanje v stolpcih pri dvojnih velikostih polj.

Dodajanje lastnega logotipa na anketni seznam

  1. Najprej odprite urejevalnik tem za temo, ki jo želite uporabljati. Datoteka:OpenThemeEditor.jpg
  2. Priporočamo uporabo sadne teme, to je trenutno naša najboljša tema.
  3. Nato razširite temo in ji dajte ime, ki ga boste prepoznali.
  4. V naslednjem pogledu lahko naložite logotip, ki ga želite uporabiti.
  5. Izberite zaslon urejevalnika `Survey List´ v spustnem meniju Zaslon v zgornjem desnem kotu.
  6. Nato izberite `layout_survey_list.twig´ v levem stranskem meniju.
  7. V urejevalniku se pomaknite do vrstice 126 in spremenite označeni del v ime datoteke slike, ki ste jo prej naložili v temo.
  8. Shranite datoteko.
  9. Spremenite privzeto temo v svojo razširjeno temo. Datoteka:ChangeDefaultTheme.jpg

Poravnajte logotip na sredino anketne strani

Ta primer je za predlogo "extends_fruity". Za druge predloge je lahko zahtevani CSS drugačen.

  1. Prijavite se v skrbniško območje LimeSurvey
  2. Pobrskajte do urejevalnika tem: Konfiguracija > Teme
  3. Poiščite "LimeSurvey Fruity Theme" na seznamu in kliknite " Gumb "Urejevalnik tem"
  4. Kliknite "custom.css" na seznamu datotek na levi strani blizu dna strani
  5. Kopirajte naslednji CSS v to datoteko in pritisnite "Shrani spremembe"
.navbar-fixed-top > div.navbar-header {
 širina: 100 % !pomembno;
}

.navbar-fixed-top > div.navbar-header > div {
 širina: 100 % !pomembno;
}

.navbar-fixed-top > div.navbar-header > div > img {
 rob: 0 samodejno 0 samodejno !pomembno;
}


Pogledi vprašanj po meri (New in 3.0 )

Opomba: To je začasna funkcija, ki bo v prihodnosti nadomeščena z objektom vprašanja (zelo enostavno bo premakniti poglede po meri na objekt vprašanja). Privzeto je onemogočen.

Od različice 2.5 naprej lahko ustvarite posebne poglede po meri za vprašanja in nekatere njihove vključene elemente. To je uporabno, če želite spremeniti postavitev HTML določene vrste vprašanja za eno ali več anket.

  • V aplikaciji/config/config.php poiščite 'config'=>array in matriki dodajte to vrstico: 'allow_templates_to_overwrite_views'=>1
  • V /{your_template}/config.xml nastavite »overwrite_question_views« na res
  • Kopiraj application/views/survey/* v template/{your_view_directory}/survey/
  • Upoštevajte, da morate kopirati samo datoteke, ki jih nameravate spremeniti, vendar mora struktura datoteke ostati enaka kot v aplikacija/ogledi/anketa/

Od različice 2.50 naprej lahko uporabite datoteko config.xml za samodejno nalaganje datotek vtičnikov.

  • Naložite svoje datoteke v mapo predloge /css ali /scripts
  • V /{your_template}/config.xml dodajte poti datotek v<css> oz<js> bloki, nekaj takega:
    <css> 
    <filename> css/jquery-ui-custom.css</filename> 
    <filename> css/bootstrap-slider.css</filename>
    
    	<filename>css/awesome-bootstrap-checkbox/awesome-bootstrap-checkbox.css</filename> 
    <filename> css/flat_and_modern.css</filename>
    
    	<filename>css/template.css</filename>
    
    	<filename>css/myCustomPlugin.css</filename> 
    </css> 
    <js> 
    <filename> skripte/template.js</filename> 
    <filename> skripti/bootstrap-slider.js</filename>
    
    	<filename>skripte/myCustomPlugin.js</filename> 
    </js>
    

Definicije razredov (za razvijalce)

answer-list

Vprašanje Vrsta vprašanja elementi
nizov/5 točk A tr
nizov/10točk B tr
nizi/matrika F tr
nizi/stolpec H tr in col
matri/dualscale 1 tr
matri/povečanjeistozmanjšanje E tr
nizi/danegotovo C tr
spol G div in ul
seznam_s_komentarjem O div
razvrstitev R ul in div
dasno Y ul in div
ranking_advanced R ul in div
listradio L div
5točkovna izbira 5 ul
več izbir M div


radio-list

Vprašanje Vrsta vprašanja elementi
da Y ul
spol G ul
nizi/danegotovo C tr
matri/povečanjeistozmanjšanje E tr
matri/dualscale 1 tr
nizov/5točk A tabela in tr
nizi/10točka B tr
nizi/matrika F tr
nizi/stolpec H col
listradio L div
seznam_s_komentarjem O div, ki mu sledi ul

radio-item

Vprašanje 'Vrsta vprašanja 'elementi'
matri/danonegotov C td
5točkovna izbira 5 li
niz/10točka B td
nizov/5točk A td
nizi/matrika F td
nizi/stolpec H td
matri/dualscale 1 td
matri/povečanjeistozmanjšanje E td
spol G li
listradio L li
da no Y li
listradio L li in div
image_select-listradio L li in div
seznam_s_komentarjem 0 li

list-group

Vprašanje Vrsta vprašanja elementi
da Y ul
5točkovna izbira 5 ul
spol G ul
razvrstitev R ul
ranking_advanced R ul in div
gumbi_skupine_indeksa_vprašanj div
indeks_vprašanj_gumbi_vprašanj div

list-group-horizontal

'Vprašanje' 'Vrsta vprašanja' 'elementi'
da no Y ul
5točkovna izbira 5 ul
spol G ul

list-unstyled

Vprašanje 'Vrsta vprašanja' 'elementi'
seznam_s_komentarjem 0 ul
listradio L ul
več izbir M ul
več izbire_s_komentarji P ul
večštevilski K ul
multipleshorttext Q ul
razvrstitev R ul
ranking_advanced R ul
bootstrap_buttons_multi M ul
image_select-multiplechoice M ul
inputondemand/multipleshorttext Q ul
register_error ul
registrirano_sporočilo ul
postavitev_seznama_anket ul
naloži ul
shrani ul
captcha ul

select-list

Vprašanje 'Vrsta vprašanja 'elementi'
razvrstitev R ul
ranking_advanced R ul

checkbox-item

Vprašanje 'Vrsta vprašanja' 'elementi'
multiflexi (Matrika številk) : td
več možnosti M li
več izbire_s_komentarji P div
image_select-listradio L li
image_select-multiplechoice M li in div
navigator razpon

checkbox-text-item

'Vprašanje' 'Vrsta vprašanja' 'elementi'
več možnosti_s_komentarji P li
več izbir M li
image_select-multiplechoice M li