Textbausteine

Einleitung

Textbausteine ist ein spezieller Inhalts-Typ im Redaktionssystem, der mit der Standardinstallation geliefert wird. Inhalte dieses Inhalts-Typs können als eben jene Textbausteine verwendet werden, wenn Sie beispielsweise wiederkehrende kleinere Texte ausgeben wollen. Im eCMS Backend finden Textbausteine auch vielfach Anwendung. Textbausteine eignen sich auch gut zur Internationalisierung von kleineren textlichen Ausgabe.

Eine Liste der Textbausteine finden Sie im eCMS Backend unter Redaktionssystem > Inhalte > Inhalte nach Inhaltstyp > Textbaustein.

Aufbau

Textbausteine bestehen aus einem eindeutigem String und dem entsprechenden Text.

Text mit Platzhaltern

Innerhalb des Textes von Textbausteinen können Ersetzungsplatzhalter eingebunden werden, die beim Aufruf des Textbausteines z.B. aus einem Frontend mit Daten oder Werten befüllt und damit ersetzt werden können. Ein Ersetzungsplatzhalter kann mit folgendem Syntax in den Text des Textbausteins eingefügt werden:

%mein_platzhalter%

Ein Textbaustein für eine Frontend-Begrüßung könnte folgenden Inhalt haben:

Hallo %benutzer%, herzlich Willkommen!

Bei der Verwendung des Textbausteines könnte dann beispielsweise der Benutzername des eingeloggten Benutzers übergeben und eingesetzt werden. Im Frontend würde dann für den Benutzer Max Mustermann folgender Text erscheinen:

Hallo Max Mustermann, herzlich Willkommen! 

Verwendung

Textbausteine können in Layouten, Formaten, Direkten Inhalten oder in Inhalten des Redaktionssystems eingesetzt werden. Für die Verwendung steht Ihnen das Format eCMS-i18n zur Verfügung, welches Sie in eCMS Elementschreibweise angeben können.

Syntax

Nutzen Sie dafür folgenden Syntax:

${eCMS-i18n:<STRING>}$

Ersetzungsplatzhalter können hierbei auch statisch mit übergeben werden.

${eCMS-i18n:<STRING>(mein_platzhalter1=Wert)}$

oder weitere Ersetzungsplatzhalter durch das Pipe-Zeichen | getrennt.

${eCMS-i18n:<STRING>(mein_platzhalter1=Wert1|mein_platzhalter2=Wert2)}$

Wenn beispielsweise der String zum Text aus dem obigen Beispiel user_welcome heißt, wäre der Aufruf mit statischer Platzhalterersetzung:

${eCMS-i18n:user_welcome(benutzer=Max Mustermann)}$