(Created page with "A sablon szerkesztése és mentése után csak akkor vonatkozik egy felmérés listaoldalára, ha a felmérés beállításai közül ki van választva. Ahhoz, hogy ez legyen...")
After editing and saving a template, it applies to a survey list page only if it is selected from the settings of the survey. To make it the default template, go under the '''General tab''' located in the '''Global settings''' of your LimeSurvey installation and choose the desired template. From this point on, all the templates that use the "default" option as template, plus the ones that are going to be newly created, will use the newly selected default template.
A sablon szerkesztése és mentése után csak akkor vonatkozik egy felmérés listaoldalára, ha a felmérés beállításai közül ki van választva. Ahhoz, hogy ez legyen az alapértelmezett sablon, lépjen a LimeSurvey telepítése '''Globális beállítások''' részében található ''''Általános''' fülre, és válassza ki a kívánt sablont. Ettől kezdve minden sablon, amely az "alapértelmezett" opciót használja sablonként, valamint az újonnan létrehozandó sablon, az újonnan kiválasztott alapértelmezett sablont fogja használni.
To use your current template for this page, you must change the appropriate setting from '''Global settings'''. In older versions, this change can be done by editing the $defaulttemplate setting from the config file: copy this setting from config-defaults.php to config.php which overrides config-defaults.php and edit this setting to <code lang="html">$defaulttemplate = 'yourtemplatename';</code>.
To use your current template for this page, you must change the appropriate setting from '''Global settings'''. In older versions, this change can be done by editing the $defaulttemplate setting from the config file: copy this setting from config-defaults.php to config.php which overrides config-defaults.php and edit this setting to <code lang="html">$defaulttemplate = 'yourtemplatename';</code>.
A LimeSurvey fejlett téma- és stílusrendszerrel rendelkezik, amely hatékony módot biztosít a fejlesztőknek a felmérés megjelenésének testreszabására. Az LS3 óta a 'sablonok kifejezést a 'témák kifejezés váltotta fel. A Témák lehetővé teszik a felmérés oldalainak stílusának szabályozását. A felmérés adminisztrátora kiválaszthat egy alapértelmezett témát, amelyet az egyes felmérésekhez használ, hogy tovább személyre szabhassa azt. A Témák olyan opciókat tartalmaz, amelyek kódolási ismeretek nélkül biztosítják az adminisztrátor számára, hogy egyszerűen logót helyezzenek el az üdvözlőoldalon, módosítsák a háttérszínt, válasszon betűtípust stb.
A LimeSurvey 3 témát tartalmaz. Ezeket a kezdeti témákat a LimeSurvey telepítési "themes/survey/" könyvtárában található könyvtárak határozzák meg. Minden témának saját könyvtára van. A téma főkönyvtárában található egy XML-beli konfigurációs fájl, valamint számos olyan könyvtár, amely tartalmazza a témák (.twig), lépcsőzetes stíluslapok (.css), nézeteket. 'scripts, images (.jpg vagy .png), és esetleg mások.
A LimeSurvey 2.50 óta a témamotor a Bootstrap 3-t használja CSS-keretként. Mivel a Bootstrap 3 egy szabványos keretrendszer, a fejlesztők rengeteg dokumentációt, oktatóanyagot és fórumszálat találhatnak róla az interneten.
A LimeSurvey 3 óta a témamotor a Twig-et használja, így a témafejlesztők biztonságosan és egyszerűen módosíthatják a felmérés megjelenítésének logikáját. A Twig lecseréli a korábbi verziókban használt helyettesítő kulcsszavak régi rendszerét. A kulcsszavak HTML-kódjának létrehozásához használt logika mostantól elérhető a téma nézeteiben.
Részlet a vanília témából:
<div class="{{aSurveyInfo.class.answercontainer}} col-xs-12" {{aSurveyInfo.attr.answercontainer}}> {# MEGJEGYZÉS: Ha testre szeretné szabni a kérdés megjelenítését, használjon #}{{kérdés.válasz|nyers}}</div>
A témák, mivel HTML és Twig kód, általában meghatározzák a megjelenítendő szöveg elhelyezését és típusát, valamint az oldal hasonló szerkezeti jellemzőit. Gyakran hivatkoznak vagy tartalmaznak más fájlokat. Legtöbbjük egy közös lépcsőzetes stíluslapok (CSS) fájlra hivatkozik, amely meghatározza a betűtípus stílusát, színét, méretét, hátterét és hasonló paramétereket, amelyek a felmérés összes oldalán közösek. A stíluslapok a HTML 'class' paramétereire hivatkoznak, amelyek a HTML-kód különböző típusú objektumaihoz vannak társítva. Ez lehetővé teszi, hogy a stíluslap meghatározza, hogyan jelenítse meg a sokféle szöveg vagy egyéb objektum mindegyikét, amelyek több helyen is megjelenhetnek. A LimeSurvey-ben minden kérdéstípushoz egyedi osztályok állnak rendelkezésre, így részletes ellenőrzést biztosítva mindegyik kérdéstípushoz. A képfájlok, például logók vagy speciális folyamatjelző konstruktorok, szintén hivatkozhatnak a témafájlban. Végül a kapcsos zárójelekben lévő speciális kulcsszavakat a felmérésben az egyes nyelvi fordítási levelezőkhöz definiált szövegekre cseréljük (például a „Felmérés címe” vagy a „Kérdés szövege” minden definiált nyelvhez).
Ha új egyéni témát hoz létre, fontolja meg annak visszaküldését a LimeSurvey közösségnek, és tegye elérhetővé mások számára. Segítségével bővíthetjük témák, felmérések és egyéb kiegészítők tárházát, hogy még jobbá tegyük a LimeSurveyt!
Tekintse meg LimeSurvey sablontárunkat, ahol megoszthatja sablonjait.
Új téma létrehozása
Új téma létrehozásához (vagy meglévő téma szerkesztéséhez) Sablonszerkesztési felhasználói engedély szükséges a LimeSurveyben, valamint engedélyre van szüksége a mögöttes operációs rendszerben lévő fájlok kezeléséhez. rendszer, amely otthont ad a LimeSurvey telepítésének.
Figyelmeztetés: Ha módosítja a témát, hatással lehet a LimeSurvey telepítéséből származó összes korábbi felmérésre is. A témák olyan speciális funkciók, amelyek tapasztalatot és HTML-ismeretet igényelnek.
Az új téma létrehozásának előnyben részesített módja a 'Témaszerkesztő (lásd alább), amely a felső eszköztár 'Konfiguráció alatt található. Egyes felhasználók szívesebben dolgoznak közvetlenül a témafájlokkal, így a webes felület helyett kedvenc szövegszerkesztőjüket használhatják. Ebben az esetben továbbra is használja a Témaszerkesztőt az új téma létrehozásához. Ezzel létrehoz egy új alaptémát az összes szükséges fájllal a LimeSurvey_web_root/upload/themes/survey/your_new_template könyvtárban. Innen a szövegszerkesztővel manuálisan módosíthatja a sablonfájlokat.
Engedélyek Megjegyzés: Unix/linux rendszereken ezek a témafájlok annak a csoportnak és felhasználónak a tulajdonában lesznek, ahol a webszerver fut (egyes rendszerek esetében "www" lehet). Tehát győződjön meg arról, hogy rendelkezik a megfelelő jogosultságokkal a fájlok szerkesztéséhez. Mentéskor ügyeljen arra, hogy ne változtassa meg a tulajdonjogát! Így szükség esetén továbbra is használhatja a webes témaszerkesztő felületet.
A LimeSurvey számos „nyilvános” eleme egy sor téma szerint módosítható. A következő rész nagyon rövid magyarázatot ad ezekről a sablonokról.
Figyelem : A nem megfelelően felépített téma működésképtelenné tehet egy felmérést (amely a megfelelő sablont használja).
A LimeSurvey témaszerkesztő lehetővé teszi a témák tartalmának online szerkesztését. A Témaszerkesztő elindítása: kattintson a 'Témák' gombra a 'Konfiguráció menüben, majd kattintson a 'Témaszerkesztő gombra a szerkeszteni vagy bővíteni kívánt téma mellett.
A sablonszerkesztő oldalon kiválaszthatja a szerkeszteni/megtekinteni kívánt sablont.
A következő lehetőségek állnak rendelkezésre:
Létrehozás: Lehetővé teszi új sablon létrehozását. Annak érdekében, hogy ne kezdjük elölről, az 'alapértelmezett' sablont másolja.
Importálás: Lehetővé teszi sablon importálását ZIP fájlból.
Exportálás : Lehetővé teszi az aktuális sablon exportálását ZIP fájlba.
Másolás: Lehetővé teszi új sablon készítését az aktuális másolásával.
Átnevezés: Lehetővé teszi a sablon nevének megváltoztatását. Általában egy sablon másolása vagy importálása után használatos.
Sablon: Egy legördülő lista, amely megjeleníti a LimeSurvey telepítésében található összes elérhető sablont.
Képernyő: Egy legördülő lista, amely lehetővé teszi, hogy kiválassza, hogy a sablon melyik felmérési oldalát szeretné megtekinteni.
Vissza az adminisztrációs panelre.
Sablon importálása/exportálása/másolása
Amikor exportál egy sablont, egy ZIP-fájl archívumot az összes sablonfájllal (.pstpl fájlok, képek, css fájlok stb.). Az exportált zip-fájlt importálhatja egy másik LimeSurvey-telepítésbe az importálási funkció használatával, vagy manuálisan átmásolhatja az archívumot egy másik LimeSurvey-telepítésbe, és kibonthatja a megfelelő sablonba. könyvtár ott.
A legjobb azonban a LimeSurvey sablon import/exportálás/másolás funkcióit használni a sablonszerkesztőben.
Oldalszerkezet / Sablonhasználat
Az üdvözlő oldal: startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
'A kérdések oldalai: startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
Az utolsó oldal: kezdőlap .pstpl, assessment.pstpl, complete.pstpl, endpage.pstpl
Sablonfájlok
A következő sablonfájlokat használjuk a nyilvános felmérés elkészítéséhez, és minden új sablon mappában létezniük kell:
startpage.pstpl: Minden html oldal elejét hozza létre. Kezdődik a "<head> " címke, és nem tartalmazhatja a "<html> " címkét. Egy szabványos html oldalnak ezt a "legelejét" a szkript írják. Kérjük, győződjön meg arról, hogy a startpage.pstpl fájljai tartalmaznak egy<body> címke. Bár sok böngésző nem követeli meg a W3 HTML-szabványok szigorú betartását, a LimeSurvey szkriptnek találnia kell egy címkét bizonyos JavaScript-elemek futtatásához. Nem gyakori, hogy sok „kulcsszó” szerepel a startpage.pstpl fájlban. Mindazonáltal érdemes lehet a(z) {SURVEYNAME} szót beletenni a címbe. A startpage.pstpl fájl tartalmazhat olyan kódot, amely a megfelelő endpage.pstpl fájlra végződik. Például elindíthat egy táblázatot ebben a fájlban, és bezárhatja a táblát az endpage.pstpl fájlban. A startpage.pstpl és endpage.pstpl fájlok a LimeSurvey által használt összes lehetséges oldalt körülölelik.
survey.pstpl: Ez a sablon a második, amelyet a legtöbb oldalon használnak, és helyet biztosít a felmérés nevének megadására. és leírás. Ennek a sablonnak nincs megfelelő 'záró' sablonja, és ezt követően be kell zárnia az ebben a sablonfájlban megnyitott összes címkét (pl.: ne hagyjon itt nyitva egy táblát, mert nincs máshol bezárható).
' welcome.pstpl:' Ezt a sablont csak az üdvözlőképernyőn használjuk (amely a főoldalon is megtalálható az 'all in one' felméréseknél). Ezzel kinyomtathatja az üdvözlő szöveget és egyéb információkat, amelyeket a bevezetőben meg kell adni. A 'survey.pstpl' fájlhoz hasonlóan nincs megfelelő 'záró' sablon, ezért ebben a sablonfájlban megnyitott összes címkét is be kell zárni.
startgroup.pstpl: Ez a sablon egy „összefoglaló” körben a csoporton belüli kérdésekhez. Rendelkezik egy megfelelő 'endgroup.pstpl' sablonnal, amellyel a fájlban lévő megnyitott címkék bezárhatók, így ezen belül is megnyithat egy táblázatot.
groupdescription.pstpl: Ez a sablonfájl egy csoport leírásának megjelenítésére szolgál. Kérjük, vegye figyelembe, hogy a felmérés beállításaiban (a Prezentáció és navigáció beállításai menüpontot a Prezentáció fülre kattintva érheti el) beállíthatja, hogy a csoport leírása megjelenjen-e vagy sem. Ha nem, akkor ez a fájl egyáltalán nem szerepel benne.
question.pstpl: Ez a fájl tartalmazza a kérdőív kérdés-, válasz- és súgószövegeit. A "csoportonkénti csoport" és a "mindent egyben" felmérésekben ezt a sablont minden kérdésnél ismételten körbeforgatják. Ehhez nincs megfelelő zárófájl, és minden címkét be kell zárni.
question_start.pstpl: Ez a fájl a kérdés elején található egyes elemeket tartalmazza. A „question.pstpl” a {KÉRDÉS} kulcsszón keresztül szerepel. Célja, hogy a sablontervezők nagyobb irányítást biztosítsanak a kérdés elrendezése felett. Ez a sablon kívül esik a normál sablonrendszeren, és kiváltva lett (a LimeSurvey 1.87-től). A sablon összes kulcsszava közvetlenül elérhető a question.pstpl oldalon.
completed.pstpl: Ez az oldal az utolsó oldalként jelenik meg, amikor a kérdőíves válaszokat elmentette és a felmérés véget ért. Használható egy "továbbító hivatkozás" megjelenítésére a felmérés beállításai szerint.
endgroup.pstpl: Ez a fájl bezárja a csoportot, és felhasználható a programban megnyitott címkék bezárására. startgroup.pstpl fájl
navigator.pstpl: Ez a fájl tartalmazza azokat a gombokat, amelyek a kérdőívben navigálnak: "következő", "előző", "utolsó", "elküld", "eddigi mentés" és a "minden törlése" hivatkozást. A kitöltött oldal kivételével minden oldalon használatos.
printanswers.pstpl: Ez a fájl rendelkezik a felmérés nyomtatott verziójához szükséges HTML-burkolóval.
print_group.pstpl : Ez a fájl megegyezik a startgroup.pstpl és endgroup.pstpl fájlokkal, de a felmérés nyomtatott verziójához.
print_question.pstpl: Ez a fájl megegyezik a question.pstpl fájllal. , hanem a felmérés nyomtatott verziójához.
print_survey.pstpl: Ez a fájl megegyezik a survey.pstpl fájllal, csak a felmérés nyomtatott verziójához.
CSS és Javascript
A sablonokban mindig használt két fájl a template.css (CSS-hez) és a template.js (Javascripthez).
{TEMPLATECSS}: Sorok hozzáadása az alapértelmezett css-hez, template.css, és template-rtl.css az rtl nyelvhez.
{TEMPLATEJS}: Adjon hozzá sorokat az alapértelmezett JavaScript-fájlokhoz, a template.js-hez és a LimeSurvey-hez szükséges összes js-fájlhoz.
A Bootstrap használata
LimeSurvey beágyazott Bootstrap 3-at, így az összes sablont stílusozhatja a jól dokumentált Bootstrap osztályokkal.
További információért tekintse meg a Bootstrap dokumentáció.
A Awesome-Bootstrap-Checkbox beépülő modult is tartalmazza. Használhatja vele a tipikus Bootstrap színosztályokat (infó, figyelmeztetés, veszély, stb.) a "-checkbox" vagy "-radio" utótaggal is, bár a jelölőnégyzeteket és a rádiókat tetszés szerint alakíthatja.
Az alapértelmezett CSS vagy Javascript lecserélése
Egyes kérdések meghatározott fájlokat használnak a Javascripthez vagy a CSS-hez. Ha ki kell cserélnie egy funkciót, használjon lépcsőzetes rendszert. Javascript függvény esetén az utoljára beolvasott függvény a használt függvény.
Egyéb sablonfájlok
A privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl és confirmationemail.pstpl fájlokat már nem használja a LimeSurvey, és az alapértelmezett ehelyett a megfelelő nyelvi fájlokban kell beállítani. Az e-mail üzenetek most felmérésenként szerkeszthetők.
Normál oldalak
Tíz szabványos oldal található, amelyeket a felmérésben résztvevők láthatnak a LimeSurvey alkalmazás felvétele vagy elérése során. Mindegyik a felmérés beállításaiban megadott 'Sablon számos közös 'Sablon fájlból épül fel. Az alábbi táblázat azt mutatja, hogy mely sablonfájlokat használták az egyes oldalak felépítéséhez.
'* MEGJEGYZÉS: Az 1.90-es és újabb verziókban ez a question.pstpl ÉS a question_start.pstpl helyébe lép. Ha régi egyéni sablont használ, hozzá kell adnia a következő sort a question.pstpl elejéhez:
Ezután adja hozzá a megfelelő záró címkét a question.pstpl végéhez:
</div>
'* MEGJEGYZÉS: Az 1.91-es és korábbi verziókban a LimeSurvey js fájlok nem szerepelnek a sablonban. A 2-es verzióban használnia kell a(z) {TEMPLATEJS} elemet az egyik sablonfájlban, hogy hozzáadja a hivatkozást a js fájlhoz. Hozzáadhatja a startpage.pstpl vagy az endpage.pstpl fájlhoz. A személyes sablon frissítéséhez eltávolíthatja a {TEMPLATEURL}/template.js sort, és le kell cserélnie a {TEMPLATEJS} elemre.
A fájlvezérlő rész
A bal oldali "fájlvezérlő" ablakban rákattinthat az oldal összeállításához használt sablonfájlok egyikére. Megtekintheti a „Képernyő részt”, a JavaScript- és CSS-fájlokat. A fájl HTML-kódja ezután megjelenik a "Most szerkesztés" ablakban a közepén. Ha a sablon szerkeszthető (a címtárengedélyek határozzák meg), akkor bármilyen módosítást elvégezhet és elmenthet.
Az "Egyéb fájlok" ablakban megjelenik a sablonkönyvtár összes többi fájljának listája. Használhatja a jobb oldalt a képfájlok (képek, logók stb.) vagy a sablon létrehozásához szükséges egyéb fájlok feltöltésére és kiválasztására.
Ahelyett, hogy minden képhez linket használna, használja a {TEMPLATEURL} mezőt. Tehát ahelyett:
A szerkesztett sablonoldal egy „mintája” látható lesz a képernyő alján. A sablonszerkesztőből nem lehet sablont törölni. Ezt úgy kell megtenni, hogy hozzáfér a mögöttes könyvtárhoz, és manuálisan törölje a fájlokat onnan. Lehetősége van különböző képernyőfelbontások kiválasztására is, hogy jobban értékelje a sablon érzését és megjelenését.
'Megjegyzés: A kiszállított sablonok nem szerkeszthetők a sablonszerkesztővel. Ha módosítani szeretné őket, először hozzon létre egy másolatot, majd szerkessze a másolatot.
Sablonfájlok helye
A LimeSurvey a „standard” sablonokat a saját külön alkönyvtárában tárolja a „/templates” könyvtárban, amely a nyilvános könyvtárban van a többi LimeSurvey nyilvános fájllal együtt. A testreszabott felhasználói sablonok a /upload/templates könyvtárban tárolódnak.
A sablonok könyvtárában az ALWAYS egy "alapértelmezett" könyvtárnak kell lennie. Ezt a sablont alapértelmezés szerint a rendszer tartalékként használja, ha nem létezik sablonmappa, vagy nem található. Alapértelmezés szerint telepítve van.
A sablonkezelési területre feltöltött bármely képfájlt használhatja a következő szintaxis segítségével:
{TEMPLATEURL}fájlnév.xyz
Stíluskérdések CSS-sel
A kérdések stílusa a CSS-ben sokkal könnyebbé vált. Minden kérdéstípusnak van egy egyedi osztálya. A kötelező kérdésekhez tartozik egy további kötelező osztály. Például egy nem kötelező kérdéshez:
Megjegyzés: Az 1.92 előtt csak .kötelező és .input-error osztályok voltak elérhetők.
Ezek a súgó- és/vagy az érvényesítési tippüzenetekre vonatkoznak, így minden típus egyedileg alakítható.
A .hide-tip és az .input-error opciók alapértelmezés szerint együttműködnek, így elrejthetők az érvényesítési tippek. Azonban megjelennek, ha érvényesítési hibák vannak, és újra eltűnnek, ha ezeket a hibákat kijavítják.
Mindezek célja, hogy kiküszöböljék a felugró figyelmeztető üzenetek szükségességét. Ehelyett a tippek szükség szerint megjelenhetnek/eltűnhetnek, és színkóddal jelzik, hogy a válaszok megfelelnek-e az érvényesítési feltételeknek.
Továbbá, amikor először meglátogat egy olyan oldalt, amelyen nem felel meg az érvényesítési feltételeknek, a tippeket tetszetős színnel színkódolhatja, hogy megmutassa, mely érvényesítési feltételek még nem teljesültek; majd jelenítse meg újra az oldalt durvább színnel, ha a személy elhúzódó ellenőrzési hibákkal küldi be az oldalt.
Cél
CSS osztály
Leírás
Kötelező
.kötelező
a kérdés kötelező
Felhasználói beviteli hiba
.input-error
a kérdésben legalább egy érvényesítési hiba volt
Tipp elrejtése
.hide-tip
hozzáadva ha a hide_tip opciót használja
default type
.em_default
az alapértelmezett tippkészlethez (numerikus érték stb…)
Válaszok száma
.em_num_answers
a min_válaszokhoz és a maximális_válaszokhoz
Értéktartomány
.em_érték_tartomány
min/max._szám_érték_n és multiflexibilis_min/max
Összegtartomány
.em_összeg_tartomány
min/ max/equals_num_value
Regex érvényesítés
.em_regex_validation
a kérdés reguláris kifejezésének érvényesítéséhez
Kérdésszintű érvényesítési függvény
.em_q_fn_validation
a kérdéshez em_validation_q option
Részkérdés-szintű érvényesítési függvény
.em_sq_fn_validation
az em_validation_sq opcióhoz
Egyéb megjegyzés kötelező
.em_other_comment_mandatory
for other_comment_mandatory "egyéb" ki van választva, de a kapcsolódó megjegyzés hiányzik.
Stílusok importálása az egyéni sablonba
Az egyéni kérdésstílusok az egyes sablonok CSS-fájljainak alján találhatók, és a következőkkel kezdődnek:
Ha saját egyéni sablont formáz, akkor a fentiek után mindent át kell tudnia másolni a templates/default/template.css (táblázatalapú elrendezések esetén) vagy a /templates/limespired/template” mappából. css (CSS-alapú elrendezésekhez) a saját stíluslapjába, anélkül, hogy bármilyen hatással lenne a többi stílusra.
Az Internet Explorer feltételes stíluslapjai
Az IE6 és IE7 és a többi böngésző közötti jelentős eltérések miatt minden sablonhoz speciális IE feltételes stíluslapok tartoznak.
A fenti kódot szerepeltetnie kell a startpage.pstpl fájlban, valamint mindkét IE stíluslap másolatát a /templates/default/ vagy a /templates/limespired táblák alapelrendezéséhez és CSS alapú elrendezés.
Megjegyzés: Ha a stílusokat a saját stíluslapjába másolja, szinte biztosan módosítania kell őket.
Alternatív megoldás az Internet Explorerhez
Feltételes osztályt helyezhet el a body számára a startpage.pstpl fájlba, és használhatja ezt az osztályt a template.css fájlban. Ezt a módszert a citronade sablon (Obsolete since 2.06) használja. js / no-js osztály hozzáadása javascript / no javascript rendszerhez.
.ie6{/*specifikus az Internet Explorer 6-hoz*/}.ielt8{/*az Internet Explorer 6-hoz és a 7-hez*/}.ie{/*az összes Internet Explorerhez */}
Jobbról balra (RTL) nyelvek és sorkizárás
A LimeSurvey szövegszerkesztője képes RTL szöveg formázására. Maga a szerkesztő azonban indokolt esetben balról jobbra formátumban jeleníti meg az RTL nyelvet. Ez csak a szerkesztő megjelenítési problémája. Az RTL és az indokolt kérdés vagy szöveg helyesen jelenik meg jobbról balra, még akkor is, ha indokolt, a felmérésben vagy az előnézetben.
A sablonfájlban lévő kulcsszavakat lecseréli az aktuális felmérési információ. Göndör zárójelek veszik körül őket, például: {SURVEYNAME}.
A következő karakterláncokat a LimeSurvey lecseréli a sablonfájl elemzésekor és a felmérés felhasználóinak való bemutatásakor. Ezek a mezőkarakterláncok szinte minden sablonon működni fognak, kivéve a „Befejezett oldalt”. (A legtöbb ilyen karakterlánc megtalálható a common.php fájlban. Ha nincs ott, nézze meg az index.php fájlt.)
Kulcsszó
Sablonfájlok
Leírás
{SURVEYNAME}
Mind Fájlok
A felmérés címe
{SURVEYDESCRIPTION}
Minden fájl
A felmérés leírása
{WELCOME}
Minden fájl (főleg a welcome.pstpl számára)
A felmérés üdvözlő szövege
{PERCENTCOMPLETE}
survey.pstpl
Egy kis grafikon, amely a felmérés kitöltésének százalékos arányát mutatja
Megjeleníti a felmérésben szereplő kérdések teljes számát (csak a számot)
{THEREAREXQUESTIONS}
üdvözöljük. pstpl
Megjeleníti a „X kérdés van ebben a felmérésben” mondatot – a megfelelő nyelvi fájlból. Az X helyébe a kérdések száma kerül. Vegye figyelembe, hogy ez egyes vagy többes szám esetén is megfelelően működik. Ha csak 1 kérdés van, akkor a következőt írja ki: "Ebben a felmérésben 1 kérdés van".
{CHECKJAVASCRIPT}
Minden fájl (főleg welcome.pstpl esetén)
Figyelmeztető üzenet a felhasználó böngészőjében le van tiltva a javascript
{QUESTION}
Question.pstpl
-
{ANSWER}
question.pstpl, print_question.pstpl
bemutatja az aktuális kérdés válaszűrlapját
{SGQ}
question.pstpl, kérdés szövege
Magában a kérdésszövegben használható, hogy dinamikusan hivatkozzon a kérdés beviteli mezőjére az aktuális kérdés felmérési csoportjának kérdésazonosítójának megjelenítésével. (a svn build 9755-től)
{QUESTIONHELP}
question.pstpl, print_question.pstpl
Súgószöveg megjelenítése (előre meghatározott tipp a kérdéstípushoz) az aktuális kérdéshez
{QUESTION_CODE}
question.pstpl, print_question.pstpl
Az aktuális kérdéskódot jeleníti meg
{QUESTION_ESSENTIALS }
question.pstpl
a kérdésazonosító és (ha a kérdés feltételes), a 'style="display:none;"'. (A kérdés burkoló címkéjébe kell foglalni.)
{QUESTION_HELP}
question.pstp, question_start.pstpl
Megjeleníti a felhasználó által definiált súgószöveget az aktuális kérdéshez
{QUESTION_INPUT_ERROR_CLASS}
question.pstp, question_start.pstpl
Osztályt biztosít, ha felhasználói beviteli hiba történt
{QUESTION_ID}
print_question.pstp
Egyedi azonosítót biztosít minden egyes kérdéshez, hogy lehetővé tegye a stílusosítást az egyes kérdésekhez
Megjeleníti az aktuális kérdés lefordított érvényes súgószövegét
{QUESTION_SCENARIO}
print_question.pstp
Kinyomtatja a "forgatókönyv" szövegét a feltételes kérdésekhez.
{CLEARALL}
Minden fájl (de a navigator.pstpl számára készült)
Megjeleníti a "Kilépés és az eredmények törlése" link
{BEFEJEZETT}
completed.pstpl
-
{URL}
completed.pstpl
Megjeleníti a felmérés "url"-jét és "url szövegét"
{PRIVACYMESSAGE}
privacy.pstpl
Az adatvédelmi üzenet akkor jelenik meg, ha anonimra állítja a felmérést. A szöveg szerkeszthető/lefordítható a nyelvi fájlokban. Ez manuálisan is módosítható a használni kívánt privacy.pstpl sablon szerkesztésével.
{TEMPLATEURL}
Összes fájl
Az aktuális sablon helyére mutató URL (hasznos a képfájlok hivatkozásához az Ön sablonja)
{SURVEYRESOURCESURL}
Összes fájl
-
{SUBMITCOMPLETE}
endpage.pstpl
A nyilatkozat (a nyelvi fájlokból), amely közli a felhasználóval, hogy kitöltötte a kérdőívet, és nyomja meg a "Küldés" gombot
{SAVEDID}
Minden fájl
Megjeleníti a felhasználó 'válaszazonosítóját'
{QUEXMLPDF}
Minden fájl
Megjeleníti a kérdőív queXML PDF-fájljának exportálására szolgáló gombot, beleértve a kérdőív kitöltésének pontjáig beírt válaszok.
{TOKEN:FIRSTNAME}
Összes fájl
***Ha a felmérés válaszai NEM ANONIMUSOK – a rendszer először a felhasználókra cseréli név a tokentáblázatból
{TOKEN:LASTNAME}
Minden fájl
-
{TOKEN:EMAIL}
Minden fájl
***Ha a felmérés válaszai NEM ANONÍMOK – a rendszer a felhasználói e-mailekkel helyettesíti a tokentáblázatban***
Összes fájl
***Ha a felmérésre adott válaszok NEM ANONÍMOK – a rendszer a felhasználói attribútum_2-re cserélődik a tokentáblázatból***
{ANSWERSCLEARED}
Lehetőleg a navigator.pstpl-ben.
A "A válaszok törölve" utasítás a nyelvi fájlokból
{RESTART}
clearall.pstpl
URL a felmérés újraindításához
{REGISTERERROR}
register.pstpl
Megjeleníti az esetleges hibaüzeneteket a regisztrációs oldalon (pl.: "E-mail címet kell megadnod")
{REGISTERMESSAGE1}
register.pstpl
Az "A befejezéshez regisztrálnia kell" ezt a felmérést" a nyelvi fájlokból
{REGISTERMESSAGE2}
register.pstpl
Részletek a regisztrációval kapcsolatban a nyelvi fájlokból
{REGISTERFORM}
register.pstpl
A regisztráció tényleges formája attól függően változik, hogy az attribútum_1 és attribútum_2 mező be van-e állítva.
{MENTÉS}
Megfelelően működik a navigator.pstpl
Megjeleníti a 'Válaszok mentése, így far” gombot, hogy felajánlja a felhasználónak, hogy mentse, és jöjjön vissza később a felmérés folytatásához. Ha a Mentés opció ki van kapcsolva a felmérés tulajdonságaiban, a címke nem jelenik meg és figyelmen kívül hagyja.
{LANGUAGECHANGER}
survey.pstpl
}
Bemenet/gombok
A felmérésben szereplő minden „bemeneti” típus saját osztálynevet kapott, így CSS-t adhat hozzá a „startpage.pstpl” fájlhoz, és némileg szabályozhatja az űrlapgombok és bemenetek megjelenését. Ezek az osztálynevek a következők:
submit (Submit Buttons)
text (Szövegbevitel - rövid szabad szöveghez, dátumhoz és számtípushoz)!N !*answertext (Válaszok szövege)
rádió (Radio Buttons)
checkbox (Check Boxes)
'select (Select / List Boxes)
textarea (Nagy szövegbevitel – hosszú szabad szöveghez)
clearall (A felmérésből kilépés és törlés " link)
rank (A rangstílus kérdés. Nem állítja be a kijelölődoboz vagy a szövegdobozok színét, de lehetővé teszi a háttér színének, szövegszínének, méretének stb. ., a rangsor kérdés további részére)
graph (A "teljesített százalékos" grafikon táblázat)
innergraph (A táblázat a grafikontáblázaton belül - ez 0% és 100% szöveget tartalmaz. Használja ezt a szöveg méretének módosításához
question (Általános beállítások minden olyan kérdéshez, amely egy táblázatban jelenik meg. Általában ezt kell használni győződjön meg róla, hogy a betűméretük és -színük megegyezik a máshol alapértelmezettként használtakkal
kötelező (Kötelező kérdések)
beviteli hiba (Felhasználó beviteli hiba - arra az esetre, ha a felhasználó hibázott egy kötelező kérdéssel vagy kérdéssel az érvényesítéssel)
tömb1 és tömb2 (Ez a két stílus ciklusra kerül a tartomány bemutatásakor válaszok egy tömb típusú kérdésre. Ezzel váltakozó háttérszínt állíthat be ezekhez a kérdéstípusokhoz. A Tömb1 az oszlopfejlécekhez is használatos ezekben a kérdéstípusokban)
'hiba (Beállítja a "Ez a kérdés kötelező" hibaüzenet színét és stílusát)
*warningjs (Beállítja a megjelenő figyelmeztető üzenet színét és stílusát, ha a résztvevő böngészőjében le van tiltva a JavaScript)
Vannak olyan elemek is, amelyek az elem azonosítójával (CSS-ben #ID) érhetők el:
surveycontact (A kezdőoldalon látható kapcsolatfelvételi üzenet)
tokenmessage (a felmérésen belüli üzeneteknél használatos, pl. a munkamenet lejárt hibaüzenet)
Mivel az összes HTML-aspektust szerkesztheti, nincs ok arra, hogy sablonjait
<divclass='new_name'></div>
, majd definiáljon egy css-t az új_név osztályhoz.
A folyamatjelző sáv stílusa
A folyamatjelző sáv megjelenése CSS-sel módosítható.
A sáv háttérszínének megváltoztatásához adja hozzá a következőhöz hasonlót a custom.css fájl végéhez (példa a gyümölcsös témára):
.gyümölcsös.progress-bar{háttérszín:#3300FF;}
A sáv szegélyszínének megváltoztatásához adja hozzá a következőhöz hasonlót a custom.css fájl végéhez (példa a gyümölcsös témára):
A fejlesztők számára elérhető speciális szolgáltatások
A LimeSurvey beépített néhány felhasználó által készített javítást, amelyek lehetővé teszik néhány speciális változtatást. Ezek a nagyon fejlett funkciók (általában) megkövetelik a LimeSurvey mögöttes kódbázis módosítását, és ezeket óvatosan kell elvégezni, nehogy biztonsági réseket okozzanak.
Saját JavaScript-funkciók támogatása
Előfordulhat, hogy egyes felhasználóknak Javascriptet kell futtatniuk a felmérési oldalakon, de a checkconditions() meghívása a BODY elemben lehetetlenné tette ezt. Ezt a hívást egy kis JavaScript-függvénnyel helyettesítették a HEAD-ben, amely a checkconditions() és a template_onload() meglétét szimatolja, mielőtt meghívná őket. Ily módon a sablon szerzője létrehozhatja saját template_onload() függvényét a HEAD-ben, amely helyettesíti az alapértelmezettet.
Az XSS-szűrő letiltása - a Globális beállítások -> Biztonság menüpontban állítsa a "HTML szűrése XSS-hez" beállítást No-ra
Írja be a szkriptet a kérdés vagy csoportleírás forrásába.
Ha azt szeretné, hogy egy nyelvspecifikus mondat szerepeljen egy felmérésben, például súgó minden oldal végén, akkor hozzáadhat egy mondatot .pstl fájlba, és elrejtheti a másik nyelv számára. Ha elrejtjük a template.css-ben, akkor használhatjuk a pszeudo szelektort :lang, de a jobb kompatibilitás érdekében használunk valamilyen osztályt.
Az alábbiakban két súgómondat található, franciául és angolul. Tedd ezt az endpage.pstpl oldalra:
A sablon szerkesztése és mentése után csak akkor vonatkozik egy felmérés listaoldalára, ha a felmérés beállításai közül ki van választva. Ahhoz, hogy ez legyen az alapértelmezett sablon, lépjen a LimeSurvey telepítése Globális beállítások részében található 'Általános fülre, és válassza ki a kívánt sablont. Ettől kezdve minden sablon, amely az "alapértelmezett" opciót használja sablonként, valamint az újonnan létrehozandó sablon, az újonnan kiválasztott alapértelmezett sablont fogja használni.
To use your current template for this page, you must change the appropriate setting from Global settings. In older versions, this change can be done by editing the $defaulttemplate setting from the config file: copy this setting from config-defaults.php to config.php which overrides config-defaults.php and edit this setting to $defaulttemplate = 'yourtemplatename';.
Import/Export of templates: Mac users
Mac users, please note that the Mac OSX default archive utility may have problems with zip folders "generated on the fly".
A workaround is to unix'es unzip from the command line:
$ unzip template.zip -d template
Archive: template.zip
inflating: template/startpage
inflating: ...
Another workaround is to use scripts in their mac-compiled counterparts.
Use the same template with different logos
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:
<imgsrc="{TEMPLATEURL}files/logoImage-{SID}.png">
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:
Create a favicon - You can use Google to find lots of free favicon generators.
Name your new favicon "favicon.ico" and place it in your template /files directory.
Add the following code to your startpage.pstpl before the </head> tag.
If you want LimeSurvey to change the appearance of every second page (i.e., even and odd survey pages), you can use .page-odd class in your CSS file to change the appearance of odd pages.
An example from default template of LimeSurvey 1.91+:
header_separator is used to adress the separator for the header "td". The "dual_scale_separator" is used to address the separator column in the dual scale array.
Adding your own logo to the survey list
First please open the theme editor for the theme you like to use.
We recommend to use fruity, it is our best theme currently.
Then extend the theme and give it a name you will recognize.
In the following view you may upload the logo you want to use.
Select the editor screen `Survey List´ in the Screen dropdown in the top right corner.
Then select `layout_survey_list.twig´ in the left side menu.
In the editor scroll to line 126 and change the marked part to the filename of the image you uploaded to the theme before.
Save your file.
Change default theme to your extended theme.
Align logo to the centre of the survey page
This example is for the "extends_fruity" template. For other templates the required CSS may be different.
Login to the LimeSurvey admin area
Browse to the theme editor: Configuration > Themes
Find "LimeSurvey Fruity Theme" in the list and click the "Theme Editor" button
Click "custom.css" in the files list on the left at near the bottom of the page
Copy the following CSS into that file and press "Save Changes"
Note: This is a temporary feature to be replaced in the future by question object (it will be very easy to move custom views to question object). It is disabled by default.
As of version 2.5, you can create template-specific custom views for questions and some of their incorporated elements. This is useful if you want to modify the HTML layout of a particular question type for one or more surveys.
In application/config/config.php, find 'config'=>array and add this line to the array : 'allow_templates_to_overwrite_views'=>1
In /{your_template}/config.xml, set "overwrite_question_views" to true
Copy application/views/survey/* to template/{your_view_directory}/survey/
Note that you only need to copy the files that you intend to modify but the file structure must remain the same as in application/views/survey/
Insert custom CSS or JavaScript files for template
As of version 2.50, you can use the config.xml File to Automatically Load Plugin Files.
Upload your files to the template /css or /scripts folder
In /{your_template}/config.xml, add the file paths to the <css> or <js> blocks, something like this:
Figyelem : A nem megfelelően felépített téma működésképtelenné tehet egy felmérést (amely a megfelelő sablont használja).
