Actions

Translations

Theme editor/12/de: Difference between revisions

From LimeSurvey Manual

m (Text replace - "ä" to "ä")
m (Text replace - "ö" to "ö")
Line 1: Line 1:
Damit man über die LimeSurvey Oberfläche eine bestehende Vorlage editieren oder in eine neue kopieren kann, benötigt man zunächst das Benutzerrecht Vorlagen zu editieren. LimeSurvey selbst benötigt natürlich Schreibrechte für das Vorlagenverzeichnis auf dem Server. Ist eines dieser Rechte nicht gesetzt, kann die Vorlage nicht über LimeSurvey angepasst werden. In diesem Fall muss man die Dateien beispielsweise per FTP herunterladen und mit geeigneter Software ändern. Eine Änderung an einer Vorlage kann unter Umständen alle gespeicherten Befragungen betreffen, daher sollten die Designanpassungen von Leuten übernommen werden, die das grundsätzliche Konzept und den genutzen Code von LimeSurvey verstehen. Die Gestaltung der Vorlagen stellen schon eine fortgeschrittene Aufgabe dar und kann einige Zeit in Anspruch nehmen, wenn man mit HTML-Code nicht wirklich viel anfangen kann.
Damit man über die LimeSurvey Oberfläche eine bestehende Vorlage editieren oder in eine neue kopieren kann, benötigt man zunächst das Benutzerrecht Vorlagen zu editieren. LimeSurvey selbst benötigt natürlich Schreibrechte für das Vorlagenverzeichnis auf dem Server. Ist eines dieser Rechte nicht gesetzt, kann die Vorlage nicht über LimeSurvey angepasst werden. In diesem Fall muss man die Dateien beispielsweise per FTP herunterladen und mit geeigneter Software ändern. Eine Änderung an einer Vorlage kann unter Umständen alle gespeicherten Befragungen betreffen, daher sollten die Designanpassungen von Leuten übernommen werden, die das grundsätzliche Konzept und den genutzen Code von LimeSurvey verstehen. Die Gestaltung der Vorlagen stellen schon eine fortgeschrittene Aufgabe dar und kann einige Zeit in Anspruch nehmen, wenn man mit HTML-Code nicht wirklich viel anfangen kann.


===Speicherort der Vorlagendateien===
===Speicherort der Vorlagendateien===
Line 17: Line 17:
- Eigene Vorlage MyCompanyTempl: Im Ordner  C:\xampp\htdocs\limesurvey\upload\templates\citronade\
- Eigene Vorlage MyCompanyTempl: Im Ordner  C:\xampp\htdocs\limesurvey\upload\templates\citronade\


Alle Bilddateien , die über das Template Management der LimeSurvey-Administration in den Vorlagenbereich kopiert werden, können über folgende Syntax eingebunden werden:
Alle Bilddateien , die über das Template Management der LimeSurvey-Administration in den Vorlagenbereich kopiert werden, können über folgende Syntax eingebunden werden:


Code
Code
Line 25: Line 25:
===Vorlagendateien===
===Vorlagendateien===


Die folgenden Dateien werden verwendet um eine öffentliche Umfrage zu erstellen und müssen daher in jeden Vorlagenordner enthalten sein:
Die folgenden Dateien werden verwendet um eine öffentliche Umfrage zu erstellen und müssen daher in jeden Vorlagenordner enthalten sein:
*'''startpage.pstpl:''' Mit den Informationen aus diese Datei wird jede HTML-Seite er&ouml;ffnet. Sie beginnt bei dem "<head>"-Tag und sollte keine "<html>"-Tags enthalten  Die allerersten Zeilen einer HTML-Seite werden von den Skripten generiert. Es ist sicherzustellen, dass die startpage.pstpl-Dateien einen "<body>"-Tag enthält, wenngleich viele Browser nicht auf strikte W3C-Konformität angewiesen sind. LimeSurvey hält sich jedoch an die W3C-Regeln und erwartet daher einen "<body>"-Tag, um verschiedene Javascript-Elemente ausführen zu k&ouml;nnen. Es ist nicht zu erwarten, das besonders viele Platzhalter in der startpage.pstpl-Datei verwendet werden, aber es bietet sich an {SURVEYNAME} für den Titel zu verwenden. Die startpage.pstpl kann Code enthalten, der in der dazugeh&ouml;rigen endpage.pstpl geschlossen wird, man kann also hier eine Tabelle &ouml;ffnen und sie in der endpage.pstpl schlie&szlig;en. Die startpage.pstpl- und die endpage.pstpl-Dateien umfassen also alle m&ouml;glichen Seiten, die von LimeSurvey genutzt werden.
*'''startpage.pstpl:''' Mit den Informationen aus diese Datei wird jede HTML-Seite eröffnet. Sie beginnt bei dem "<head>"-Tag und sollte keine "<html>"-Tags enthalten  Die allerersten Zeilen einer HTML-Seite werden von den Skripten generiert. Es ist sicherzustellen, dass die startpage.pstpl-Dateien einen "<body>"-Tag enthält, wenngleich viele Browser nicht auf strikte W3C-Konformität angewiesen sind. LimeSurvey hält sich jedoch an die W3C-Regeln und erwartet daher einen "<body>"-Tag, um verschiedene Javascript-Elemente ausführen zu können. Es ist nicht zu erwarten, das besonders viele Platzhalter in der startpage.pstpl-Datei verwendet werden, aber es bietet sich an {SURVEYNAME} für den Titel zu verwenden. Die startpage.pstpl kann Code enthalten, der in der dazugehörigen endpage.pstpl geschlossen wird, man kann also hier eine Tabelle öffnen und sie in der endpage.pstpl schlie&szlig;en. Die startpage.pstpl- und die endpage.pstpl-Dateien umfassen also alle möglichen Seiten, die von LimeSurvey genutzt werden.
*'''survey.pstpl:''' Diese Vorlage ist die zweite Datei, die auf den meisten Seiten genutzt wird und bietet einen Raum, in dem der Umfragenname und die Beschreibung Platz finden. Diese Datei hat kein abschlie&szlig;endes Gegenstück, daher sollten alle Tags geschlossen werden (also beispielsweise keine Tabellen ge&ouml;ffnet lassen, wie man es in der startpage.pstpl machen kann)
*'''survey.pstpl:''' Diese Vorlage ist die zweite Datei, die auf den meisten Seiten genutzt wird und bietet einen Raum, in dem der Umfragenname und die Beschreibung Platz finden. Diese Datei hat kein abschlie&szlig;endes Gegenstück, daher sollten alle Tags geschlossen werden (also beispielsweise keine Tabellen geöffnet lassen, wie man es in der startpage.pstpl machen kann)
*'''welcome.pstpl:''' Diese Vorlagendatei wird ausschlie&szlig;lich auf der Willkommenseite eingebunden (was allerdings gleichzeitig die Hauptseite der "All-in-One"-Umfragen ist. Diese Datei kann genutzt werden, um die Willkommensnachricht und andere Informationen, die in der Einführung enthalten sind, auszudrucken. Genau wie bei der survey.pstpl existiert kein schlie&szlig;endes Gegenstück, daher müssen ebenfalls alle Tags abgeschlossen werden.
*'''welcome.pstpl:''' Diese Vorlagendatei wird ausschlie&szlig;lich auf der Willkommenseite eingebunden (was allerdings gleichzeitig die Hauptseite der "All-in-One"-Umfragen ist. Diese Datei kann genutzt werden, um die Willkommensnachricht und andere Informationen, die in der Einführung enthalten sind, auszudrucken. Genau wie bei der survey.pstpl existiert kein schlie&szlig;endes Gegenstück, daher müssen ebenfalls alle Tags abgeschlossen werden.
*'''startgroup.pstpl:''' Diese Vorlage kann eine Zusammenfassung für die in einer Gruppe zusammengestellten Fragen beinhalten. Diese Datei hat eine passende engroup.pstpl-Datei, Tags k&ouml;nnen daher ge&ouml;ffnet bleiben.
*'''startgroup.pstpl:''' Diese Vorlage kann eine Zusammenfassung für die in einer Gruppe zusammengestellten Fragen beinhalten. Diese Datei hat eine passende engroup.pstpl-Datei, Tags können daher geöffnet bleiben.
*'''groupdescription.pstpl:''' Diese Vorlagendatei wird verwendet um eine Beschreibung einer Gruppe zur Verfügung zu stellen. Sie wurde von der startgruop.pstpl gel&ouml;st, da die Beschreibung in einer "Frage-für-Frage"-Umfrage zwischen den einzelnen Fragen auf einer eigenen Seite zur Verfügung gestellt wird, während die Inhalte bei einer "Gruppe-für-Gruppe"- oder "All-in-One"-Umfrage als &Uuml;berschrift zu der jeweiligen Frage fungiert. groupdescription.pstpl hat keine abschlie&szlig;ene Gegendatei, daher sollten alle Tags geschlossen werden.
*'''groupdescription.pstpl:''' Diese Vorlagendatei wird verwendet um eine Beschreibung einer Gruppe zur Verfügung zu stellen. Sie wurde von der startgruop.pstpl gelöst, da die Beschreibung in einer "Frage-für-Frage"-Umfrage zwischen den einzelnen Fragen auf einer eigenen Seite zur Verfügung gestellt wird, während die Inhalte bei einer "Gruppe-für-Gruppe"- oder "All-in-One"-Umfrage als &Uuml;berschrift zu der jeweiligen Frage fungiert. groupdescription.pstpl hat keine abschlie&szlig;ene Gegendatei, daher sollten alle Tags geschlossen werden.
*'''question.pstpl:''' Diese Datei besteht aus den den Fragen, Antworten und Hilfetexten der Umfrage, in der "Gruppe-für-Gruppe"- und "All-in-One"-Umfrage wird der Inhalt dieser Vorlage mit jeder Frage wiederholt. Es existiert keine dazugeh&ouml;rige Vorlage, die ge&ouml;ffnete Tags abschlie&szlig;en k&ouml;nnte, daher sollten alle Tags geschlossen werden.
*'''question.pstpl:''' Diese Datei besteht aus den den Fragen, Antworten und Hilfetexten der Umfrage, in der "Gruppe-für-Gruppe"- und "All-in-One"-Umfrage wird der Inhalt dieser Vorlage mit jeder Frage wiederholt. Es existiert keine dazugehörige Vorlage, die geöffnete Tags abschlie&szlig;en könnte, daher sollten alle Tags geschlossen werden.
*'''question_start.pstpl:''' Diese Datei beinhaltet die individuellen Elemente, die am Anfang einer Frage gefunden werden. Der Inhalt wird über den Platzhalter {QUESTION} in die question.pstpl eingebunden. Diese Vorlage soll Designern weitergehende Kontrollm&ouml;glichkeiten über das Layout einer Frage gewähren. Diese Vorlagendatei liegt au&szlig;erhalb des normalen Vorlagensystems und wurde mit der Version LimeSurvey 1.87 abgel&ouml;st. Alle Schlüsselw&ouml;rter dieser Vorlage sind mittlerweile direkt in der question.pstpl ansprechbar. Anmerkung: Umfragen, die die Vorlage question_start.pstpl verwenden, werden zumindest noch einige Versionsnnummern von LimeSurvey 1.x lauffähig sein.
*'''question_start.pstpl:''' Diese Datei beinhaltet die individuellen Elemente, die am Anfang einer Frage gefunden werden. Der Inhalt wird über den Platzhalter {QUESTION} in die question.pstpl eingebunden. Diese Vorlage soll Designern weitergehende Kontrollmöglichkeiten über das Layout einer Frage gewähren. Diese Vorlagendatei liegt au&szlig;erhalb des normalen Vorlagensystems und wurde mit der Version LimeSurvey 1.87 abgelöst. Alle Schlüsselwörter dieser Vorlage sind mittlerweile direkt in der question.pstpl ansprechbar. Anmerkung: Umfragen, die die Vorlage question_start.pstpl verwenden, werden zumindest noch einige Versionsnnummern von LimeSurvey 1.x lauffähig sein.
*'''submit.pstpl (and privacy.pstpl):''' Diese Seite ist die vorletzte Seite jeder Umfrage (ausgenommen der "All-in-One"-Umfrage), auf der dem Teilnehmer die M&ouml;glichkeit gegeben wird, seine Antworten noch einmal zu überprüfen, bevor er die Umfrage abschlie&szlig;t und die Ergebnisse verschickt. Sofern es sich um eine anonyme Umfrage handelt, werden die Hinweise zum Datenschutz aus der privacy.pstpl-Vorlage eingebunden.
*'''submit.pstpl (and privacy.pstpl):''' Diese Seite ist die vorletzte Seite jeder Umfrage (ausgenommen der "All-in-One"-Umfrage), auf der dem Teilnehmer die Möglichkeit gegeben wird, seine Antworten noch einmal zu überprüfen, bevor er die Umfrage abschlie&szlig;t und die Ergebnisse verschickt. Sofern es sich um eine anonyme Umfrage handelt, werden die Hinweise zum Datenschutz aus der privacy.pstpl-Vorlage eingebunden.
*'''completed.pstpl:''' Diese Seite wird als Abschlusseite angezeigt, sobald die Antworten gespeichert und die Umfrage beendet ist. Diese Vorlage kann verwendet werden, um den Teilnehmer über einen "Forwarding Link" auf eine andere Seite weiterzuleiten.
*'''completed.pstpl:''' Diese Seite wird als Abschlusseite angezeigt, sobald die Antworten gespeichert und die Umfrage beendet ist. Diese Vorlage kann verwendet werden, um den Teilnehmer über einen "Forwarding Link" auf eine andere Seite weiterzuleiten.
*'''endgroup.pstpl:''' Diese Datei schlie&szlig;t eine Fragengruppe und kann verwendet werden, um in der startgroup.pstpl ge&ouml;ffnete Tags abzuschlie&szlig;en.
*'''endgroup.pstpl:''' Diese Datei schlie&szlig;t eine Fragengruppe und kann verwendet werden, um in der startgroup.pstpl geöffnete Tags abzuschlie&szlig;en.
*'''navigator.pstpl:''' Diese Vorlagendatei enthält die Navigationselemente, über die man durch die Umfrage navigieren kann, "weiter", "zurück", "Zwischengespeicherte Umfrage laden", "absenden", "später fortfahren" und "Umfrage verlassen und l&ouml;schen"
*'''navigator.pstpl:''' Diese Vorlagendatei enthält die Navigationselemente, über die man durch die Umfrage navigieren kann, "weiter", "zurück", "Zwischengespeicherte Umfrage laden", "absenden", "später fortfahren" und "Umfrage verlassen und löschen"


===Seitenstruktur / Vorlagennutzung===
===Seitenstruktur / Vorlagennutzung===
Line 44: Line 44:
*'''The Final Page:''' startpage.pstpl, completed.pstpl, endpage.pstpl
*'''The Final Page:''' startpage.pstpl, completed.pstpl, endpage.pstpl


===Schlüsselw&ouml;rter / Platzhalter===
===Schlüsselwörter / Platzhalter===


Platzhalter innerhalb einer Vorlage werden zur Laufzeit mit den Informationen der jeweiligen Umfrage ersetzt. Sie werden in geschweifte Klammern gesetzt, so z.B: {SURVEYNAME}
Platzhalter innerhalb einer Vorlage werden zur Laufzeit mit den Informationen der jeweiligen Umfrage ersetzt. Sie werden in geschweifte Klammern gesetzt, so z.B: {SURVEYNAME}


Grundsätzlich k&ouml;nnen alle Platzhalter in allen Vorlagen verwendet werden, allerdings werden schlicht keine Inhalte angezeigt, wenn das Skript zu diesem Zeitpunkt noch keine Inhalte zur Anzeige hervorgebracht hat. Das bedeutet zum Beipsiel, dass es sinnlos wäre, in der startpage.pstpl den Platzhalter {QUESTION} zu verwenden, da em Skript zu diesem Zeitpunkt noch keine Fragen bekannt sind.
Grundsätzlich können alle Platzhalter in allen Vorlagen verwendet werden, allerdings werden schlicht keine Inhalte angezeigt, wenn das Skript zu diesem Zeitpunkt noch keine Inhalte zur Anzeige hervorgebracht hat. Das bedeutet zum Beipsiel, dass es sinnlos wäre, in der startpage.pstpl den Platzhalter {QUESTION} zu verwenden, da em Skript zu diesem Zeitpunkt noch keine Fragen bekannt sind.


Die folgende Tabelle beinhaltet die verwendbaren Platzhalter, sowie die Vorlagendateien, in denen sie funktionieren.
Die folgende Tabelle beinhaltet die verwendbaren Platzhalter, sowie die Vorlagendateien, in denen sie funktionieren.
Line 73: Line 73:
|{GROUPDESCRIPTION}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Anzeige der Beschreibung der aktuellen Fragengruppe
|{GROUPDESCRIPTION}||startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl||Anzeige der Beschreibung der aktuellen Fragengruppe
|-
|-
|{QUESTION}||question.pstpl||Dieser Platzhalter wurde mit der Version 1.87 abgel&ouml;st, ist aber nach wie vor verwendbar. Anzeige des Textes der aktuellen Frage. Das Format von {QUESTION} kann über die question.pstpl angepasst werden. Dier folgenden Platzhalter k&ouml;nnen anstelle von {QUESTION} verwendet und mit passendem HTML-Code formatiert werden:{QUESTION_TEXT},{QUESTION_MANDATORY}, {QUESTION_HELP}, {QUESTION_MAN_MESSAGE}, {QUESTION_VALID_MESSAGE} and {QUESTION_INPUT_ERROR_CLASS}
|{QUESTION}||question.pstpl||Dieser Platzhalter wurde mit der Version 1.87 abgelöst, ist aber nach wie vor verwendbar. Anzeige des Textes der aktuellen Frage. Das Format von {QUESTION} kann über die question.pstpl angepasst werden. Dier folgenden Platzhalter können anstelle von {QUESTION} verwendet und mit passendem HTML-Code formatiert werden:{QUESTION_TEXT},{QUESTION_MANDATORY}, {QUESTION_HELP}, {QUESTION_MAN_MESSAGE}, {QUESTION_VALID_MESSAGE} and {QUESTION_INPUT_ERROR_CLASS}
|-
|-
|{ANSWER}||question.pstpl||Anzeige der Antwort der aktuellen Frage
|{ANSWER}||question.pstpl||Anzeige der Antwort der aktuellen Frage
Line 101: Line 101:
|{NAVIGATOR} ||navigator.pstpl||Anzeige der Navigationselemente (weiter, zurück, später fortfahren)
|{NAVIGATOR} ||navigator.pstpl||Anzeige der Navigationselemente (weiter, zurück, später fortfahren)
|-
|-
|{CLEARALL}||Alle Dateien (ist aber gedacht für navigator.pstpl)||Anzeige des "Umfrage verlassen und L&ouml;schen"-Links
|{CLEARALL}||Alle Dateien (ist aber gedacht für navigator.pstpl)||Anzeige des "Umfrage verlassen und Löschen"-Links
|-
|-
|{SUBMITBUTTON}||submit.pstpl||Anzeige des abschlie&szlig;enden "Absenden"-Buttons.
|{SUBMITBUTTON}||submit.pstpl||Anzeige des abschlie&szlig;enden "Absenden"-Buttons.
Line 115: Line 115:
|kann <img src='{TEMPLATEURL}me.jpg'> verwendet werden. Hierbei ist zu beachten, dass dieser Platzhalter auch den / bereits beinhaltet. </nowiki>
|kann <img src='{TEMPLATEURL}me.jpg'> verwendet werden. Hierbei ist zu beachten, dass dieser Platzhalter auch den / bereits beinhaltet. </nowiki>
|-
|-
|{SAVE}||Alle Dateien (gedacht für navigator.pstpl)||Anzeige des "Später Fortfahren"-Buttons, um dem Teilnehmer die spätere Fortsetzung der Umfrage zu erm&ouml;glichen. Sollte die Speichern-Funktion in der Umfrage deaktiviert sein, wird dieser Platzhalter ignoriert und nicht angezeigt.
|{SAVE}||Alle Dateien (gedacht für navigator.pstpl)||Anzeige des "Später Fortfahren"-Buttons, um dem Teilnehmer die spätere Fortsetzung der Umfrage zu ermöglichen. Sollte die Speichern-Funktion in der Umfrage deaktiviert sein, wird dieser Platzhalter ignoriert und nicht angezeigt.
|-
|-
|{LANGUAGECHANGER}||survey.pstpl||Anzeige für den Wechsel der Sprache.  
|{LANGUAGECHANGER}||survey.pstpl||Anzeige für den Wechsel der Sprache.  
Line 130: Line 130:
*'''select''' (Auswahl- / List-Boxen)
*'''select''' (Auswahl- / List-Boxen)
*'''textarea''' (Texteingaben - für gro&szlig;e Freitextfelder)
*'''textarea''' (Texteingaben - für gro&szlig;e Freitextfelder)
*'''clearall''' (Der "Umfrage verlasssen und l&ouml;schen"-Link)
*'''clearall''' (Der "Umfrage verlasssen und löschen"-Link)
*'''rank''' (für die Ranglistenfragen.Hierbei wird nicht die Farbe der ausgewählten Box definiert (dies wird mit den obenstehenden Klassen abgedeckt), sondern erlaubt die Formatierung der Hintergrundfarbe, Textfarbe und -Gr&ouml;&szlig;e, etc. für den Rest der Ranglistenfrage.
*'''rank''' (für die Ranglistenfragen.Hierbei wird nicht die Farbe der ausgewählten Box definiert (dies wird mit den obenstehenden Klassen abgedeckt), sondern erlaubt die Formatierung der Hintergrundfarbe, Textfarbe und -Grö&szlig;e, etc. für den Rest der Ranglistenfrage.
*'''graph''' (Die Anzeige des Fortschrittbalkens)
*'''graph''' (Die Anzeige des Fortschrittbalkens)
*'''innergraph''' (Die Tabellle innerhalb des Fortschrittbalkens - diese beinhaltet den 0% and 100% Text. Hiermit kann die Gr&ouml;&szlig;e des Textes definiert werden.
*'''innergraph''' (Die Tabellle innerhalb des Fortschrittbalkens - diese beinhaltet den 0% and 100% Text. Hiermit kann die Grö&szlig;e des Textes definiert werden.
*'''question''' (Grundsätzliche Einstellungen für alle Fragen, die in einer Tabelle dargestellt werden. Diese Einstellung wird verwendet um sicherzustellen, dass die Farbe und Gr&ouml;&szlig;e zu den übrigen Eingabefeldern passt, die an anderer Stelle formatiert werden.
*'''question''' (Grundsätzliche Einstellungen für alle Fragen, die in einer Tabelle dargestellt werden. Diese Einstellung wird verwendet um sicherzustellen, dass die Farbe und Grö&szlig;e zu den übrigen Eingabefeldern passt, die an anderer Stelle formatiert werden.
*'''mandatory'''  (Pflichtfragen)
*'''mandatory'''  (Pflichtfragen)
*'''input_error''' (Eingabefehler des Benutzers - falls der Teilnehmer einen Fehler bei einer Pflichtangabe oder bei einer Frage mit definierten Antworten gemacht hat)
*'''input_error''' (Eingabefehler des Benutzers - falls der Teilnehmer einen Fehler bei einer Pflichtangabe oder bei einer Frage mit definierten Antworten gemacht hat)
*'''array1''' and '''array2''' (Diese beiden Designs werden abwechselnd verwendet, wenn ein Antwortbereich zur Auswahl steht.  Diese Einstellung erlaubt einen abwechselnden Hintergrund für jede Antwort. '''Array1''' wird bei diesen Fragen auch für die Tabellenk&ouml;pfe verwendet.)
*'''array1''' and '''array2''' (Diese beiden Designs werden abwechselnd verwendet, wenn ein Antwortbereich zur Auswahl steht.  Diese Einstellung erlaubt einen abwechselnden Hintergrund für jede Antwort. '''Array1''' wird bei diesen Fragen auch für die Tabellenköpfe verwendet.)
*'''errormandatory''' (Definiert die Farbe und das Design der Meldung "Bitte beantworten Sie diese Frage" bei Pflichtangaben.
*'''errormandatory''' (Definiert die Farbe und das Design der Meldung "Bitte beantworten Sie diese Frage" bei Pflichtangaben.
*'''warningjs''' (Setzt die Farbe und das Design der angezeigten Warnmeldungen, wenn der Anwender einen Browser ohne Javascript-Unterstützung verwendet.
*'''warningjs''' (Setzt die Farbe und das Design der angezeigten Warnmeldungen, wenn der Anwender einen Browser ohne Javascript-Unterstützung verwendet.
Line 143: Line 143:
Ein Beispiel dafür, wie diese Klassen verwendet werden, kann in der Bubblegum-Vorlage gefunden werden, welche auf der LimeSurvey-Webseite zur Verfügung steht.
Ein Beispiel dafür, wie diese Klassen verwendet werden, kann in der Bubblegum-Vorlage gefunden werden, welche auf der LimeSurvey-Webseite zur Verfügung steht.


Da alle HTML-Formatierungsm&ouml;glichkeiten genutzut werden k&ouml;nnen, besteht keine Veranlassung die Vorlagen mit einem <div class='new_name'> zu versehen und diese new_name-Klasse dann über eine eigene CSS-Datei zu formatieren.
Da alle HTML-Formatierungsmöglichkeiten genutzut werden können, besteht keine Veranlassung die Vorlagen mit einem <div class='new_name'> zu versehen und diese new_name-Klasse dann über eine eigene CSS-Datei zu formatieren.


====Fragen gestalten====
====Fragen gestalten====


Seit der Version 1.80 ist es m&ouml;glich, das grundsätzliche Layout der Fragen über CC zu gestalten. Hierzu gibt es weitergehende M&ouml;glichkeiten unter [http://docs.limesurvey.org/tiki-index.php?page=Template%20editor#Styling_questions_in_LimeSurvey_1.8 Templates/The Template Editor -> Styling questions in Limesurvey 1.8]
Seit der Version 1.80 ist es möglich, das grundsätzliche Layout der Fragen über CC zu gestalten. Hierzu gibt es weitergehende Möglichkeiten unter [http://docs.limesurvey.org/tiki-index.php?page=Template%20editor#Styling_questions_in_LimeSurvey_1.8 Templates/The Template Editor -> Styling questions in Limesurvey 1.8]


===Andere Vorlagendateien===
===Andere Vorlagendateien===


Bei der Datei chart.jpg handelt es sich um eine kleine 1-Pixel-Bilddatei, über welche der Fortschrittsbalken innerhalb der Fortschrittstabelle gebildet wird. Wenn diese Datei im jeweiligen Vorlagenverzeichnis nicht zur Verfügung steht, wird LimeSurvey die eigene kastanienbraune Standard-Datei aus dem &ouml;ffentlichen Verzeichnis verwenden. Soll ein Fortschrittbalken in einer eigenen Farbe dargestellt werden, sollte diese Farbe also in dieer Datei gespeichert werden. Hierbei ist zu beachten, dass es sich um eine  '''JPEG''' file, 1 pixel x 1 pixel, in der gewünschten Farbe handeln muss.
Bei der Datei chart.jpg handelt es sich um eine kleine 1-Pixel-Bilddatei, über welche der Fortschrittsbalken innerhalb der Fortschrittstabelle gebildet wird. Wenn diese Datei im jeweiligen Vorlagenverzeichnis nicht zur Verfügung steht, wird LimeSurvey die eigene kastanienbraune Standard-Datei aus dem öffentlichen Verzeichnis verwenden. Soll ein Fortschrittbalken in einer eigenen Farbe dargestellt werden, sollte diese Farbe also in dieer Datei gespeichert werden. Hierbei ist zu beachten, dass es sich um eine  '''JPEG''' file, 1 pixel x 1 pixel, in der gewünschten Farbe handeln muss.


Die '''privacy.pstpl''', '''invitationemail.pstpl''', '''reminderemail.pstpl''' and '''confirmationemail.pstpl''' werden nicht weiter von LimeSurvey verwendet und die Standardtexte werden stattdessen in der jeweiligen Sprachdatei abgelegt. Die eMail-Nachrichten k&ouml;nnen mittlerweile pro Umfrage individuell gestaltet werden.
Die '''privacy.pstpl''', '''invitationemail.pstpl''', '''reminderemail.pstpl''' and '''confirmationemail.pstpl''' werden nicht weiter von LimeSurvey verwendet und die Standardtexte werden stattdessen in der jeweiligen Sprachdatei abgelegt. Die eMail-Nachrichten können mittlerweile pro Umfrage individuell gestaltet werden.


===erweiterte M&ouml;glichkeiten für Entwickler===
===erweiterte Möglichkeiten für Entwickler===


Beginnend mit der Version 0.99 wurden einige Patches von Anwendern in LimeSurvey integriert, die einige spezielle &Auml;nderungen erm&ouml;glichen. Diese sehr fortgeschrittenen Funktionen ben&ouml;tigen meistens &Auml;nderungen des zugrundliegenden Codes und sollten daher mit Vorsicht eingesetzt werden, um keine Sicherheitsl&ouml;cher zu erstellen.
Beginnend mit der Version 0.99 wurden einige Patches von Anwendern in LimeSurvey integriert, die einige spezielle &Auml;nderungen ermöglichen. Diese sehr fortgeschrittenen Funktionen benötigen meistens &Auml;nderungen des zugrundliegenden Codes und sollten daher mit Vorsicht eingesetzt werden, um keine Sicherheitslöcher zu erstellen.


====Grundsätzliche Integrationsm&ouml;glichkeiten in bestehende CMS====
====Grundsätzliche Integrationsmöglichkeiten in bestehende CMS====


Um LimeSurvey in ein anderes CMS zu integrieren, müssen die folgenden Optionen in der '''config.php''' angepasst werden:
Um LimeSurvey in ein anderes CMS zu integrieren, müssen die folgenden Optionen in der '''config.php''' angepasst werden:
Line 183: Line 183:
====Unterstützung für eigene Javascript-Anwendungen====
====Unterstützung für eigene Javascript-Anwendungen====


Einige Anwender ben&ouml;tigen eigene Javascript-Anwendungen auf ihren Umfrageseiten. aber der Aufruf von '''checkconditions()''' im Body-Element verhindert dies effektiv. Dieser Aufruf wurde ersetzt durch eine kleine Javascript-Funktion im Head, welche den Aufruf von '''checkconditions()''' und '''template_onload()''' sucht, bevor die jeweilige Funktion aufgerufen wird. Auf diesem Weg erhält der Vorlagengestalter die M&ouml;glichkeit eine eigene '''template_onload()''' Funktion im HEAD zu erstellen, welches die Standardfunktion ersetzt.
Einige Anwender benötigen eigene Javascript-Anwendungen auf ihren Umfrageseiten. aber der Aufruf von '''checkconditions()''' im Body-Element verhindert dies effektiv. Dieser Aufruf wurde ersetzt durch eine kleine Javascript-Funktion im Head, welche den Aufruf von '''checkconditions()''' und '''template_onload()''' sucht, bevor die jeweilige Funktion aufgerufen wird. Auf diesem Weg erhält der Vorlagengestalter die Möglichkeit eine eigene '''template_onload()''' Funktion im HEAD zu erstellen, welches die Standardfunktion ersetzt.


====&Auml;ndern der Ampelanzeige der Vorlagengestaltung von rot nach grün====
====&Auml;ndern der Ampelanzeige der Vorlagengestaltung von rot nach grün====

Revision as of 00:03, 3 May 2013

Message definition (Theme editor)
==Creating a new theme==

Damit man über die LimeSurvey Oberfläche eine bestehende Vorlage editieren oder in eine neue kopieren kann, benötigt man zunächst das Benutzerrecht Vorlagen zu editieren. LimeSurvey selbst benötigt natürlich Schreibrechte für das Vorlagenverzeichnis auf dem Server. Ist eines dieser Rechte nicht gesetzt, kann die Vorlage nicht über LimeSurvey angepasst werden. In diesem Fall muss man die Dateien beispielsweise per FTP herunterladen und mit geeigneter Software ändern. Eine Änderung an einer Vorlage kann unter Umständen alle gespeicherten Befragungen betreffen, daher sollten die Designanpassungen von Leuten übernommen werden, die das grundsätzliche Konzept und den genutzen Code von LimeSurvey verstehen. Die Gestaltung der Vorlagen stellen schon eine fortgeschrittene Aufgabe dar und kann einige Zeit in Anspruch nehmen, wenn man mit HTML-Code nicht wirklich viel anfangen kann.

Speicherort der Vorlagendateien

LimeSurvey unterscheidet bei Vorlagen zwischen Standardvorlagen und Eigenen Vorlagen.

Standardvorlagen sind Vorlagen die bereits in der LimeSurvey-Installation mitgeliefert werden. Sie

befinden sich im templates Verzeichnis in einem Ordner der den Namen der entsprechende Vorlage trägt. Um eine Standard-Vorlage zu editieren sollte jene mit dem Vorlagen-Editor kopiert werden um so aus der Standardvorlage eine Eigene Vorlage zu erstellen.

Eigene Vorlagen sind von einem Benutzer der LimeSurvey-Software kopierte Standard-Vorlagen oder  importierte Vorlagen in Form einer zip-Datei. Sie befinden sich im Verzeichnis upload/templates in einem Ordner der den Namen der entsprechende Vorlage trägt.

Beispiele: Installation in C:\xampp\htdocs\limesurvey\

- Standardvorlage citronade: Im Ordner C:\xampp\htdocs\limesurvey\templates\citronade\

- Eigene Vorlage MyCompanyTempl: Im Ordner  C:\xampp\htdocs\limesurvey\upload\templates\citronade\

Alle Bilddateien , die über das Template Management der LimeSurvey-Administration in den Vorlagenbereich kopiert werden, können über folgende Syntax eingebunden werden:

Code

{TEMPLATEURL}filename.xyz

Vorlagendateien

Die folgenden Dateien werden verwendet um eine öffentliche Umfrage zu erstellen und müssen daher in jeden Vorlagenordner enthalten sein:

  • startpage.pstpl: Mit den Informationen aus diese Datei wird jede HTML-Seite eröffnet. Sie beginnt bei dem "<head>"-Tag und sollte keine "<html>"-Tags enthalten  Die allerersten Zeilen einer HTML-Seite werden von den Skripten generiert. Es ist sicherzustellen, dass die startpage.pstpl-Dateien einen "<body>"-Tag enthält, wenngleich viele Browser nicht auf strikte W3C-Konformität angewiesen sind. LimeSurvey hält sich jedoch an die W3C-Regeln und erwartet daher einen "<body>"-Tag, um verschiedene Javascript-Elemente ausführen zu können. Es ist nicht zu erwarten, das besonders viele Platzhalter in der startpage.pstpl-Datei verwendet werden, aber es bietet sich an {SURVEYNAME} für den Titel zu verwenden. Die startpage.pstpl kann Code enthalten, der in der dazugehörigen endpage.pstpl geschlossen wird, man kann also hier eine Tabelle öffnen und sie in der endpage.pstpl schließen. Die startpage.pstpl- und die endpage.pstpl-Dateien umfassen also alle möglichen Seiten, die von LimeSurvey genutzt werden.
  • survey.pstpl: Diese Vorlage ist die zweite Datei, die auf den meisten Seiten genutzt wird und bietet einen Raum, in dem der Umfragenname und die Beschreibung Platz finden. Diese Datei hat kein abschließendes Gegenstück, daher sollten alle Tags geschlossen werden (also beispielsweise keine Tabellen geöffnet lassen, wie man es in der startpage.pstpl machen kann)
  • welcome.pstpl: Diese Vorlagendatei wird ausschließlich auf der Willkommenseite eingebunden (was allerdings gleichzeitig die Hauptseite der "All-in-One"-Umfragen ist. Diese Datei kann genutzt werden, um die Willkommensnachricht und andere Informationen, die in der Einführung enthalten sind, auszudrucken. Genau wie bei der survey.pstpl existiert kein schließendes Gegenstück, daher müssen ebenfalls alle Tags abgeschlossen werden.
  • startgroup.pstpl: Diese Vorlage kann eine Zusammenfassung für die in einer Gruppe zusammengestellten Fragen beinhalten. Diese Datei hat eine passende engroup.pstpl-Datei, Tags können daher geöffnet bleiben.
  • groupdescription.pstpl: Diese Vorlagendatei wird verwendet um eine Beschreibung einer Gruppe zur Verfügung zu stellen. Sie wurde von der startgruop.pstpl gelöst, da die Beschreibung in einer "Frage-für-Frage"-Umfrage zwischen den einzelnen Fragen auf einer eigenen Seite zur Verfügung gestellt wird, während die Inhalte bei einer "Gruppe-für-Gruppe"- oder "All-in-One"-Umfrage als Überschrift zu der jeweiligen Frage fungiert. groupdescription.pstpl hat keine abschließene Gegendatei, daher sollten alle Tags geschlossen werden.
  • question.pstpl: Diese Datei besteht aus den den Fragen, Antworten und Hilfetexten der Umfrage, in der "Gruppe-für-Gruppe"- und "All-in-One"-Umfrage wird der Inhalt dieser Vorlage mit jeder Frage wiederholt. Es existiert keine dazugehörige Vorlage, die geöffnete Tags abschließen könnte, daher sollten alle Tags geschlossen werden.
  • question_start.pstpl: Diese Datei beinhaltet die individuellen Elemente, die am Anfang einer Frage gefunden werden. Der Inhalt wird über den Platzhalter {QUESTION} in die question.pstpl eingebunden. Diese Vorlage soll Designern weitergehende Kontrollmöglichkeiten über das Layout einer Frage gewähren. Diese Vorlagendatei liegt außerhalb des normalen Vorlagensystems und wurde mit der Version LimeSurvey 1.87 abgelöst. Alle Schlüsselwörter dieser Vorlage sind mittlerweile direkt in der question.pstpl ansprechbar. Anmerkung: Umfragen, die die Vorlage question_start.pstpl verwenden, werden zumindest noch einige Versionsnnummern von LimeSurvey 1.x lauffähig sein.
  • submit.pstpl (and privacy.pstpl): Diese Seite ist die vorletzte Seite jeder Umfrage (ausgenommen der "All-in-One"-Umfrage), auf der dem Teilnehmer die Möglichkeit gegeben wird, seine Antworten noch einmal zu überprüfen, bevor er die Umfrage abschließt und die Ergebnisse verschickt. Sofern es sich um eine anonyme Umfrage handelt, werden die Hinweise zum Datenschutz aus der privacy.pstpl-Vorlage eingebunden.
  • completed.pstpl: Diese Seite wird als Abschlusseite angezeigt, sobald die Antworten gespeichert und die Umfrage beendet ist. Diese Vorlage kann verwendet werden, um den Teilnehmer über einen "Forwarding Link" auf eine andere Seite weiterzuleiten.
  • endgroup.pstpl: Diese Datei schließt eine Fragengruppe und kann verwendet werden, um in der startgroup.pstpl geöffnete Tags abzuschließen.
  • navigator.pstpl: Diese Vorlagendatei enthält die Navigationselemente, über die man durch die Umfrage navigieren kann, "weiter", "zurück", "Zwischengespeicherte Umfrage laden", "absenden", "später fortfahren" und "Umfrage verlassen und löschen"

Seitenstruktur / Vorlagennutzung

  • The Welcome Page: startpage.pstpl, welcome.pstpl, navigator.pstpl, endpage.pstpl
  • The Questions Pages: startpage.pstpl, survey.pstpl, startgroup.pstpl, groupdescription.pstpl, question.pstpl, endgroup.pstpl, navigator.pstpl, endpage.pstpl
  • The Submit Page: startpage.pstpl, survey.pstpl, submit.pstpl, (privacy.pstpl), navigator.pstpl, endpage.pstpl
  • The Final Page: startpage.pstpl, completed.pstpl, endpage.pstpl

Schlüsselwörter / Platzhalter

Platzhalter innerhalb einer Vorlage werden zur Laufzeit mit den Informationen der jeweiligen Umfrage ersetzt. Sie werden in geschweifte Klammern gesetzt, so z.B: {SURVEYNAME}

Grundsätzlich können alle Platzhalter in allen Vorlagen verwendet werden, allerdings werden schlicht keine Inhalte angezeigt, wenn das Skript zu diesem Zeitpunkt noch keine Inhalte zur Anzeige hervorgebracht hat. Das bedeutet zum Beipsiel, dass es sinnlos wäre, in der startpage.pstpl den Platzhalter {QUESTION} zu verwenden, da em Skript zu diesem Zeitpunkt noch keine Fragen bekannt sind.

Die folgende Tabelle beinhaltet die verwendbaren Platzhalter, sowie die Vorlagendateien, in denen sie funktionieren.

Platzhalter
Vorlagen-Datei
Beschreibung
{SURVEYNAME} Alle Dateien Titel der Umfrage
{SURVEYDESCRIPTION} Alle Dateien Beschreibung der Umfrage
{PERCENTCOMPLETE} survey.pstpl Ein kleiner Graph, der den Fortschritt der Umfrage anzeigt
{WELCOME} Alle Dateien (hauptsächlich für welcome.pstpl) Die Willkommensnachricht der Umfrage
{NUMBEROFQUESTIONS} welcome.pstpl Zeigt die Gesamtanzahl der Fragen an (ausschließlich die Anzahl)
{THEREAREXQUESTIONS} welcome.pstpl Anzeige des Satzes "Diese Umfrage enthält X Fragen." aus der jeweiligen Sprachdatei. Das X wird zur Laufzeit durch die tatsächliche Anzahl der Fragen ersetzt. Hierbei ist beachten, dass LimeSurvey Singular und Plural unterscheidet.
{CHECKJAVASCRIPT} Alle Dateien (hauptsächlich für welcome.pstpl) Warnmeldung, wenn der Browser kein Javascript unterstützt.
{GROUPNAME} startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl Anzeige der aktuellen Fragengruppe
{GROUPDESCRIPTION} startgroup.pstpl, groupdescription.pstpl, endgroup.pstpl Anzeige der Beschreibung der aktuellen Fragengruppe
{QUESTION} question.pstpl Dieser Platzhalter wurde mit der Version 1.87 abgelöst, ist aber nach wie vor verwendbar. Anzeige des Textes der aktuellen Frage. Das Format von {QUESTION} kann über die question.pstpl angepasst werden. Dier folgenden Platzhalter können anstelle von {QUESTION} verwendet und mit passendem HTML-Code formatiert werden:{QUESTION_TEXT},{QUESTION_MANDATORY}, {QUESTION_HELP}, {QUESTION_MAN_MESSAGE}, {QUESTION_VALID_MESSAGE} and {QUESTION_INPUT_ERROR_CLASS}
{ANSWER} question.pstpl Anzeige der Antwort der aktuellen Frage
{QUESTIONHELP} question.pstpl Zeigt den Hilfetext der aktuellen Frage an
{QUESTION_CLASS} question.pstpl eindeutige Klasse für jeden Fragentyp. (Wird in den die jeweilige Frage umfassenden Tag eingebunden)
{QUESTION_CODE} question.pstpl Zeigt den Code der aktuellen Frage an
{QUESTION_ESSENTIALS} question.pstpl die ID der aktuellen Frage und - sofern es sich um eine Frage mit Bedingungen handelt - 'style="display:none;"'(Wird in den die jeweilige Frage umfassenden Tag eingebunden)
{QUESTION_HELP} question.pstpl, question_start.pstpl Zeigt den benutzerdefinierten Hilfetext zu der aktuellen Frage
{QUESTION_INPUT_ERROR_CLASS} question.pstp, question_start.pstpl Bietet eine Klasse, wenn der Teilnehmer einen Eingabefehler gemacht hat.
{QUESTION_TEXT} question.pstpl, question_start.pstpl Anzeige des Fragetextes der aktuellen Frage
{QUESTION_MANDATORY} question.pstpl, question_start.pstpl Zeigt den Ausgabetext für Pflichtangaben der jeweiligen Sprachdate an
{QUESTION_MAN_CLASS} question.pstpl Klasse für Pflichtangaben (Wird in den die jeweilige Frage umfassenden Tag eingebunden)
{QUESTION_MAN_MESSAGE} question.pstpl, question_start.pstpl Anzeige des Hilfetextes für Pflichtangaben aus der jeweiigen Sprachdatei.
{QUESTION_VALID_MESSAGE} question.pstpl, question_start.pstpl Anzeige des gültigen Hilfetextes der aktuellen Frage aus der jeweiligen Sprachdatei.
{NAVIGATOR} navigator.pstpl Anzeige der Navigationselemente (weiter, zurück, später fortfahren)
{CLEARALL} Alle Dateien (ist aber gedacht für navigator.pstpl) Anzeige des "Umfrage verlassen und Löschen"-Links
{SUBMITBUTTON} submit.pstpl Anzeige des abschließenden "Absenden"-Buttons.
{COMPLETED} completed.pstpl Anzeige der Abschlussmeldung
{url} completed.pstpl Anzeige der Umfrage-'url' und des 'url text'
{PRIVACY} submit.pstpl Anzeige der Datenschutzhinweise bei anonymen Umfragen
{TEMPLATEURL} Alle Dateien Wird durch die http://-Adresse ersetzt, auf der sich die Umfrage befindet.Dieser Platzhalter kann verwendet werden um z.B. Bilder in die Vorlage einzubinden, z.B. anstatt: <img src='http://your.domain.com/surveyor/templates/mytemplate/me.jpg'> |- |kann <img src='{TEMPLATEURL}me.jpg'> verwendet werden. Hierbei ist zu beachten, dass dieser Platzhalter auch den / bereits beinhaltet.
{SAVE} Alle Dateien (gedacht für navigator.pstpl) Anzeige des "Später Fortfahren"-Buttons, um dem Teilnehmer die spätere Fortsetzung der Umfrage zu ermöglichen. Sollte die Speichern-Funktion in der Umfrage deaktiviert sein, wird dieser Platzhalter ignoriert und nicht angezeigt.
{LANGUAGECHANGER} survey.pstpl Anzeige für den Wechsel der Sprache.

CSS / Cascading Style Sheets

Jedem Eingabetyp wird in der Umfrage eine eigene Klasse zugewiesen, daher kann CSS über die startpage.pstpl hinzugefügt werden. Auf diesem Weg kann das Aussehen der Buttons und Eingaben gesteuert werden. Die folgenden Namen werden dabei für die Klassen verwendet:

  • submit (Versenden-Buttons)
  • text (Texteingaben - für kurze Freitextfelder, Datumseingaben und numerische Eingaben)
  • answertext (Antworttexte)
  • radio (Radio-Buttons)
  • checkbox (Checkboxen)
  • select (Auswahl- / List-Boxen)
  • textarea (Texteingaben - für große Freitextfelder)
  • clearall (Der "Umfrage verlasssen und löschen"-Link)
  • rank (für die Ranglistenfragen.Hierbei wird nicht die Farbe der ausgewählten Box definiert (dies wird mit den obenstehenden Klassen abgedeckt), sondern erlaubt die Formatierung der Hintergrundfarbe, Textfarbe und -Größe, etc. für den Rest der Ranglistenfrage.
  • graph (Die Anzeige des Fortschrittbalkens)
  • innergraph (Die Tabellle innerhalb des Fortschrittbalkens - diese beinhaltet den 0% and 100% Text. Hiermit kann die Größe des Textes definiert werden.
  • question (Grundsätzliche Einstellungen für alle Fragen, die in einer Tabelle dargestellt werden. Diese Einstellung wird verwendet um sicherzustellen, dass die Farbe und Größe zu den übrigen Eingabefeldern passt, die an anderer Stelle formatiert werden.
  • mandatory  (Pflichtfragen)
  • input_error (Eingabefehler des Benutzers - falls der Teilnehmer einen Fehler bei einer Pflichtangabe oder bei einer Frage mit definierten Antworten gemacht hat)
  • array1 and array2 (Diese beiden Designs werden abwechselnd verwendet, wenn ein Antwortbereich zur Auswahl steht.  Diese Einstellung erlaubt einen abwechselnden Hintergrund für jede Antwort. Array1 wird bei diesen Fragen auch für die Tabellenköpfe verwendet.)
  • errormandatory (Definiert die Farbe und das Design der Meldung "Bitte beantworten Sie diese Frage" bei Pflichtangaben.
  • warningjs (Setzt die Farbe und das Design der angezeigten Warnmeldungen, wenn der Anwender einen Browser ohne Javascript-Unterstützung verwendet.

Ein Beispiel dafür, wie diese Klassen verwendet werden, kann in der Bubblegum-Vorlage gefunden werden, welche auf der LimeSurvey-Webseite zur Verfügung steht.

Da alle HTML-Formatierungsmöglichkeiten genutzut werden können, besteht keine Veranlassung die Vorlagen mit einem

zu versehen und diese new_name-Klasse dann über eine eigene CSS-Datei zu formatieren.

Fragen gestalten

Seit der Version 1.80 ist es möglich, das grundsätzliche Layout der Fragen über CC zu gestalten. Hierzu gibt es weitergehende Möglichkeiten unter Templates/The Template Editor -> Styling questions in Limesurvey 1.8

Andere Vorlagendateien

Bei der Datei chart.jpg handelt es sich um eine kleine 1-Pixel-Bilddatei, über welche der Fortschrittsbalken innerhalb der Fortschrittstabelle gebildet wird. Wenn diese Datei im jeweiligen Vorlagenverzeichnis nicht zur Verfügung steht, wird LimeSurvey die eigene kastanienbraune Standard-Datei aus dem öffentlichen Verzeichnis verwenden. Soll ein Fortschrittbalken in einer eigenen Farbe dargestellt werden, sollte diese Farbe also in dieer Datei gespeichert werden. Hierbei ist zu beachten, dass es sich um eine  JPEG file, 1 pixel x 1 pixel, in der gewünschten Farbe handeln muss.

Die privacy.pstpl, invitationemail.pstpl, reminderemail.pstpl and confirmationemail.pstpl werden nicht weiter von LimeSurvey verwendet und die Standardtexte werden stattdessen in der jeweiligen Sprachdatei abgelegt. Die eMail-Nachrichten können mittlerweile pro Umfrage individuell gestaltet werden.

erweiterte Möglichkeiten für Entwickler

Beginnend mit der Version 0.99 wurden einige Patches von Anwendern in LimeSurvey integriert, die einige spezielle Änderungen ermöglichen. Diese sehr fortgeschrittenen Funktionen benötigen meistens Änderungen des zugrundliegenden Codes und sollten daher mit Vorsicht eingesetzt werden, um keine Sicherheitslöcher zu erstellen.

Grundsätzliche Integrationsmöglichkeiten in bestehende CMS

Um LimeSurvey in ein anderes CMS zu integrieren, müssen die folgenden Optionen in der config.php angepasst werden:

// Set $embedded to true and specify the header and footer functions if the survey is to be displayed embedded in a CMS

// $embedded wird auf true gesetzt und header footer Funktionen werden definiert, wenn die Umfrage in einem CMS eingebettet werden soll. 


$embedded = false;

$embedded_inc = "";               // path to the header to include if any

$embedded_headerfunc = "";        // e.g. COM_siteHeader for geeklog

$embedded_footerfunc = "";        // e.g. COM_siteFooter for geeklog

Die Einstellung $embedded = true; muss definiert wernden, wenn LimeSurvey in ein CMS eingebettet werden soll. Mit der Nutzung der $embedded_inc Variablen kann man seine eigenen .php Dateien integrieren. Mit dem Setzen von $embedded_headerfunc oder $embedded_footerfunc, kann man Funktionen aufrufen, die sich in inegrierten PHP-Dateien befinden und so die Ausgabe des Headers und Footers anstelle von LimeSurvey steuern.

Unterstützung für eigene Javascript-Anwendungen

Einige Anwender benötigen eigene Javascript-Anwendungen auf ihren Umfrageseiten. aber der Aufruf von checkconditions() im Body-Element verhindert dies effektiv. Dieser Aufruf wurde ersetzt durch eine kleine Javascript-Funktion im Head, welche den Aufruf von checkconditions() und template_onload() sucht, bevor die jeweilige Funktion aufgerufen wird. Auf diesem Weg erhält der Vorlagengestalter die Möglichkeit eine eigene template_onload() Funktion im HEAD zu erstellen, welches die Standardfunktion ersetzt.

Ändern der Ampelanzeige der Vorlagengestaltung von rot nach grün

Sofern noch nicht geschehen, bitte die Verzeichnisrechte des Admin-Verzeichnisses aus lesen/schreiben/ausführen setzen (chmod 755).

Wechsele über den Dateimanager in das Vorlagenverzeichnis.

1 Ändere die Berechtigung, z.B. für die Vorlage "vallendar"  (oder irgendeiner anderen Vorlage deiner Wahl)auf 777

2 voila! die rote Ampelanzeige für "vallendar" ist nun grün.

3 Anmerkung: Um keine Sicherheitsrisiken einzugehen sollte die Berechtigung für das Verzeichnis (und alle anderen Vorlagen) nach der Vorlagengestaltung wieder auf den ursprünglichen Wert gesetzt werden, z.b. 644.

Retrieved from "http://manual.limesurvey.org/index.php?title=Translations:Theme_editor/12/de&oldid=22812"