Freier Platzhalter

(Basic, Pro, Master ab 1.0)

Wird durch den Text ersetzt, der in das gleichnamige Datenfeld eingetragen wurde.

Verwendung

{{%Name: %Parameter }}

{{%Name: %Parameter, %Zusatz }}
%Name

Name des Platzhalters. Dieser muss folgenden Regeln entsprechen:

  • Der Name darf nicht mit vt beginnen.
  • Der Name darf keine Leerzeichen enthalten.
  • Der Name darf keine Satz- oder Sonderzeichen enthalten. Einzige Ausnahmen sind Bindestrich (-) und Unterstrich (_).
  • Der Name darf keine Umlaute oder fremdsprachige Buchstaben enthalten.
  • Der Name darf nicht mit einer Zahl beginnen. Innerhalb des Namens sind Zahlen dagegen erlaubt.
  • Die Groß-/Kleinschreibung ist bedeutungslos. Die Namen headline, Headline und HEADLINE bezeichnen aus Virthos-Sicht alle denselben Platzhalter.
%Parameter

Angabe, in welchem Ausgabeformat der Text ausgegeben werden soll. Beim ersten Auftreten des Platzhalters im Standardtemplate beeinflusst diese Angabe auch, wie das Eingabefeld aussieht, das zum Bearbeiten des Platzhalters bereitgestellt wird (siehe Hinweise).

%Zusatz

Beim ersten Auftreten des Platzhalters im Standardtemplate, kann der %Parameter durch einen Zusatz ergänzt werden, der das Eingabefeld zum Bearbeiten des Platzhalters näher beschreibt (siehe Hinweise).

Hinweise

Steht der Platzhalter beim ersten Auftreten im Standardtemplate ohne Parameter, wird zum Bearbeiten ein einfaches mehrzeiliges Eingabefeld bereitgestellt. Um eine andere Art von Eingabefeld zu erhalten, können Sie einen der folgenden Parameter verwenden:

short

Einzeiliges Textfeld. Über den %Zusatz können Sie die Länge des Feldes (Anzahl der Zeichen) steuern. Die Standardlänge beträgt 50 Zeichen.

styled

Längeres mehrzeiliges Textfeld mit einem "T"-Button, über den sich eine Onlinehilfe zu den Formatierungsmöglichkeiten aufrufen lässt.

mdown oder markdown

Längeres mehrzeiliges Textfeld mit einem "M"-Button, über den sich eine Onlinehilfe zu den Formatierungsmöglichkeiten aufrufen lässt.

html

Interaktiver Wysiwig-HTML-Editor. Über den %Zusatz können Sie das Aussehen und Verhalten des Editors beeinflussen:

Zusatz Bedeutung
simple (Vorgabe) einfacher Editor
extended erweiterter Editor
fullpage erweiterter Editor für vollständige HTML-Dokumente

Sie können als Zusatz auch den Pfad zu einer JavaScript-Datei angeben, die für die Initialisierung des Editors verwendet werden soll. Auf diese Weise können Sie den Editor spezielleren Zwecken anpassen. Als Grundlage sollten Sie eine der mitgelieferten Initialisierungsdateien verwenden, die im Verzeichnis system/resources/tiny_mce_config liegen. Eine Beschreibung aller Konfigurationsmöglichkeiten finden Sie in der TinyMCE-Dokumentation.

checkbox

Einzelnes Ankreuzfeld oder Gruppe von Ankreuzfeldern. Als %Zusatz müssen Sie eine JSON-Liste mit den Feldbezeichnungen oder eine Seitennummer angeben. Eine Liste könnte zum Beispiel so aussehen:

{{Wochentage: checkbox, ["Montag", "Dienstag", "Mittwoch", "Donnerstag", "Freitag"] }}

Wenn die Bezeichnungen der Ankreuzfelder von ihren jeweiligen Werten abweichen sollen, können Sie als %Zusatz auch eine Liste von Objekten angeben:

{{Wochentage: checkbox, [
{ "value": "",  "text": "<keine Angabe>" },
{ "value": "1", "text": "Montag" },
{ "value": "2", "text": "Dienstag" },
{ "value": "3", "text": "Mittwoch" },
{ "value": "4", "text": "Donnerstag" },
{ "value": "5", "text": "Freitag" }
]}}

Wenn Sie mit einer solchen Liste arbeiten und den gespeichert Wert wieder in den zugehörigen Text umwandeln wollen, können Sie den Ausgabefilter list verwenden.

Sie können als %Zusatz auch eine Virthos-Seitennummer angeben. In diesem Fall wird für jede Subseite der angegebenen Seite ein Ankreuzfeld bereitgestellt, wobei der Seitenname als Feldbezeichner und die Seitennummer als Feldwert dient.

select

Auswahlliste in Form eines Drop-down-Menüs. Die gewünschten Menüpunkte werden nach denselben Regeln angegeben wie bei checkbox.

grid

Interaktives Tabellengitter. Über den %Zusatz können Sie das Aussehen und Verhalten des Gitters beeinflussen. Entweder geben Sie die Zahl der Tabellenspalten an (Standardwert: 5), oder Sie geben eine JSON-Liste mit den gewünschten Spaltennamen an, zum Beispiel:

{{Varianten: grid, [ "Code", "Bezeichnung", "Aufpreis" ] }}

Statt einer reinen Namensliste können Sie auch eine Objektliste angeben und auf diese Weise zusätzliche Spalteneigenschaften festlegen. Mögliche Merkmale sind:

Merkmal Bedeutung
name Spaltenname
width Spaltenbreite in Pixeln (Vorgabe: 120)
editor Art des Spalteninhalts bzw. Name des Editors, der zum Bearbeiten der Spaltenwerte verwendet werden soll (Vorgabe: Text)

Folgende Editoren stehen zur Auswahl:

Editor Beschreibung
Text (Vorgabe) kurzer Text (ohne Zeilenumbrüche)
LongText mehrzeiliger Text
Integer ganze Zahl
Date Datum (Auswahl aus interaktivem Kalender)
Checkbox Ankreuzfeld (Wert "true" oder leer)
YesNoSelect Ja-Nein-Auswahlliste (Wert "yes" oder "no")
PercentComplete Prozentregler (Zahl von 0 bis 100)

Beispiel für ein komplexeres Tabellengitter:

{{Artikel: grid, [
{ "name":"number", "width":120, "editor":"Integer" },
{ "name":"name", "width":60 },
{ "name":"price", "width":60 },
{ "name":"description", "width":280, "editor":"LongText" }
]}}

Die Tabellenwerte werden in Form einer JSON-Objektiste gespeichert, wobei jedes Objekt einer Tabellenzeile entspricht. Die Namen der Objekteigenschaften entsprechen den jeweiligen Spaltennamen, so dass man die Tabellendaten aus dem letzten Beispiel folgendermaßen ausgeben könnte:

<ul>
<!--{{vtRepeat: {Artikel} }}-->
    <li>
        <strong>{{vtItem:name}} | {{vtItem:price}} &euro;</strong><br>
        Art.-Nr. {{vtItem:number}}<br>
        {{vtItem:description}}
    </li>
<!--{{vtEndRepeat}}-->
</ul>

Wenn Sie nur eine Spaltenanzahl, aber keine Namen vorgeben, werden die Spalten mit fortlaufenden Buchstaben benannt und können dann innerhalb einer vtRepeat-Schleife mit {{vtItem:A}}, {{vtItem:B}} etc. ausgegeben werden.

pagename

Einzeiliges Textfeld, das zum Festlegen des internen Seitennamens dient. Der %Name wird in diesem Fall ignoriert.

non_editable

Für den betreffenden Platzhalter wird kein Eingabefeld bereitgestellt. Dies kann sinnvoll sein, um früher getätigte Eingaben vor Veränderungen zu schützen, oder um Felder, deren Inhalt automatisch berechnet wird (in Virthos Master), beim Bearbeiten auszublenden.

Siehe auch