Mit diesem Codepaket können durch eine einfache Methode Platzhalter mit komplexen Inhalten ersetzt werden. Für jeden Platzhalter wird in PHP ein Event ausgelöst welches den Ersatztext für diesen Platzhalter ermitteln soll.

Definition und Austausch von Platzhaltern

Platzhalter welche von diesem Codepaket ausgetaucht werden sollen, müssen innerhalb von zwei geschweiften Klammern eingeschlossen sein. Es können beliebig viele Platzhalter in einem Text platziert werden.

... {{ [Platzhalterdefinition] }} ...

Auf diese Weise definierte Texte können mithilfe des nachfolgenden Codes bearbeitet werden um die Platzhalter mit ihren echten Werten auszutauschen.

use Brandbox\Framework\Brandbox\Placeholder;

// Variablen welche dem Platzhaltercode zur Verfügung stehen
$context = [
    'something' => 'strange',
    'person' => [
        'firstname' => 'Max',
        'lastname' => 'Mustermann',
    ],
];

$source = 'Das ist ein Beispieltext mit einem {{ [Platzhalterdefinition] }!';

$content = $this
    ->staticController(Placeholder\Manager::class)
    ->get($source, $context)
;

// $content enthält nun den Text aus $source mit ersetztem Platzhalter

Verfügbare Platzhalter und Variablen

Manchen Platzhaltern können Variablen mitgegeben werden um bspw. den Inhalt für den Platzhalter zu definieren. Diese Variablen können als array oder object der Manager-Methode aus dem o.g. Beispiel mitgegeben werden. Die Variablen werden dann innerhalb eines Platzhalters mit ihren Namen oder Indexen aus dem Kontext angesprochen. Verschachtelte Informationen werden mit einem Punkt (.) getrennt. Neben den Variablen können auch statische Parameter gesetzt werden. Ein string muss in Anführungszeichen (") eingeschlossen werden, true und false werden als boolean interpretiert und Zahlen als integer oder float.

Platzhalterdefinition Beschreibung

{{ i18n=[Variable oder Parameter] }} Versucht die übergebene Variable oder Parameter mithilfe des TranslatationManager zu übersetzen. Der Parameter oder die Variable müssen hierzu dem Format Paketname.Übersetzungsidentifikator entsprechen.

{{ output=[Variable oder Parameter] }} Gitb die überbene Variable ohne eine Veränderung aus.

{{ readable=[Variable oder Parameter] }} Versucht die übergebene Variable mithilfe von Brandbox/Casting in einen menschenlesbares Format zu bringen. Hierzu muss die Variable innerhalb eines Objektes sein welches das EntityInterface von Brandbox/Dbal implementiert.

{{ number=[Variable oder Parameter] }}

Formatiert die übergebene Variable oder Parameter als Zahl unter berücksichtigung der aktuellen Sprache und des Landes. Es können nachfolgende Optionen übergeben werden um die Formatierung zu beeinflussen.

Optionsname	Beschreibung
`style`	Legt die Art der Formatierung fest. Es kann zwischen `decimal`, `currency`, `percentage` und `scientific` gewählt werden.
`decimals`	Legt die Anzahl der Nachkommastellen fest. Falls nicht angegeben werden keine Nachkommastellen dargestellt.
`zerofill`	Falls diese Option festgelegt wurde und die übergebene Zahl 0 ist, wird der Platzhalter mit dem Wert dieser Option ersetzt.
`currency`	Definiert den ISO-Währungscode der für die `currency`-Formatierung genutzt wird. Falls diese Option nicht gesetzt wurde, wird der Währungscode aus dem aktuellen Land bezogen.
`decimal_zerofill`	Ähnlich zu `zerofill`, allerdings werden nur die Nachkommastellen ersetzt.

Pogrammatische Erweiterung

Dieses Codepaket stellt die folgenden Events zur Verfügung um das Verhalten zu beeinflussen:

Eventname	Beschreibung
`OnPopulatePlaceholder`	Wird für jede Stelle innerhalb des `$source`-Parameters ausgelöst, welche innerhalb von geschweiften Klammern (`{{ ... }}`) eingeschlossen ist.

Platzhalter (Brandbox/Placeholder)

Definition und Austausch von Platzhaltern

Verfügbare Platzhalter und Variablen

Pogrammatische Erweiterung