Revision as of 15:59, 26 September 2023 by Maren.fritz(talk | contribs)(Created page with "===checkbox-text-item=== {|class=wikitable !'''Pytanie'''!!'''Typ pytania'''!!'''elementy''' |- |wielokrotny wybór_z_komentarzami|| P || li |- |wielokrotny wybór|| M || li...")
LimeSurvey posiada zaawansowany system motywów i stylów, zapewniający programistom skuteczny sposób dostosowywania wyglądu ankiety. Od wersji LS3 termin „szablony” został zastąpiony terminem „motywy”. Motywy pozwalają kontrolować styl stron ankiety. Administrator ankiety może wybrać domyślny motyw, który będzie używany w każdej ankiecie w celu dalszej personalizacji. Motywy zawierają opcje, dzięki którym administrator bez umiejętności kodowania może w prosty sposób dodać logo na stronie powitalnej, zmienić kolory tła, wybrać czcionkę itp.
LimeSurvey zawiera 3 motywy. Te początkowe motywy są definiowane przez katalogi znajdujące się w katalogu instalacyjnym LimeSurvey „themes/survey/”. Każdy motyw ma swój własny katalog. W głównym katalogu motywu znajdziesz plik konfiguracyjny w formacie XML oraz liczne katalogi zawierające widoki themes (.twig), kaskadowe arkusze stylów (.css), 'skrypty, obrazy (.jpg lub .png) i ewentualnie inne.
Od wersji LimeSurvey 2.50 silnik motywów wykorzystuje 3 jako framework CSS. Ponieważ Bootstrap 3 jest standardowym frameworkiem, programiści znajdą w Internecie wiele dokumentacji, tutoriali i wątków na forach na jego temat.
Od wersji LimeSurvey 3 silnik motywów korzysta z Twig, dzięki czemu twórcy motywów mogą w bezpieczny i łatwy sposób zmieniać logikę renderowania ankiet. Twig zastępuje stary system zastępowania słów kluczowych, który był używany w poprzednich wersjach. Logika użyta do wygenerowania kodu HTML słów kluczowych jest teraz dostępna w widokach motywu.
Motywy, będące kodem HTML i Twig, zwykle definiują położenie i rodzaj wyświetlanego tekstu oraz podobne cechy strukturalne strony. Często odwołują się do innych plików lub je zawierają. Większość z nich odwołuje się do wspólnego pliku kaskadowych arkuszy stylów (CSS), który definiuje styl czcionki, kolor, rozmiar, tło i podobne parametry wspólne dla wszystkich stron ankiety. Arkusze stylów odwołują się do parametrów „klas” HTML, które są powiązane z różnymi typami obiektów w kodzie HTML. Dzięki temu arkusz stylów może zdefiniować sposób wyświetlania każdego z wielu typów tekstu lub innych obiektów, które mogą pojawiać się w wielu miejscach. Istnieją unikalne klasy dla każdego typu pytania w LimeSurvey, co daje szczegółową kontrolę nad wyglądem każdego z nich. Pliki obrazów, takie jak logo lub specjalne konstruktory pasków postępu, mogą również zawierać odniesienia w pliku motywu. Na koniec specjalne słowa kluczowe w nawiasach klamrowych są zastępowane tekstem zdefiniowanym w ankiecie dla każdego korespondenta tłumaczącego język (na przykład „Tytuł ankiety” lub „Tekst pytania” dla każdego zdefiniowanego języka).
Jeśli utworzysz nowy, niestandardowy motyw, rozważ udostępnienie go społeczności LimeSurvey i udostępnienie go innym. Z Twoją pomocą możemy rozwijać nasze repozytorium motywów, ankiet i innych dodatków, aby uczynić LimeSurvey jeszcze lepszym!
Zajrzyj do naszego repozytorium szablonów LimeSurvey, w którym możesz udostępniać swoje szablony.
Tworzenie nowego motywu
Aby móc utworzyć nowy motyw (lub edytować istniejący motyw), potrzebujesz Uprawnienia użytkownika do edytowania szablonu w LimeSurvey, a także uprawnienia do manipulowania plikami w podstawowym systemie operacyjnym system hostujący Twoją instalację LimeSurvey.
Uwaga ostrzeżenia: Jeśli zmienisz motywy, możesz mieć wpływ na wszystkie istniejące ankiety z Twojej instalacji LimeSurvey. Motywy to zaawansowana funkcja wymagająca doświadczenia i znajomości języka HTML.
Preferowanym sposobem utworzenia nowego motywu jest użycie „Edytora motywów” (patrz poniżej), który znajduje się w obszarze „Konfiguracja” na górnym pasku narzędzi. Niektórzy użytkownicy wolą pracować bezpośrednio z plikami motywów, aby móc korzystać ze swojego ulubionego edytora tekstu zamiast interfejsu internetowego. W takim przypadku nadal użyj Edytora motywów, aby najpierw utworzyć nowy motyw. Spowoduje to utworzenie nowego motywu podstawowego ze wszystkimi potrzebnymi plikami w katalogu „LimeSurvey_web_root/upload/themes/survey/your_new_template”. Stamtąd możesz użyć edytora tekstu, aby ręcznie dostosować pliki szablonów.
Uprawnienia Uwaga: w systemach Unix/Linux te pliki motywów będą własnością grupy i użytkownika, na którym działa serwer WWW (w niektórych systemach może to być „www”). Upewnij się więc, że masz odpowiednie uprawnienia do edycji tych plików. Kiedy je zapiszesz, upewnij się, że nie zmienią właściciela! Dzięki temu w razie potrzeby nadal będziesz mógł korzystać z interfejsu edycji motywu internetowego.
Wiele „publicznych” elementów LimeSurvey można dostosować za pomocą szeregu motywów. Następna sekcja zawiera bardzo krótkie wyjaśnienie tych szablonów.
Edytor motywów: Konfiguracja > Motywy> Edytor motywów
Edytor motywów jest dostępny tylko dla użytkowników z uprawnieniami do szablonów i dla superadministratorów.
Uwaga : Nieprawidłowo skonstruowany motyw może spowodować, że ankieta (wykorzystująca odpowiedni szablon) przestanie działać.
Edytor motywów LimeSurvey umożliwia edycję zawartości motywów online. Aby uruchomić Edytor motywów: kliknij opcję „Motywy” w menu „Konfiguracja”, a następnie kliknij przycisk „Edytor motywów” obok motywu, który chcesz edytować lub rozszerzyć.
Strona edytora szablonów umożliwia wybranie szablonu, który chcesz edytować/wyświetlić.
Dostępne są następujące opcje:
Utwórz: Umożliwia utworzenie nowego szablonu. Aby nie zaczynać od zera, kopiowany jest szablon „domyślny”.
Import: Umożliwia import szablonu z pliku ZIP.
Eksport : Umożliwia wyeksportowanie bieżącego szablonu do pliku ZIP.
Kopiuj: Umożliwia utworzenie nowego szablonu poprzez skopiowanie bieżącego.
Zmień nazwę: Umożliwia zmianę nazwy szablonu. Zwykle jest używany po skopiowaniu lub zaimportowaniu szablonu.
Szablon: Lista rozwijana, która pokazuje wszystkie dostępne szablony, które znajdują się w Twojej instalacji LimeSurvey.
Ekran: Lista rozwijana, która pozwala wybrać, którą konkretną stronę ankiety w danym szablonie chcesz wyświetlić.
Wróć do panelu administracyjnego.
Importuj/Eksportuj/Kopiuj szablon
Kiedy 'eksportujesz szablon, zostanie utworzone archiwum w formacie ZIP ze wszystkimi plikami szablonów (pliki .pstpl, obrazy, pliki css, ...). Możesz „zaimportować” wyeksportowany plik zip do innej instalacji LimeSurvey, korzystając z funkcji importu, lub możesz ręcznie skopiować archiwum do innej instalacji LimeSurvey i rozpakować je do odpowiedniego szablon tam katalog.
Najlepiej jednak skorzystać z funkcji importu/eksportu/kopiowania szablonu LimeSurvey w edytorze szablonów.
Następujące pliki szablonów są używane do tworzenia ankiety publicznej i muszą znajdować się w każdym nowym folderze szablonów, który utworzysz:
startpage.pstpl: Tworzy początek każdej strony HTML. Zaczyna się od „<head> „ i nie powinien zawierać „<html> ". Ten „sam początek” standardowej strony HTML jest pisany przez skrypty. Upewnij się, że pliki startpage.pstpl zawierają<body> etykietka. Mimo że wiele przeglądarek nie wymaga ścisłego przestrzegania standardów HTML W3, skrypt LimeSurvey musi znaleźć tag, aby uruchomić określone elementy JavaScript. Nieczęsto zdarza się, że w pliku startpage.pstpl występuje wiele „słów kluczowych”. Możesz jednak umieścić w tytule nazwę ankiety. Plik startpage.pstpl może zawierać kod kończący się odpowiednim plikiem endpage.pstpl. Można na przykład rozpocząć tabelę w tym pliku i zamknąć ją w pliku endpage.pstpl. Pliki startpage.pstpl i endpage.pstpl otaczają każdą możliwą stronę używaną przez LimeSurvey.
survey.pstpl:' Ten szablon jest drugim używanym na większości stron i zapewnia miejsce na umieszczenie nazwy ankiety i opis. Ten szablon nie ma odpowiedniego szablonu „zamykającego”, dlatego powinieneś zamknąć wszystkie tagi otwarte w tym pliku szablonu (tzn.: nie zostawiaj tutaj otwartej tabeli, ponieważ nie ma gdzie jej zamknąć).
' welcome.pstpl:' Ten szablon jest używany tylko na ekranie powitalnym (który znajduje się również na stronie głównej ankiet „wszystko w jednym”). Można w ten sposób wydrukować tekst powitalny i inne informacje, które należy podać we wstępie. Podobnie jak plik „survey.pstpl”, nie ma odpowiadającego mu szablonu „zamykającego”, więc wszystkie tagi otwarte w tym pliku szablonu również powinny zostać zamknięte.
startgroup.pstpl: Ten szablon może zapewnić „podsumowanie” pytań w grupie. Zawiera pasujący szablon „endgroup.pstpl”, którego można użyć do zamknięcia dowolnych otwartych tagów w tym pliku, dzięki czemu można otworzyć w nim tabelę.
groupdescription.pstpl: Ten plik szablonu jest używany do wyświetlania opisu grupy. Pamiętaj, że w ustawieniach ankiety (dostęp do „Ustawień prezentacji i nawigacji” klikając w zakładkę „Prezentacja”) możesz określić, czy opis grupy ma być wyświetlany, czy nie. Jeśli nie, ten plik nie zostanie w ogóle uwzględniony.
question.pstpl: Ten plik zawiera sekcje pytań, odpowiedzi i tekstu pomocy w Twojej ankiecie. W ankietach „grupa po grupie” i „wszystko w jednym” ten szablon jest powtarzany cyklicznie przy każdym pytaniu. Nie ma odpowiedniego pliku zamykającego i wszystkie znaczniki powinny zostać zamknięte.
question_start.pstpl: Ten plik zawiera poszczególne elementy znajdujące się na początku pytania. Jest on zawarty w „question.pstpl” za pomocą słowa kluczowego {QUESTION}. Ma to na celu umożliwienie projektantom szablonów większej kontroli nad układem pytania. Ten szablon znajduje się poza normalnym systemem szablonów i „został zastąpiony (od LimeSurvey 1.87)”. Wszystkie słowa kluczowe z tego szablonu są teraz dostępne bezpośrednio w question.pstpl.
completed.pstpl: Ta strona jest wyświetlana jako ostatnia strona po zapisaniu odpowiedzi na ankietę i zakończeniu ankiety. Można go użyć do wyświetlenia „linku przekierowującego” zgodnie z ustawieniami ankiety.
endgroup.pstpl: Ten plik zamyka grupę i może być użyty do zamknięcia wszelkich tagów otwartych w plik startgroup.pstpl
navigator.pstpl: Ten plik zawiera przyciski umożliwiające poruszanie się po ankiecie, „następny”, „poprzedni”, „ostatni”, „prześlij”, „zapisz do tej pory” i link „wyczyść wszystko”. Jest używany na wszystkich stronach z wyjątkiem strony wypełnionej.
printanswers.pstpl: Ten plik zawiera opakowanie HTML niezbędne do wydrukowania ankiety.
print_group.pstpl : Ten plik jest taki sam jak startgroup.pstpl i endgroup.pstpl, ale dotyczy wersji drukowanej ankiety.
print_question.pstpl: Ten plik jest taki sam jak question.pstpl , ale dla wersji drukowanej ankiety.
print_survey.pstpl: Ten plik jest taki sam jak ankieta.pstpl, ale dotyczy wersji drukowanej ankiety.
CSS i Javascript
Dwa pliki, które są zawsze używane w szablonie, to template.css (dla CSS) i template.js (dla JavaScript).
{TEMPLATECSS}: Dodaj linie dla domyślnego css, template.css, i template-rtl.css dla języka rtl.
{TEMPLATEJS}: Dodaj linie dla domyślnych plików javascript, template.js i wszystkich plików js potrzebnych dla LimeSurvey.
Korzystanie z Bootstrap
LimeSurvey ma wbudowany Bootstrap 3, dzięki czemu możesz stylizować wszystkie swoje szablony za pomocą dobrze udokumentowanych klas Bootstrap.
Więcej informacji można znaleźć w Bootstrap dokumentacja.
Dołączona jest także wtyczka Awesome-Bootstrap-Checkbox. Dzięki niemu możesz używać typowych klas kolorów Bootstrap (informacje, ostrzeżenie, niebezpieczeństwo itp.), również z przyrostkiem „-checkbox” lub „-radio”, chociaż stylizujesz pola wyboru i radia według własnych upodobań.
Zastąpienie domyślnego CSS lub JavaScript
W niektórych pytaniach używane są określone pliki JavaScript lub CSS. Jeśli chcesz zastąpić funkcję, użyj systemu kaskadowego. W przypadku funkcji javascript ostatnia odczytana funkcja jest funkcją używaną.
Inne pliki szablonów
Pliki „privacy.pstpl”, „invitationemail.pstpl””, „reminderemail.pstpl” i „confirmationemail.pstpl” nie są już używane przez LimeSurvey, a wartością domyślną są zamiast tego ustawione w odpowiednich plikach językowych. Wiadomości e-mail można teraz edytować według ankiety.
Strony standardowe
Istnieje dziesięć standardowych stron, które uczestnik ankiety może zobaczyć w trakcie korzystania z aplikacji LimeSurvey lub uzyskiwania do niej dostępu. Każdy z nich jest zbudowany z szeregu wspólnych plików „Szablonów” z „Szablonu” określonego w ustawieniach ankiety. Poniższa tabela wskazuje, które pliki szablonów zostały użyte podczas tworzenia każdej z tych stron.
* UWAGA: W wersji 1.90+ zastępuje to question.pstpl ORAZ question_start.pstpl. Jeśli używasz starego niestandardowego szablonu, musisz dodać następujący wiersz na początku question.pstpl:
A następnie dodaj odpowiedni tag zamykający na końcu question.pstpl:
</div>
* UWAGA: W wersji 1.91 i wcześniejszych pliki LimeSurvey js nie są uwzględniane w szablonie. W wersji 2 „musisz użyć {TEMPLATEJS} w jednym z plików szablonów”, aby dodać łącze do pliku js. Możesz dodać go w startpage.pstpl lub endpage.pstpl. Możesz usunąć linię {TEMPLATEURL}/template.js i zastąpić ją linią {TEMPLATEJS}, aby zaktualizować szablon osobisty.
Sekcja kontroli plików
W oknie „kontroli plików” po lewej stronie możesz kliknąć jeden z plików szablonów, który służy do kompilacji strony. Możesz zobaczyć Część ekranu, pliki JavaScript i CSS. Kod HTML tego pliku pojawi się następnie w oknie „Teraz edycja” pośrodku. Jeśli szablon jest edytowalny (określony przez uprawnienia katalogu), możesz następnie wprowadzić dowolne zmiany i je zapisać.
Okno „Inne pliki” pokazuje listę wszystkich pozostałych plików z katalogu szablonów. Możesz użyć prawej strony, aby „przesłać i wybrać pliki obrazów (zdjęcia, logo itp.) lub inne pliki potrzebne do utworzenia szablonu”.
Zamiast używać linku do każdego zdjęcia, użyj ciągu pola {TEMPLATEURL}. Zatem zamiast:
W wersjach LimeSurvey wcześniejszych niż 2.50 użyj:
img src='{TEMPLATEURL}moje zdjęcie.jpg'
„Próbka” edytowanej strony szablonu będzie widoczna na dole ekranu. Nie ma możliwości usunięcia szablonu z edytora szablonów. Należy to zrobić, uzyskując dostęp do podstawowego katalogu i ręcznie usuwając stamtąd pliki. Masz również możliwość wyboru różnych rozdzielczości ekranu, aby lepiej ocenić styl i wygląd szablonu.
Uwaga: Dostarczonych szablonów nie można edytować za pomocą edytora szablonów. Jeśli chcesz je zmodyfikować, najpierw utwórz kopię, a następnie edytuj kopię.
Lokalizacja plików szablonów
LimeSurvey przechowuje każdy ze „standardowych” szablonów w oddzielnym podkatalogu w katalogu „/templates”, który jest przechowywany w katalogu publicznym wraz z innymi publicznymi plikami LimeSurvey. Dostosowane szablony użytkownika są przechowywane w katalogu „/upload/templates”.
W katalogu szablonów „ZAWSZE” powinien znajdować się katalog „domyślny”. Ten szablon jest używany domyślnie i jako rezerwowy, jeśli folder szablonów nie istnieje lub nie można go znaleźć. Jest instalowany domyślnie.
Możesz użyć dowolnych plików graficznych, które prześlesz do obszaru zarządzania szablonami, korzystając z następującej składni:
{TEMPLATEURL}nazwapliku.xyz
Stylizacja pytań za pomocą CSS
Stylizacja pytań w CSS stała się znacznie łatwiejsza. Każdy typ pytania ma teraz unikalną klasę. Pytania obowiązkowe mają dodatkowe zajęcia obowiązkowe. Na przykład w przypadku pytania nieobowiązkowego:
Klasy te są używane dla każdego typu pytania. Niektóre typy pytań wykorzystują tylko jedną lub dwie klasy, podczas gdy inne mogą wykorzystywać znacznie więcej.
Klasy globalne
Nazwa klasy
Część
Typ pytania
Przykłady
Uwaga
.question (Obsolete since 3.0)
Wszystkie bloki pytań
Wszystkie typy pytań
,
,
.ls-answers (New in 3.0 )
Wszystkie bloki pytań
Wszystkie typy pytań
,
,
.subquestions-list
Lista pytań podrzędnych
Pytanie wielokrotnego wyboru, pytanie typu tablicowego
,
.questions-list też jest używana
.lista-odpowiedzi
Lista odpowiedzi
Pytanie jednokrotnego wyboru, pytanie typu tablicowego, pytanie tekstowe z wieloma wejściami
,
.odpowiedź
Część odpowiedzi: jedna odpowiedź
Pytanie jednokrotnego wyboru, pytanie typu tablicowego, pytanie tekstowe z wieloma wejściami
,
.noanswer-item
Część odpowiedzi na brak odpowiedzi
Pytanie jednokrotnego wyboru, pytanie typu tablicowego
,
Brak odpowiedzi jest także odpowiedzią, zatem należy zastosować podwójną klasę: brak odpowiedzi i odpowiedź
.pytanie-przedmiot
Część pytająca: jedno pytanie
Pytanie wielotekstowe, typ pytania tablicowego
,
Niektóre odpowiedzi są także pytaniami. Mamy wtedy dużo class="question-item-answer-item"
.button-list
Lista przycisków
Tak nie i pytanie o płeć
.button-item
Część odpowiedzi za pomocą przycisku
Tak nie i pytanie o płeć
.checkbox-list
Lista pól wyboru
Pytanie wielokrotnego wyboru, numer tablicy (pole wyboru), typ pytania
,
Niektóre typy pytań korzystają z klas wielolistowych, np. pole wyboru z komentarzem: class="checkbox-list lista-tekstowa"
Uwaga: przed wersją 1.92 dostępne były tylko klasy .mandatory i .input-error.
Odnoszą się one do komunikatów pomocy i/lub wskazówek dotyczących sprawdzania poprawności, dzięki czemu każdy typ może być indywidualnie stylizowany.
Opcje .hide-tip i .input-error domyślnie współdziałają ze sobą, dzięki czemu można ukryć wskazówki dotyczące sprawdzania poprawności. Pojawiają się jednak, gdy wystąpią błędy podczas sprawdzania poprawności, i znikają, gdy błędy te zostaną naprawione.
Wszystkie mają na celu wyeliminowanie konieczności wyświetlania wyskakujących komunikatów ostrzegawczych. Zamiast tego wskazówki mogą pojawiać się/znikać w razie potrzeby i są oznaczone kolorami, aby wskazać, czy odpowiedzi spełniają kryteria weryfikacji.
Co więcej, gdy po raz pierwszy odwiedzisz stronę, która nie spełnia kryteriów weryfikacji, możesz oznaczyć wskazówki kolorami w przyjemnym kolorze, aby pokazać, które kryteria weryfikacji nie zostały jeszcze spełnione; następnie wyświetl stronę ponownie, używając ostrzejszego koloru, jeśli osoba prześle stronę z utrzymującymi się błędami sprawdzania poprawności.
Cel
Klasa CSS
Opis
Obowiązkowe
.obowiązkowe
pytanie jest obowiązkowe
Błąd wprowadzania danych przez użytkownika
.input-error
w pytaniu wystąpił co najmniej jeden błąd sprawdzania poprawności
Ukryj wskazówkę
.ukryj wskazówkę
dodano jeśli użyjesz opcji hide_tip
wpisz domyślny
.em_default
dla domyślnego zestawu końcówek (wartość liczbowa itp.)
Num odpowiedzi
.em_num_answers
for dla min_answers i max_answers
Zakres wartości
.em_value_range
dla min/max_num_value_n i multiflexible_min/max
Zakres sumy
.em_sum_range
dla min/ max/equals_num_value
Weryfikacja wyrażenia regularnego
.em_regex_validation
do sprawdzania poprawności pytania za pomocą wyrażeń regularnych
Funkcja sprawdzania poprawności na poziomie pytania
.em_q_fn_validation
dla opcja em_validation_q
Funkcja sprawdzania poprawności na poziomie podpytania
.em_sq_fn_validation
dla opcji em_validation_sq
Inny komentarz obowiązkowy
.em_other_comment_mandatory
dla opcji other_comment_mandatory - wyświetla się, gdy Wybrano „inne”, ale brakuje powiązanego komentarza.
Importowanie stylów do niestandardowego szablonu
Niestandardowe style pytań znajdują się na dole pliku CSS każdego szablonu i zaczynają się od:
Jeśli stylizujesz swój własny, niestandardowy szablon, powinieneś móc skopiować wszystko po powyższym z templates/default/template.css (dla układów opartych na tabelach) lub /templates/limespired/template. css (dla układów opartych na CSS) do własnego arkusza stylów bez żadnego wpływu na inne style.
Warunkowe arkusze stylów przeglądarki Internet Explorer
Ze względu na wyraźne rozbieżności w renderowaniu między IE6 i IE7 a innymi przeglądarkami, dla każdego szablonu dołączone są specjalne arkusze stylów warunkowych IE.
Powinieneś zawrzeć powyższy kod w pliku startpage.pstpl oraz kopie obu arkuszy stylów IE z pliku „/templates/default/” lub „/templates/limespired” dla podstawowego układu tabel i Układ oparty odpowiednio na CSS.
Uwaga: Jeśli skopiujesz style do własnego arkusza stylów, prawie na pewno będziesz musiał je poprawić.
Alternatywne rozwiązanie dla przeglądarki Internet Explorer
Możesz umieścić klasę warunkową dla treści w pliku startpage.pstpl i użyć tej klasy w pliku template.css. Ta metoda jest używana w szablonie cytronady (Obsolete since 2.06). Dodanie klasy js / no-js, aby mieć system javascript / brak javascript.
.ie6{/*specyficzne dla przeglądarki Internet Explorer 6*/}.ielt8{/*specyficzne dla przeglądarki Internet Explorer 6 i 7*/}.ie{/*specyficzne dla wszystkich przeglądarek */}
Języki od prawej do lewej (RTL) i uzasadnij
Edytor tekstu w LimeSurvey może formatować tekst RTL. Jednak sam edytor pokazuje język RTL w formacie od lewej do prawej, gdy jest to uzasadnione. Jest to po prostu problem z wyświetlaniem edytora. RTL i uzasadnione pytanie lub tekst będą wyświetlane poprawnie od prawej do lewej, nawet jeśli są uzasadnione, w ankiecie lub na podglądzie.
Słowa kluczowe w pliku szablonu zostaną zastąpione bieżącymi informacjami z ankiety. Są one otoczone nawiasami klamrowymi, na przykład: {NAZWA ANKIETY}.
Poniższe ciągi zostaną zastąpione przez LimeSurvey podczas analizowania pliku szablonu i prezentowania go użytkownikom ankiety. Te ciągi pól będą działać na prawie każdym szablonie z wyjątkiem „Ukończonej strony”. (Większość tych ciągów można znaleźć w pliku common.php. Jeśli go tam nie ma, poszukaj w pliku Index.php.)
Słowo kluczowe
Pliki szablonów
Opis
{NAZWA ANKIETY}
Wszystkie Pliki
Tytuł ankiety
{SURVEYDESCRIPTION}
Wszystkie pliki
Opis ankiety
{WELCOME}
Wszystkie pliki (głównie dla Welcome.pstpl)
Tekst powitalny ankiety
{PERCENTCOMPLETE}
survey.pstpl
Mały wykres przedstawiający procent wypełnienia ankiety
Wyświetla całkowitą liczbę pytań w ankiecie (tylko liczbę)
{THEREAREXQUESTIONS}
witaj. pstpl
Wyświetla zdanie „W tej ankiecie znajduje się X pytań” – z odpowiedniego pliku językowego. X zastępuje się liczbą pytań. Pamiętaj, że będzie to również działać odpowiednio w przypadku liczby pojedynczej i mnogiej. Jeśli jest tylko 1 pytanie, wyświetli się "W tej ankiecie jest 1 pytanie".
{CHECKJAVASCRIPT}
Wszystkie pliki (głównie dla Welcome.pstpl)
Komunikat ostrzegawczy po zakończeniu- przeglądarka użytkownika ma wyłączoną obsługę JavaScript
{QUESTION}
Question.pstpl
-
{ANSWER}
question.pstpl, print_question.pstpl
prezentuje formularz odpowiedzi na aktualne pytanie
{SGQ}
question.pstpl, tekst pytania
Można użyć w samym tekście pytania, aby dynamicznie odwoływać się do pola wejściowego pytania, wyświetlając identyfikator ankiety-grupy-pytania dla bieżącego pytania. (od wersji svn 9755)
{QUESTIONHELP}
question.pstpl, print_question.pstpl
Wyświetla tekst pomocy (predefiniowana wskazówka dotycząca typu pytania) dla bieżącego pytania
{QUESTION_CLASS}
question.pstpl, print_question.pstpl
unikalna klasa dla każdego typu pytania. (Do umieszczenia w tagu zawijającym pytanie.)
{QUESTION_CODE}
question.pstpl, print_question.pstpl
Wyświetla bieżący kod pytania
{QUESTION_ESSENTIALS }
question.pstpl
identyfikator pytania i (jeśli pytanie jest warunkowe) 'style="display:none;"'. (Do umieszczenia w tagu zawijającym pytanie.)
{QUESTION_HELP}
question.pstp, question_start.pstpl
Wyświetla tekst pomocy zdefiniowany przez użytkownika dla bieżącego pytania
{QUESTION_TYPE_HELP}
print_question.pstp
Wyświetla tekst pomocy zdefiniowany przez użytkownika dla bieżącego pytania
{QUESTION_INPUT_ERROR_CLASS}
question.pstp, question_start.pstpl
Udostępnia klasę, jeśli wystąpił błąd wprowadzania danych przez użytkownika
{QUESTION_ID}
print_question.pstp
Udostępnia unikalny identyfikator dla każdego pytania, aby umożliwić stylizację dla konkretnych pytań
Wszystkie pliki (ale przeznaczone dla navigator.pstpl)
Wyświetla Link „Wyjdź i wyczyść wyniki”
{COMPLETED}
completed.pstpl
-
{URL}
completed.pstpl
Wyświetla „url” i „tekst adresu URL” ankiety
{PRIVACYMESSAGE}
privacy.pstpl
Komunikat dotyczący prywatności wyświetla się, jeśli ustawisz anonimowość ankiety. Tekst można edytować/tłumaczyć w plikach językowych. Można to również zmienić ręcznie, edytując szablon private.pstpl, którego chcesz użyć.
{TEMPLATEURL}
Wszystkie pliki
Adres URL bieżącej lokalizacji szablonu (przydatny do odwoływania się do plików obrazów w Twój szablon)
{SURVEYRESOURCESURL}
Wszystkie pliki
Adres URL do aktualnie przesłanych plików dla tej lokalizacji ankiety (przydatne do odwoływania się do plików graficznych w Twoim pytaniu, grupie, ....)
{SUBMITCOMPLETE}
endpage.pstpl
Oświadczenie (z plików językowych), które informuje użytkownika o wypełnieniu ankiety i konieczności naciśnięcia przycisku „Wyślij”
{SUBMITREVIEW}
survey.pstpl
Oświadczenie (z plików językowych), które informuje użytkownika, że może przejrzeć/zmienić udzielone odpowiedzi, klikając „<< prev”
{SAVEDID}
Wszystkie pliki
Wyświetla „ID odpowiedzi” użytkownika
{QUEXMLPDF}
Wszystkie pliki
Wyświetla przycisk umożliwiający eksport kwestionariusza w formacie PDF queXML, w tym odpowiedzi wprowadzone do momentu, w którym ankieta została wypełniona.
{TOKEN:FIRSTNAME}
Wszystkie pliki
***Jeśli odpowiedzi w ankiecie NIE są ANONIMOWE - są najpierw zastępowane użytkownikami nazwa z tabeli tokenów
{TOKEN:LASTNAME}
Wszystkie pliki
-
{TOKEN:EMAIL}
Wszystkie pliki
***Jeśli odpowiedzi w ankiecie NIE są ANONIMOWE - zostaną zastąpione adresem e-mail użytkownika z tabeli tokenów***
{TOKEN:ATTRIBUTE_1}
Wszystkie pliki
***Jeśli odpowiedzi w ankiecie NIE są ANONIMOWE - zostają zastąpione atrybutem użytkownika_1 z tabeli tokenów***
|Wszystkie pliki
***Jeśli odpowiedzi na ankietę NIE są ANONIMOWE - zostają zastąpione atrybutem użytkowników_2 z tabeli tokenów***
{ANSWERSCLEARED}
Najlepiej w navigator.pstpl
The Komunikat „Answers Cleared” z plików językowych
{RESTART}
clearall.pstpl
URL, aby ponownie uruchomić ankietę
{REGISTERERROR}
register.pstpl
Pokazuje wszelkie komunikaty o błędach na stronie rejestracji (np.: „Musisz podać adres e-mail”)
{REGISTERMESSAGE1}
register.pstpl
Oświadczenie „Musisz być zarejestrowany, aby ukończyć ta ankieta” z plików językowych
{REGISTERMESSAGE2}
register.pstpl
Szczegóły dotyczące rejestracji z plików językowych
{REGISTERFORM}
register.pstpl
Rzeczywisty formularz rejestracji będzie się zmieniać w zależności od tego, czy ustawiono pola atrybut_1 i atrybut_2.
{SAVE}
Działa prawidłowo na navigator.pstpl
Wyświetla komunikat „Zapisz swoje odpowiedzi, aby daleko”, aby zaoferować użytkownikowi zapisanie ankiety i powrót później w celu kontynuowania ankiety. Jeśli opcja Zapisz we właściwościach ankiety jest wyłączona, tag nie będzie pokazywany i ignorowany.
{LANGUAGECHANGER}
survey.pstpl
}
Wejście/Przyciski
Każdemu typowi „wejściowemu” w ankiecie nadano własną nazwę klasy, dzięki czemu możesz dodać CSS do pliku „startpage.pstpl” i mieć pewną kontrolę nad wyglądem przycisków formularzy i danych wejściowych. Nazwy tych klas są następujące:
prześlij (przyciski wysyłania)
'tekst (wprowadzany tekst — krótki dowolny tekst, data i typ liczbowy)
tekst odpowiedzi (tekst odpowiedzi)
radio' (przyciski opcji)
pole wyboru (pola wyboru)
'select' (Wybierz/Lista pól)
textarea (Duży tekst - w przypadku długiego, wolnego tekstu)
clearall ("Wyjdź i wyczyść ankietę " link)
rank (Pytanie w stylu rangi. Nie ustawia koloru pola wyboru ani pól tekstowych, ale pozwala na zmianę koloru tła, koloru tekstu, rozmiaru itp. ., dla reszty pytania rankingowego)
wykres (tabela wykresów „ukończonych procentowo”)
wewnętrzny wykres (Tabela wewnątrz tabeli wykresów - to zawiera tekst 0% i 100%. Użyj tego, aby zmienić rozmiar tego tekstu)
pytanie (Ustawienia ogólne dla każdego pytania wyświetlanego w tabeli. Ogólnie rzecz biorąc, powinieneś używać tego do upewnij się, że ich rozmiar i kolor czcionki są takie same, jak domyślnie użyte gdzie indziej)
obowiązkowe (Pytania obowiązkowe)
błąd wejściowy (Użytkownik błąd wejściowy - na wypadek, gdyby użytkownik popełnił błąd w pytaniu obowiązkowym lub pytaniu z walidacją)
array1 i array2 (Te dwa style są przełączane podczas prezentowania zakresu odpowiedzi na pytanie typu tablicowego. Pozwala to ustawić przemienny kolor tła dla tego typu pytań. Array1 jest również używany w nagłówkach kolumn w tego typu pytaniach)
errormandatory (Ustawia kolor i styl komunikatu o błędzie „To pytanie jest obowiązkowe”)
*warningjs (Ustawia kolor i styl komunikatu ostrzegawczego wyświetlanego, jeśli przeglądarka uczestnika ma wyłączoną obsługę JavaScript)
Dostęp do niektórych elementów można uzyskać również za pomocą identyfikatora elementu („#ID” w CSS):
„„kontakt ankiety” (Wiadomość kontaktowa wyświetlana na stronie startowej)
tokenmessage (używany do wiadomości wewnątrz ankiety, np. komunikat o błędzie wygaśnięcia sesji)
Ponieważ możesz edytować wszystkie aspekty HTML, nie ma powodu otaczać szablonów znakiem
<divclass='new_name'></div>
, a następnie zdefiniuj css dla tej klasy nowa_nazwa.
Stylizacja paska postępu
Wygląd paska postępu można modyfikować za pomocą CSS.
Aby zmienić kolor tła paska, dodaj na końcu pliku niestandardowego.css coś takiego (przykład motywu owocowego):
.owocowy.pasekpostępu{kolortła:#3300FF;}
Aby zmienić kolor obramowania paska, dodaj na końcu pliku niestandardowego.css coś takiego (przykład motywu owocowego):
LimeSurvey zintegrował kilka poprawek stworzonych przez użytkowników, które pozwalają na pewne specjalne zmiany. Te bardzo zaawansowane funkcje (zazwyczaj) wymagają zmian w podstawowym kodzie LimeSurvey i należy je wykonywać ostrożnie, aby nie wprowadzić luk w zabezpieczeniach.
Wsparcie dla własnych funkcji JavaScript
Niektórzy użytkownicy mogą potrzebować uruchomić JavaScript na stronach ankiet, ale wywołanie metody checkconditions() w elemencie BODY uniemożliwia to. To wywołanie zostało zastąpione małą funkcją JavaScript w HEAD, która sprawdza istnienie funkcji „checkconditions()” i „template_onload()” przed ich wywołaniem. W ten sposób autor szablonu może utworzyć własną funkcję „template_onload()” w HEAD, która zastąpi funkcję domyślną.
Wyłącz filtr XSS - w Ustawieniach globalnych -> Bezpieczeństwo ustaw "Filtruj HTML dla XSS" na Nie.
Wpisz swój skrypt w źródle pytania lub opisu grupy.
Jeśli chcesz, aby ankieta zawierała zdanie specyficzne dla języka, na przykład pomoc na końcu każdej strony, możesz dodać zdanie w pliku .pstl i ukryć je dla innego języka. Jeśli ukryjemy to w pliku template.css, możemy użyć pseudoselektora :lang, ale użyjemy jakiejś klasy dla lepszej kompatybilności.
Poniżej znajdują się dwa zdania pomocy, w języku francuskim i angielskim. Umieść to na endpage.pstpl:
Po edycji i zapisaniu szablonu ma on zastosowanie do strony z listą ankiet tylko wtedy, gdy zostanie wybrany w ustawieniach ankiety. Aby ustawić go jako szablon domyślny, przejdź do zakładki Ogólne znajdującej się w ustawieniach globalnych Twojej instalacji LimeSurvey i wybierz żądany szablon. Od tego momentu wszystkie szablony korzystające z opcji „domyślnej” jako szablonu, a także te, które mają zostać nowo utworzone, będą używać nowo wybranego szablonu domyślnego.
Aby użyć bieżącego szablonu dla tej strony, musisz zmienić odpowiednie ustawienie z „Ustawień globalnych”. W starszych wersjach tę zmianę można wprowadzić, edytując ustawienie $defaulttemplate z pliku konfiguracyjnego: skopiuj to ustawienie z config-defaults.php do config.php, co zastępuje config-defaults.php i edytuj to ustawienie do $defaulttemplate = 'yourtemplatename'; .
Import/Eksport szablonów: Użytkownicy komputerów Mac
Użytkownicy komputerów Mac powinni pamiętać, że domyślne narzędzie archiwizujące w systemie Mac OSX może mieć problemy z folderami zip „generowanymi w locie”.
Rozwiązaniem jest rozpakowanie plików Unix z wiersza poleceń:
$ rozpakuj szablon.zip -d szablon
Archive: template.zip
pompowanie: szablon/strona startowa
pompowanie: ...
Innym obejściem jest użycie skryptów w ich odpowiednikach skompilowanych na komputerze Mac.
Użyj tego samego szablonu z różnymi logo
Jeśli chcesz używać tego samego szablonu dla wszystkich ankiet i po prostu zmienić logo każdej ankiety, możesz użyć symbolu zastępczego {SID} w pliku szablonu .pstpl i w ten sposób odnieść się do różnych obrazów:
<imgsrc="{TEMPLATEURL}files/logoImage-{SID}.png">
Wyświetl niestandardową ikonę ulubionych
Favikona to mała ikona widoczna na pasku adresu przeglądarki, liście zakładek lub karcie. Możesz wyświetlić własną ikonę w następujący sposób:
Utwórz favikonę — możesz skorzystać z Google, aby znaleźć wiele darmowych generatorów favikon.
Nazwij swoją nową favikonę „favicon.ico” i umieść ją w swoim szablonie/plikach katalog.
Dodaj następujący kod do swojej strony startowej.pstpl przed</head> etykietka.
Jeżeli chcesz, aby LimeSurvey zmieniał wygląd co drugiej strony (tzn. parzystych i nieparzystych stron ankiet), możesz użyć klasy .page-odd w swoim pliku CSS, aby zmienić wygląd stron nieparzystych.
„header_separator” służy do adresowania separatora nagłówka „td”. „Separator_podwójnej skali” służy do adresowania kolumny separatora w tablicy o podwójnej skali.
Dodawanie własnego logo do listy ankiet
Najpierw otwórz edytor motywów dla motywu, którego chcesz używać.
Zalecamy używanie owocowego, jest to obecnie nasz najlepszy motyw.
Następnie rozszerz motyw i nadaj mu nazwę, którą będziesz rozpoznawał.
W poniższym widoku możesz przesłać logo, którego chcesz użyć.
Uwaga: Jest to funkcja tymczasowa, która w przyszłości zostanie zastąpiona obiektem pytania (bardzo łatwo będzie przenieść niestandardowe widoki do obiektu pytania). Domyślnie jest wyłączona.
Począwszy od wersji 2.5, możesz tworzyć niestandardowe widoki pytań i niektórych zawartych w nich elementów, specyficzne dla szablonu. Jest to przydatne, jeśli chcesz zmodyfikować układ HTML określonego typu pytania dla jednej lub większej liczby ankiet.
W application/config/config.php znajdź 'config'=>array i dodaj tę linię do tablicy: 'allow_templates_to_overwrite_views'=>1
W /{your_template}/config.xml ustaw "overwrite_question_views" na true
Skopiuj aplikację/widoki/ankieta/* do szablonu/{katalog_widoku}/survey/
Pamiętaj, że wystarczy skopiować tylko te pliki, które zamierzasz modyfikować, ale struktura plików musi pozostać taka sama jak w aplikacja/opinie/ankieta/
Wstaw niestandardowe pliki CSS lub JavaScript dla szablonu
Od wersji 2.50 można używać pliku config.xml do automatycznego ładowania plików wtyczek.
Prześlij swoje pliki do folderu szablonu /css lub /scripts
W /{your_template}/config.xml dodaj ścieżki plików do<css> Lub<js> bloki, coś takiego: