LimeSurvey има усъвършенствана система за тема и стил, предоставяща на разработчиците ефективен начин за персонализиране на външния вид на проучването. От LS3 терминът "шаблони" е заменен с термина "теми". Темите позволяват контрол върху стила на страниците на анкетата. Администраторът на проучването може да избере тема по подразбиране, която ще се използва за всяко проучване, за да го персонализира допълнително. Темите идват с опции, които предоставят на администратор без умения за кодиране лесен начин за добавяне на лого към началната страница, промяна на цветовете на фона, избор на шрифт и т.н.
LimeSurvey идва с 3 теми. Тези първоначални теми се дефинират от директории, намиращи се в директорията "themes/survey/" на инсталацията на LimeSurvey. Всяка тема има своя собствена директория. В основната директория на дадена тема ще намерите конфигурационен файл в XML и множество директории, съдържащи изгледите теми (.twig), каскадни стилови таблици (.css), 'скриптове, изображения ('.jpg или .png) и може би други.
От LimeSurvey 2.50 двигателят на темата използва Bootstrap 3 като CSS рамка. Тъй като Bootstrap 3 е стандартна рамка, разработчиците ще намерят много документация, уроци и форумни теми за него в интернет.
От LimeSurvey 3 насам, механизмът за теми използва Twig, така че разработчиците на теми могат да променят логиката на изобразяването на проучването по безопасен и лесен начин. Twig замени старата система от заместващи ключови думи, която беше използвана в предишните версии. Логиката, използвана за генериране на HTML на ключовите думи, вече е достъпна в изгледите на темата.
Фрагмент от Vanilla Theme:
!Н! <div class="{{aSurveyInfo.class.answercontainer}} col-xs-12" {{aSurveyInfo.attr.answercontainer}}> !Н! {# ЗАБЕЛЕЖКА: Ако искате да персонализирате изобразяването на въпроса, използвайте тема за въпрос #}{{aQuestion.answer|суров}}</div> !Н!
Темите, бидейки HTML и Twig код, са склонни да определят позиционирането и вида на текста, който да се показва, и подобни структурни характеристики на страницата. Те често препращат или включват други файлове. Повечето от тях препращат към общ файл с каскадни стилови таблици (CSS), който определя стила на шрифта, цвета, размера, фона и подобни параметри, общи за всички страници в проучването. Стиловите таблици препращат към HTML class параметри, които са свързани с различните типове обекти в HTML кода. Това позволява на листа със стилове да дефинира как да показва всеки от многото типове текст или други обекти, които могат да се появят на множество места. Има уникални класове за всеки тип въпрос в LimeSurvey и по този начин предоставя подробен контрол върху външния вид на всеки. Файлове с изображения, като лога или специални конструктори на ленти за напредък, също могат да бъдат посочени във файла на темата. И накрая, специални ключови думи във фигурни скоби се заменят с текст, дефиниран в анкетата за всеки кореспондент за превод на език (например „Заглавие на анкетата“ или „Текст на въпроса“ за всеки дефиниран език).
Ако създадете нова персонализирана тема, моля, помислете дали да я допринесете обратно към общността на LimeSurvey и да я направите достъпна за други. С ваша помощ можем да разширим нашето хранилище от теми, анкети и други добавки, за да направим LimeSurvey още по-добър!
Вижте нашето хранилище за шаблони на LimeSurvey, където можете да споделите вашите шаблони.
Създаване на нова тема
За да можете да създадете нова тема (или да редактирате съществуваща тема), имате нужда от Template Editing user permission в LimeSurvey, както и разрешение за манипулиране на файловете в основната операционна система, хостваща вашата инсталация на LimeSurvey.
Предупреждение: Ако промените теми, можете също така да засегнете всички съществуващи анкети от вашата инсталация на LimeSurvey. Темите са разширена функция, която изисква опит и HTML познания.
Предпочитаният начин за създаване на нова тема е чрез Редактора на теми (вижте по-долу), който се намира под Конфигурация в горната лента с инструменти. Някои потребители предпочитат да работят директно с файлове с теми, така че да могат да използват любимия си текстов редактор вместо уеб интерфейса. В този случай все още използвайте редактора на теми, за да създадете първо новата си тема. Това ще създаде нова основна тема с всички необходими файлове в директорията LimeSurvey_web_root/upload/themes/survey/your_new_template. Оттам можете да използвате вашия текстов редактор, за да коригирате ръчно файловете на шаблона.
Забележка за разрешенията: на unix/linux системи, тези файлове с теми ще бъдат собственост на групата и потребителя, където работи уеб сървърът (може да е "www" за някои системи). Така че, уверете се, че имате подходящите разрешения за редактиране на тези файлове. Когато ги запазите, уверете се, че няма да променят собствеността си! По този начин все още можете да използвате интерфейса за редактиране на уеб теми, ако е необходимо.
Редица „обществени“ елементи на LimeSurvey могат да бъдат коригирани чрез поредица от теми. Следващият раздел предоставя много кратко обяснение на тези шаблони.
Редактор на теми: Конфигурация > Теми> Редактор на теми
Редакторът на теми е достъпен само за потребители с разрешение за шаблони и за суперадминистратори.
Внимание : Тема, която не е конструирана правилно, може да доведе до неработоспособност на анкета (която използва съответния шаблон).
Редакторът на теми LimeSurvey ви позволява да редактирате съдържанието на вашите теми онлайн. За да стартирате редактора на теми: щракнете върху Теми в менюто Конфигурация и след това щракнете върху бутона Редактор на теми' до темата, която искате да редактирате или разширите.
Страницата за редактор на шаблони ви позволява да изберете шаблона, който искате да редактирате/прегледате.
Налични са следните опции:
'Създаване': Позволява ви да създадете нов шаблон. За да не започвате от нулата, шаблонът 'по подразбиране' се копира.
Import: Позволява ви да импортирате шаблон от ZIP файл.
Export : Позволява ви да експортирате текущия шаблон в ZIP файл.
Копиране: Позволява ви да направите нов шаблон чрез копиране на текущия.
Преименуване: Позволява ви да промените името на шаблона. Обикновено се използва след копиране или импортиране на шаблон.
Шаблон: падащ списък, който показва всички налични шаблони, които се намират във вашата инсталация на LimeSurvey.
'Екран': падащ списък, който ви позволява да изберете коя конкретна страница с анкета от този шаблон искате да видите.
Връщане към административния панел'.
Импортиране/Експортиране/Копиране на шаблон
Когато експортирате шаблон, ще бъде създаден ZIP-файлов архив с всички ваши шаблонни файлове (.pstpl файлове, изображения, css файлове, ...). Можете да импортирате експортирания zip файл в друга инсталация на LimeSurvey, като използвате функцията за импортиране, или можете ръчно да копирате архива в друга инсталация на LimeSurvey и да го извлечете в съответния template директория там.
Най-добре е обаче да използвате функциите за импортиране/експортиране/копиране на шаблони на LimeSurvey в редактора на шаблони.
Структура на страницата / Използване на шаблона
Страницата за добре дошли: startpage.pstpl, welcome.pstpl, privacy.pstpl, navigator.pstpl, endpage.pstpl
„Страниците с въпроси:'' startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, endpage.pstpl
'Последната страница:' начална страница .pstpl, оценка.pstpl, завършен.pstpl, крайна страница.pstpl
Файлове с шаблони
Следните шаблонни файлове се използват за създаване на вашата обществена анкета и трябва да съществуват във всяка нова шаблонна папка, която създавате:
startpage.pstpl: Създава началото на всяка html страница. Започва от "<head> " и не трябва да съдържа "<html> ". Това „самото начало" на стандартна html страница е написано от скриптовете. Моля, уверете се, че вашите файлове startpage.pstpl съдържат<body> етикет. Въпреки че много браузъри не изискват стриктно спазване на W3 HTML стандартите, скриптът LimeSurvey трябва да намери таг, за да изпълни определени елементи на javascript. Не е обичайно да видите много „ключови думи“, използвани във файла startpage.pstpl. Все пак може да пожелаете да поставите {SURVEYNAME} в заглавието. Файлът startpage.pstpl може да съдържа код, който завършва в съответния файл endpage.pstpl. Например, можете да започнете таблица в този файл и да затворите таблицата във файла endpage.pstpl. Файловете startpage.pstpl и endpage.pstpl обхващат всяка възможна страница, използвана от LimeSurvey.
survey.pstpl:'' Този шаблон е вторият използван на повечето страници и предоставя място за поставяне на името на проучването и описание. Този шаблон няма съответен шаблон за „затваряне“ и впоследствие трябва да затворите всички тагове, отворени в този файл с шаблон (т.е.: не оставяйте таблица отворена тук, защото няма къде другаде да я затворите).
' welcome.pstpl: Този шаблон се използва само в началния екран (който също е на главната страница за анкети „всичко в едно“). Можете да използвате това, за да отпечатате приветствения текст и друга информация, която трябва да бъде предоставена във въведението. Подобно на файла 'survey.pstpl', няма съответен шаблон за 'затваряне', така че всички тагове, отворени в този файл с шаблон, също трябва да бъдат затворени.
startgroup.pstpl: Този шаблон може да предостави „обобщение“ за въпроси в група. Той има съответстващ шаблон „endgroup.pstpl“, който може да се използва за затваряне на всички отворени тагове в този файл, така че можете да отворите таблица в него.
'groupdescription.pstpl:' Този шаблонен файл е използвани за показване на описание на група. Моля, обърнете внимание, че в настройките на проучването (достъп до „Настройки за презентация и навигация“, като щракнете върху раздела „Представяне“) можете да зададете дали описанието на групата да се показва или не. Ако не, тогава този файл изобщо не е включен.
question.pstpl: Този файл съдържа секциите с въпроси, отговори и помощен текст на вашата анкета. В анкетите „група по група“ и „всичко в едно“ този шаблон се повтаря многократно с всеки въпрос. Няма съответстващ затварящ файл за това и всички тагове трябва да бъдат затворени.
question_start.pstpl:' Този файл съдържа отделните елементи, открити в началото на въпрос. Той е включен в 'question.pstpl' чрез ключовата дума {QUESTION}. Целта му е да позволи на дизайнерите на шаблони повече контрол върху оформлението на въпроса. Този шаблон е извън нормалната система за шаблони и е заменен (от LimeSurvey 1.87). Всички ключови думи от този шаблон вече са достъпни директно в question.pstpl.
completed.pstpl: Тази страница се показва като последна страница, когато отговорите на анкетата са запазени и анкетата приключи. Може да се използва за показване на „препращаща връзка“, както е зададено в настройката на анкетата.
endgroup.pstpl:' Този файл затваря групата и може да се използва за затваряне на всички тагове, отворени в файл startgroup.pstpl
navigator.pstpl: Този файл съдържа бутоните, които навигират в анкетата, "следваща", "предишна", "последна", "изпращане", "запазване досега" и връзката „изчистване на всички“. Използва се във всички страници с изключение на завършената страница.
printanswers.pstpl: Този файл има HTML обвивката, необходима за печатната версия на анкетата.
print_group.pstpl : Този файл е същият като startgroup.pstpl и endgroup.pstpl, но за печатната версия на анкетата.
print_question.pstpl: Този файл е същият като question.pstpl , но за печатната версия на анкетата.
print_survey.pstpl: Този файл е същият като survey.pstpl, но за печатната версия на анкетата.
CSS и Javascript
Два файла, които винаги се използват в шаблон, са template.css (за CSS) и template.js (за Javascript).
{TEMPLATECSS}:'' Добавете редове за css по подразбиране, template.css, и template-rtl.css за rtl език.
{TEMPLATEJS}: Добавете редове за javascript файлове по подразбиране, template.js и всички js файлове, необходими за LimeSurvey.
Използване на Bootstrap
LimeSurvey има вграден Bootstrap 3, така че можете да стилизирате всичките си шаблони с добре документираните класове на Bootstrap.
За повече информация, моля, вижте Bootstrap документация.
Плъгинът Awesome-Bootstrap-Checkbox също е включен. С него можете да използвате типичните цветови класове на Bootstrap (информация, предупреждение, опасност и т.н.) също с наставката "-checkbox" или "-radio", въпреки че стилизирате квадратчета за отметка и радиостанции, както предпочитате.
Замяна на CSS или Javascript по подразбиране
Някои въпроси използват конкретни файлове за Javascript или CSS. Ако трябва да замените функция, използвайте каскадна система. За функцията на javascript последната прочетена функция е използваната функция.
Други шаблонни файлове
privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl и confirmationemail.pstpl вече не се използват от LimeSurvey и настройките по подразбиране са вместо това задайте в приложимите езикови файлове. Имейл съобщенията вече могат да се редактират на база анкета по анкета.
Стандартни страници
Има десет стандартни страници, които участникът в проучването може да види в хода на вземане или достъп до приложението LimeSurvey. Всеки е изграден от редица общи Template файлове от Template, посочени в настройките на анкетата. Таблицата по-долу показва кои шаблонни файлове се използват при конструирането на всяка от тези страници.
* ЗАБЕЛЕЖКА: Във версия 1.90+ това замества question.pstpl И question_start.pstpl. Ако използвате стар персонализиран шаблон, трябва да добавите следния ред в началото на question.pstpl:
След това добавете съответния затварящ таг в края на question.pstpl:
</div>
* ЗАБЕЛЕЖКА: Във версия 1.91 и по-стари js файловете на LimeSurvey не са включени в шаблона. Във версия 2 трябва да използвате {TEMPLATEJS} в един от вашите шаблонни файлове, за да добавите връзката към js файла. Можете да го добавите в startpage.pstpl или в endpage.pstpl. Можете да премахнете реда {TEMPLATEURL}/template.js и трябва да замените с {TEMPLATEJS}, за да актуализирате личен шаблон.
Секцията за управление на файловете
В прозореца „контрол на файлове“ отляво можете да щракнете върху един от файловете на шаблона, който се използва за компилиране на страницата. Можете да видите „Екранната част“, JavaScript и CSS файловете. След това HTML кодът за този файл ще се появи в прозореца „Редактиране сега“ в центъра. Ако шаблонът може да се редактира (определен от разрешенията за директория), можете да направите промени и да ги запазите.
Прозорецът "Други файлове" показва списък с всички други файлове от директорията на шаблона. Можете да използвате дясната страна, за да качите и изберете файлове с изображения (ваши снимки, лога,...) или други файлове, необходими за създаване на вашия шаблон'.
Вместо да използвате връзка за всяка картина, използвайте низа на полето {TEMPLATEURL}. И така, вместо:
„Извадка“ от шаблонната страница, която редактирате, ще бъде видима в долната част на екрана. Няма начин да изтриете шаблон от редактора на шаблони. Това трябва да стане чрез достъп до основната директория и ръчно изтриване на файловете от там. Също така имате възможност да изберете различни резолюции на екрана, за да оцените по-добре усещането и външния вид на шаблона.
Забележка: Изпратените шаблони не могат да се редактират с помощта на редактора на шаблони. Ако искате да ги промените, първо създайте копие и го редактирайте.
Местоположение на файловете на шаблона
LimeSurvey съхранява всеки от „стандартните“ шаблони в собствена отделна поддиректория в директорията „/templates“, която се съхранява в публичната директория с другите публични файлове на LimeSurvey. Персонализираните потребителски шаблони се съхраняват в директорията /upload/templates.
Трябва да има ВИНАГИ директория "по подразбиране" в директорията с шаблони. Този шаблон се използва по подразбиране и като резервен вариант, ако папка с шаблони не съществува или не може да бъде намерена. Той идва инсталиран по подразбиране.
Можете да използвате всякакви файлове с изображения, които качите в областта за управление на шаблона с помощта на този синтаксис:
{TEMPLATEURL}именафайл.xyz
Въпроси за стилизиране с CSS
Оформянето на въпроси в CSS стана много по-лесно. Всеки тип въпрос вече има уникален клас. Задължителните въпроси имат допълнителен задължителен клас. Например за незадължителен въпрос:
Забележка: Преди 1.92 бяха налични само класове .mandatory и .input-error.
Те се отнасят за съобщенията за помощ и/или съвети за проверка, така че всеки тип да може да бъде индивидуално стилизиран.
Опциите .hide-tip и .input-error си взаимодействат по подразбиране, така че можете да имате скрити съвети за проверка. Те обаче се появяват, когато има грешки при валидирането, и изчезват отново, когато тези грешки бъдат коригирани.
Всички те са предназначени да премахнат необходимостта от изскачащи предупредителни съобщения. Вместо това съветите могат да се появяват/изчезват според нуждите и са цветно кодирани, за да покажат дали отговорите преминават критериите за валидиране.
Освен това, когато за първи път посетите страница, която има неизпълнени критерии за валидиране, можете да оцветите съветите в приятен цвят, за да покажете кои критерии за валидиране все още не са изпълнени; след това покажете страницата отново, като използвате по-ярък цвят, ако лицето изпрати страницата с продължаващи грешки при валидиране.
Цел
CSS клас
Описание
Задължително
.задължително
въпросът е задължително
Грешка при въвеждане от потребителя
.input-error
въпросът имаше поне една грешка при валидиране
Скрий съвет
.hide-tip
добавен ако използвате опцията hide_tip
тип по подразбиране
.em_default
за набор от съвети по подразбиране (числова стойност и т.н.)
Брой отговори
.em_num_answers
за за min_answers и max_answers
Обхват на стойността
.em_value_range
за min/max_num_value_n и multiflexible_min/max
Обхват на сумата
.em_sum_range
за min/ max/equals_num_value
Валидиране на Regex
.em_regex_validation
за валидиране на регулярен израз на въпроса
Функция за валидиране на ниво въпрос
.em_q_fn_validation
за em_validation_q опция
Функция за проверка на ниво подвъпрос
.em_sq_fn_validation
за опцията em_validation_sq
Друг коментар задължителен
.em_other_comment_mandatory
за other_comment_mandatory опция - показва кога „друго“ е избрано, но свързаният коментар липсва.
Импортиране на стилове във вашия персонализиран шаблон
Персонализираните стилове на въпроси са в долната част на CSS файла на всеки шаблон и започват с:
/* --------------------------- НАЧАЛО: Стилове на въпроси ----------------- ------------- */
Ако оформяте свой собствен персонализиран шаблон, трябва да можете да копирате всичко след горния от templates/default/template.css (за базирани на таблици оформления) или /templates/limespired/template. css (за оформления, базирани на CSS) във вашия собствен стилов лист без никакво въздействие върху другите ви стилове.
Условни стилови таблици на Internet Explorer
Поради забележимите несъответствия в изобразяването между IE6 и IE7 и другите браузъри, за всеки шаблон има включени специални таблици с условни стилове на IE.
Трябва да включите горния код във вашия startpage.pstpl и копия на двата IE стилови листа от /templates/default/ или /templates/limespired за базово оформление на таблици и Съответно CSS базирано оформление.
Забележка: Ако копирате стиловете във вашия собствен лист със стилове, почти сигурно ще трябва да ги промените.
Алтернативно решение за Internet Explorer
Можете да поставите условен клас за body в startpage.pstpl и да използвате този клас във вашия template.css. Този метод се използва в шаблона за цитронада (Obsolete since 2.06). Добавяне на js / no-js клас, за да има javascript / без javascript система.
.ie6{/*специфично за Internet Explorer 6*/}.ielt8{/*специфично за Internet Explorer 6 и 7*/}.ie{/*специфично за всички Internet Explorer */}
Езици отдясно наляво (RTL) и оправдаване
Текстовият редактор в LimeSurvey може да форматира RTL текст. Самият редактор обаче показва RTL езика във формат отляво надясно, когато е оправдан. Това е просто проблем с дисплея на редактора. RTL и оправданият въпрос или текст ще се показват правилно отдясно наляво, дори когато са оправдани, във вашата анкета или при визуализация.
Ключовите думи във файл с шаблон се заменят с текущата информация от проучването. Те са оградени с фигурни скоби, например: {SURVEYNAME}.
Следните низове ще бъдат заменени от LimeSurvey при анализиране на шаблонния файл и представянето му на потребителите на анкетата. Тези полеви низове ще работят на почти всеки шаблон, с изключение на „Завършена страница“. (Повечето от тези низове могат да бъдат намерени във файла common.php. Ако не е там, погледнете във файла index.php.)
'Ключова дума
'Файлове с шаблони
Описание
{SURVEYNAME}
Всички Файлове
Заглавието на анкетата
{SURVEYDESCRIPTION}
Всички файлове
Описанието на анкетата
{ДОБРЕ ДОШЛИ}
Всички файлове (основно за welcome.pstpl)
Поздравителният текст на анкетата
{PERCENTCOMPLETE}
survey.pstpl
Малка графика, показваща процента на попълнената анкета
Показва изречението "В тази анкета има X въпроса" - от съответния езиков файл. X се заменя с броя на въпросите. Имайте предвид, че това също ще работи подходящо за единствено или множествено число. Ако има само 1 въпрос, ще се отпечата „Има 1 въпрос в тази анкета“.
{CHECKJAVASCRIPT}
Всички файлове (основно за welcome.pstpl)
Предупредително съобщение при край- потребителският браузър има деактивиран javascript
{QUESTION}
Question.pstpl
-
{ANSWER}
question.pstpl, print_question.pstpl
представя формата за отговор на текущия въпрос
{SGQ}
question.pstpl, текст на въпроса
Може да се използва в самия текст на въпроса за динамично препращане към полето за въвеждане на въпроса чрез показване на ID на въпроса за група от анкети за текущия въпрос. (от svn build 9755)
{QUESTIONHELP}
question.pstpl, print_question.pstpl
Показва помощен текст (предварително зададен съвет за тип въпрос) за текущия въпрос
{QUESTION_CODE}
question.pstpl, print_question.pstpl
Показва кода на текущия въпрос
{QUESTION_ESSENTIALS }
question.pstpl
ID на въпроса и (ако въпросът е условен), 'style="display:none;"'. (Да се включи в етикета за обвиване на въпроса.)
{QUESTION_HELP}
question.pstp, question_start.pstpl
Показва дефинирания от потребителя помощен текст за текущия въпрос
{QUESTION_INPUT_ERROR_CLASS}
question.pstp, question_start.pstpl
Предоставя клас, ако имаше грешка при въвеждане от потребителя
{QUESTION_ID}
print_question.pstp
Предоставя уникален идентификатор за всеки въпрос, за да позволи стилизиране на конкретни въпроси
Показва преведения валиден текст на помощно съобщение за текущия въпрос
{QUESTION_SCENARIO}
print_question.pstp
Отпечатва текста на „сценария“ за условни въпроси.
{NAVIGATOR}
navigator.pstpl
Показва бутони за навигация (следващ, предишен, последен)
{CLEARALL}
Всички файлове (но предназначени за navigator.pstpl)
Показва Връзка „Изход и изчистване на резултатите“
{COMPLETED}
completed.pstpl
Показва съобщението „completed“ за регистрация, ще се промени в зависимост от това дали полетата attribute_1 и attribute_2 са зададени.
{URL}
completed.pstpl
Показва 'url' и 'url текст' на анкетата
{PRIVACYMESSAGE}
privacy.pstpl
Съобщението за поверителност се показва, ако зададете анкетата си да бъде анонимна. Текстът може да бъде редактиран/преведен в езиковите файлове. Това може да се промени и ръчно чрез редактиране на шаблона privacy.pstpl, който искате да използвате.
{TEMPLATEURL}
Всички файлове
URL адресът към текущото местоположение на шаблона (полезно за препратка към файлове с изображения в вашият шаблон)
{SURVEYRESOURCESURL}
Всички файлове
-
{SUBMITCOMPLETE}
endpage.pstpl
Изявлението (от езиковите файлове), което казва на потребителя, че е попълнил анкетата, и да натисне бутона „Изпращане“
{SAVEDID}
Всички файлове
Показва „ID на отговора“ на потребител
{QUEXMLPDF}
Всички файлове
Показва бутон за експортиране на queXML PDF на въпросника, включително въведени отговори до точката, която е била попълнена в анкетата.
{TOKEN:FIRSTNAME}
Всички файлове
***Ако отговорите на анкетата НЕ СА АНОНИМНИ - първо се заменят с потребителите име от таблицата с токени
{TOKEN:LASTNAME}
Всички файлове
-
{TOKEN:EMAIL}
Всички файлове
***Ако отговорите на анкетата НЕ СА АНОНИМНИ - се заменят с потребителския имейл от таблицата с токени***
{TOKEN:ATTRIBUTE_1}
Всички файлове
***Ако отговорите на анкетата НЕ СА АНОНИМНИ - се заменя с потребителския атрибут_1 от таблицата с токени***
|Всички файлове
***Ако отговорите на анкетата НЕ СА АНОНИМНИ - се заменя с потребителския атрибут_2 от таблицата с токени***
{ANSWERSCLEARED}
За предпочитане в navigator.pstpl
Изявление „Отговорите са изчистени“ от езиковите файлове
{RESTART}
clearall.pstpl
URL за рестартиране на анкетата
{REGISTERERROR}
register.pstpl
Показва всички съобщения за грешка в страницата за регистрация (т.е.: „Трябва да включите имейл адрес“)
{REGISTERMESSAGE1}
register.pstpl
Изявлението „Трябва да сте регистрирани, за да завършите тази анкета" от езиковите файлове
{REGISTERMESSAGE2}
register.pstpl
Подробности за регистрацията от езиковите файлове
{REGISTERFORM}
register.pstpl
Действителният формуляр за регистриране ще се промени в зависимост от това дали полетата attribute_1 и attribute_2 са зададени.
{SAVE}
Работи подходящо на navigator.pstpl
Показва „Запазете вашите отговори така far', за да предложи на потребителя да запази и да се върне по-късно, за да продължи проучването. Ако опцията Запазване е деактивирана в свойствата на анкетата, етикетът няма да бъде показан и игнориран.
{LANGUAGECHANGER}
survey.pstpl
}
Вход/Бутони
Всеки тип „въвеждане“ в проучване е получил собствено име на клас, така че можете да добавите CSS към вашия файл „startpage.pstpl“ и да имате известен контрол върху външния вид на бутоните на формуляра и въвеждането. Имената на тези класове са както следва:
'submit (Бутони за изпращане)
'text' (Въвеждане на текст - за кратък свободен текст, дата и числов тип)!N !*answertext (Текст на отговорите)
radio (Радио бутони)
checkboxes (Квадтата за отметка)
'select' (Полета за избор / списъци)
textarea (Въвеждания с голям текст - за дълъг свободен текст)
'clearall (Проучването „Изход и изчистване“ " връзка)
rank (Въпросът за стила на класирането. Не задава цвета на полето за избор или текстовите полета, но позволява промяна на цвета на фона, цвета на текста, размера и т.н. ., за останалата част от въпроса за класиране)
graph (Таблицата с графика "процент завършено")
'innergraph' (Таблицата вътре в таблицата с графика - това съдържа 0% и 100% текст. Използвайте това, за да промените размера на този текст)
question (Общи настройки за всеки въпрос, който се показва в рамките на таблица. По принцип трябва да използвате това, за уверете се, че размерът и цветът на шрифта им са същите, каквито сте използвали другаде по подразбиране)
задължителен (Задължителни въпроси)
input-error (Потребител грешка при въвеждане - ако потребителят е направил грешка със задължителен въпрос или въпрос с валидиране)
array1 и array2 (Тези два стила се редуват при представяне на диапазона от отговори на въпрос от тип масив. Това ви позволява да зададете променлив цвят на фона за тези типове въпроси. Array1 се използва и за заглавията на колоните в тези типове въпроси)
errormandatory (Задава цвета и стила на съобщението за грешка „Този въпрос е задължителен“)
*'warningjs (Задава цвета и стила на показваното предупредително съобщение, ако браузърът на участника е с деактивиран javascript)
Има и някои елементи, които могат да бъдат достъпни с помощта на ID на елемента (#ID в CSS):
'surveycontact' (Съобщението за контакт, показано на началната страница)
tokenmessage (използва се за съобщения в анкетата, напр. съобщение за грешка при изтекла сесия)
Тъй като можете да редактирате всички аспекти на HTML, няма причина да ограждате шаблоните си с
<divclass='new_name'></div>
и след това дефинирайте css за този клас new_name.
Стилизиране на лентата за напредъка
Външният вид на лентата за напредък може да се променя с CSS.
За да промените цвета на фона на лентата, добавете нещо като следното в края на вашия custom.css файл (пример за плодова тема):
.fruity.progress-bar{цвятнафона:#3300FF;}
За да промените цвета на рамката на лентата, добавете нещо като следното в края на вашия custom.css файл (пример за плодова тема):
.fruity.progress-bar{рамка:1pxплътен#FF0000;}
Разширени функции, достъпни за разработчиците
LimeSurvey е интегрирал някои направени от потребителя пачове, които позволяват някои специални промени. Тези много разширени функции (като цяло) изискват промени в основния код на LimeSurvey и трябва да се правят внимателно, за да не се въведат дупки в сигурността.
Поддръжка за вашите собствени Javascript функции
Някои потребители може да се наложи да стартират Javascript на страниците с анкети, но извикването на checkconditions() в елемента BODY направи невъзможно това. Това извикване е заменено с малка JavaScript функция в HEAD, която надушва за съществуването на checkconditions() и template_onload(), преди да ги извика. По този начин авторът на шаблон може да създаде своя собствена template_onload() функция в HEAD, която замества тази по подразбиране.
Деактивирайте XSS филтъра - в Глобални настройки -> Сигурност, задайте "Филтър HTML за XSS" на No.
Въведете своя скрипт в източника на въпрос или описание на група.
Ако искате да имате конкретно изречение за език в анкета, например помощ в края на всяка страница, можете да добавите .pstl файл към изречение и да го скриете за другия език. Ако го скрием в template.css, можем да използваме псевдо селектора :lang, но използваме някакъв клас за по-добра съвместимост.
По-долу има две помощни изречения на френски и английски. Поставете това на endpage.pstpl:
Промяна на оформлението на страницата с проучването
След редактиране и запазване на шаблон, той се прилага към страница със списък с анкети само ако е избран от настройките на анкетата. За да го направите шаблон по подразбиране, отидете в раздела Общи, намиращ се в Глобални настройки на вашата инсталация на LimeSurvey и изберете желания шаблон. От този момент нататък всички шаблони, които използват опцията "по подразбиране" като шаблон, плюс тези, които ще бъдат новосъздадени, ще използват новоизбрания шаблон по подразбиране.
За да използвате текущия си шаблон за тази страница, трябва да промените подходящата настройка от 'Глобални настройки. В по-стари версии тази промяна може да бъде направена чрез редактиране на настройката $defaulttemplate от конфигурационния файл: копирайте тази настройка от config-defaults.php в config.php, която замества config-defaults.php и редактирайте тази настройка на $defaulttemplate = 'yourtemplatename'; .
Импорт/Експорт на шаблони: потребители на Mac
Потребители на Mac , моля, имайте предвид, че помощната програма за архивиране по подразбиране на Mac OSX може да има проблеми с zip папки, „генерирани в движение“.
Заобиколно решение е да разархивирате unix от командния ред:
$ разархивирайте шаблон.zip -d шаблон
Архив: template.zip
надуване: шаблон/начална страница
надуване: ...
Друго заобиколно решение е да използвате скриптове в компилираните им за mac аналози.
Използвайте същия шаблон с различни лога
Ако искате да използвате един и същ шаблон за всички проучвания и просто искате да промените логото за всяко проучване, можете да използвате контейнера {SID} във файла .pstpl на шаблона и по този начин да препращате към различни изображения:
<imgsrc="{TEMPLATEURL}files/logoImage-{SID}.png">
Показване на персонализирана фавикона
Favicon е малката икона, която виждате в адресната лента на браузъра, в списъка с отметки или в раздела. Можете да покажете своя собствена икона, както следва:
Създайте favicon - Можете да използвате Google, за да намерите много безплатни генератори на favicon.
Назовете новата си favicon "favicon.ico" и я поставете във вашия шаблон /файлове директория.
Добавете следния код към вашата startpage.pstpl преди</head> етикет.
Различен външен вид за страниците с анкети/въпроси
Ако искате LimeSurvey да промени външния вид на всяка втора страница (т.е. четни и нечетни страници с проучване), можете да използвате .page-odd' клас във вашия CSS файл, за да промените външния вид на нечетните страници.
Пример от шаблон по подразбиране на LimeSurvey 1.91+:
header_separator се използва за адресиране на разделителя за заглавката "td". "dual_scale_separator" се използва за адресиране на разделителната колона в масива с двоен мащаб.
Добавяне на вашето собствено лого към списъка с анкети
Първо, моля, отворете редактора на теми за темата, която искате да използвате. Файл:OpenThemeEditor.jpg
Препоръчваме да използвате fruity, това е най-добрата ни тема в момента.
След това разширете темата и й дайте име, което ще разпознаете. Файл:ExtendTheme.jpg
В следващия изглед можете да качите логото, което искате да използвате.
Изберете `Survey List’ на екрана на редактора в падащото меню на екрана в горния десен ъгъл. Файл:OpenScreenSurveyList.jpg
След това изберете `layout_survey_list.twig´ в менюто отляво.
В редактора превъртете до ред 126 и променете маркираната част на името на файла на изображението, което сте качили в темата преди. Файл:ChangeSurveyListHeaderImageEditor.jpg
Забележка: Това е временна функция, която ще бъде заменена в бъдеще от въпрос обект (ще бъде много лесно да преместите персонализирани изгледи към въпрос обект). По подразбиране е деактивиран.
Считано от версия 2.5, можете да създавате специфични за шаблон персонализирани изгледи за въпроси и някои от техните включени елементи. Това е полезно, ако искате да промените HTML оформлението на конкретен тип въпрос за една или повече анкети.
В application/config/config.php намерете 'config'=>array и добавете този ред към масива: 'allow_templates_to_overwrite_views'=>1
В /{your_template}/config.xml задайте "overwrite_question_views" на вярно
Копирайте application/views/survey/* в template/{your_view_directory}/survey/
Имайте предвид, че трябва да копирате само файловете, които възнамерявате да промените, но файловата структура трябва да остане същата като в приложение/изгледи/анкета/
Вмъкнете персонализирани CSS или JavaScript файлове за шаблон
От версия 2.50 можете да използвате файла config.xml за автоматично зареждане на файлове с добавки.
Качете файловете си в папката шаблон /css или /scripts
В /{your_template}/config.xml добавете пътищата на файловете към<css> или<js> блокове, нещо като това:
Внимание : Тема, която не е конструирана правилно, може да доведе до неработоспособност на анкета (която използва съответния шаблон).
