Documentation

Templates

Templates definieren das Layout einer Frage, also Aussehen und Funktionalität.

Einführung

Es gibt 5 verschieden Template-Typen.

Typ	Beschreibung
Keine Dateneingabe	Das Template enthält keine Eingabemöglichkeit. Sinnvoll für Titel, Überschriften, Erklärungstexte, usw.
Einfach Antwort	Das Template enthält Eingabefelder, die aber nur eine Antwortmöglichkeit zulassen. Beispiele sind: Radiobutton oder Selectbox.
Mehrfach Antwort	Das Template enthält Eingabefelder, die mehrere Antwortmöglichkeiten zulassen. Beispiele sind: Checkboxen oder Selectbox mit mehrfach Option.
Matrix	Das Template enthält Eingabefelder, die mehrere Antwortmöglichkeiten in mehreren Kategorien zulassen.
Text	Das Template enthält ein Freitext Eingabefeld.

Variablen und Befehle

Durch die Einbettung von formgen Befehlen kann man ein Template sehr flexibel gestalten.
Jede Frage enthält die Möglichkeit über das Feld "Variablen" bestimmte Variablen mit Werten zu belegen.
Diese können im Template abgegriffen werden, um dann entsprechende Tags (Abstände, Bilder, Texte) zu
aktivieren.
In den folgenden Tabellen sind die Variablen, die verwendet werden können aufgelistet und erklärt:
Variablen, die sich auf eine Frage beziehen

Variablenname	Bedeutung
questionText1	Fragetext 1
questionText2	Fragetext 2
questionError	'true' falls Fehler in dieser Frage aufgetreten ist
questionErrorText	Enthält den Fehlertext
questionID	Aktuelle QUE_ID
questionIndex	Zähler über die Questions (beginnt bei 0)
questionNum	laufende Nummer der Frage, nicht sichtbare Fragen werden nicht mitgezählt
questionPicture	Enthält den Image Tag, falls für die Frage ein Bild definiert ist
freetext	'true' falls zusätzliche Freitexteingabe möglich (Kompatibilität)
questionFreetext	'true' falls zusätzliche Freitexteingabe möglich
questionInput	'true' falls Pflichteingabefeld

Variablen, die sich auf eine Antwort beziehen

Variablenname	Bedeutung
answerIndex	Zähler über die Answers (beginnt bei 0)
answerNum	laufende Nummer
answerText	Antworttext
answerName	HTML Name des Input Items
answerValue	Wert der Antwort
answerCode	Frei definierbarer Antwortcode
answerGroup	Antwortgruppe
answerPoints	Punkte dieser Antwort
answerChecked	Enthält das Wort “checked“ falls Antwort ausgewählt
answerSelected	Enthält das Wort „selected“ falls Antwort ausgewählt
answerPicture	Enthält den img Tag, falls Bild vorhanden

Variablen, die sich auf eine Matrix-Antwort beziehen

Variablenname	Bedeutung
matrixIndex	Zähler über die Matrix
matrixValue	Wert des Matrixpunktes
matrixName	Matrix Name
matrixGroup	Matrix Gruppe
matrixRating	Matrix Rating

Beispieltemplate: Einfach Antwort mit Reload

<table width="100%" cellpadding=2 cellspacing=2>
  [question picture]
     <tr><td valign="top">[out questionPicture/]</td></tr>
  [/question]
  <tr>
    <td [out bgcol1/] width="100%" valign=top>
       <div class="frage-1">
          [cond questionError]<font class="error">[/cond][out questionText1/]
       </div>
       [if_exists questionText2]<div class="frage-2">[out questionText2/]</div>[/if_exists]
    </td>
  </tr>
  [question answers]
  <tr>
    <td [out bgcol2/] valign=top>
       <div class="antwort-1">
          <input type="radio" name="[out answerName/]" value="[out answerValue/]" [out answerChecked/]
          	onClick="document.formgen.submit()">[out answerText/]
       </div>
    </td>
  </tr>
  [/question]
  [question freetext]
  <tr>
     <td width="100%" [out bgcol2/]>
        <div class="antwort-1">[out freetextlabel/] 
           <input type=text name="[out answerName/]" value="[out answerValue/]" size=30 maxlength=50>    
		</div>
     </td>
  </tr>   
  [/question] 
</table>

Beispieltemplate: Checkbox 2-spaltig

<table width="100%" cellpadding=2 cellspacing=2>
  [question picture]
     <tr><td valign="top">[out questionPicture/]</td></tr>
  [/question]
  <tr>
    <td [out bgcol1/] width=100% valign=top>
       <div class="frage-1">
          [cond questionError]<font class="error">[/cond][out questionText1/] 
       </div>
       [if questionText2]<div class="frage-2">[out questionText2/]</div>[/if]
    </td>
  </tr>
</table>

<table width="100%" cellpadding=2 cellspacing=2>
  [question answers]
  [if answerIndex mod 2==0]
   <tr>
  [/if]
  <td width="50%" [out bgcol2/]>
    <div class="antwort-1">
       <input type=checkbox name="[out answerName/]" value="[out answerValue/]" [out answerChecked/]>
    	[out answerText/]<br>
    </div>
  </td>
  [if answerIndex mod 2==1]
   </tr>
  [/if]
  [/question]
  
  [if answerIndex mod 2==0]
  <td [out bgcol2/] width="50%"> </td>
  </tr>
  [/if]

[question freetext]
  <tr>
     <td width="100%" [out bgcol2/]>
        <div class="antwort-1">[out freetextlabel/] 
           <input type=text name="[out answerName/]" value="[out answerValue/]" size=30 maxlength=50>
        </div>
     </td>
  </tr>   
  [/question]
</table>

Beispiel: Bild mit Größe

[question picture -width 200/]