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 Pixeln (optional).
• Höhe
  Die Höhe des Pop-Up-Fensters in Pixeln (optional).

Hinweis: Die Funktion erstellt den Link nur. Sie müssen den Link anschließend noch mittels html() oder 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: Informationen per Mausklick einblenden

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.

// 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>');

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

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

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.

replace('%link%', textlink('explanation', 'hier'), 'html');

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

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

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

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