Actions

Theme editor/sl: Difference between revisions

From LimeSurvey Manual

(Created page with "LimeSurvey ima osnovni sistem za predloge in stile, ki omogoča tematsko prilagoditev aplikacije za uporabo v številnih brskalnikih.  Tukaj jih enostavno imenujemo '''Predlo...")
(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...")
 
(330 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.


LimeSurvey comes with a set of templates right out of the box. These initial templates are defined by directories within the LimeSurvey installation "templates" directory.  Each template has it's own directory.  Within the main directory of a template are numerous files: '''templates (.pstpl)''', '''cascading style sheets (.css)''', '''images''' ('''.jpg''' or '''.png''') and maybe others.


Like in other theme-based systems, fragments of HTML code are stored in the .pstpl template files.  These fragments are read in and used to construct the page to display to the end user during the operation of a survey. Often '''keywords''' surrounded by curly braces are included in the files that are then replaced with the relevant text.  The following gives an example of a template file content and its result when used in a survey page:
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.  


<syntaxhighlight lang="html4strict" enclose="div"><center><font face='verdana' color='red'>{SURVEYNAME}</font><br />
 
<font face='verdana' color='blue'><u>{SURVEYDESCRIPTION}</u></center>
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.
 
 
Delček iz teme Vanilla:
 
<syntaxhighlight lang="twig">
<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>
</syntaxhighlight>


One gets a result that looks like:
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]
 
==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.
 
<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>


<div class="simplebox"><center>'''<span style='color:red'>My New Survey</span>'''</center>
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.
<center><u><span style='color:#0000ff'>This is a survey written by me to find out what sort of chocolate people like.</span></u></center></div>


Templates, being HTML code, tend to define the positioning and type of text to be displayed and similar structural features of the page.  They often reference or include other files.  Most reference a common cascading style sheets (CSS) file that defines the font style, color, size, background and similar parameters common to all pages in the survey. Style sheets reference HTML '''class''' parameters that are associated with the various types of objects in the HTML code.  This allows the style sheet to describe once how to display each of the many types of text or other objects that may appear in multiple places.  There are unique classes for each question type in LimeSurvey and thus giving detailed control over the appearance of each.  Image files, like logos or special progress-bar constructors, may be referenced as well in the Template file.  Finally, special Keywords in curly braces are replaced with text defined in the Survey for each of its corresponding language translations (for example, the Survey Title or Question Text for each language defined).
<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 />


If you create a new custom template, please consider contributing it back to the LimeSurvey community, and make it available to others. With your help, we can grow our repository of templates, surveys, and other ad-ons, to make LimeSurvey even better! See the shared [http://www.limesurvey.org/en/download-limesurvey-design-templates/viewcategory/9-survey-design-templates Template Repository]
Številne LimeSurvey-eve 'javne' elemente je možno nastaviti z vrsto predlog. V tem razdelku je prikazana zelo kratka razlaga takšnih predlog.


=Creating a new Template=
{{Opomba|Datoteke s temami so kompleksna funkcija. Poleg HTML-ja morate poznati tudi CSS, Twig in JavaScript.}}


To be able to create a new template (or edit an existing template), you need Template Editing user permission in LimeSurvey as well as permission to manipulate the files in the underlying operating system hosting your LimeSurvey installation.
=LimeSurvey-ev urejevalnik predlog=


<div class="simplebox">'''Note of Warning:''' As template changes can affect all surveys in an installation, changes should be limited to those skilled in understanding general concepts in the code base. Templates are an advanced feature that can take some experimentation to get correct if you are not familiar with HTML code methods.</div>
'''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.  


The preferred way to create a new template is through the Template Editor (see below) via the web Admin interface. Some people may like to work directly with template files so that they can use their favorite text editor instead of the web interface. In this case, still use the Template Editor to first create your new template. This will create a new base template with all the files you need in the LimeSurvey_web_root/upload/templates/your_new_template directory. From there you can use your text editor to manually adjust the template files.


<div class="simplebox">'''Permissions Note:''' on unix/linux systems, these template files will be owned by the group and user who the web server is running as (may be "www" for some systems). So make sure you have access to edit these files, and when you save them make sure they don't change ownership, so you can still use the web Template Editing interface if needed</div>
{{Alert|title=Pozor|text=Tema, ki ni pravilno sestavljena, lahko povzroči nedelovanje ankete (ki uporablja ustrezno predlogo). }}


Template files may seem complex to understand at first. You have to likely understand HTML code, possibly Styles and Style Sheets, and have access to the underlying LimeSurvey installation files if the template files and directories are not editable. Copy an existing template to a new directory to play around with the content. This may help make the concept clearer.


A number of the 'public' elements of LimeSurvey can be adjusted by a series of templates. This section provides a very brief explanation of these templates.
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.  


=The LimeSurvey Template Editor=


To ease the understanding and quick update of a Template, LimeSurvey provides a '''Template Editor''' in the main '''administrative''' toolbar of the application.  This Template Editor is only available to users given the privilege in the User Security settings.  A template effects all surveys and can render a survey inoperable if not constructed properly.  So Template editing is thought best restricted to a very limited, knowledgeable set of users.  Having permission to enter the Template Editor is not enough though.
[[Datoteka:Themes menu.png]]
[[Datoteka:Theme editor button.png|''Gumb za dostop do urejevalnika tem za temo Bootswatch'']]




The LimeSurvey Template Editor allows you to edit the contents of your templates online. Start the Template Editor by clicking on the "Template Editor" icon [[File:templates.png]] in the LimeSurvey Administration toolbar (Templates). The main screen is similar to the LimeSurvey Survey Administration screen. It allows you to select the template to edit/view. Once this has been selected you can then select from one of the different public survey pages. You are then presented with a list of the template files that make up that particular page.
Stran urejevalnika predlog vam omogoča, da izberete predlogo, ki jo želite urediti/ogledati.  
 


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


==The Template Menu==


*'''Edit Icon:''' The "edit" icon indicates whether or not the template is editable. A blurred out icon indicates that the template is read only; a clickable icon indicates you may make modifications. To change the icon from blurred to clear, you have to modify the template's permissions.
Na voljo so naslednje možnosti:
*'''Import Template:''' Allows you to import a template.
*'''Export Template:''' Allows you to export the current template to a .zip-File.
*'''Copy Template:''' Allows you to make a new template by copying the current one.
*'''Rename this template:''' Allows you to change the name of the template.  Generally used after copying an existing template or importing a template by manipulating the underlying directories.


The "Screen" drop-down list on the right allows you to choose which particular survey page you are currently looking at.


==Import/Export/Copy a Template==
*''''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.


When you '''export '''a template, this will create a zip-file archive with all the files your template consists of (.pstpl files, images, css files, ...). You can simply '''import '''the exported zip-file at other LimeSurvey systems by using the import feature or you can manually copy the archive to another installation and extract it into the corresponding template directory there. If you copy the template in the same installation, you will need to rename the folder to create another named copy of that template.
*''''Zaslon'''': Spustni seznam, ki vam omogoča, da izberete, katero stran ankete te predloge si želite ogledati.
*''''Nazaj na skrbniško ploščo''''.


If the file and directory permissions are open for the LimeSurvey application to write, then you can use the programs '''copy '''and rename features to make a local copy of a template.
===Uvozi/Izvozi/Kopiraj predlogo===


==Page Structure / Template Use==
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]].  
*'''The Welcome Page:''' startpage.pstpl, welcome.pstpl, privacy.pstpl,  navigator.pstpl, endpage.pstpl
*'''The Questions Pages:''' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl
*'''The Submit Page:''' startpage.pstpl, survey.pstpl, submit.pstpl, (privacy.pstpl), navigator.pstpl, endpage.pstpl
*'''The Final Page:''' startpage.pstpl, assesment.pstpl, completed.pstpl, endpage.pstpl


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


The following template files are used to produce your public survey and must exist in any new template folder you create:
===Struktura strani / uporaba predloge===
*'''startpage.pstpl:''' Produces the start of each html page. It starts at the "<head>" tag, and should not contain the "<html>" tag. This 'very beginning' of a standard html page is written by the scripts. Please ensure that your startpage.pstpl files contains a <body> tag, even though many browsers do not require strict adherence to the W3 HTML stanards, the LimeSurvey script needs to find a <body> tag, to run certain javascript elements. It is not expected that many 'keywords' will be used in the startpage.pstpl file, however you may wish to put the {SURVEYNAME} into the title. The startpage.pstpl file can contain code that ends in the corresponding endpage.pstpl file, so you can start a table in this file and close the table in the endpage.pstpl file. The startpage.pstpl and endpage.pstpl files wrap around every possible page used by LimeSurvey.
*'''Pozdravna stran:''' startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
*'''survey.pstpl:''' This template is the second used on most pages, and provides a space to put the survey name and description. This template does not have a corresponding 'closing' template, and subsequently you should close all tags opened in this template file (ie: don't leave a table open here because there is nowhere else to close it)
*'' 'Strani z vprašanji:'''' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
*'''welcome.pstpl:''' This template is only used in the welcome screen (which is also on the main page for 'all in one' surveys). You can use this to print out the welcome text, and other information that should be provided in the introduction. Like the 'survey.pstpl' file, there is no corresponding 'closing' template, so all tags opened in this template file should be closed as well.
*''''Končna stran:'''' začetna stran .pstpl, ocena.pstpl, dokončano.pstpl, končna stran.pstpl
*'''startgroup.pstpl:''' This template can provide a 'summary' wrap around for questions within a group. It has a matching 'endgroup.pstpl' template that can be used to close any opened tags in this file, so you can open a table within this.
*'''groupdescription.pstpl:''' This template file is used to display a description of a group. It is separate to the startgroup.pstpl file because in a "question by question" survey it will be displayed on its own unique page in between groups, whereas in a "group by group" or "all in one" survey it provides a header to the subsequent questions. groupdescription.pstpl does not have a corresponding 'closing' template file, so all tags should be closed.
*'''question.pstpl:''' This file contains the question, answer and help text sections of your survey, and in the "group by group" and "all in one" surveys this template is cycled repeatedly with each question. There is no corresponding closing file for this and all tags should be closed.
*'''question_start.pstpl:''' This file contains the individual elements found at the start of a question. It is included within 'question.pstpl' via the {QUESTION} keyword. It is intended to allow template designers more control over the layout of a question. This template sits outside the normal templating system and '''was superseeded (as of LS1.87)'''. All keywords from this template are now available directly in question.pstpl. NOTE: templates using question_start.pstpl will still work at least for a couple more versions of LS 1.x
*'''submit.pstpl (and privacy.pstpl):''' This page is the penultimate page for all types of survey (except the "all in one" type) where the participant is given an option to review questions before submitting their responses. It provides privacy information where a survey is anonymous, which it extracts from the '''privacy.pstpl''' file.
*'''completed.pstpl:''' This page is displayed as the final page when the survey responses have been saved and the survey is over. It can be used to display a "forwarding link" as set in the survey setup.
*'''endgroup.pstpl:''' This file closes the group, and can be used to close off any tags opened in the startgroup.pstpl file
*'''navigator.pstpl:''' This file contains the buttons that navigate through the survey, "next", "prev", "last", "submit", "save so far"  and the "clear all" link. It is used in all pages except the completed page.
*'''printanswers.pstpl:''' This file has the HTML wrapper for the print version of the survey.
*'''print_group.pstpl:''' This file is the same as startgroup.pstpl endgroup.pstpl but for the print version of the survey.
*'''print_question.pstpl:''' This file is the same as question.pstpl but for the print version of the survey.
*'''print_survey.pstpl:''' This file is the same as survey.pstpl but for the print version of the survey.


== CSS and Javascript==
===Datoteke predloge===


Two files are allways used for template : template.css for css and template.js for 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:
*'''{TEMPLATECSS}:''' Add lines for default css, template.css and template-rtl.css for rtl language.
*'''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.
*'''{TEMPLATEJS}:''' Add lines for default javascript files, template.js and all js files needed for 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.


=== Replacing default css or javascript===
=== CSS in Javascript===


Some question use specific files for javascript or css. You can use your own files. All files used in your survey included in ./scripts or in .//styles-public can be replaced, just put a file with the same name in your template.
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.


==Other Template Files==
=== 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].


The '''privacy.pstpl''', '''invitationemail.pstpl''', '''reminderemail.pstpl''' and '''confirmationemail.pstpl''' are no longer used by LimeSurvey and defaults are instead set in the applicable language files. The email messages can now be edited on a survey by survey basis.
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.


==Standard Pages==
==== Zamenjava privzetega CSS ali Javascripta====


There are ten standard pages that a survey participant may see in the course of taking or accessing the LimeSurvey application. Each is constructed from a number of common '''Template''' files from the '''Template''' specified in the survey's settings. The table below indicates which template files are used in constructing each of these pages.
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.


{| class="wikitable"
{| class="wikitable"
!  '''Survey Pages:'''<br />'''Template Files'''!!Survey<br />List!!Welcome!!Question!!Completed!!Clear All!!Register!!Load!!Save!!Print<br />Answers!!Print<br />Survey
!  '''Strani ankete:'''<br />'''Datoteke predloge'''!!Anketa<br />Seznam!!Dobrodošlica!!Vprašanje!!Zaključeno!!Počisti vse!!Registracija!!Naloži!!Shrani!!Natisni<br />Odgovori!!Natisni<br />Anketa
|-
|-
|SurveyList||align="center" | [[File:check.gif]]|| || || || || || || || ||
|Anketni seznam||align="center" | [[File:check.gif]]|| || || || || || || || ||
|-
|-
|Welcome|| ||align="center" | [[File:check.gif]]|| || || || || || || ||
|Dobrodošlica|| ||align="center" | [[File:check.gif]]|| || || || || || || ||
|-
|-
|Privacy|| ||align="center" | [[File:check.gif]]|| || || || || || || ||
|Zasebnost|| ||align="center" | [[File:check.gif]]|| || || || || || || ||
|-
|-
|Navigator|| ||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]|| || || || || || ||
|Navigacija|| ||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]|| || || || || || ||
|-
|-
|Survey|| || ||align="center" | [[File:check.gif]]|| || ||align="center" | [[File:check.gif]]|| || || ||
|Anketa|| || ||align="center" | [[File:check.gif]]|| || ||align="center" | [[File:check.gif]]|| || || ||
|-
|-
|StartGroup|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|Uvodna skupina|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|-
|-
|GroupDescription|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|Opis skupine|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|-
|-
|Question<span style='color:red'>'''*'''</span>|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|Vprašanje<span style='color:red'>'''*'''</span>|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|-
|-
|EndGroup|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|Končna skupina|| || ||align="center" | [[File:check.gif]]|| || || || || || ||
|-
|-
|Assessment|| || || ||align="center" | [[File:check.gif]]|| || || || || ||
|Ocena|| || || ||align="center" | [[File:check.gif]]|| || || || || ||
|-
|-
|Completed|| || || ||align="center" | [[File:check.gif]]|| || || || || ||
|Zaključeno|| || || ||align="center" | [[File:check.gif]]|| || || || || ||
|-
|-
|ClearAll|| || || || ||align="center" | [[File:check.gif]]|| || || || ||
|Počisti vse|| || || || ||align="center" | [[File:check.gif]]|| || || || ||
|-
|-
|Register|| || || || || ||align="center" | [[File:check.gif]]|| || || ||
|Registracija|| || || || || ||align="center" | [[File:check.gif]]|| || || ||
|-
|-
|Load|| || || || || || ||align="center" | [[File:check.gif]]|| || ||
|Naloži|| || || || || || ||align="center" | [[File:check.gif]]|| || ||
|-
|-
|Save|| || || || || || || ||align="center" | [[File:check.gif]]|| ||
|Shrani|| || || || || || || ||align="center" | [[File:check.gif]]|| ||
|-
|-
|PrintAnswers|| || || || || || || || ||align="center" | [[File:check.gif]]||
|Natisni odgovore|| || || || || || || || ||align="center" | [[File:check.gif]]||
|-
|-
|Print Survey || || || || || || || || || ||align="center" | [[File:check.gif]]
|Natisni anketo || || || || || || || || || ||align="center" | [[File:check.gif]]
|-
|-
|Print Group || || || || || || || || || ||align="center" | [[File:check.gif]]
|Natisni skupino || || || || || || || || || ||align="center" | [[File:check.gif]]
|-
|-
|Print Question || || || || || || || || || ||align="center" | [[File:check.gif]]
|Natisni vprašanje || || || || || || || || || ||align="center" | [[File:check.gif]]
|-
|-
|StartPage<br />EndPage<br />Template.css||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||  
|Začetna stran<br />Zaključna stran<br />Template.css||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||align="center" | [[File:check.gif]]||  
|}
|}


<span style='color:red'>'''*'''</span>NOTE: In versions 1.90 and up this replaces question.pstpl AND question_start.pstpl. If you are using an old custom template, you need to add the following line to the beginning of question.pstpl:<syntaxhighlight lang="php" enclose="div"><div {QUESTION_ESSENTIALS} class="{QUESTION_CLASS}{QUESTION_MAN_CLASS}{QUESTION_INPUT_ERROR_CLASS}"></syntaxhighlight>And then add the corresponding closing tag to the end of 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>NOTE: In version 1.91 and earlier, LimeSurvey js files are not included by the template. In version 2, '''you have to use {TEMPLATEJS} in your one of your template file''' to add the link to the js file. You can add it in startpage.pstpl or in endpage.pstpl. You can remove the {TEMPLATEURL}/template.js line and you have to replace with {TEMPLATEJS} to update a personal template.
===Razdelek za nadzor datotek===


==The File Control Section==
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.


In the "file control" window on the left, you can click on one of the template files that is used to compile the page. The HTML code for that file will then appear in the "Now editing" window in the center. If the template is editable (determined by directory permissions) you can then make any changes and save them.
<center>[[Datoteka:File Control Section.png|center]]</center>


The "Other Files" window shows a list of all other files in the template directory. You can use the right side to '''upload and select image files (your pics, logos,...) or other files needed to create your template'''. Note: Instead of a link directly to each picture in your template you can use the field string {TEMPLATEURL}.  So instead of:


<syntaxhighlight lang="html4strict" enclose="div">img src='/limesurvey/templates/yourtemplate/mypicture.jpg'</syntaxhighlight>
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:
You can use:
<syntaxhighlight lang="html4strict" enclose="div">img src='{TEMPLATEURL}mypicture.jpg'</syntaxhighlight>


A "sample" of the template page you are editing will be visible at the bottom of the screen. There is no way to to delete a template from the template editor. This must be done by accessing the underlying directory and deleting the file there.


<div class="simplebox">'''Note:''' The shipped templates cannot be edited using the Template Editor and should never be changed. If you want to modify them, create a copy first and modify the copy.</div>
Namesto povezave za vsako sliko uporabite niz polja {TEMPLATEURL}. Torej, namesto:


==Location of template files==
<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>


LimeSurvey stores each of the 'standard' templates in their own distinct sub-directory within the /templates directory that is kept in the public directory with the other LimeSurvey public files. Customized user templates are stored in the /upload/templates directory.
V različicah LimeSurvey pred 2.50 uporabite:
<syntaxhighlight lang="html4strict"> img src='{TEMPLATEURL}moja slika.jpg'</syntaxhighlight>


To create a new template, use the according icon in the template editor.
"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.


There should ALWAYS be a "default" directory in the templates directory. This template is used by default and as a fall-back if a template folder doesn't exist, or can't be found. The "default" directory comes with the package.
<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>


You can use any image files that you upload into the template management area with syntax like this:
===Lokacija datotek predloge===


<syntaxhighlight lang="php" enclose="div">{TEMPLATEURL}filename.xyz</syntaxhighlight>
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.


=Styling questions with CSS=
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.


Styling of questions in CSS has become much easier. Each question type now has a unique class. Mandatory question's also have an additional mandatory class. For example, for a non-mandatory question:
Uporabite lahko poljubno sliko, ki ste jo naložili v območje za upravljanje predloge, z uporabo zapisa podobnega temu:


<syntaxhighlight lang="html4strict" enclose="div"><div id="question5" class="gender">
<syntaxhighlight lang="php">{TEMPLATEURL}ime datoteke.xyz</syntaxhighlight>
 
==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:
 
<syntaxhighlight lang="html4strict"><div id="question5" class="gender">
...
...
</div></syntaxhighlight>
</div></syntaxhighlight>


and if the question is mandatory
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>


and if the question is mandatory but the user didn't answer it or if there is validation on a question
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>


and if the question has validation applied but the user hasn't answered correctly
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>


==Global classes for question part==
==Globalni razredi, ki se nanašajo na vprašanja==


This class are used for each question type. Some question type use only one or two class, but other can use much more.
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č.


{| class="wikitable alternance"
{| class="wikitable alternance"
|+ Global classes
|+ Globalni razredi
|-
|-
! scope="col" | Class name
! scope="col" | Ime razreda
! scope="col" | Part
! scope="col" | Območje
! scope="col" | Question type
! scope="col" | Vrsta vprašanja
! scope="col" | Examples
! scope="col" | Primeri
! scope="col" | Note
! scope="col" | Opomba
|-
|-
! scope="row" | .question
! scope="row" | .question
| All question block
| Celoten blok vprašanja
| All question type
| Vse vrste vprašanj
|&lt;p class="question">, &lt;ul class="question">, &lt;table class="question">
|&lt;p class="question">, &lt;ul class="question">, &lt;table class="question">
|  
|  
|-
|-
! scope="row" | .subquestions-list
! scope="row" | .subquestions-list
| List of subquestion
| Seznam podvprašanj
| Multi choice question, array question type
| Več izbir, lestvica
| &lt;ul class="subquestions-list">, &lt;table class="subquestions-list">
| &lt;ul class="subquestions-list">, &lt;table class="subquestions-list">
| .questions-list is used too
| uporablja se tudi .questions-list  
|-
|-
! scope="row" | .answers-list
! scope="row" | .answers-list
| List of answers
| Seznam vprašanj
| Single choice question, array question type, Multi input text question
| Vprašanja z eno izbiro, lestvice, vprašanja za več vnosov besedil
| &lt;ul class="answers-list">, &lt;table class="answers-list">
| &lt;ul class="answers-list">, &lt;table class="answers-list">
|  
|  
|-
|-
! scope="row" | .answer-item
! scope="row" | .answer-item
| The answer part: one answer
| Nanaša se na odgovore: en odgovor
| Single choice question, array question type, Multi input text question
| Vprašanje z eno izbiro, lestvica, vprašanje za več vnosov besedil
| &lt;li class="answer-item">, &lt;td class="answer-item">
| &lt;li class="answer-item">, &lt;td class="answer-item">
|
|
|-
|-
! scope="row" | .noanswer-item
! scope="row" | .noanswer-item
| The answer part for no answer
| Nanaša se na odgovore: brez odgovora
| Single choice question, array question type
| Vprašanje z eno izbiro, lestvica
| &lt;li class="noanswer-item">, &lt;td class="noanswer-item">
| &lt;li class="noanswer-item">, &lt;td class="noanswer-item">
| No answer is an answer too, then have double class noanswer-item and answer-item
| Tudi če ni odgovora, je to prav tako odgovor. V tem primeru imamo dvojni razred noanswer-item in answer-item
|-
|-
! scope="row" | .question-item
! scope="row" | .question-item
| The question part: one question
| Nanaša se na vprašanje: eno vprašanje
| Multi text question, array question type
| Vprašanje z več besedila, lestvica
| &lt;li class="question-item">, &lt;tr class="question-item">
| &lt;li class="question-item">, &lt;tr class="question-item">
| Some answer are question too, then we have a lot of class="question-item answer-item"
| Nekateri odgovori so prav tako vprašanja. V tem primeru imamo veliko razredov="question-item answer-item"
|-
|-
! scope="row" | .checkbox-list
! scope="row" | .checkbox-list
| A list of checkbox
| Seznam potrditvenih polj
| Multi choice question, array number (checkbox) question type
| Več izbir, tabela številk (potrditvena polja)
| &lt;ul class="checkbox-list">, &lt;tr class="checkbox-list">
| &lt;ul class="checkbox-list">, &lt;tr class="checkbox-list">
| Some question type have multi list class: like checkbox with comment : class="checkbox-list text-list"
| Nekatere vrste vprašanj imajo razred večih seznamov: kot seznam s komentarjem: razred="checkbox-list text-list"
|-
|-
! scope="row" | .checkbox-item
! scope="row" | .checkbox-item
| The answer part with a checkbox
| Nanaša se na odgovore s potrditvenimi polji
| Multi choice question, array number (checkbox) question type
| Več izbir, tabela številk (potrditvena polja)
| &lt;li class="checkbox-item">, &lt;td class="checkbox-item">
| &lt;li class="checkbox-item">, &lt;td class="checkbox-item">
|
|
|-
|-
! scope="row" | .radio-list
! scope="row" | .radio-list
| A list of radio item
| Seznam izbirni gumbi
| Single choice question, array question type
| Vprašanje z eno izbiro, lestvica
| &lt;ul class="radio-list">, &lt;tr class="radio-list">
| &lt;ul class="radio-list">, &lt;tr class="radio-list">
|
|
|-
|-
! scope="row" | .radio-item
! scope="row" | .radio-item
| The answer part with a radio
| Nanaša se na odgovore s potrditvenimi polji
| Single choice question, array question type
| Vprašanje z eno izbiro, lestvica
| &lt;li class="radio-item">, <td class="radio-item">
| &lt;li class="radio-item">, <td class="radio-item">
|
|
|-
|-
! scope="row" | .text-list
! scope="row" | .text-list
| A list of text input
| Seznam za vnos besedila
| Multi text question type, array of text
| Vprašanje z več besedila, besedilna lestvica
| &lt;ul class="text-list">, &lt;tr class="text-list">
| &lt;ul class="text-list">, &lt;tr class="text-list">
|
|
|-
|-
! scope="row" | .text-item
! scope="row" | .text-item
| The answer part of a text input
| Nanaša se na odgovore za besedilni vnos
| Multi text question type, array of text
| Vprašanje z več besedila, besedilna lestvica
| &lt;li class="text-item">, <td class="text-item">
| &lt;li class="text-item">, <td class="text-item">
|
|
|-
|-
! scope="row" | .numeric-list
! scope="row" | .numeric-list
| A list of text input with numeric only answer
| Seznam vnosa besedila le s številčnimi odgovori
| Multi numeric question type, array of number
| Več številskih odgovorov, lestvica s številkami
| &lt;ul class="text-list numeric-list">, &lt;tr class="text-list numeric-list">
| &lt;ul class="text-list numeric-list">, &lt;tr class="text-list numeric-list">
|
|
|-
|-
! scope="row" | .numeric-item
! scope="row" | .numeric-item
| The answer part of a numeric input
| Nanaša se na odgovore za vnos številk
| Multi numeric question type, array of number
| Več številskih odgovorov, lestvica s številkami
| &lt;li class="numeric-item">, &lt;td class="numeric-item">
| &lt;li class="numeric-item">, &lt;td class="numeric-item">
|
|
|-
|-
! scope="row" | .select-list
! scope="row" | .select-list
| A list of select
| Seznam izbir
| Array numbers, Dual scale array (select)
| Lestvica številk, dvojna lestvica izbir
| &lt;table class="select-list">
| &lt;table class="select-list">
|
|
|-
|-
! scope="row" | .select-item
! scope="row" | .select-item
| The answer part of a select
| Nanaša se na odgovore z izbirami
| Array numbers, Dual scale array (select), single choice with select
| Lestvica številk, dvojna lestvica izbir, ena možnost z izbiranjem
| &lt;p class="select-item">, &lt;td class="select-item">
| &lt;p class="select-item">, &lt;td class="select-item">
|
|
|-
|-
! scope="row" | .hide
! scope="row" | .hide
| Used for accessibility: hidden with css but read by screenreader
| Uporablja se za dostopnost: skrito s css-jem vendar berljivo z bralnikom zaslona
| Short text question
| Kratko besedilo
| &lt;label class="hide">
| &lt;label class="hide">
| Can be used for other purpose
| Lahko se uporablja za druge namene
|-
|-
! scope="row" | .dontread
! scope="row" | .dontread
| Used for accessibility: not be read by screenreader
| Uporablja se za dostopnost: ni berljivo z bralniki zaslonov
| Array question type
| Lestvica
| &lt;th class="dontread">
| &lt;th class="dontread">
|
|
|-
|-
! scope="row" | .checkbox
! scope="row" | .checkbox
| input[type=checkbox]
| vnos[vrsta=potrditveno polje]
| Question with checkbox
| Vprašanje s potrditvenimi polji
| &lt;input type="checkbox" class="checkbox">
| &lt;input type="checkbox" class="checkbox">
| With modern browser: not needed but some old browser need this
| Skupaj s sodobnim brsklanikom: ni potrebno vendar nekateri starejši brskalniki ga potrebujejo
|-
|-
! scope="row" | .radio
! scope="row" | .radio
| input[type=radio]
| vnos[tip=izbirni gumbi]
| Question with radio
| Vprašanje z izbirnimi gumbi
| &lt;input type="radio" class="radio">
| &lt;input type="radio" class="radio">
| With modern browser: not needed but some old browser need this
| Skupaj s sodobnim brsklanikom: ni potrebno vendar nekateri starejši brskalniki ga potrebujejo
|-
|-
! scope="row" | .text
! scope="row" | .text
| input[type=text]
| vnos[vrsta=besedilo]
| Question with input text, or textarea
| Vprašanje za vnos besedila
| &lt;textarea class="text">
| &lt;textarea class="text">
|
|
|-
|-
! scope="row" | .answertext
! scope="row" | .answertext
| Array question type
| Lestvica
| Answer part of array question type
| Nanaša se ne odgovor lestvica
| &lt;th class="answertext">
| &lt;th class="answertext">
|
|
|-
|-
! scope="row" | .col-answers
! scope="row" | .col-answers
| Array question type
| Lestvica
| Column of answers
| Stolpec odgovorov
| &lt;col class="col-answers">
| &lt;col class="col-answers">
|
|
|-
|-
! scope="row" | .odd .even
! scope="row" | .odd .even
| Array question type
| Lestvica
| Alternation for column
| Menjava za stolpec
| &lt;col class="odd">
| &lt;col class="odd">
|
|
|-
|-
! scope="row" | .odd .even
! scope="row" | .odd .even
| Array question type
| Lestvica
| Alternation for column
| Menjava za stolpec
| &lt;col class="odd">
| &lt;col class="odd">
|
|
|-
|-
! scope="row" | .array1 .array2
! scope="row" | .array1 .array2
| Array question type
| Lestvica
| Alternation for line
| Menjava za stolpec
| &lt;tr class="array1">
| &lt;tr class="array1">
|
|
|}
|}


=== Some example of question part with classes===
==== Nekaj primerov vprašanj z razredi====


'''text-short question type:'''<source lang="html4strict">
'''Vprašanje vrste kratkega besedila:'''<source lang="html4strict">
<p class="question answer-item text-item ">
<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">
<label class="hide label" for="answerSGQA">Answer</label><input type="text" value="" id="answerSGQA" name="SGQA" size="50" class="text  empty">
</p>
</p>
</source>
</source>
'''Multiple short text'''<source lang="html4strict">
'''Večkratno kratko besedilo'''<source lang="html4strict">
<ul class="subquestions-list questions-list text-list">
<ul class="subquestions-list questions-list text-list">
   <li class="question-item answer-item text-item" id="javatbdSGQA">
   <li class="question-item answer-item text-item" id="javatbdSGQA">
Line 388: Line 421:
</ul>
</ul>
</source>
</source>
'''Array question type'''<source lang="html4strict">
'''Vprašanje vrste lestvica'''<source lang="html4strict">
<table class="question subquestion-list questions-list ">
<table class="question subquestion-list questions-list ">
<caption class="hide read">Some explanation for accessibility.</caption>
<caption class="hide read">Some explanation for accessibility.</caption>
Line 419: Line 452:
</table>
</table>
</source>
</source>
==The full list of question classes==
===Celoten seznam razredov vprašanj===


{|
{|
|'''Question Type'''||'''Question Class'''||'''Question ID'''
|'''Vrsta vprašanja'''||'''Razred vprašanja'''||'''ID vprašanja'''
|-
|-
|5 point choice||.choice-5-pt-radio||5
|Pet stopenjska lestvica ||.choice-5-pt-radio||5
|-
|-
|Array (10 point choice)||.array-10-pt||B
|Lestvica (10 stopenjska)||.array-10-pt||B
|-
|-
|Array (5 point choice)||.array-5-pt||A
|Lestvica (5 stopenjska)||.array-5-pt||A
|-
|-
|Array (Flexible Labels) dual scale||.array-flexible-duel-scale ||1
|Dvojna velikost polja||.array-flexible-duel-scale ||1
|-
|-
|Array (Increase, Same, Decrease)||.array-increase-same-decrease||E
|Lestvica (povečalo, ostalo enako, zmanjšalo)||.array-increase-same-decrease||E
|-
|-
|Array (Multi Flexible) (Numbers)||.array-multi-flexi ||:
|Array (Multi Flexible) (Numbers)||.array-multi-flexi ||:
|-
|-
|Array (Multi Flexible) (Text)||.array-multi-flexi-text||;
|Polja (besedila)||.array-multi-flexi-text||;
|-
|-
|Array (Yes/No/Uncertain)||.array-yes-uncertain-no||C
|Lestvica (da/ne/neodločen)||.array-yes-uncertain-no||C
|-
|-
|Array (flexible labels)||.array-flexible-row ||F
|Polje||.array-flexible-row ||F
|-
|-
|Array (flexible labels) by column||.array-flexible-column||H
|Polje po stolpcih||.array-flexible-column||H
|-
|-
|Boilerplate question||.boilerplate||X
|Maskirano vprašanje||.boilerplate||X
|-
|-
|Date||.date||D
|Datum||.date||D
|-
|-
|Gender||.gender||G
|Spol||.gender||G
|-
|-
|Huge free text||.text-huge||U
|Ogromno besedilo||.text-huge||U
|-
|-
|Language switch||.language||I
|Zamenjava jezika||.language||I
|-
|-
|List (dropdown)||.list-dropdown||!
|Seznam (izbirni seznam)||.list-dropdown||!
|-
|-
|List (radio)||.list-radio||L
|Seznam (izbirni gumbi)||.list-radio||L
|-
|-
|List with comment||.list-with-comment||O
|Seznam s komentarjem||.list-with-comment||O
|-
|-
|Long free text||.text-long||T
|Dolgo besedilo||.text-long||T
|-
|-
|Multiple numerical input||.numeric-multi||K
|Več številskih odgovorov||.numeric-multi||K
|-
|-
|Multiple options||.multiple-opt||M
|Več možnosti||.multiple-opt||M
|-
|-
|Multiple options with comments||.multiple-opt-comments||P
|Več možnosti s komentarjem||.multiple-opt-comments||P
|-
|-
|Multiple short text||.multiple-short-txt||Q
|Več kratkih besedilnih vnosov||.multiple-short-txt||Q
|-
|-
|Numerical input||.numeric||N
|Številski vnos||.numeric||N
|-
|-
|Ranking||.ranking||R
|Razvrščanje||.ranking||R
|-
|-
|Short free text||.text-short||S
|Kratko besedilo||.text-short||S
|-
|-
|Yes/No||.yes-no||Y
|da/ne||.yes-no||Y
|-
|-
|
|
|}
|}


==The full list of validation classes==
===Celoten seznam validacijskih razredov===


<div class="simplebox">Note:  Prior to 1.92, only .mandatory and .input-error classes were available.</div>
<div class="simplebox">Opomba:  Pred različico 1.92 sta bila na voljo le razreda .mandatory in .input-error.</div>


These apply to the help and/or validation tip messages so that each type can be individually styled.
To se nanaša na sporočila za pomoč in/ali preverjanje, tako da je lahko vsaka vrsta posebej oblikovana.


The .hide-tip option and .input-error options, by default, interact so that you can have validation tips start hidden, but appear when there validation errors, and disappear again when those errors are rectified.
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.


All of these are designed to eliminate the need for pop-up alert messages.  Instead, tips can appear/disappear as needed, and are color-coded to indicate whether the answers pass the validation criteria.
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.


Furthermore, when you first visit a page that has unmet validation criteria, you can color-code the tips in a pleasing color to show which validation criteria have not been med; then re-display the page using a harsher color if the person submits the page with lingering validation errors.
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.


{|
{|
|'''Purpose'''||'''CSS Class'''||'''Description'''
|'''Namen'''||'''CSS razred'''||'''Opis'''
|-
|-
|Mandatory||.mandatory||the question is mandatory
|Obvezno||.mandatory||vprašanje je obvezno
|-
|-
|User input error||.input-error||the question had at least one validation error
|Napačen vnos s strani anketiranca||.input-error||vprašanje ima vsaj eno napako pri preverjanju
|-
|-
|Hide Tip||.hide-tip||added if you use the hide_tip option
|Skrij namig||.hide-tip||dodano, če uporabljate možnost hide_tip  
|-
|-
|Num answers||.em_num_answers||for for min_answers and max_answers
|Številčni odgovori||.em_num_answers||za min_answers in max_answers
|-
|-
|Value range||.em_value_range||for min/max_num_value_n and multiflexible_min/max
|Razpon vrednosti||.em_value_range||za min/max_num_value_n in multiflexible_min/max
|-
|-
|Sum range||.em_sum_range||for min/max/equals_num_value
|Razpon vsote||.em_sum_range||za min/max/equals_num_value
|-
|-
|Regex validation||.em_regex_validation||for regular-expression validation of the question
|Regex preverjanje||.em_regex_validation||za preverjanje regularnosti izrazov v vprašanju
|-
|-
|Question-level validation function||.em_q_fn_validation||for the em_validation_q option
|Funkcija preverjanja stopnje vprašanja||.em_q_fn_validation||za možnost em_validation_q  
|-
|-
|Subquestion-level validation function||.em_sq_fn_validation||for the em_validation_sq option
|Funkcija preverjanja stopnje podvprašanja||.em_sq_fn_validation||za možnost em_validation_sq  
|-
|-
|Other comment mandatory||.em_other_comment_mandatory||for other_comment_mandatory option - shows when "other" is selected but associated comment is missing.
|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.
|-
|-
|
|
|}
|}


==Importing styles into your custom template==
===Uvoz slogov v vašo predlogo po meri===


The custom question styles are near the bottom of each template's CSS file and start with:<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>


If you're styling your own custom template, You should be able to copy everything after the above from templates/default/template.css (for tables based layouts) or /templates/limespired/template.css (for CSS based layouts) into your own style sheet without any impact on your other styles.
Č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==
===Internet Explorer Conditional Style Sheets===


Because of the marked discrepancies in rendering between IE6, IE7 and most other browsers, there are special IE conditional style sheets included for each template.
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>


You should include the above code within your '''startpage.pstpl''' and copies of both the IE style sheets from either /templates/default/ or /templates/limespired for Tables base layout and CSS based layout respectively.
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.


<div class="simplebox">'''Note:''' If you copy the styles into your own style sheet you will almost certainly need to tweak them.</div>
<div class="simplebox">'''Opomba:''' če kopirate oblike v vašo lastno obliko slogov, jih boste skoraj zagotovo morali popravljati.</div>


===Alternative solution for Internet explorer===
====Alternativna rešitev za Internet Explorer====


You can put conditional class for body in startpage.pstpl, and use this class in your template.css. This method is used in citronade template. Adding a js / no-js class to to have javascript / no javascript system.
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.


<source lang="html4strict"><!--[if lt IE 7 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie6 ielt7 ielt8 ielt9 no-js"> <![endif]-->
<source lang="html4strict"><!--[if lt IE 7 ]> <body class="lang-{SURVEYLANGUAGE} {SURVEYFORMAT} ie ie6 ielt7 ielt8 ielt9 no-js"> <![endif]-->
Line 556: Line 589:
<script type='text/javascript'>/*<![CDATA[*/(function(H){ H.className=H.className.replace(/\bno-js\b/,'js') })(document.getElementsByTagName('body')[0]);/*]]>*/</script></source>
<script type='text/javascript'>/*<![CDATA[*/(function(H){ H.className=H.className.replace(/\bno-js\b/,'js') })(document.getElementsByTagName('body')[0]);/*]]>*/</script></source>


And in template.css use
In v uporabi template.css


<source lang="css">.ie6{/*specific for internet explorer 6*/}
<source lang="css">.ie6{/*posebej za internet explorer 6*/}
.ielt8{/*specific for internet explorer 6 and 7*/
.ielt8{/*posebej za internet explorer 6 in 7*/}
.ie{/*specific for all internet explorer */}</source>
.ie{/*posebej za vse različice internet explorerja */}</source>


== Right-to-Left (RTL) Languages and justify==
=== Jeziki od desne proti levi (RTL) in utemelji ===


The text editor within LimeSurvey is able to format RTL Text. However, the editor itself shows the RTL language in a left to right format when justified.  This is just an editor display issue. The RTL and justified question or text will display correctly from right to left, even when justified, in your survey or on preview.
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.


==Keywords==
===Ključne besede===


Keywords within a template file get replaced by the current survey information. They are surrounded by curly brackets, for example: {SURVEYNAME}
{{Zastarelo|3.0}}  


The following strings will be replaced by LimeSurvey when parsing the template file and presenting it to survey users. These field strings will work on almost every template except for the 'Completed Page'. (Most of these strings can be found in the common.php file. If it's not there, look in the index.php file.)
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)


{|class=wikitable
{|class=wikitable
!'''Keyword'''!!'''Template files'''!!'''Description'''
!'''Ključna beseda'''!!'''Datoteke predloge'''!!'''Opis'''
|-
|-
|{SURVEYNAME}||All Files||The survey title
|{SURVEYNAME}||Vse datoteke||Naslov ankete
|-
|-
|{SURVEYDESCRIPTION}||All Files||The survey description
|{SURVEYDESCRIPTION}||Vse datoteke||Opis ankete
|-
|-
|{WELCOME}||All files (mainly for welcome.pstpl)||The survey 'welcome' text
|{WELCOME}||Vse datoteke (večinoma za welcome.pstpl)||'Pozdravno' besedilo ankete
|-
|-
|{PERCENTCOMPLETE}||survey.pstpl||A small graph showing the percentage of the survey completed
|{PERCENTCOMPLETE}||survey.pstpl||Majhen graf, ki prikaže procent opravljene ankete
|-
|-
|{GROUPNAME}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Displays the current group name
|{GROUPNAME}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Prikaže ime trenutne skupine
|-
|-
|{GROUPDESCRIPTION}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Displays the current group description
|{GROUPDESCRIPTION}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Prikaže opis trenutne skupine
|-
|-
|{NUMBEROFQUESTIONS}||welcome.pstpl||Displays the total number of questions in the survey (just the number)
|{NUMBEROFQUESTIONS}||welcome.pstpl||Prikaže celotno število vprašanj v anketi (le številko)
|-
|-
|{THEREAREXQUESTIONS}||welcome.pstpl||Displays the sentence "There are X questions in this survey" - from the relevant language file. The X is replaced with the number of questions. Note that this will also work appropriately for singular or plural. If there is only 1 question, it will print "There is 1 question in this survey".
|{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}||All files (mainly for welcome.pstpl)||Warning message when end-user browser have javascript disabled
|{CHECKJAVASCRIPT}||Vse datoteke (večinoma za welcome.pstpl)||Prikaže se opozorilo, kadar ima brskalnik anketiranca izklopljen javascript
|-
|-
|{QUESTION}||Question.pstpl||('''Has been superseeded but the {QUESTION_...} keywords as of LS1.87''') Displays the current question text (The format of {QUESTION} can customised by editing 'question_start.pstpl') Use the following: {QUESTION_TEXT}, {QUESTION_MANDATORY}, {QUESTION_HELP}, {QUESTION_MAN_MESSAGE}, {QUESTION_VALID_MESSAGE} and {QUESTION_INPUT_ERROR_CLASS} and appropriate wrapping HTML instead of {QUESTION}
|{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||presents the answer form for the current question
|{ANSWER}||question.pstpl, print_question.pstpl||Prikaže obrazec za trenutno vprašanje
|-
|-
|{SGQ}||question.pstpl, question text||Can be used in the question text itself, to reference the input field of the question dynamically by displaying the Survey-Group-Question id for the current question. (as of svn build 9755)
|{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||Displays help text (predefined tip for question type) for the current question
|{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||unique class for each question type. (To be included in the question's wrapping tag.)
|{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||Displays the current question code
|{QUESTION_CODE}||question.pstpl, print_question.pstpl||Prikaže kodo  trenutnega vprašanja
|-
|-
|{QUESTION_ESSENTIALS}||question.pstpl||the question ID and (if a question is conditional), 'style="display:none;"'. (To be included in the question's wrapping tag.)
|{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||Displays the user defined help text for the current question
|{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||Displays the user defined help text for the current question
|{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||Provides a class if there was user input error
|{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||Provides a unique ID for each question to allow styling for specific questions
|{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||Displays the text for the current question
|{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||Displays the translated 'Mandatory' text for the current question
|{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||class if a question is mandatory. (To be included in the question's wrapping tag.)
|{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||Displays the translated 'Mandatory' help message text for the current question
|{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||Incremental count of questions.
|{QUESTION_NUMBER}||print_question.pstpl||Število vprašanj.
|-
|-
|{QUESTION_VALID_MESSAGE}||question.pstp, print_question.pstp, question_start.pstpl||Displays the translated valid help message text for the current question
|{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||Prints out the 'scenario' text for conditional questions.
|{QUESTION_SCENARIO}||print_question.pstp||Natisne  besedilo v obliki 'scenarija' za pogojna vprašanja.
|-
|-
|{NAVIGATOR}||navigator.pstpl||Displays navigation buttons (next, prev, last)
|{NAVIGATOR}||navigator.pstpl||Prikaže navigacijske gumbe (naslednji, prejšnji, zadnji)
|-
|-
|{CLEARALL}||All files (but intended for navigator.pstpl)||Displays the "Exit and Clear Results" link
|{CLEARALL}||Vse datoteke (vendar namenjeno za navigator.pstpl)||Prikaže povezave za "Končaj in počisti rezultate"
|-
|-
|{SUBMITBUTTON}||submit.pstpl||Displays the final submit button
|{SUBMITBUTTON}||submit.pstpl||Prikaže končni gumb za oddajo
|-
|-
|{COMPLETED}||completed.pstpl||Displays the 'completed' message for registering, will change depending on whether the attribute_1 and attribute_2 fields are set.
|{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||Displays the survey 'url' and 'url text'
|{URL}||completed.pstpl||Prikaže 'url' ankete in  'url besedilo'
|-
|-
|{PRIVACY}||submit.pstpl||Displays privacy information when survey is anonymous
|{PRIVACY}||submit.pstpl||Prikaže informacije o zasebnosti, kadar je anketa anonimna
|-
|-
|{PRIVACYMESSAGE}||privacy.pstpl||The privacy message is shown if you set your survey to be anonymous. [[Translating LimeSurvey|The text can be edited/translated]] in the language files. This can also be changed manually by editing the privacy.pstpl template you wish to use.
|{PRIVACYMESSAGE}||privacy.pstpl||Prikaže se sporočilo o zasebnosti, če nastavite anketo na anonimno. [[Translating LimeSurvey/sl|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}||All Files||The URL to the current template location (useful for referencing image files in your template)
|{TEMPLATEURL}||Vse datoteke||URL na trenutno mesto predloge (uporabno za sklicujoče datoteke slik v vaši predlogi)
|-
|-
|{SUBMITCOMPLETE}||endpage.pstpl||The statement (from the language files) that tells the user they have completed the survey, and to press the "Submit" button
|{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||The statement (from the language files) that tells the user they can review/change the answers they have made by clicking "<< prev"
|{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}||All Files||***If survey answers are NOT ANONYMOUS - gets replaced with the users first name from the tokens table
|{TOKEN:FIRSTNAME}||Vse datoteke||***Če odgovori ankete NISO ANONIMNI - se zamenjajo z imenom uporabnikov iz tabele žetonov
|-
|-
|{TOKEN:LASTNAME}||All Files||***If survey answers are NOT ANONYMOUS - gets replaced with the users last name from the tokens table***
|{TOKEN:LASTNAME}||Vse datoteke||***Če odgovori ankete NISO ANONIMNI - se zamenjajo s priimkom iz tabele žetonov***
|-
|-
|{TOKEN:EMAIL}||All Files||***If survey answers are NOT ANONYMOUS - gets replaced with the users email from the tokens table***
|{TOKEN:EMAIL}||Vse datoteke||***Če odgovori ankete NISO ANONIMNI - se zamenjajo z elektronskim naslovom iz tabele žetonov***
|-
|-
|{TOKEN:ATTRIBUTE_1}||All Files||***If survey answers are NOT ANONYMOUS - gets replaced with the users attribute_1 from the tokens table***
|{TOKEN:ATTRIBUTE_1}||All Files||***Če odgovori ankete NISO ANONIMNI - se zamenjajo z atributom 1 iz tabele žetonov***
|-
|-
|{TOKEN:ATTRIBUTE_2}||All Files||***If survey answers are NOT ANONYMOUS - gets replaced with the users attribute_2 from the tokens table***
|{TOKEN:ATTRIBUTE_2}||All Files||***Če odgovori ankete NISO ANONIMNI - se zamenjajo z atributom 2 iz tabele žetonov***
|-
|-
|{ANSWERSCLEARED}||Preferably in navigator.pstpl||The "Answers Cleared" statement from the language files
|{ANSWERSCLEARED}||Zaželjeno v navigator.pstpl||Izjava za "Ponastavljanje odgovorov" iz jezikovne datoteke
|-
|-
|{RESTART}||clearall.pstpl||URL to restart the survey
|{RESTART}||clearall.pstpl||URL za ponovni zagon ankete
|-
|-
|{CLOSEWINDOW}||All Files (Preferably in navigator.pstpl)||URL to close current window
|{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")
|{REGISTERERROR}||register.pstpl||Shows any error messages in the register page (ie: "You must include an email address")
Line 678: Line 713:
|}
|}


==Input/Buttons==
===Vnos/Gumbi===


Each "input" type in a survey has been given its own class name, so that you can add CSS to your "startpage.pstpl" file, and have some control over the appearance of form buttons and inputs. These class names are as follows:
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''' (Submit Buttons)
*'''submit''' (Gumbi za oddajo)
*'''text''' (Text Inputs - for short free text, date and numerical type)
*'''text''' (Besedilni vnosi - za kratko besedilo, datum in številke)
*'''answertext''' (Text of answers)
*'''answertext''' (Besedilo odgovorov)
*'''radio''' (Radio Buttons)
*'''radio''' (Radijski gumbi)
*'''checkbox''' (Check Boxes)
*'''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):
Obstaja tudi nekaj elementov, ki se jih lahko uporablja z uporabo ID-ja elementa ('''#ID''' v CSS):
*'''surveycontact''' (The contact message shown on the start page)
*'''surveycontact''' (Sporočilo o stiku, ki se prikaže na uvodni strani)
*'''tokenmessage''' (used for messages inside the survey, e.g. the session expired error message)
*'''tokenmessage''' (Uporablja se za sporočila znotraj ankete t.i. sporočilo o napaki, da je seja potekla)


An example of using these classes with style sheets can be found in the "bubblegum" template that comes with the LimeSurvey application.
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.


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.
==Oblikovanje vrstice o napredovanju==


==Styling the progress bar==
Prikaz vrstice napredka se lahko spreminja s CSS-jem.


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


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.
<syntaxhighlight lang="php">.sadno .progress-bar {
 
barva ozadja: #3300FF;
'''Version 1.87 and newer:'''
 
The progress bar appearance can be modified with CSS.
 
To change the background colour of the bar, add something like the following to the end of your template.css file.
 
<syntaxhighlight lang="php" enclose="div">#progress-wrapper .ui-widget-header {
 background-color: #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''':
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.


// Set $embedded to true and specify the header and footer functions if the survey is to be displayed embedded in a CMS
====Podpora za vaše lastne funkcije Javascript====


  <nowiki>
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.
$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.
'''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]].


===Support for your own Javascript functions===
{{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]].}}


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.


'''Version 1.87 and newer:'''
==Namigi in triki==
*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=
===Element, specifičen za jezik===


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.
Č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.


[http://youtu.be/Uk3FQyDTIY0 LimeSurvey training video - template customization]
Primer: za besedilo pomoči na koncu strani v francoščini in angleščini je potrebno dodati sledeče v datoteko endpage.pstpl:


=Tips & Tricks=
<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>


==Some language specific element==
in v datoteko template.css


If you want to have some langage specific sentence in a survey, for example an help at end of each page, you can add in a .pstl file a sentence and hidding it for other langage. And hidding it in the template.css, we can use psuedo selector :lang, but for best compatibility, we use some class.
<syntaxhighlight lang="php">.lang-fr .en{display:none}
 
Example for a help sentence at bottom of the page, in french an english, put this on endpage.pstpl:
 
<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