Weitere Dokumente
Einführung in die Verwendung von Platzhaltern und Datenelementen
Elemente für den Layouteditor und die Definition der Seitenvorlagen
Syntax und Attribute von Datenelementen in Webseitenvorlagen
Grundaufbau der Platzhalter für Dateninhalte
Grundaufbau der Platzhalter für Dateninhalte
Aufbauend auf der Einführung in die Verwendung von Platzhaltern und Datenelementen wird hier nun der Syntax zur Verwendung von Platzhaltern für Dateninhalte in den Webseiten-Vorlagendateien erläutert.
Jeder Platzhalter in einer Seitenvorlage steht für einen Dateninhalt. Web Business Shop erkennt einen gültigen Platzhalter an den umschließenden { } und einem gültigen Dateninhaltsnamen. Innerhalb von Datenelementen entscheidet das übergeordnete Datenelement über die Gültigkeit. Im Shopsystem sind aber auch eine Vielzahl von Platzhaltern verwendbar, die auch außerhalb von Datenelementen integrierbar sind.
Platzhalter innerhalb von Datenelementen
Datenelemente sind im wesentlichen nichts anderes als Datenbankabfragen, die Datensätze aus einer Tabelle oder auch mehrere Tabellen lesen.
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.produktid}
<!-- wbc:end -->
Die verfügbaren Datenfelder (sprich: Platzhalter) und Datenräume bei vordefinierten Datenelementen werden in der Onlindoku bei jedem Datenelement aufgeführt.
In o.g. Beispiel würde auch der Platzhalter {produktid} genügen, es empfiehlt sich aber ein expliziter Verweis auf den Hauptdatensatz eines Elements mit data. Wenn mehrere Tabellen in einer Datenbankabfrage eines Datenelements involviert sind, wird der Hauptdatensatz bei den vordefinierten Elementen immer mit data benannt.
Diese Verweisvorgaben dienen der Unterscheidung von Platzhaltern, um Überschneidungen in Datenräumen zu verhindern.
Vordefinierte Verweisangaben für Platzhalter
{medien.Medienname:Datenfeldname}
Bezieht sich auf die zu einem Datensatz geladenen Medieneinträge. Wird nur innerhalb von Datenelementen interpretiert.
{merkmale.Merkmalname:Datenfeldname}
Bezieht sich auf die zu einem Datensatz geladenen Merkmalseinträge. Wird nur innerhalb von Datenelementen interpretiert.
{preise.Datenfeldname}
Bezieht sich auf die zu einem Produkt-Datensatz geladenen Preiseinträge. Wird nur innerhalb von Datenelementen interpretiert.
{user.Datenfeldname}
Bezieht sich auf die zu einem Shopbesucher gespeicherten Daten
{session.Datenfeldname}
Bezieht sich auf die zu einem Shopbesucher gespeicherten Sitzungsdaten
{prop.Datenfeldname}
Bezieht sich auf die Daten der Grundkonfiguration Ihres Onlineshops.
{wbc.Datenfeldname}
Bezieht sich auf die Attribut-Daten des übergeordneten Datenelements.
{get.Parametername}
Bezieht sich auf die Parameterwerte die mit dem Abruf einer Webshop-Seite in der URL-Adresse mit übergeben wurden.
{getnum.Parametername}
Identisch mit dem Verweis get, jedoch erfolgt hier vor dem Austausch des Platzhalters eine numerische Konvertierung des angefordertern Parameterwerts. Wurde der Parameter nicht an die Seite übergeben wird 0 eingesetzt.
Aus diesem Dateninhaltsschema fallen zwei Verweisnamen heraus, da diese keinen Bezug zu einem Datenraum haben sondern PHP-Scriptkode ausführen:
{date.Datumsformat}
Gibt das aktuelle Datum oder die aktuelle Uhrzeit gemäß dem im Platzhalter angegebenen Format (date-Funktion von PHP) aus.
{eval.PHP Kode}
Führt den angegebenen PHP-Kode aus. Der Platzhalter wird anschließend entfernt, eine Ausgabe erfolgt nicht. Wird nur innerhalb von Datenelementen interpretiert.
Formatierung von Dateninhalten
Dateninhalte, die über Platzhalter in die Webseiten Ihres Shops integriert werden, lassen sich mit einer Erweiterung der Platzhalter-Definition auch formatiert einbetten. Dabei wird nach dem Inhaltsnamen ein : (Doppelpunkt) und das Formatkennzeichen angegeben.
Liste der Formatkennzeichen
raw
Jeder Dateninhalt wird normalerweise HTML-Kodiert in den Platzhalter eingefügt. Wenn Sie ein Datenfeld "as is" ausgeben möchten (z.B. die Produktbeschreibung) setzen Sie dieses Formatkennzeichen.
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.beschreibung:raw}
<!-- wbc:end -->
w99
Ersetzen Sie mit einem Platzhalter Textinhalt, kann mit diesem Kennzeichen die Anzahl der auszugebenden Wörter eines Datenfelds begrenzt werden. Ersetzen Sie 99 mit der Anzahl der gewünschten Wörter.
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.bezeichnung:w6}
<!-- wbc:end -->
datum
Datumsfelder werden in Web Business Shop immer in der Form YYYYMMDD gespeichert. Zur Ausgabe eines Datums in der Weise DD.MM.YYYY benutzen Sie dieses Kennzeichnen.
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.ndatum:datum}
<!-- wbc:end -->
num
Zur homogenen Darstellung von numerischen Werten. So wird z.B. 1 zu 1.00 oder 3.46372 zu 3.46
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.lbestand:num}
<!-- wbc:end -->
int
Zur homogenen Darstellung von ganzzahligen Werten. So wird z.B. 1.05 zu 1
<!-- wbc:begin name="produkt" pid="{getnum.pid}" -->
{data.lbestand:int}
<!-- wbc:end -->
wrg
Zur Formatierung von Preisangaben gemäß den Einstellungen in der Währungstabelle, inkl. Währungskennzeichen.
<!-- wbc:begin name="produkt" preise="1" pid="{getnum.pid}" -->
{preise.aktuell:wrg}
<!-- wbc:end -->
wrgtxt
Zur Formatierung von Preisangaben gemäß den Einstellungen in der Währungstabelle, inkl. Währungskode.
<!-- wbc:begin name="produkt" preise="1" pid="{getnum.pid}" -->
{preise.aktuell:wrgtxt}
<!-- wbc:end -->

