LimeSurvey are un sistem avansat de temă și stil care oferă dezvoltatorilor o modalitate eficientă de a personaliza aspectul sondajului. De la LS3, termenul "şabloane" a fost înlocuit cu termenul "teme". Temele permit controlul asupra stilului paginilor unui sondaj. Un administrator de sondaj poate selecta o temă implicită care va fi folosită pentru fiecare sondaj pentru a o personaliza în continuare. „Teme” vine cu opțiuni care oferă unui administrator fără abilități de codare o modalitate simplă de a adăuga un logo pe pagina de întâmpinare, de a schimba culorile de fundal, de a selecta un font etc.
LimeSurvey vine cu 3 teme. Aceste teme inițiale sunt definite de directoarele situate în directorul „themes/survey/” de instalare LimeSurvey. Fiecare temă are propriul director. În directorul principal al unei teme veți găsi un fișier de configurare în XML și numeroase directoare care conțin vizualizările themes (.twig), cascading style sheets (.css), 'scripturi, imagini ('.jpg sau .png) și poate altele.
Începând cu LimeSurvey 2.50, motorul de temă folosește Bootstrap 3 ca cadru CSS. Deoarece Bootstrap 3 este un cadru standard, dezvoltatorii vor găsi o mulțime de documentație, tutoriale și fire de discuții despre acesta pe internet.
De la LimeSurvey 3, motorul de teme folosește Twig, astfel încât dezvoltatorii de teme pot schimba logica redării sondajului într-un mod sigur și ușor. Twig înlocuiește vechiul sistem de cuvinte cheie de înlocuire care a fost folosit în versiunile anterioare. Logica care a fost folosită pentru a genera HTML-ul cuvintelor cheie este acum disponibilă în vizualizările temei.
Fragment din Tema Vanilie:
<div class="{{aSurveyInfo.class.answercontainer}} col-xs-12" {{aSurveyInfo.attr.answercontainer}}> {# NOTĂ: Dacă doriți să personalizați redarea întrebării, utilizați o temă de întrebare #}{{aQuestion.answer|crud}}</div>
Temele, fiind codul HTML și Twig, tind să definească poziționarea și tipul de text de afișat și caracteristicile structurale similare ale paginii. Ele fac referire sau includ adesea alte fișiere. Cele mai multe dintre ele fac referire la un fișier comun de foi de stil în cascadă (CSS) care definește stilul fontului, culoarea, dimensiunea, fundalul și parametrii similari comuni tuturor paginilor din sondaj. Foile de stil fac referire la parametrii HTML „’’clasă’’’ care sunt asociați cu diferitele tipuri de obiecte din codul HTML. Acest lucru permite foii de stil să definească modul de afișare a fiecăruia dintre numeroasele tipuri de text sau alte obiecte care pot apărea în mai multe locuri. Există clase unice pentru fiecare tip de întrebare în LimeSurvey, oferind astfel control detaliat asupra aspectului fiecăruia. Fișierele imagine, cum ar fi logo-urile sau constructorii speciali de bare de progres, pot fi de asemenea menționate în fișierul Theme. În cele din urmă, cuvintele cheie speciale din acolade sunt înlocuite cu text definit în sondaj pentru fiecare corespondent de traducere a limbii (de exemplu, „Titlul sondajului” sau „Textul întrebării” pentru fiecare limbă definită).
Dacă creați o nouă temă personalizată, vă rugăm să o contribuiți înapoi la comunitatea LimeSurvey și să o puneți la dispoziție altora. Cu ajutorul tău, putem crește depozitul nostru de teme, sondaje și alte suplimente pentru a face LimeSurvey și mai bun!
Consultați depozitul de șabloane LimeSurvey unde vă puteți partaja șabloanele.
Crearea unei noi teme
Pentru a putea crea o temă nouă (sau edita o temă existentă), aveți nevoie de Modificarea șablonului permisiunea utilizatorului în LimeSurvey, precum și permisiunea de a manipula fișierele din operațiunea de bază. sistem care găzduiește instalarea dvs. LimeSurvey.
Notă de avertizare: Dacă schimbați teme, puteți afecta și toate sondajele preexistente din instalarea dvs. LimeSurvey. Temele sunt o caracteristică avansată care necesită experiență și cunoștințe HTML.
Modul preferat de a crea o temă nouă este prin „Editorul de teme” (vezi mai jos), care se află sub „Configurare” din bara de instrumente de sus. Unii utilizatori preferă să lucreze direct cu fișierele tematice, astfel încât să poată folosi editorul de text preferat în locul interfeței web. În acest caz, utilizați în continuare Editorul de teme pentru a crea mai întâi noua temă. Aceasta va crea o nouă temă de bază cu toate fișierele de care aveți nevoie în directorul LimeSurvey_web_root/upload/themes/survey/your_new_template. De acolo puteți utiliza editorul de text pentru a ajusta manual fișierele șablon.
Notă privind permisiunile: pe sistemele unix/linux, aceste fișiere cu teme vor fi deținute de grupul și utilizatorul pe care rulează serverul web (poate fi „www” pentru unele sisteme). Deci, asigurați-vă că aveți permisiunile corespunzătoare pentru a edita aceste fișiere. Când le salvați, asigurați-vă că nu își schimbă proprietarul! În acest fel, puteți utiliza în continuare interfața de editare a temei web, dacă este necesar.
O serie de elemente „publice” ale LimeSurvey pot fi ajustate printr-o serie de teme. Următoarea secțiune oferă o explicație foarte scurtă a acestor șabloane.
Editor de teme: Configurare > Teme> Editor de teme
Editorul de teme este disponibil numai pentru utilizatori cu permisiunea Templates și pentru superadministratori.
Atenție : O temă care nu este construită corect poate face ca un sondaj (care folosește șablonul respectiv) să devină inoperabil.
Editorul de teme LimeSurvey vă permite să editați conținutul temelor dvs. online. Pentru a porni Editorul de teme: faceți clic pe „Teme” în meniul „Configurare”, apoi faceți clic pe butonul „Editor de teme” de lângă tema pe care doriți să o editați sau să extindeți.
Pagina editorului de șabloane vă permite să selectați șablonul pe care doriți să îl editați/vizualizați.
Sunt disponibile următoarele opțiuni:
Creare: Vă permite să creați un șablon nou. Pentru a nu începe de la zero, șablonul „implicit” este copiat.
Import: Vă permite să importați un șablon dintr-un fișier ZIP.
Export : Vă permite să exportați șablonul curent într-un fișier ZIP.
Copy: Vă permite să creați un șablon nou prin copierea celui actual.
Redenumiți: Vă permite să schimbați numele șablonului. Este folosit în general după copierea sau importul unui șablon.
Șablon: o listă derulantă care arată toate șabloanele disponibile care se află în instalarea dvs. LimeSurvey.
Ecran: o listă derulantă care vă permite să alegeți ce pagină de sondaj din acel șablon doriți să o vizualizați.
Reveniți la panoul de administrare.
Importați/Exportați/Copiați un șablon
Când exportați un șablon, va fi creată o arhivă de fișier ZIP cu toate fișierele șablon (fișiere .pstpl, imagini, fișiere css, ...). Puteți „importa” fișierul zip exportat într-o altă instalare LimeSurvey utilizând caracteristica de import sau puteți copia manual arhiva într-o altă instalare LimeSurvey și o puteți extrage în șablon corespunzător director acolo.
Cu toate acestea, cel mai bine este să utilizați funcțiile de import/export/copiere a șablonului LimeSurvey în editorul de șabloane.
Structura paginii/Utilizarea șablonului
Pagina de bun venit: startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
'Paginile de întrebări:' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
Pagina finală: pagina de pornire .pstpl, evaluare.pstpl, completat.pstpl, endpage.pstpl
Fișiere șablon
Următoarele fișiere șablon sunt folosite pentru a produce sondajul dvs. public și trebuie să existe în orice folder de șablon nou creat de dvs.:
startpage.pstpl: Produce începutul fiecărei pagini html. Începe la "<head> " eticheta și nu trebuie să conțină "<html> „. Acest „început” al unei pagini html standard este scris de scripturi. Asigurați-vă că fișierele dvs. startpage.pstpl conțin un<body> etichetă. Chiar dacă multe browsere nu necesită respectarea strictă a standardelor HTML W3, scriptul LimeSurvey trebuie să găsească o etichetă pentru a rula anumite elemente javascript. Nu este obișnuit să vedeți multe „cuvinte cheie” utilizate în fișierul startpage.pstpl. Cu toate acestea, poate doriți să adăugați {SURVEYNAME} în titlu. Fișierul startpage.pstpl poate conține cod care se termină în fișierul endpage.pstpl corespunzător. De exemplu, puteți începe un tabel din acest fișier și puteți închide tabelul din fișierul endpage.pstpl. Fișierele startpage.pstpl și endpage.pstpl înconjoară fiecare pagină posibilă utilizată de LimeSurvey.
survey.pstpl: Acest șablon este al doilea folosit în majoritatea paginilor și oferă un spațiu pentru a pune numele sondajului si descriere. Acest șablon nu are un șablon de „închidere” corespunzător și, ulterior, ar trebui să închideți toate etichetele deschise în acest fișier șablon (adică: nu lăsați un tabel deschis aici deoarece nu există niciun alt loc unde să-l închideți).
' welcome.pstpl:' Acest șablon este folosit doar în ecranul de întâmpinare (care se află și pe pagina principală pentru sondajele „tot într-unul”). Puteți utiliza acest lucru pentru a tipări textul de bun venit și alte informații care ar trebui furnizate în introducere. La fel ca fișierul „survey.pstpl”, nu există un șablon de „închidere” corespunzător, așa că toate etichetele deschise în acest fișier șablon ar trebui să fie și ele închise.
startgroup.pstpl: Acest șablon poate oferi un „rezumat” pentru întrebările din cadrul unui grup. Are un șablon „endgroup.pstpl” potrivit care poate fi folosit pentru a închide orice etichete deschise în acest fișier, astfel încât să puteți deschide un tabel în cadrul acestuia.
groupdescription.pstpl: Acest fișier șablon este folosit pentru a afișa o descriere a unui grup. Vă rugăm să rețineți că în setările sondajului (accesați „Setări de prezentare și navigare” făcând clic pe fila „Prezentare”) puteți seta dacă descrierea grupului trebuie afișată sau nu. Dacă nu, atunci acest fișier nu este inclus deloc.
question.pstpl: Acest fișier conține secțiunile de întrebare, răspuns și text de ajutor ale sondajului dvs. În sondajele „grup cu grup” și „tot într-unul”, acest șablon este ciclic în mod repetat cu fiecare întrebare. Nu există niciun fișier de închidere corespunzător pentru aceasta și toate etichetele ar trebui închise.
question_start.pstpl: Acest fișier conține elementele individuale găsite la începutul unei întrebări. Este inclus în „question.pstpl” prin intermediul cuvântului cheie {QUESTION}. Este destinat să permită designerilor de șabloane mai mult control asupra aspectului unei întrebări. Acest șablon se află în afara sistemului normal de șabloane și „a fost înlocuit (începând cu LimeSurvey 1.87)”. Toate cuvintele cheie din acest șablon sunt acum disponibile direct în question.pstpl.
completed.pstpl: Această pagină este afișată ca pagină finală când răspunsurile la sondaj au fost salvate și sondajul sa încheiat. Poate fi folosit pentru a afișa un „link de redirecționare” așa cum este setat în configurarea sondajului.
endgroup.pstpl: Acest fișier închide grupul și poate fi folosit pentru a închide orice etichete deschise în fișier startgroup.pstpl
navigator.pstpl: Acest fișier conține butoanele care navighează prin sondaj, „următorul”, „prev”, „ultimul”, „trimitere”, „salvare până acum” și linkul „șterge tot”. Este folosit în toate paginile, cu excepția paginii completate.
printanswers.pstpl: Acest fișier are pachetul HTML necesar pentru versiunea tipărită a sondajului.
print_group.pstpl : Acest fișier este același cu startgroup.pstpl și endgroup.pstpl, dar pentru versiunea tipărită a sondajului.
print_question.pstpl: Acest fișier este același cu question.pstpl , dar pentru versiunea tipărită a sondajului.
print_survey.pstpl: Acest fișier este același cu survey.pstpl, dar pentru versiunea tipărită a sondajului.
CSS și Javascript
Două fișiere care sunt întotdeauna utilizate într-un șablon sunt template.css (pentru CSS) și template.js (pentru Javascript).
{TEMPLATECSS}: Adăugați linii pentru CSS implicit, template.css, și template-rtl.css pentru limbajul rtl.
{TEMPLATEJS}: Adăugați linii pentru fișierele javascript implicite, template.js și toate fișierele js necesare pentru LimeSurvey.
Folosind Bootstrap
LimeSurvey are Bootstrap 3 încorporat, astfel încât să vă puteți stila toate șabloanele cu clasele Bootstrap bine documentate.
Pentru mai multe informații, consultați Bootstrap documentație.
Pluginul Awesome-Bootstrap-Checkbox este de asemenea inclus. Cu acesta, puteți utiliza clasele de culoare tipice Bootstrap (informații, avertisment, pericol, etc.) și cu sufixul „-checkbox” sau „-radio”, deși stilând casetele de selectare și radiourile după cum preferi.
Înlocuirea implicită a CSS sau Javascript
Unele întrebări folosesc fișiere specifice pentru Javascript sau CSS. Dacă trebuie să înlocuiți o funcție, utilizați un sistem în cascadă. Pentru funcția javascript, ultima funcție citită este funcția utilizată.
Alte fișiere șablon
privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl și confirmationemail.pstpl nu mai sunt folosite de LimeSurvey, iar valorile implicite sunt setați în schimb în fișierele de limbă aplicabile. Mesajele de e-mail pot fi acum editate în funcție de sondaj.
Pagini standard
Există zece pagini standard pe care un participant la sondaj le poate vedea în timpul accesării sau accesării aplicației LimeSurvey. Fiecare este construit dintr-un număr de fișiere „Șablon” comune din „Șablonul” specificat în setările sondajului. Tabelul de mai jos indică ce fișiere șablon sunt folosite la construirea fiecărei pagini.
* NOTĂ: În versiunea 1.90+, aceasta înlocuiește question.pstpl ȘI question_start.pstpl. Dacă utilizați un șablon personalizat vechi, trebuie să adăugați următoarea linie la începutul lui question.pstpl:
Și apoi adăugați eticheta de închidere corespunzătoare la sfârșitul question.pstpl:
</div>
* NOTĂ: În versiunea 1.91 și anterioară, fișierele LimeSurvey js nu sunt incluse în șablon. În versiunea 2, trebuie să utilizați {TEMPLATEJS} într-unul dintre fișierele șablon pentru a adăuga linkul la fișierul js. Îl puteți adăuga în startpage.pstpl sau în endpage.pstpl. Puteți elimina linia {TEMPLATEURL}/template.js și trebuie să o înlocuiți cu {TEMPLATEJS} pentru a actualiza un șablon personal.
Secțiunea de control al fișierelor
În fereastra „control fișiere” din stânga, puteți face clic pe unul dintre fișierele șablon care este utilizat pentru a compila pagina. Puteți vedea „partea ecranului”, fișierele JavaScript și CSS. Codul HTML pentru acel fișier va apărea apoi în fereastra „Editare acum” din centru. Dacă șablonul este editabil (determinat de permisiunile directorului), apoi puteți face orice modificări și le puteți salva.
Fereastra „Alte fișiere” arată o listă cu toate celelalte fișiere din directorul șablonului. Puteți folosi partea dreaptă pentru a „încărca și selecta fișiere imagine (fotografiile, logo-urile,...) sau alte fișiere necesare pentru a vă crea șablonul”.
În loc să utilizați un link pentru fiecare imagine, utilizați șirul de câmp {TEMPLATEURL}. Deci, în loc de:
În versiunile LimeSurvey înainte de 2.50 utilizați:
img src='{TEMPLATEURL}mypicture.jpg'
O „probă” a paginii șablon pe care o editați va fi vizibilă în partea de jos a ecranului. Nu există nicio modalitate de a șterge un șablon din editorul de șabloane. Acest lucru trebuie făcut prin accesarea directorului de bază și ștergerea manuală a fișierelor de acolo. Aveți, de asemenea, posibilitatea de a selecta diferite rezoluții de ecran pentru a evalua mai bine aspectul și aspectul șablonului.
Notă: Șabloanele livrate nu pot fi editate folosind editorul de șabloane. Dacă doriți să le modificați, creați mai întâi o copie și editați copia.
Locația fișierelor șablon
LimeSurvey stochează fiecare dintre șabloanele „standard” în propriul lor subdirector distinct în directorul „/templates” care este păstrat în directorul public împreună cu celelalte fișiere publice LimeSurvey. Șabloanele de utilizator personalizate sunt stocate în directorul /upload/templates.
Ar trebui să existe „ÎNTOTDEAUNA” un director „implicit” în directorul de șabloane. Acest șablon este utilizat în mod implicit și ca alternativă dacă un folder de șablon nu există sau nu poate fi găsit. Vine instalat implicit.
Puteți utiliza orice fișiere imagine pe care le încărcați în zona de gestionare a șablonului cu ajutorul acestei sintaxe:
{TEMPLATEURL}filename.xyz
Stilizarea întrebărilor cu CSS
Stilizarea întrebărilor în CSS a devenit mult mai ușoară. Fiecare tip de întrebare are acum o clasă unică. Întrebările obligatorii au o clasă suplimentară obligatorie. De exemplu, pentru o întrebare neobligatorie:
Aceste clase sunt folosite pentru fiecare tip de întrebare. Unele tipuri de întrebări folosesc doar una sau două clase, în timp ce altele pot folosi mult mai multe.
Clase globale
Nume clasa
Partea
Tip întrebare
Exemple
Notă
.întrebarea (Obsolete since 3.0)
Toate blocurile de întrebări
Toate tipurile de întrebare
,
,
.ls-răspuns (New in 3.0 )
Toate blocurile de întrebări
Toate tipurile de întrebare
,
,
.lista-subîntrebări
Lista subîntrebărilor
Întrebare cu variante multiple, tip de întrebare matrice
,
Se folosește și .questions-list
.listă-răspunsuri
Lista de răspunsuri
Întrebare cu o singură alegere, tip de întrebare matrice, întrebare text cu introducere multiplă
,
.răspuns-articol
Partea de răspuns: un singur răspuns
Întrebare cu o singură alegere, tip de întrebare matrice, întrebare text cu introducere multiplă
,
.noanswer-item
Partea de răspuns pentru niciun răspuns
Întrebare cu o singură alegere, tip de întrebare matrice
,
Niciun răspuns este de asemenea un răspuns, apoi au clasa dublă fără răspuns și item-răspuns
.intrebare-articol
Partea de întrebare: o întrebare
Întrebare cu mai multe text, tip de întrebare matrice
,
Unele răspunsuri sunt și întrebări. Apoi avem o mulțime de class="question-item answer-item"
.lista de butoane
O listă de butoane
Da nu și întrebarea de gen
.buton-articol
Partea de răspuns cu un buton
Da nu și întrebarea de gen
.checkbox-list
O listă de casete de selectare
Întrebare cu alegere multiplă, număr de matrice (căsuță de selectare) tip întrebare
,
Unele tipuri de întrebări folosesc clasa multi-listă, cum ar fi caseta de selectare cu comentariu: class="checkbox-list text-list"
.checkbox-array (New in 3.0 )
O serie de casete de selectare
Matrice (numere) cu opțiunea casetă de selectare
.checkbox-item
Partea de răspuns cu o casetă de selectare
Întrebare cu alegere multiplă, număr de matrice (căsuță de selectare) tip întrebare
,
.radio-list
O listă de articole radio
Întrebare cu o singură alegere, tip de întrebare matrice (fiecare rând)
,
.radio-array (New in 3.0 )
O serie de articole radio
Tip întrebare matrice
.articol radio
Partea de răspuns cu un radio
Întrebare cu o singură alegere, tip de întrebare matrice
,
.text-list
O listă cu introducerea textului
Tip de întrebare cu mai multe text, matrice de text
,
.articol-text
Partea de răspuns a unei introduceri de text
Tip de întrebare cu mai multe text, matrice de text
,
.numeric-list
O listă de introducere a textului cu răspuns numai numeric
Tip de întrebare cu mai multe cifre, matrice de numere
,
.lista de numere
O listă de introducere a textului cu răspuns numai numeric (fiecare rând)
Tip de întrebare cu mai multe cifre, matrice de numere
Notă: Înainte de 1.92, erau disponibile numai clasele .obligatoriu și .input-error.
Acestea se aplică mesajelor de ajutor și/sau sfaturi de validare, astfel încât fiecare tip să poată fi stilat individual.
Opțiunea .hide-tip și opțiunile .input-error interacționează în mod implicit, astfel încât să puteți avea sfaturi de validare ascunse. Cu toate acestea, ele apar atunci când există erori de validare și dispar din nou când acele erori sunt rectificate.
Toate acestea sunt concepute pentru a elimina nevoia de mesaje de alertă pop-up. În schimb, sfaturile pot apărea/dispără după cum este necesar și sunt codificate cu culori pentru a indica dacă răspunsurile trec criteriile de validare.
Mai mult, atunci când vizitați pentru prima dată o pagină care are criterii de validare neîndeplinite, puteți codifica color sfaturile într-o culoare plăcută pentru a arăta care criterii de validare nu au fost încă îndeplinite; apoi reafișează pagina folosind o culoare mai aspră dacă persoana trimite pagina cu erori persistente de validare.
Scop
Clasa CSS
Descriere
Obligatoriu
.obligatoriu
întrebarea este obligatoriu
Eroare de intrare de utilizator
.input-error
întrebarea a avut cel puțin o eroare de validare
Ascunde Sfatul
.hide-tip
adăugat dacă utilizați opțiunea hide_tip
tip implicit
.em_default
pentru setul implicit de sfaturi (valoare numerică etc...)
Număr răspunsuri
.em_num_answers
pentru pentru min_answers și max_answers
Interval de valori
.em_value_range
pentru min/max_num_value_n și multiflexible_min/max
Interval de sumă
.em_sum_range
pentru min/ max/equals_num_value
Validare Regex
.em_regex_validation
pentru validarea cu expresii regulate a întrebării
Funcția de validare la nivel de întrebare
.em_q_fn_validation
pentru opțiunea em_validation_q
Funcția de validare la nivel de subîntrebare
.em_sq_fn_validation
pentru opțiunea em_validation_sq
Alt comentariu obligatoriu
.em_other_comment_mandatory
pentru opțiunea_other_comment_obligatorie - arată când „altul” este selectat, dar comentariul asociat lipsește.
Importul stilurilor în șablonul personalizat
Stilurile personalizate de întrebări sunt aproape de partea de jos a fișierului CSS al fiecărui șablon și încep cu:
/* --------------------------- START: Stiluri de întrebare ----------------- ------------- */
Dacă vă stilați propriul șablon personalizat, ar trebui să puteți copia totul după cel de mai sus din „templates/default/template.css” (pentru machete bazate pe tabel) sau „/templates/limespired/template”. css (pentru machete bazate pe CSS) în propria ta foaie de stil, fără nici un impact asupra celorlalte stiluri.
Foile de stil condiționate Internet Explorer
Din cauza discrepanțelor marcate de redare între IE6 și IE7 și celelalte browsere, sunt incluse foi de stil IE condiționate pentru fiecare șablon.
Ar trebui să includeți codul de mai sus în „startpage.pstpl' și copii ale ambelor foi de stil IE din /templates/default/ sau /templates/limespired pentru aspectul de bază și Aspect bazat pe CSS, respectiv.
Notă: Dacă copiați stilurile în propria foaie de stil, aproape sigur va trebui să le modificați.
Soluție alternativă pentru Internet Explorer
Puteți pune o clasă condiționată pentru body în startpage.pstpl și utilizați această clasă în template.css. Această metodă este utilizată în șablonul citronade (Obsolete since 2.06). Adăugarea unei clase js / no-js pentru a avea sistem javascript / no javascript.
.ie6{/*specific pentru Internet Explorer 6*/}.ielt8{/*specific pentru Internet Explorer 6 și 7*/}.ie{/*specific pentru toate Internet Explorer */}
Limbi de la dreapta la stânga (RTL) și justificați
Editorul de text din LimeSurvey este capabil să formateze textul RTL. Cu toate acestea, editorul însuși arată limbajul RTL într-un format de la stânga la dreapta atunci când este justificat. Aceasta este doar o problemă de afișare a editorului. RTL și întrebarea sau textul justificat se vor afișa corect de la dreapta la stânga, chiar și atunci când sunt justificate, în sondajul dvs. sau în previzualizare.
Cuvintele cheie dintr-un fișier șablon sunt înlocuite cu informațiile curente ale sondajului. Sunt înconjurate de paranteze, de exemplu: {SURVEYNAME}.
Următoarele șiruri de caractere vor fi înlocuite cu LimeSurvey atunci când analizați fișierul șablon și îl prezentați utilizatorilor sondajului. Aceste șiruri de câmp vor funcționa pe aproape fiecare șablon, cu excepția „Pagină finalizată”. (Majoritatea acestor șiruri pot fi găsite în fișierul common.php. Dacă nu este acolo, căutați în fișierul index.php.)
Cuvânt cheie
Fișiere șablon
Descriere
{SURRVEYNAME}
Toate Fișiere
Titlul sondajului
{SURVEYDESCRIPTION}
Toate fișierele
Descrierea sondajului
{WELCOME}
Toate fișierele (în principal pentru welcome.pstpl)
Textul de „bun venit” al sondajului
{PERCENTCOMPLETE}
survey.pstpl
Un mic grafic care arată procentul din sondaj completat
Afișează numărul total de întrebări din sondaj (doar numărul)
{THEREAREINTREBĂRI}
bine ai venit. pstpl
Afișează propoziția „Există X întrebări în acest sondaj” - din fișierul de limbă relevant. X este înlocuit cu numărul de întrebări. Rețineți că acest lucru va funcționa corespunzător și pentru singular sau plural. Dacă există doar o întrebare, se va imprima „Există o întrebare în acest sondaj”.
{CHECKJAVASCRIPT}
Toate fișierele (în principal pentru welcome.pstpl)
Mesaj de avertizare când se încheie- browserul utilizatorului are javascript dezactivat
{INTREBARE}
Question.pstpl
-
{RASPUNS}
question.pstpl, print_question.pstpl
prezentă formularul de răspuns pentru întrebarea curentă
{SGQ}
question.pstpl, textul întrebării
Poate fi folosit în textul întrebării în sine pentru a face referire la câmpul de introducere al întrebării în mod dinamic, prin afișarea ID-ului Chestionar-Grup-Întrebare pentru întrebarea curentă. (începând cu svn build 9755)
{QUESTIONHELP}
question.pstpl, print_question.pstpl
Afișează text de ajutor (sfat predefinit pentru tipul de întrebare) pentru întrebarea curentă
{QUESTION_CODE}
question.pstpl, print_question.pstpl
Afișează codul de întrebare curent
{QUESTION_ESSENTIALS }
question.pstpl
ID-ul întrebării și (dacă o întrebare este condiționată), „style="display:none;"'. (Pentru a fi inclus în eticheta de împachetare a întrebării.)
{QUESTION_HELP}
question.pstp, question_start.pstpl
Afișează textul de ajutor definit de utilizator pentru întrebarea curentă
{QUESTION_INPUT_ERROR_CLASS}
question.pstp, question_start.pstpl
Oferă o clasă dacă a existat o eroare de introducere a utilizatorului
{QUESTION_ID}
print_question.pstp
Oferă un ID unic pentru fiecare întrebare pentru a permite stilul pentru anumite întrebări
Afișează textul mesajului de ajutor valid tradus pentru întrebarea curentă
{QUESTION_SCENARIO}
print_question.pstp
Tipărește textul „scenariului” pentru întrebările condiționate.
{NAVIGATOR}
navigator.pstpl
Afișează butoanele de navigare (next, prev, last)
{CLEARALL}
Toate fișierele (dar destinate navigator.pstpl)
Afișează Link „Ieșire și șterge rezultatele”
{COMPLETED}
completed.pstpl
Afișează mesajul „finalizat” pentru înregistrare, se va schimba în funcție de setarea câmpurilor atribut_1 și atribut_2.
{URL}
completed.pstpl
Afișează „url” și „text URL” sondaj
{PRIVACYMESSAGE}
privacy.pstpl
Mesajul de confidențialitate este afișat dacă setați sondajul să fie anonim. Textul poate fi editat/tradus în fișierele de limbă. Acest lucru poate fi modificat și manual prin editarea șablonului privacy.pstpl pe care doriți să-l utilizați.
{TEMPLATEURL}
Toate fișierele
Adresa URL către locația actuală a șablonului (utilă pentru referirea fișierelor imagine în șablonul dvs.)
{SURVEYRESOURCESURL}
Toate fișierele
-
{SUBMITCOMPLETE}
endpage.pstpl
Declarația (din fișierele de limbă) care îi spune utilizatorului că a completat sondajul și să apese butonul „Trimite”
{SAVEDID}
Toate fișierele
Afișează „ID de răspuns” al utilizatorului
{QUEXMLPDF}
Toate fișierele
Afișează butonul pentru a exporta PDF-ul queXML al chestionarului, inclusiv răspunsurile introduse până la punctul care a fost completat în sondaj.
{TOKEN:FIRSTNAME}
Toate fișierele
***Dacă răspunsurile la sondaj NU sunt ANONIME - sunt înlocuite mai întâi cu utilizatorii numele din tabelul de jetoane
{TOKEN:LASTNAME}
Toate fișierele
-
{TOKEN:EMAIL}
Toate fișierele
***Dacă răspunsurile la sondaj NU sunt ANONIME - este înlocuit cu e-mailul utilizatorilor din tabelul de jetoane***
{TOKEN:ATTRIBUTE_1}
Toate fișierele
***Dacă răspunsurile la sondaj NU sunt ANONIME - este înlocuit cu atributul utilizatorilor_1 din tabelul de jetoane***
|Toate fișierele
***Dacă răspunsurile la sondaj NU sunt ANONIME - este înlocuit cu atributul utilizatorilor_2 din tabelul de jetoane***
{ANSWERSCLEARED}
De preferință în navigator.pstpl
The Declarația „Răspunsuri șterse” din fișierele de limbă
{RESTART}
clearall.pstpl
URL pentru repornirea sondajului
{REGISTERERROR}
register.pstpl
Afișează orice mesaj de eroare în pagina de înregistrare (adică: „Trebuie să includeți o adresă de e-mail”)
{REGISTERMESSAGE1}
register.pstpl
Instrucțiunea „Trebuie să fiți înregistrat pentru a finaliza acest sondaj" din fișierele de limbă
{REGISTERMESSAGE2}
register.pstpl
Detalii despre înregistrarea din fișierele de limbă
{REGISTERFORM}
register.pstpl
Formula actuală de înregistrare se va modifica în funcție de setarea câmpurilor atribut_1 și atribut_2.
{SAVE}
Funcționează potrivit pe navigator.pstpl
Afișează „Salvați răspunsurile, astfel încât far' pentru a oferi utilizatorului să salveze și să revină mai târziu pentru a continua sondajul. Dacă opțiunea Salvare este dezactivată în proprietățile sondajului, eticheta nu va fi afișată și ignorată.
{LANGUAGECHANGER}
survey.pstpl
}
Intrare/Butoane
Fiecare tip de „input” dintr-un sondaj a primit propriul nume de clasă, astfel încât să puteți adăuga CSS la fișierul „startpage.pstpl” și să aveți un anumit control asupra aspectului butoanelor și intrărilor de formular. Aceste nume de clasă sunt după cum urmează:
submit (Butoane de trimitere)
text (Intrari de text - pentru text liber scurt, dată și tip numeric)
answertext (Textul răspunsurilor)
radio (Butoane radio)
checkbox (Check Boxes)
„selectați” (Selectați / casete de listă)
textarea (Introduceri de text mari - pentru text liber lung)
clearall (Sondajul „Exit and Clear Survey” " link)
rank (Întrebarea stilului de clasare. Nu setează culoarea casetei de selectare sau a casetelor de text, dar permite schimbarea culorii fundalului, a culorii textului, a mărimii etc., pentru restul întrebării de clasare)
graph (Tabelul grafic „procent finalizat”)
innergraph (Tabelul din interiorul tabelului grafic - acesta conține textul 0% și 100%. Folosiți-l pentru a modifica dimensiunea acestui text)
întrebare (Setări generale pentru orice întrebare care este afișată într-un tabel. În general, ar trebui să utilizați aceasta pentru a asigurați-vă că dimensiunea și culoarea fontului sunt aceleași cu cele pe care le-ați folosit în altă parte ca implicit)
obligatoriu (Întrebări obligatorii)
eroare de introducere (Utilizator eroare de intrare - pentru dacă un utilizator a greșit cu o întrebare obligatorie sau cu o întrebare cu validare! Răspunsuri pentru o întrebare de tip matrice. Acest lucru vă permite să setați o culoare de fundal alternativă pentru aceste tipuri de întrebări. Matrice1 este folosită și pentru titlurile coloanelor din aceste tipuri de întrebări)
errorobligatory (Setează culoarea și stilul mesajului de eroare „Această întrebare este obligatorie”)
*warningjs (Setează culoarea și stilul mesajului de avertizare afișat dacă browserul participantului are javascript dezactivat)
Există și câteva elemente care pot fi accesate folosind ID-ul elementului (#ID în CSS):
surveycontact (Mesajul de contact afișat pe pagina de start)
tokenmessage (utilizat pentru mesajele din cadrul sondajului, de exemplu, mesajul de eroare a expirat sesiunea)
Deoarece puteți edita toate aspectele HTML, nu există niciun motiv să vă înconjurați șabloanele cu un
<divclass='new_name'></div>
și apoi definiți un css pentru acea clasă new_name.
Stilizarea barei de progres
Aspectul barei de progres poate fi modificat cu CSS.
Pentru a schimba culoarea de fundal a barei, adăugați ceva de genul următor la sfârșitul fișierului personalizat.css (exemplu pentru tema fructată):
.fructat.progress-bar{culoaredefundal:#3300FF;}
Pentru a schimba culoarea chenarului barei, adăugați ceva de genul următor la sfârșitul fișierului personalizat.css (exemplu pentru tema fructată):
.fructat.progress-bar{chenar:1pxsolid#FF0000;}
Funcții avansate disponibile pentru dezvoltatori
LimeSurvey a integrat câteva corecții create de utilizator care permit unele modificări speciale. Aceste caracteristici foarte avansate (în general) necesită modificări ale bazei de cod de bază a LimeSurvey și trebuie făcute cu atenție pentru a nu introduce găuri de securitate.
Suport pentru propriile funcții Javascript
Unii utilizatori ar putea avea nevoie să ruleze Javascript pe paginile sondajului, dar apelarea „checkconditions()” în elementul BODY a făcut imposibilă acest lucru. Acest apel a fost înlocuit cu o funcție JavaScript mică în HEAD care adulmecă existența „checkconditions()” și „template_onload()” înainte de a le apela. În acest fel, un autor de șablon își poate crea propria funcție template_onload() în HEAD care o înlocuiește pe cea implicită.
Dezactivați filtrul XSS - în Setări globale -> Securitate, setați „Filtrare HTML pentru XSS” la Nu.
Introduceți scriptul în sursa unei întrebări sau a descrierii unui grup.
Dacă doriți să aveți o propoziție specifică unei limbi într-un sondaj, de exemplu ajutor la sfârșitul fiecărei pagini, puteți adăuga un fișier .pstl o propoziție și o puteți ascunde pentru cealaltă limbă. Dacă îl ascundem în template.css, putem folosi pseudo-selectorul :lang, dar folosim o clasă pentru o mai bună compatibilitate.
Mai jos, sunt două propoziții de ajutor, în franceză și engleză. Pune asta pe endpage.pstpl:
După editarea și salvarea unui șablon, acesta se aplică unei pagini cu listă de sondaje numai dacă este selectat din setările sondajului. Pentru a-l transforma în șablonul implicit, accesați „fila General” situată în „Setări globale” a instalării dumneavoastră LimeSurvey și alegeți șablonul dorit. Din acest moment, toate șabloanele care folosesc opțiunea „implicit” ca șablon, plus cele care urmează să fie nou create, vor folosi șablonul implicit nou selectat.
Pentru a utiliza șablonul actual pentru această pagină, trebuie să modificați setarea corespunzătoare din „Setări globale'. În versiunile mai vechi, această modificare se poate face prin editarea setării $defaulttemplate din fișierul de configurare: copiați această setare din config-defaults.php în config.php, care înlocuiește config-defaults.php și editați această setare în $defaulttemplate = 'yourtemplatename'; .
Import/Export de șabloane: utilizatori de Mac
Utilizatori Mac , vă rugăm să rețineți că utilitarul de arhivare implicit Mac OSX poate avea probleme cu folderele zip „generate din mers”.
O soluție este să dezarhivați Unix-ul din linia de comandă:
$ unzip template.zip -d template
Arhivă: template.zip
umflare: șablon/pagina de pornire
umflare:...
O altă soluție este să folosiți scripturi în omologii lor compilați pe Mac.
Folosiți același șablon cu logo-uri diferite
Dacă doriți să utilizați același șablon pentru toate sondajele și doriți doar să schimbați sigla pentru fiecare sondaj, puteți utiliza substituentul {SID} în fișierul șablon .pstpl și, prin urmare, vă referiți la imagini diferite:
<imgsrc="{TEMPLATEURL}files/logoImage-{SID}.png">
Afișează favicon personalizat
O favicon este pictograma mică pe care o vedeți în bara de adrese, lista de marcaje sau fila browserului. Puteți afișa propria pictogramă după cum urmează:
Creați o favicon - Puteți utiliza Google pentru a găsi o mulțime de generatoare de favicon gratuite.
Numiți noua dvs. favicon „favicon.ico” și plasați-o în șablonul /fișierele dvs. director.
Adăugați următorul cod la „startpage.pstpl' înainte de</head> etichetă.
Aspect diferit pentru paginile de sondaj/întrebări
Dacă doriți ca LimeSurvey să schimbe aspectul fiecărei pagini a doua (adică paginile de sondaj pare și impare), puteți utiliza clasa „.page-odd' în fișierul dvs. CSS pentru a schimba aspectul paginilor impare.
Un exemplu din șablonul implicit al LimeSurvey 1.91+:
header_separator este folosit pentru a adresa separatorul pentru antetul "td". „Dual_scale_separator” este folosit pentru a adresa coloana separatorului din matricea dual scale.
Adăugarea propriului logo la lista de sondaje
Mai întâi, deschideți editorul de teme pentru tema pe care doriți să o utilizați.
Vă recomandăm să folosiți fruity, este cea mai bună temă a noastră în prezent.
Apoi extinde tema și dă-i un nume pe care îl vei recunoaște.
În următoarea vizualizare, puteți încărca sigla pe care doriți să o utilizați.
Selectați ecranul de editare `Survey List´ din meniul derulant Ecran din colțul din dreapta sus.
Apoi selectați „layout_survey_list.twig” în meniul din stânga.
În editor, derulați la linia 126 și schimbați partea marcată cu numele de fișier al imaginii pe care ați încărcat-o înainte în temă.
Vizualizări de întrebări personalizate (New in 3.0 )
Notă: Aceasta este o caracteristică temporară care va fi înlocuită în viitor cu obiect întrebare (va fi foarte ușor să mutați vizualizările personalizate la obiectul întrebare). Este dezactivat implicit.
Începând cu versiunea 2.5, puteți crea vizualizări personalizate specifice șablonului pentru întrebări și unele dintre elementele lor încorporate. Acest lucru este util dacă doriți să modificați aspectul HTML al unui anumit tip de întrebare pentru unul sau mai multe sondaje.
În application/config/config.php, găsiți „config”=>array și adăugați această linie la matrice: „allow_templates_to_overwrite_views”=>1
În /{your_template}/config.xml, setați „overwrite_question_views” la adevărat
Copiați aplicația/views/survey/* în template/{your_view_directory}/survey/
Rețineți că trebuie să copiați doar fișierele pe care intenționați să le modificați, dar structura fișierului trebuie să rămână aceeași ca în aplicație/vizualizări/sondaj/
Inserați fișiere CSS sau JavaScript personalizate pentru șablon
Începând cu versiunea 2.50, puteți utiliza fișierul config.xml pentru a încărca automat fișierele plugin.
Încărcați fișierele în folderul șablon /css sau /scripts
În /{template_dvs.}/config.xml, adăugați căile fișierelor la<css> sau<js> blocuri, ceva de genul acesta:
Atenție : O temă care nu este construită corect poate face ca un sondaj (care folosește șablonul respectiv) să devină inoperabil.
