Der Artikel beschreibt die Verwendung von Platzhaltern mit den Typen 3 bis 5 für Checkboxen und Auswahlfelder in Vorlagen.
Mögliche Typen für eine Checkbox
| typ=3 | Simple Checkbox Yes/No (1/0 |
| typ=4 | Checkbox. Je nach Zustand wird der über checked= bzw. unchecked= festgelegte Wert ausgegeben. |
| typ=5 | Auswahl (Radio-Buttons, Einfachauswahl). Die Optionen werden über values= definiert; ausgegeben wird der Wert der gewählten Option. |
Checkbox mit typ=4
Eine Checkbox gibt je nach Zustand einen von zwei Werten aus:
Einstellung | Beschreibung |
checked=x | Wert, der bei angehakter Checkbox ausgegeben wird (ohne Angabe: 1). |
unchecked=x | Wert, der bei nicht angehakter Checkbox ausgegeben wird (ohne Angabe: leer). |
default=1 | Checkbox ist beim Anlegen des Werbemittels vorangehakt. |
Beispiel — ein zuschaltbarer Rahmen über eine CSS-Klasse (die Klasse
.border definieren Sie im Feld CSS-Code der Vorlage):<div class="%template{typ=4|checked=border|unchecked=|default=1}:Rahmen anzeigen%">...</div>Auch komplette HTML-Elemente sind als Wert möglich, z.B. ein zuschaltbares Störer-Bild:
%template{typ=4|checked=<img src="stoerer.png">|unchecked=}:Störer anzeigen%Achten Sie darauf, dass der Wert in sich abgeschlossen ist (keine offenen Tags wie ein einzelnes
<div ...> ohne schließendes Tag) — der Platzhalter fügt seinen Wert an genau einer Stelle ein.Werden mehrere unabhängige Optionen benötigt, setzen Sie einfach mehrere
typ=4-Platzhalter — jeder an der Stelle im Code, an der sein Wert eingefügt werden soll.Auswahl (Radio) mit typ=5
Die wählbaren Optionen legen Sie über die Einstellung
values= fest, getrennt durch Semikolon (;):%template{typ=5|values=Rot;Grün;Blau}:Hintergrundfarbe%Der angezeigte Name ist dabei gleichzeitig der Wert, der in den HTML-Code eingesetzt wird. Sollen Anzeigename und eingesetzter Wert unterschiedlich sein, trennen Sie beide mit einer Tilde (
~) in der Form Anzeigename~Wert:%template{typ=5|values=Rot~#ff0000;Grün~#00cc00;Blau~#0000ff|default=Grün}:Hintergrundfarbe%Der Anwender sieht beim Anlegen des Werbemittels die Auswahl "Rot / Grün / Blau", in den Code eingesetzt wird z.B.
#00cc00.Über
default=x legen Sie den Anzeigenamen der vorausgewählten Option fest; ohne Angabe ist die erste Option vorausgewählt. Es ist immer genau eine Option gewählt.Hinweise & Einschränkungen für Typ 4 & 5
- Anzeigenamen und Werte dürfen die Zeichen
{}|:%;und~nicht enthalten (diese sind Teil der Platzhalter-Syntax). Das Zeichen=ist erlaubt, HTML-Schnipsel mit Attributen (z.B.<img src="logo.png">) funktionieren also als Wert. - Wegen des verbotenen Doppelpunkts können CSS-Deklarationen nicht komplett als Wert hinterlegt werden (
Klein~font-size:12pxfunktioniert nicht). Schreiben Sie den festen Teil in die Vorlage und wählen Sie nur den variablen Teil aus:font-size:%template{typ=5|values=Klein~12px;Mittel~16px;Groß~22px|default=Mittel}:Schriftgröße% - Die Werte innerhalb eines
typ=5-Feldes müssen eindeutig sein, da die Auswahl anhand des Wertes gespeichert wird. - Wird in der Vorlage nachträglich ein Ausgabewert (
checked=,unchecked=oder der Wert einervalues=-Option) geändert, liefern bestehende Werbemittel weiterhin den alten Wert aus, bis sie einmal neu bearbeitet und gespeichert wurden (ggf. über Vorlage aktualisieren). Beim erneuten Bearbeiten fällt eine nicht mehr zuordenbare Auswahl aufdefault=bzw. die erste Option zurück. - Die Einstellung
required=1ist fürtyp=4/typ=5nicht erforderlich: Beityp=5ist immer eine Option gewählt, beityp=4ist "nicht angehakt" ein gültiger Zustand.