vtSet
(Basic, Pro, Master ab 1.3)
Speichert einen Wert in einer Variablen.
Verwendung
<!--{{vtSet: %Name="%Wert"}}-->
<!--{{vtSet: %Name1="Wert1", %Name2="%Wert2", ...}}-->
<!--{{vtSet: %Name }}-->
- %Name, %Name1, %Name2 ...
Name der jeweiligen Variablen. Wenn der Name mit
[]
endet, wird %Wert als neues Element an die Liste %Name angehängt. Wenn der Name mit[xxx]
endet, wird die Eigenschaftxxx
des Objekts %Name auf %Wert gesetzt.- %Wert, %Wert1, %Wert2 ...
(optional) Der Wert, der in der jeweiligen Variablen gespeichert werden soll. Wird kein Wert angegeben, bekommt die Variable den Inhalt des
vtResult
-Platzhalters zugewiesen, der das Ergebnis der letzten Aktion oder Berechnung enthält.
Hinweise
Ein mit vtSet
gespeicherter Wert lässt sich mit dem vtGet
-Platzhalter
wieder ausgeben. Ein dauerhaftes Speichern über mehrere Seitenabrufe hinweg ist
mit vtSet
allerdings nicht möglich; für diesen Zweck ist die Verwendung von
Sessionvariablen nötig.
Beachten Sie, dass Sie nicht nur den Wert mit Hilfe von Platzhaltern angeben können, sondern auch den Namen der Variablen (siehe Beispiel).
Beginnend mit v3.8.7 ist es möglich, Rechenformeln zu verwenden, um den Wert von
Variablen zu setzen. Wenn man ans Ende des Variablennamens einen Doppelpunkt
setzt, wird der übergebene Wert (nach Ersetzung aller enthaltenen Platzhalter)
als PHP-Ausdruck interpretiert und evaluiert. Diese Schreibweise ersetzt somit
eine vtCalc
- mit nachfolgender vtSet
-Anweisung.
Beispiele
<!--{{vtSet: Titel = "{Headline}", Text="{Inhalt}" }}-->
<!--{{vtSet: Anrede = "Hallo {Anrede} {Nachname}!" }}-->
<!--{{vtSet: Liste = "{vtLoop}{vtName}, {vtEndLoop}" }}-->
<!--{{vtSet: Var_{vtGet:Nummer} = "abcde" }}-->
<!--{{vtCalc: substr( '{Artikel:escaped}', 0, 150 ) }}-->
<!--{{vtSet: Teaser }}-->
<!--{{vtSet: Tage[] = "Dienstag" }}-->
<!--{{vtSet: Tage[] = "Donnerstag" }}-->
<!--{{vtSet: Tage[] = "Samstag" }}-->
<!--{{vtRepeat: {vtGet:Tage} }}-->{{vtItem}}<br><!--{{vtEndRepeat}}-->
<!--{{vtSet: Kontakt[Name] = "Hans Mustermann" }}-->
<!--{{vtSet: Kontakt[Telefon] = "030 12345678" }}-->
<!--{{vtSet: Kontakt[Email] = "hans@mustermann.de" }}-->
<!--{{vtSet: Kontakte[] = "{vtGet:Kontakt}" }}-->
<!--{{vtSet: Kontakt[Name] = "Erika Mustermann" }}-->
<!--{{vtSet: Kontakt[Telefon] = "030 9876543" }}-->
<!--{{vtSet: Kontakt[Email] = "erika@mustermann.de" }}-->
<!--{{vtSet: Kontakte[] = "{vtGet:Kontakt}" }}-->
<!--{{vtRepeat: {vtGet:Kontakte} }}--> {{vtItem:Name}}, {{vtItem:Telefon}}<br><!--{{vtEndRepeat}}-->
<!--{{vtSet: Bruttopreis:= "{Nettpreis}*1.19" }}-->
Siehe auch
Objekte und Listen