getTextElement()

Die Funktion getTextElement() liefert den Inhalt eines Textes (Textbaustein oder Text im Fragenkatalog) als String.

Der optionale zweite Parameter kann entweder (nur) das Ausgabeformat festlegen oder zusätzliche Einstellungen und Platzhalter vorgeben.

string getTextElement(string TextKennung, [string Ausgabeformat])

string getTextElement(string TextKennung, array Einstellungen)

• TextKennung
  Kennung des Textbausteins, dessen Inhalt zurückgegeben werden soll.
• Ausgabeformat
  Optional können Sie ausgeben, in welchem Format der Inhalt zurückgegeben wird.
  • 'block' → (Standard) HTML-Code im Blockelement (mit Abständen und Ausrichtung)
  • 'html' → Nur der eigentliche Inhalt als HTML-Code
  • 'plain' → Unformatierter Text mit Zeilenumbrüchen
• Einstellungen
  Optional können Einstellungen und Platzhalter definiert werden
  • 'format' → Ausgabeformat wie oben
  • '%key%' → Platzhalter, welche im Textbaustein vor der Ausgabe ersetzt werden

Hinweis: Falls der Textbaustein mit Titel und/oder Formatierung im Fragebogen ausgegeben wird, so ist auch dies im HTML-Code enthalten. Nicht enthalten sind allerdings eine eventuelle Ausrichtung (links/mittig/rechts/Blocksatz) sowie Abstand unter dem Textbaustein.

Im folgenden Beispiel wird einer von 2 Textbausteinen („desc1“ oder „desc2“) per Platzhalter in einen dritten Platzhalter („description“) eingebunden. Der dritte Textbaustein muss dabei den Platzhalter %desc% enthalten.

if (value('AB01_01') == 1) {
  $desc = getTextElement('desc1', 'html');
} else {
  $desc = getTextElement('desc2', 'html');
}
replace('%desc%', $desc);
text('description');

Im folgenden Beispiel wird jedes „a“ und jedes „A“ durch einen Unterstrich ersetzt und der Textbaustein anschließend angezeigt.

$content = getTextElement('priming');
$out = str_replace(array('a','A'), '_', $content);
html($out);

Hier wurde ein Text TX01 mit der Dartellung „HTML-Code“ definiert, welcher mehrere Platzhalte beinhaltet:

<div id="teaser%num%" style="border: 1px solid #AAAAAA; border-radius: 0.5em; padding: 1em; display: flex; flex-direction: row-reverse; gap: 2em; background-color: white; flex-wrap: wrap;">
    <div style="flex: 1 1 30%; text-align: center;">
        <img src="%image%" alt="" style="width: 100%; max-width: 200px;">
    </div>
    <div style="flex: 1 1 250px;">
        <div style="display: flex; gap: 0.6em; margin-bottom: 0.6em; align-items: center;">
            <img src="%source.logo%" style="width: 22px">
            <span>%source.name%</span>
        </div>
        <div style="font-weight: bold; font-size: 125%;">
            %headline%
        </div>
    </div>
</div>

Dieser Textbaustein wird im Fragebogen mehrfach verwendet, und die Platzhalter werden jeweils unterschiedlich gefüllt, z.B.

$html = '<div style="max-width: 600px; margin: 0 auto; display: flex; flex-direction: column; gap: 0.7em; padding: 1em;">';
 
$html.= getTextElement('TX01', [
    '%num%' => 1,
    '%image%' => 'image01.jpg',
    '%source.logo%' => 'source07.png',
    '%source.name%' => '24/4 News',
    '%headline%' => 'Vertreter der ABC zu Gast in Helsinki, schwierige Gespräche erwartet.'
    'format' => 'html'
]);
 
$html.= '</div>';
 
html($html);