VAYA Template Engine

Ein WordPress-Plugin, um URL oder POST-Parameter in einer Seite anzeigen zu können

Wenn man Seiten bauen will, die z.B. die Rückgaben von einem externen Formular verwenden, kann man mit diesem Plugin eine einfache Template-Sprache nutzen, um die Anzeige sauber auf die Parameter zu personalisieren.

Die in der URL kodierten Parameter können formattiert werden oder es können Bedingungen ausgewertet werden, die ebenfalls die URL-Parameter berücksichtigen. Damit lassen sich auch komplexe Fallunterscheidungen treffen, um genau passende Texte ausliefern zu können.

Oktopus der URL-Teile in ein Template einsetzt.

Beschreibung der Templatesprache

Alle Textknoten innerhalb von Elementen .vaya-template werden verarbeitet. Dazu muss man nur unter Erweitert unter CSS Klassen die Klasse „vaya-template“ einfügen.

  • Platzhalter:

    • {name}: HTML-escaped Wert aus URL-Parametern oder POST/JSON (Server injiziert als window.vayaTmplData).

    • {name|default}: Default, wenn name fehlt.

    • {name:format} und {name:format|default}: Formatierung.

    • {echo name} und {echo name:format}: wie oben, aber ohne Konflikte mit Schlüsselwort-ähnlichen Namen.

    • {(exp):format}: Formatierung für Ausdruck.

  • Bedingungen:

    • {if <exp>}...{endif}

    • {if <exp>}...{elseif <exp>}...{endif}

    • {if <exp>}...{else}...{endif}

    • {if <exp>}...{elseif <exp>}...{else}...{endif}

Hinweis: Für {<exp>:<format>} muss das Expression-Fragment nicht mit einem Schlüsselwort-ähnlichen Namen beginnen. Verwende daher bevorzugt Klammern, z. B. {(1+2)*3:f2}.

Formate (:format)

Die Formatierung wird im Browser per JavaScript vorgenommen.

Allgemeine Syntax:

  • <type> oder <type><breite>

  • Bei Float zusätzlich optional: <type><breite>.<nachkommastellen>

Wenn eine Breite (Zahl direkt nach der Typekennung) angegeben ist, wird das Ergebnis rechtsbündig in ein Feld dieser Breite gesetzt. Ist das Ergebnis zu lang, wird links abgeschnitten. Ohne Breite wird die volle notwendige Breite ausgegeben.

Bei Float-Formaten mit .n werden genau n Nachkommastellen verwendet. Das Dezimaltrennzeichen ist das der aktuellen Locale (z. B. Komma in de-DE).

Unterstützte Typen:

  • s / str / string: String (Standard)

  • d / int / i: 32-bit Integer

  • f / float: Float

    • ohne .n: variable Nachkommastellen (so viele wie nötig)

    • mit .n: genau n Nachkommastellen (0–20)

Beispiele:

  • {preis:f.2} → 12,30 (Locale de-DE)

  • {preis:f10.2} → rechtsbündig (Breite 10), ggf. links abgeschnitten

  • {(1+2)*3:f0} → 9 (keine festen Nachkommastellen)

  • {name:20} → rechtsbündig (Breite 20)

Hinweis: Zeilenumbrüche innerhalb der {if}-Blöcke sind erlaubt und werden unverändert verarbeitet.

Beispiel

Hier ist ein Beispiel für die Nutzung der Template-Anweisungen, um eine Dankeseite für die FundraisingBox zu erstellen.

{if interval == 0}
{if amount > 500}Riesigen Dank für Ihre großartige{else}Vielen Dank für Ihre{endif} Spende in Höhe von {amount:f.2} €.
{else}
Vielen Dank, dass Sie sich für eine {if interval==1}montaliche{else}{if interval==3}quartalsweise{else}{if interval==6}halbjährliche{else}jährliche{endif}{endif}{endif} Spende in Höhe von {amount:f.2} € entschieden haben.
{endif}

{if covered_fee_amount > 0}Und auch herzlichen Dank, dass Sie die Gebühren übernommen haben.
{endif}

Hier nun das durch Ersetzung entstandene Ergebnis. Dies kann getestet werden, indem man die entsprechenden Parameter an die URL anfügt und die Seite neu aufruft.


Vielen Dank, dass Sie sich für eine jährliche Spende in Höhe von 0.00 € entschieden haben.

Verschlagwortet mit