~~NOTOC~~

====== textlink() ======

''string **textlink**(string //TextKennung//, mixed //Beschriftung//, [int //Breite//, int //Höhe//])''

Falls ein Text (z.B. eine längere Beschreibung) nicht direkt im Fragebogen gezeigt werden soll, kann sie auch in einem neuen Fenster (Pop-Up) erscheinen. Der Text wird dabei im selben Layout dargestellt wie der Fragebogen.

  * //TextKennung//\\ Die Kennung des Textbausteins, der im Pop-Up-Fenster angezeigt werden soll.
  * //Beschrifung//\\ Die Beschriftung des Hyperlinks (Text oder HTML-Code) zum Öffnen des Pop-Up Fensters.
    * <string> -- Beschriftung unabhängig von der Sprachversion
    * <array> -- Beschriftung je nach Sprachversion. Die Kennung der Sprachversion (z.B. ''"ger"'' oder ''"eng"'') wird als Schlüssel des Arrays verwendet, die eigentliche Beschriftung als zugehöriger Wert.
  * //Breite//\\ Die Breite des Pop-Up-Fensters in [[:de:glossary#pixel|Pixeln]] (optional).
  * //Höhe//\\ Die Höhe des Pop-Up-Fensters in Pixeln (optional).


===== Hinweise =====

**Hinweis:** Die Funktion erstellt den Link nur. Sie müssen den Link anschließend noch mittels ''[[:de:create:functions:text|html()]]'' oder [[:de:create:placeholders|Platzhalter]] im Fragebogen platzieren.

**Hinweis:** Der Text ist unter dem erzeugten Link nur für Benutzer des Fragebogens (Interviewpartner) erreichbar.

**Tipp:** Optional kann angegeben werden, wie groß das neue Fenster dargestellt werden soll. Es ist oft sinnvoll, das Fenster klein zu halten, damit man den Fragebogen weiter im Hintergrund sieht. Wird keine Größe angegeben, so ist die Größe 600 × 500 Pixel voreingestellt.

**Tipp:** Wenn Sie für die Anzeige eines kurzen Textes kein eigenes Fragebogen-Fenster öffnen wollen -- wer weiß, ob der Teilnehmer danach wieder zum Fragebogen zurück findet -- dann lesen Sie folgendes Kapitel: [[:de:create:popup|Informationen per Mausklick einblenden]]


===== Allgemeines Beispiel =====

Für das folgende Beispiel muss zunächst unter **Textbausteine u. Beschriftung** ein neuer Textbaustein mit der Kennung "explanation" angelegt werden. Anschließend wird folgender PHP-Code auf einer Fragebogen-Seite platziert.

<code php>
// HTML-Code für den Link in der PHP-Variable $link speichern
$link = textlink('explanation', 'hier');
// Den Link im Fragebogen anzeigen
html('<p>Bitte klicken Sie '.$link.'</p>');
</code>

Der folgende PHP-Code liefert dasselbe Ergebnis -- nur ein wenig unübersichtlicher.

<code php>
html('<p>Bitte klicken Sie '.textlink('explanation', 'hier').'</p>');
</code>


===== Link als Platzhalter =====

Oftmals ist es einfacher, den Link via Platzhalter im Fragebogen zu platzieren. Folgender PHP-Code wird über einer Frage platziert, die im Frage-Text den Platzhalter ''%link%'' verwendet.

<code php>
replace('%link%', textlink('explanation', 'hier'), 'html');
</code>


===== Größe des Pop-Up steuern =====

Folgender PHP-Code öffnet ein Pop-Up-Fenster in der Größe 640 × 400 Pixel.

<code php>
$link = textlink('explanation', 'Erklärung', 640, 400);
html('<p>Bitte lesen Sie ggf. die '.$link.'</p>');
</code>



===== Mehrsprachige Befragungen =====

Je nach Sprachversion wird als Link entweder "Text nochmal zeigen" oder "Display Text Again" angezeigt.


<code php>
$link = textlink('stimulus', array(
  'ger' => 'Text nochmal zeigen',
  'eng' => 'Display the Text Again'
));
html('<p><strong>'.stimulus.'</strong></p>');
</code>