myty4 CMS, Intranet, eCommerce und Web-to-Print Framework für Online Erfolg und Prozessoptimierung in Unternehmen | Impressum

XML-Tag Dokumentation für Vorlagen-Entwickler

tycon / myty Tag Bibliothek

Die Tag-Bibliothek ermöglicht Vorlagen- und Vorlagenbaustein-Entwicklern Zugriff auf Funktionen des Frameworks myty (vormals tyCON). Zur Eingrenzung muss rechts die Version der Software angegeben werden.

Fragen zu den Tags beantworten wir auf der kostenpflichtigen Hotline (62cent aus dem dt. Festnetz) 0900-100 58 58 43 oder über das Support-Formular.

ty:additionals

zusätzliche Inhalte in den Quellcode einfügen

Fügt folgende Inhalte an die richtige Position im HTML-Quellcode ein:

Javascripts
CSS-Dateien
Inhalte für den Head-Bereich der Seite
Funktionen, die bei onload oder onunload ausgeführt werden sollen

Attribut	Beschreibung	Werte	Optional
id	ID für den Head-Inhalt, um den Inhalt nur einmal einzufügen. Nur verfügbar für type="head".		optional
type	Typ des Inhalts.	js \| css \| onload \| onunload \| head \| additionalCode \| jquery

ty:area

dynamische Bereiche anlegen [Modul: dynamic area]

Der Area-Tag ermöglicht das Einspielen und Verwalten von Snippets (Code-Schnippsel) in einer in der Design-Vorlage (Template) angelegten Area. Innerhalb dieser Area können die Code-Schnippsel hinzugefügt, verschoben, gelöscht werden.
In einer Schnippsel-Bibliothek können die einzelnen Code-Fragmente verwaltet werden.

Eine Area-Snippet kann: HTML-Tags, tyCON XML-Tags und PHP Quellcode enthalten und über einen internen Editor verändert werden.

Attribut	Beschreibung	Werte	Optional
cellHeight	Mit diesem Attribut definiert man die Höhe einer Zelle der Matrix. Dieses Attribut kann nur in Verbindung mit den Attributen cellWidth, unit, rows und cols verwendet werden.	Höhe einer Zelle in Pixel	optional
cellWidth	Mit diesem Attribut definiert man die Breite einer Zelle der Matrix. Dieses Attribut kann nur in Verbindung mit den Attributen cellHeight, unit, rows und cols verwendet werden.	Breite einer Zelle in Pixel	optional
cols	Mit diesem Attribut definiert man die Anzahl der Spalten in der Matrix. Dieses Attribut kann nur in Verbindung mit den Attributen cellHeight, cellWidth, unit und rows verwendet werden.	Anzahl der Spalten	optional
id	um eine ty:area identifizieren zu können muss eine id vorhanden sein
noticelist	Wandelt die ty:area in eine Merkliste um. In dieser Area werden nicht die zugewiesenen Schnipsel ausgegeben, sondern die Schnipsel die der Nutzer auf seiner Merkliste hat. Ist keine ID an der Area angegeben, wird diese auf den Wert "default" gesetzt.	true	optional
privs	um nur bestimmten benutzergruppen auf das ty:area feld zugriff zu gestatten, kann das Attribut privs genutzt werden.	admin, chief	optional
rows	Mit diesem Attribut definiert man die Anzahl der Zeilen in der Matrix. Dieses Attribut kann nur in Verbindung mit den Attributen cellHeight, cellWidth, unit und cols verwendet werden.	Anzahl der Zeilen	optional
shortlist	Ist die Area eine Merkliste, so kann mit diesem Attribut eine kurze Version der Merkliste ausgegeben werden. In der Merkliste müssen dafür die "langen" Bereiche gekennzeichnet sein (mit dem Tag <ty-area:longversion>), diese werden in der kurzen Merkliste nicht ausgegeben	true	optional
topic	Genau wie beim ty:content Tag erlaubt der ty:area Tag das Definieren eines Topics, welches dann den Inhalt in den sogenannten "global" Status versetzt. Alle Webseiten, die auf Basis einer Design-Vorlage (Template) basieren, deren ty:area das gleiche Topic (z.B.: "global") besitzen, stellen den gleichen "Inhalt" an dieser Stelle dar. Im Falle des ty:area Tags bedeutet dies, dass die Anordnung der integrierten Snippets auf allen Seiten gleich ist. Dies betrifft jedoch nicht die in der Area platzieren ty:content Tags, da diese für sich selbst einen "seitenspezifisch" oder "global"-Status bekommen können.	global	optional
unit	Dieses Attribut gibt an, welche Einheit die Werte cellWidth und cellHeight haben. Zur Zeit wird nur die Einheit "px" unterstützt.	px	optional

ty-area:alreadyaddedtonl

Der von diesem Tag eingeschlossene Bereich wird nur ausgegeben, wenn dieser Schnipsel bereits auf einer Merkliste vorhanden ist.

ty-area:isnl

Der in diesem Tag eingeschlossene Bereich wird nur innerhalb von Merklisten ausgegeben. Nützlich für einen "von der Merkliste entfernen" Knopf.

ty-area:isnonl

Der in diesem Tag eingeschlossene Bereich wird nur innerhalb von "normalen" Areas ausgegeben, die keine Merklisten sind. Nützlich um einen "auf die Merkliste hinzufügen" Knopf darzustellen.

ty-area:longversion

Kennzeichnet den langen Bereich eines Schnipsels. Wird dieser Schnipsel in einer kurzen Merkliste ausgegeben, so wird der in <ty-area:longversion> eingeschlossene Bereich dort nicht ausgegeben.

ty-area:notyetonnl

Der von diesem Tag eingeschlossene Bereich wird nur ausgegeben, wenn sich dieser Schnipsel noch nicht auf einer Merkliste befindet.

ty-area:snippetRelId

Mit dem Tag <ty-area:snippetRelId/> erhalten Sie die ID des aktuellen Schnipsels.

ty:bannerrotation

Bannerrotation

Die Bannerrotation steuert die zeitliche Anzeige von Werbeflächen. Die Rotation kann auch zum Austausch von anderen Inhalten auf verschiedenen Seiten wie Bildern und Texten verwendet werden.

Es kann im Backend der Anzeigezeitraum, die maximale Anzahl an Einblendungen und die Größe des Banners eingestellt werden.

Attribut	Beschreibung	Werte	Optional
category	Es werden nur Banner aus dieser Kategorie (Einstellbar in den Bannereinstellungen) für die Anzeige ausgewählt.	string	optional
count	Gibt die Anzahl an Bannern die ausgegeben werden sollen an. Standardwert : 1	integer	optional
height	Beschränkt die Ausgabegröße des Banners in der Höhe, sofern es sich um ein Bild handelt.	integer	optional
id	Eindeutiger Bezeichner der Anzeigefläche, dieser muss angegeben sein.	string
rel	Eine zusätzliche Ergänzung um Banner, um nach anderen Kriterien filtern zu können, dabei enthählt rel einen SQL-Anweisungsteil, welcher die SQL Anweisung zusätzlich einschränken kann. Bsp.: rel="width<='600'"	string	optional
topic	Für bestimmte Anwendungsfälle kann es sinnvoll sein, ein anderes Topic als das der aktuellen Seite zu verwenden. Standardwert: topic der aktuellen Seite	string	optional
width	Beschränkt die Ausgabegröße des Banners in der Breite, sofern es sich um ein Bild handelt.	integer	optional

ty:blog

Blog und Kommentar Funktionen

Mit dem ty:blog Tag lässt sich ein komplexes Blog erstellen oder einfach eine Kommentar Funktion einbinden.

mode="activation"

Tag zur Aktivierung von Kommentaren und Trackbacks.

mode="addcomment"
[ Beispiel ]

Mit diesem Tag legt man einen neuen Kommentar an. Das Tag muss ein Formular umschliessen sowie einen button mit Namen "blog_addcomment" besitzen. Welche Namen die Inputfelder haben müssen und welche Daten erwartet/verarbeitet werden, sieht man im Beispiel

mode="blogentrycount"

Gibt die Anzahl der sichtbaren Blogeinträge in der angegebenen Kategorie aus

Attribut	Beschreibung	Werte	Optional
topic	Kategorie zu der die Einträge ausgegeben werden sollen

mode="blogentryhidden"

Wird ausgeführt, wenn der angegebene Blogeintrag deaktiviert/unsichtbar ist.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags, welcher abgefragt werden soll.

mode="blogentryvisible"

Wird ausgeführt, wenn der angegebene Blogeintrag sichtbar ist.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags der abgefragt werden soll.

mode="commentcount"

zählt die Kommentare zu einem bestimmten Blogeintrag.

Attribut	Beschreibung	Werte	Optional
parentid	Enthält die ID des Blogeintrags, dessen Kommentare gezählt werden sollen. <ty:blog mode="commentcount" parentid="5"/> zählt alle Kommentare von Blogeintrag 5.
tbl	Gibt die Tabelle an auf die sich der Kommentar bezieht. Hat man nur eine Tabelle (bei einem normalen Blog) kann man diese Angabe weglassen. Nutzt man die Kommentarfunktion zusätzlich noch für eine andere Tabelle (für Artikel in einem Shop zum Beispiel) so muss hier die entsprechende Tabelle angegeben werden. Defaultwert: "blogentries".		optional

mode="commentsallowed"

Wird ausgeführt, wenn für den entsprechenden Eintrag Kommentare erlaubt sind.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags.

mode="delblogentry"
[ Beispiel ]

Löscht einen Blogeintrag anhand seiner ID. Das Tag muss ein Formular umschliessen, welches mit einen Button namens "blog_delblogentry" abgesendet wird.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags der gelöscht werden soll.

mode="delcomment"
[ Beispiel ]

Dieses Tag ist zum löschen eines Kommentars notwendig. Es muss ein Formular umschliessen welches einen submit-button Names "blog_delcomment" hat. Per Parameter wird der zu löschende Kommentar übergeben.

Attribut	Beschreibung	Werte	Optional
cid	Enthält die ID des zu löschenden Kommentars.

mode="deltrackback"
[ Beispiel ]

Dieses Tag ist zum löschen eines Trackbacks notwendig. Es muss ein Formular umschliessen welches einen submit-button Names "blog_deltrackback" hat. Per Parameter wird die ID des zu löschenden Trackbacks übergeben.

Attribut	Beschreibung	Werte	Optional
tid	ID des zu löschenden Trackbacks

mode="edit_blogentry"

Dieses Tag ist zum Erstellen eines neuen Blogeintrags sowie zum Bearbeiten eines vorhandenen Blogeintrags zu benutzen. Es muss ein Formular umschliessen welches mit einem button names "blog_addblogentry"abgeschickt wird. Das Anpingen und Trackbacksenden wird ebenfalls über dieses Tag geregelt, dazu müssen nur die entsprechenden Variablen übergeben werden. Welche Variablen alle übergeben werden können, siehe Beispiel.

mode="entrystatus"

Gibt den Status eines Blogeintrags als Zahl zurück. Um einen Text auszugeben, sollte die Zahl als ID eines Contentfelds benutzt werden.

mode="error"

Dieses Tag wird ausgeführt, falls ein Fehler aufgetreten ist (Felder falsch oder gar nicht ausgefüllt z.B.). Will man einen bestimmten Fehler abfangen so kann man dies mit dem Attribut name tun. Eine Fehlermeldung, wenn kein Author bei einem Kommentar angegeben ist sähe demnach so aus:<ty:blog mode="error" name="author">Kein Author angegeben!</ty:blog>. Für eine Liste mit allen möglichen Fehlern siehe Beispiel.

Attribut	Beschreibung	Werte	Optional
name	Mit diesem Attribut kann ein bestimmter Fehler angegeben werden. mode="error" wird dann nur ausgeführt, wenn genau dieser Fehler auftritt. Wird das Attribut name weggelassen, wird mode="error" ausgeführt sobald irgendein Fehler auftritt.		optional

mode="get"

Mit diesem Tag können die im Blogmodul eingestellten Seiten abgefragt werden. So lassen sich einfach Links auf die Start-, Detail-, etc. Seiten erstellen.

Attribut	Beschreibung	Werte	Optional
blogid	ID des Blogeintrags. Kann auch als Parameter übergeben werden, ist jedoch sinnvoller es mit diesem Attribut zu tun. Das Attribut existiert zusätzlich unter dem Synonym "binarea", da in einer area Attribute in denen die Zeichenkette "id" vorkommt verändert werden können.
page	Name der Seite die zurückgegeben werden soll. (start, detail, edit, login, rss, atom, activatefile).
params	Parameter die der Seite übergeben werden sollen. Sollte in etwa so aussehen: params="a=5&c=6".

mode="getformelem" get="catoptions"

Füllt eine Selectbox mit den Kategorien/Rubriken des Blogs.

mode="ifauthorname"

Gibt den Nickname zurück wenn vorhanden. Kann Text umschliessen, welcher in dem Fall ausgegeben wird, wenn kein nickname vorhanden ist.

mode="ifauthorname"

Gibt den Nickname zurück wenn vorhanden. Kann Text umschliessen, welcher in dem Fall ausgegeben wird, wenn kein nickname vorhanden ist.

mode="lastmonths"

Attribut	Beschreibung	Werte	Optional
count	Anzahl wieviele Monate maximal ausgegeben werden sollen		optional
showempty	Monate ohne Einträge auch anzeigen	no,yes	optional

ty-blog:flipflop

Gibt abwechselnd 0 und 1 aus

ty-blog:monthblogentries

Gibt die Anzahl der in diesem Monat vorhandenen Einträge aus

ty-blog:monthid

Gibt die Nummer des Monats zurück

ty-blog:monthname

Gibt den Namen des Monats aus

mode="nocommentsallowed"

Gegenstück zu commentsallowed. Wird ausgeführt wenn keine Kommentare erlaubt sind.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags.

mode="noerror"

Verwendung exakt wie mode="error", nur das dieses Tag ausgeführt wird, wenn kein Fehler aufgetreten ist.

Attribut	Beschreibung	Werte	Optional
name	Mit diesem Attribut wird ein bestimmter Fehler angegeben, siehe mode="error".		optional

mode="notrackbacksallowed"

Gegenstück zu mode="trackbacksallowed", wird ausgeführt wenn keine Trackbacks erlaubt sind.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags der auf Trackbacks überprüft werden soll.

mode="ownoradmin"

Wird ausgeführt, wenn der angegebene Blogeintrag vom eingeloggten Nutzer erstellt wurde bzw. wenn der eingeloggter Nutzer das Recht blog/frontend/blogentries->editall besitzt. (Das Recht besitzt standardmäßig nur der Blogadmin). Dieses Tag sollte man um die Buttons zum editieren und löschen setzen, wenn man möchte, das jeder Nutzer nur seine eigenen Blogeinträge editieren und löschen darf.
Die ID des Blogeintrags wird in diesem Fall nicht per Attribut übergeben, damit man diese auch mit ty-Befehlen angeben kann. Stattdessen muss innerhalb des "ownoradmin"-Tags ein <ty-blog:dbid> Tag die ID nummer des Blogeintrags einschließen. Am besten das Beispiel anschauen, dann sollte die Verwendung klar sein.

mode="printformfields"

Gibt alle im Blogmodul eingestellten Formularfelder aus. Geeignet für ein Formular um seine eigenen Nutzerdaten zu ändern.

mode="printformfieldslist"

Gibt die Namen aller Formularfelder mit Komma getrennt aus. Wird bei einem Anmeldeformular benötigt für eine Siteroles Abfrage.

mode="printformfieldsnew"

Gibt alle im Blogmodul eingestellten Formularfelder aus. Geeignet für ein Anmeldeformular.

mode="printkeywords"

Gibt die Keywörter eines Blogeintrags aus.

Attribut	Beschreibung	Werte	Optional
maxFontSize	Gibt die maximale Schriftgröße für die Stichworte an. Standardwert ist 18. Es werden immer 5 Stufen zwischen den angegebenen Schriftgrößen berechnet, bei den Standardwerten 10-18 also 10,12,14,16,18		optional
minFontSize	Gibt die Minimale Schriftgröße für die Stichworte an. Standardwert ist 10		optional

ty-blog:keyword

Gibt das Keywort aus.

ty-blog:keywordfontcolor

Gibt eine Schriftfarbe für das Keywort aus, anhand seiner Wichtigkeit im Verhältnis zur durchschnittlichen Wichtigkeit. Die ausgegebenen Schriftfarben sind #aaaaaa, #888888, #666666 (dunkler = wichtiger).

ty-blog:keywordfontsize

Gibt eine Schriftgröße für das Keywort aus, anhand seiner Wichtigkeit im Verhältnis zur durchschnittlichen Wichtigkeit. Die Schriftgröße liegt zwischen 10 und 18 und wird in 2er Schritten erhöht.

ty-blog:keywordimportance

Gibt aus wie "wichtig" das Keywort ist (entspricht ungefähr der Anzahl der Blogeinträge bei denen das Keywort angegeben ist)

mode="printmembers"
[ Beispiel ]

Gibt Informationen über alle Mitglieder bzw. ein Mitglied des Blogs aus, die Ausgabe erfolgt über die jeweiligen sub-tags. Ist das Attribut ID angegeben, so werden nur Informationen über das spezielle Mitglied ausgegebene, ansonsten werden alle Mitglieder nacheinander ausgegeben.

Attribut	Beschreibung	Werte	Optional
id	NutzerID des Mitglieds, wenn nur Informationen über ein Mitglied ausgegeben werden sollen.		optional

ty-blog:memberfirstname

Gibt den Vornamen des Mitglieds aus.

ty-blog:memberhasfirstname

Fragt ab, ob das Blogmitglied einen Vornamen angegeben hat. Diese Abfrage gibt es für alle Attribute die sich abfragen lassen (ty-blog:memberhasinfotext, ty-blog:memerhasicq, etc.).

ty-blog:memberhomepage

Gibt die Homepage des Blogmitglieds aus. Das abgefragte Attribut ist "homepage".

ty-blog:membericq

Gibt die ICQ Nummer des Blogmitglieds aus. Das abgefragte Attribut heisst "icq".
Die gleiche Abfrage gibt es auch für MSN (Attribut "msn") und Yahoo (Attribut "yahoo").

ty-blog:memberid

Gibt die ID des Mitglieds aus.

ty-blog:memberinfotext

Gibt einen Infotext über das Mitglied aus. Das abgefragte Attribut heisst "infotext".

ty-blog:memberlastname

Gibt den Nachnamen des Mitglieds aus.

ty-blog:membernickname

Gibt den Nickname des Nutzers aus.

ty-blog:memberpicture

Gibt den Inhalt des Attributs "picture" aus. Dieses sollte ein Link zu einem Bild enthalten. Um das Bild auszugeben, sollte dieses Tag als Quelle für ein img-Tag definiert werden, also so: <img src="<ty-blog:memberpicture/>">.

ty-blog:memberrole

Gibt die Rolle des Mitglieds aus. Nur Nutzer die das Attribut "role" besitzen, werden überhaupt durch printmembers ausgegeben. So kann man sicherstellen, dass auch wirklich nur Blognutzer als Mitglieder angezeigt werden und nicht andere Accounts (Admin, Gast, etc.).

ty-blog:nomembers

Wird ausgegeben, wenn das Blog noch keine Mitglieder hat.

mode="replacestuff"
[ Beispiel ]

Dieses Tag ersetzt einige ty-blog Tags, welche für die Ausgabe der Blogeinträge mit ty:db benötigt werden. Das Tag sollte immer die ganze ty:db Abfrage umschliessen, bzw. gleich die ganze Datei.

ty-blog-allconditions

Fasst alle anderen Bedingungen zusammen und generiert eine Abfrage die auf alle Bedingungen und-verknüpft reagiert

ty-blog-get_category

Gibt in SQL syntax eine Abfrage nach der Kategorie aus. Die Kategorie wird als topic übergeben, es wird geprüft ob das topic Teil der Kategorien/Rubriken ist. Ist es das nicht, ist der Rückgabewert der Nullstring. Ist dies nicht die erste Abfrage so muss <ty-blog-and_get_category/> verwendet werden.

ty-blog-get_keyword

Gibt in SQL syntax die Abfrage nach dem Keyword aus, welches in $keyword übergeben wurde. Gibt es bereits eine andere Abfrage vor dieser, so muss <ty-blog-and_get_keyword/> benutzt werden.

ty-blog-get_month

Gibt in SQL syntax die Abfrage nach dem Monat aus, der in $month übergeben wurde. Sollte bei der Blogausgabe in die rel Klausel der ty:db Abfrage gesetzt werden. Gibt es bereits andere Abfragen vor dieser, so muss das Tag <ty-blog-and_get_month/> benutzt werden.

ty-blog-hidden

Gibt in SQL syntax eine Abfrage aus, ob der aktuelle Eintrag sichtbar ist. Wird $showhidden = yes gesetzt, so wird eine Abfrage generiert, ob der aktuelle Eintrag nicht sichtbar ist. Sollte als erste Bedingung in der ty:db Abfrage benutzt werden, da hier immer ein Rückgabe wert vorliegt. (Bei den anderen Abfrage ist dies nur der Fall, wenn die entsprechende Variable übergeben wird)

ty-blog-myentries

Gibt eine Abfrage in SQL Syntax aus, die nur die Beiträge des aktuellen Nutzers ausgibt

mode="similarentries"

Gibt Blogeinträge mit ähnlichen/gleichen Keywörter aus.

ty-blog:entryheading

Gibt die Überschrift des Blogeintrags aus

ty-blog:entryid

Gibt die ID des Blogeintrags aus.

ty-blog:entryimportance

Gibt die Anzahl der übereinstimmenden Keywörter aus.

mode="trackback"
[ Beispiel ]

Dieses Tag wird benutzt um eingehende Trackbacks aufzufangen und in die Datenbank einzutragen. Man setzt es in einer extra Datei ein, an die die anderen Blogger ihre Trackbacks senden. Im Beispiel sieht man die komplette Implementation einer Trackbackdatei.

mode="trackbackcount"

Zählt die vorhandenen Trackbacks zu einem Blogeintrag.

Attribut	Beschreibung	Werte	Optional
bid	ID des Blogeintrags von dem die Trackbacks bezählt werden sollen.
bid	ID des Blogeintrags von dem die Trackbacks bezählt werden sollen.

mode="trackbacksallowed"

Wird ausgeführt wenn Trackbacks für den entsprechenden Blogeintrag erlaubt sind. <ty:blog mode="trackbacksallowed" bid="5">Trackbacks sind für Blogeintrag 5 erlaubt</ty:blog>

Attribut	Beschreibung	Werte	Optional
bid	In diesem Attribut gibt man die ID des Blogeintrags an, bei dem überprüft werden soll, ob Trackbacks erlaubt sind.

ty:button

dynamische Buttons erzeugen

Der ty:button Tag wird dann verwendet, wenn grafische, dynamische Buttons generiert werden müssen, z.B.: bei der Darstellung der Seitentruktur. Es wird dadurch möglich auch exclusive Schrifttypen via Grafik, automatisch auf der Seite zu plazieren.

Mit ty:button können Sie ohne Programmierkentnisse, und ohne grossen Aufwand Grafiken erzeugen.

Attribut	Beschreibung	Werte	Optional
angle	Mit angle kann man den Winkel festlegen, in dem der Button gedreht werden kann.		optional
bgcolor	Mit bgcolor können Sie die Hintergrundfarbe als Hexadezimalwert (ohne #) angeben. bgcolor wird nur verwendet, wenn kein Attribut template verwendet wurde.
caption	Im Attribut caption wird der Text angegeben der in der Grafik angezeigt werden soll. Auf Hochkommas sowie ausgefallene Sonderzeichen sollten Sie verzichten.
case	case wandelt alle Text in Gross- oder Kleinschreibung um. 1. case=""upper" -> Texte werden in Grossschreibung umgewandelt 2. case=""lower" -> Texte werden in Kleinschreibung umgewandelt Sonderzeichen und Umlaute werden nicht umgewandelt.	upper, lower
color	Mit color können Sie die Schriftfarbe als Hexadezimalwert (ohne #) angeben.
font	Mit dem optionalen Attribut font können Sie den Pfad zu einer True Type Schrifftart angeben. Sollte es fehlen, wird automatisch Arial benutzt.
fontSize	Mit fontSize kann die Schriftgrösse in Pixeln angegeben werden.
startX	Textabstand von links in Pixel
startY	Textabstand von oben in Pixel
template	Das Attribut template kann den Pfad zu einer PNG Grafik beinhalten. Diese Grafik wird als Buttonhintergrund verwendet.

ty:cache

cache

ty:cache puffert generierte Ausgaben für eine angegebene Zeit zwischen. Die Seitengenerierungszeiten werden dadurch enorm verkürzt. Eingesetzt werden sollte dieses Modul in Bereichen eines Templates, die sich wenig ändern und dadurch eher statische Daten repräsentiert. Wenn zu erwarten ist, das sich die Navigation Durchschnittlich höchstens 1x pro Stunde ändert, kann ein Cache das Generieren der Navigation im Template beschleunigen, indem es diesen Teil nur einmal je Stunde erzeugt. Hierdurch kann unnötige Serverlast und Seitengenerierungszeit vermieden werden.

Abhängig von Topic, Nutzer und id wird das Resultat eines Codeabschnitt für eine bestimmte Zeit (welche per expire in sekunden definiert wurde) im Cache gespeichert.

Ist im Navigationssetup definiert, dass der Cache gelöscht werden soll, so wird beim veröffentlichen einer Inhaltsseite der Cache automatisch mit geleert. Weiterhin ist das caching für Backendnutzer deaktiviert, dadurch wird vermieden, dass ein Redakteur veraltete Inahlte angezeigt bekommt.

Attribut	Beschreibung	Werte	Optional
expire	Gibt die Zeit in Sekunden an, wie lange dieser Bereich zwischengespeichert werden soll.
id	Ist erforderlich um verschiedene Cache-Bereiche in einem Template zu unterscheiden.

ty:content

Content-Bereiche definieren

Der ty:content Tag erlaubt das festlegen von Content-Bereichen in der Vorlagedatei. Dies können beliebig viele sein. Die Unterscheidung erfolgt aufgrund verschiedener ID's und ggf. ein eigenes Topic. Funktionen: zusätzlich können Rechteeinschränkungen übergeben werden, sowie der Ausschluss von Funktionen ...

Das ty:content Tag ermöglicht es Ihnen editierbare Content-Bereiche zu erstellen.

Attribut	Beschreibung	Werte	Optional
blockelements	blockelements="false" erlaubt zwar HTML Tags für Links o.ä. innerhalb eines Contentfeldes, allerdings sind keine Umbrüche oder Absätze möglich.	false	optional
display	display="dynamic" passt die Breite des Editierbereiches dem Inhalt an der Editierbereich ist somit nicht mehr automatisch 100% breit und nach dem Bereich wird kein Zeilenumbruch eingefügt das Attribut display wird nur im Internet Explorer umgesetzt	dynamic	optional
html	html="false" verbietet HTML-Tags im Contentfeld. Die Eingabe ist zwar technisch möglich, allerdings werden die Tags beim Speichern gelöscht.	false	optional
id	Das Attribut id sollte in einer Vorlage immer eindeutig sein, das heißt nie doppelt vorkommen. Dieses Attribut ist unbedingt erforderlich.
noEdit	In einigen Fällen (editierbarer Text in title tags) kann es sinnvoll sein, das Attribut noEdit zu setzen. noEdit="true" Die Tags edit="false" und inlineEdit="false" haben die gleiche Bedeutung. Wenn der Content-Tag das Attribut topic besitzt, kann der Inhalt an anderer Stelle bearbeitet werden.	true
privs	Mit dem optionalen Attribut privs können Sie verschiedenen Redakteurgruppen das Recht geben, diesen Textbereich zu bearbeiten. Mögliche Parameter sind: admin oder chief	admin oder chief
topic	Sollte der Inhalt bei einem ty:content Tag in der gesamten Webseite immer gleich bleiben, hat man die Möglichkeit das optionale Attribut topic zu vergeben. Dazu muss unter Projektverwaltung -> content das "Editieren unbekannter Topics zulassen" angeschalten sein.

ty:db

Datentabellen auslesen [Modul: Database Manager]

Der ty:db Tag erlaubt das Auslesen von Datentabellen aus der mit dem tyCON verbundenen mySQL Datenbank. Anwendung findet diese einfache und standardisierte Funktion in üblichen Tabellen zur Darstellung von z.B.: Newsmeldungen, Produktinfos, Kontaktdaten, Dateiversionen, Bildergalerien, Foren ...

Mit ty:db Tags können Sie Daten aus einer Datentabelle auslesen, die Sie im tyCON angelegt haben. Innerhalb von ty:db Tags können Sie beliebigen HTML Quelltext eintragen. Die Tabelle muss unbedingt eine Spalte 'id' besitzen. Wenn eine Spalte 'language' existiert , so muss der Datensatz auch ein Sprachkürzel enhalten, ansonsten wird er nicht ausgelesen. Wenn es eine Spalte 'status' mit den ENUM Werten 'enabled', 'disabled' gibt, werden immer nur die 'enabled' Datensätze ausgelesen. Wurde die Tabelle mit den tyCON-Datenbankmodul erstellt, sind die erforderliche Spalten bereits automatisch eingerichtet. Anforderungen/Bedingung: Diese Funktionen ist nur mit dem lizenzierten Modul: "Database Manager" möglich

Attribut	Beschreibung	Werte	Optional
group	Mit group [SQL:GROUP BY] können Sie alle Ergebnisse nach einer Spalte gruppieren.
id	Mit id haben Sie die Möglichkeit einen bestimmten Datensatz anzeigen zu lassen. Z.B für eine News-Detailseite.		optional
ignoreLanguage	Wenn dieses Attribut auf true gesetzt ist wird die Sprache der Datensätze ignoriert. Es werden also alle vorhandenen, aktivierten Datensätze ausgelesen	true	optional
join	Mit join können Sie verschieden Tabellen miteinander verbinden. [SQL:JOIN]
limit	Wenn Sie ein limit [SQL:LIMIT] angeben, werden nur limit Ergebnisse angezeigt
order	Mit order [SQL:ORDER BY] können Sie alle Ergebnisse nach einer oder mehreren Spalten sortieren.
pages	Mit pages="true" sowie dem Attribut limit wird automatisch eine Blätterfunktion erzeugt.
rel	Mit rel lassen sich Abfragebedingungen [SQL:WHERE] definieren.
select	Mit select="" [SQL:SELECT] können Sie einzelne Spalten oder die gesamte Tabelle auslesen.
soap	geben Sie mit diesem Attribut an, von welcher Webschnittstelle (diese kann durch eine andere myty Version zur Verfügung gestellt werden) die Daten abgefragt werden sollen. Alle Attribute des ty:db Tags werden nun an die Webservice Schnittstelle weitergeleitet und von dieser verarbeitet. beachten Sie auch die Attribute: soap_user="" soap_password="" Wird kein Ergebnis zurückgeliefert, kann dies verschiedene Ursachen haben, überprüfen Sie bitte, ob die Einstellung für den Soap Server korrekt eingestellt wurden. Beachten Sie auch, dass der angegeben Pfad zu der Schnittstellenbeschreibungsdatei folgende Form besitzen muss "http://server/..../tydb.wsdl". Dieser Link wird im Setup der SOAP Server Einstellung ausgegeben.		optional
soap_clearWSDLCache	Über dieses Attribut kann der WSDL-Cache des Webservices geleert werden. Es sollte nur bei der Entwicklung, nicht aber dauerhaft gesetzt werden.	true	optional
soap_password	Erfordert die SOAP Schnittstelle die Angabe eines Passwortes, so muss dieses hier angegeben werden.		optional
soap_user	Erfordert die Schnittstelle die Angabe eines Nutzernamens, so muss dieser hier angegeben werden.		optional
table	Mit table="Tabellenname" wählen Sie die Datentabelle aus, die ausgelesen werden soll.
topic	Es werden alle Ergebnisse dieser Seite zugeordnet. Diese sind dann nur editierbar, wenn der entsprechende Redakteur sowohl das Editierrecht für die Seite als auch das Recht zum Editieren der Datentabelle hat.
tyMasterDB	Dieses Attribut muss vorhanden sein, um Tabellen der Master-Datenbank zu nutzen. Diese Funktion ist nur mit dem Mandantenmodul lieferbar.	true	optional
version	Wird nur ausgewertet bei versionierten Tabellen. Dient dann zur Auswahl der angeforderten Version. So kann auch im Backend die veröffentlichte Version angezeigt werden und im Frontend die Unveröffentlichte.	published\|unpublished	optional

ty-db:colvalue
[ Beispiel ]

Mit colvalue werden Inhalte der abgefragten Spalten ausgegeben.

Attribut	Beschreibung	Werte	Optional
col	Mit col legt man die auszugebene Spalte fest. z.B.: col="Spalte"		optional
count_[NAME]	gibt die Anzahl der gruppierten Werte zurück		optional
display	siehe Attribut display des Tags ty:content	dynamic	optional
maxlength	Die Ausgabe wird mit diesem Attribut auf eine gewisse Zeichenanzahl begrenzt maxlength="50" es werden maximal 50 Zeichen ausgegeben Achtung: Bei Verwendung dieses Attributes wird die Editierfunktion deaktiviert (Attribut inlineEditing="false") um das beschneiden schon existierender Inhalte zu verhindern.		optional
nl2br	Mit colvalue werden Textfelder ausgegeben. Das Attribut nl2br="true", ersetzt alle Zeilenumbrüche mit <br /> .	true	optional
noEdit	deaktiviert das Editieren für angezeigte Texte der Datenbank siehe Attribut noEdit des Tags ty:content Die Tags edit="false" und inlineEdit="false" haben die gleiche Bedeutung.	true	optional

ty-db:comment

Startelement der Kommentarelemente

ty-db-comment:from

ty-db-comment:num

Zeigt Anzahl aller Datensätze einer Tabelle an

ty-db-comment:to

ty-db:conditional
[ Beispiel ]

Gibt den eingeschlossenen HTML-Code aus, wenn der Inhalt der Spalte col nicht leer ist.

Attribut	Beschreibung	Werte	Optional
col	Spaltenname
mod	der Wert gibt den Modulus der Anzeige der Ergebnisse an das Attribut start wird zwingend benötigt
start	der Wert gibt an, bei welchem Ergebnis des Modulus der Code ausgeführt wird
value	Gibt an, ob man herausfinden möchte, ob ein Wert eingegeben wurde oder ob keine Wert eingegeben wurde wenn value="true" oder nicht angegeben funktioniert ty-db:conditional wie gewohnt wenn value="false" bekommt man den inhalt des Tags ausgegeben, wenn kein Wert eingegeben wurde	true oder false	optional

ty-db:conditionalFallback
[ Beispiel ]

Der Inhalt dieses Tags wird ausgegeben, wenn der Wert, der in col="..." angegebenen Spalte, leer ist.

Attribut	Beschreibung	Werte	Optional
col	Gibt die Spalte an, deren Inhalt geprüft werden soll.

ty-db:date
[ Beispiel ]

Gibt das gewählte Datum im gewählten Format aus.

Attribut	Beschreibung	Werte	Optional
field	Spaltenname (Die Spalte muss den Wert timestamp haben)
format	formatiert die ausgabe des Datums

ty-db:edit

edit wird im Editiermodus durch einen Editierbutton sowie einem Button zum eintragen eines neuen Datensatzes ersetzt

ty-db:editCurrent

edit wird im Editiermodus durch einen Editierbutton sowie einem Button zum eintragen eines vorhandenen Datensatzes ersetzt

ty-db:editNew

edit wird im Editiermodus durch einen Editierbutton sowie einem Button zum eintragen eines neuen Datensatzes ersetzt

ty-db:fallback

Wenn nichts ausgegeben wird, kann dies mit fallback abgefangen werden.

ty-db:fileurl

Es wird nur der Pfad einer Datei ausgegeben.

Attribut	Beschreibung	Werte	Optional
col	Spaltenname

ty-db:flipflop

Es wird abwechselnd 0 bzw. 1 zurückgegeben.

ty-db:header

Die Ausgabe wird nach dem Feld col gruppiert.

ty-db:htmlHeader

Der HTML Code innerhalb von htmlHeader wird vor der Ausgabe der Datensätze einmalig ausgegeben. Dies ist beispielsweise bei einer Ausgabe der Datensätze in Tabellen oder Listen nützlich. (Beispiel)

ty-db:img
[ Beispiel ]

img zeigt Bilder und Grafiken an. Diese Bilder befinden sich im Ordner /media/files/Tabellenname/ und müssen im jpg- oder png-Format vorliegen. Der Dateiname des Bildes lautet DatensatzID_Bildname.jpg (oder png).
Stellen Sie sicher das der Ordner alle Schreibrechte besitzt.

Attribut	Beschreibung	Werte	Optional
field	Spaltenname
maxheight	maximale Bildhöhe optional
maxwidth	maximale Bildbreite optional
popupmaxheight	gibt die maximale Höhe des Popupfensters an
popupmaxwidth	gibt die maximale Breite des Popupfensters an

ty-db:imgurl

Es wird nur der Pfad des Bildes ausgegeben.

Attribut	Beschreibung	Werte	Optional
col	Spaltenname

ty-db:lastrow

gibt den eingeschlossenen Text aus, wenn letzter Datenbankeintrag erreicht wurde.

ty-db:pager
[ Beispiel ]

Startelement der Blätterfunktionselemente

ty-db:relatedArticles
[ Beispiel ]

Gibt die Shop-Artikel aus, die eine Beziehung zum Datentabellen-Eintrag haben.

Dieser Tag funktioniert wie der Shop-Tag <ty:shop element="listOfArticles"/>. Die Untertags sind damit auch die gleichen.

ty-db:rownumber

Gibt die Nummer der Ausgabezeile wieder. Bei jeder Abfrage beginnt die Nummerierung bei 1.

ty:flipflop

Erzeugt einen simplen Flipflop

Erzeugt einen Flipflop, dieser kann z.B. zum stylen von Listen, Tabellen oder anderen Inhaltselementen genutzt werden. Das Modul ist kompatibel zu allen anderen Listen erzeugenden Modulen, es kann innerhalb oder außerhalb als umschließendes Tag genutzt werden.

Attribut	Beschreibung	Werte	Optional
counter	Gibt die Bezeichnung des zu verwendenen Zählers an. Ist diese nicht angegeben, wird der Zähler "global" genutzt.	string	optional
mod	Gibt einen Modulo an, dieser wird bei der Ausgabe von Zahlen per ty-flipflop:number oder ty-flipflop:isNumber auf die aktuelle Nummer des Zählers angewendet. Wenn mod nicht angegeben wurde, wird kein Modulo auf die aktuelle Zählernummer angewendet.	integer	optional
start	Gibt den Startwert an, bei dem der Zähler beim ersten initialisieren starten soll. Die interne Zählernummer kann auch durch ty-flipflop:reset wieder zurückgesetzt werden. Der Standardwert ist 0, wenn kein Wert angegeben wurde.	integer	optional

ty-flipflop:inc

Inkrementiert den Zähler um 1.

ty-flipflop:isNumber

Prüft, ob eine bestimmte Zählernummer erreicht wurde, und gibt die Ersetzung gegebenenfalls aus.

<ty-flipflop:isNumber value="1,4">...</ty-flipflop:isNumber>

Attribut	Beschreibung	Werte	Optional
inc	steuert, ob nach der Ausgabe der Wert des Zählers inkrementiert werden soll. Standardwert:true	true\|false	optional
mod	Überschreibt den Modulo für die ausgabe des Tags. Es wird der Wert des Attributes des Haupttags für die aktuelle Ausgabe überschrieben.	integer	optional
value	Prüft, ob der Wert des Zählers einem der angegeben Werte entspricht. Vor der Prüdung wird der Modulo operator angewendet.	integer,integer,...

Attribut

Beschreibung

Werte

Optional

inc

steuert, ob nach der Ausgabe der Wert des Zählers inkrementiert werden soll.

Standardwert:true

true|false

optional

mod

Überschreibt den Modulo für die ausgabe des Tags. Es wird der Wert des Attributes des Haupttags für die aktuelle Ausgabe überschrieben.

integer

optional

value

Prüft, ob der Wert des Zählers einem der angegeben Werte entspricht. Vor der Prüdung wird der Modulo operator angewendet.

integer,integer,...

ty-flipflop:number

Liefert die aktuelle Zählernummer zurück, beachtet dabei den Wert des Modulo.

Attribut	Beschreibung	Werte	Optional
inc	steuert, ob nach der Ausgabe der Wert des Zählers inkrementiert werden soll. Standardwert:true	true\|false	optional
mod	Überschreibt den Modulo für die ausgabe des Tags. Es wird der Wert des Attributes des Haupttags für die aktuelle Ausgabe überschrieben.	integer	optional

Attribut

Beschreibung

Werte

Optional

inc

steuert, ob nach der Ausgabe der Wert des Zählers inkrementiert werden soll.

Standardwert:true

true|false

optional

mod

Überschreibt den Modulo für die ausgabe des Tags. Es wird der Wert des Attributes des Haupttags für die aktuelle Ausgabe überschrieben.

integer

optional

ty-flipflop:reset

Die aktuelle Zählernummer wird auf den startwert oder 0 zurückgesetzt.

ty:formmanager

Formulare einbinden

Der Formularmanager ermöglicht das einfache Erstellen und Einbinden von Formularen in die eigene Webseite. Der Redakteur kann Formulare jederzeit selbstständig verändern und
erweitern ohne sich um die Validierung der Formulardaten zu kümmern.

Die Formular-Daten werden direkt in einer Datentabelle gespeichert und können somit jederzeit
verwaltet und an anderer Stelle über das ty:db-Tag (Database Manager) ausgegeben werden.

Attribut	Beschreibung	Werte	Optional
dbFields	Das Attribut dbFields kann nur in Verbindung mit dem Attribut dbValues verwendet werden! Beide Attribute ermöglichen das Bearbeiten eines Datensatzes der mit dem Formular verknüpften Datentabelle. Die Daten werden in das Formular eingelesen und nach erfogreicher Änderung wird der Datensatz aktualisiert. Ist kein entsprechender Datensatz vorhanden, wird ein neuer Datensatz erzeugt. Für das Attribut dbFields wird der Name, für dbValues der Wert der Tabellenspalte angegeben. Bei der Verwendung von mehreren Bedingungen werden die einzelnen Werte in beiden Attributen durch das Zeichen \| abgetrennt.		optional
dbValues	Informationen zu dbValues finden Sie am Attribut dbFields.		optional
global	Über das Attribut global können globale Formulare definiert werden. Wird in einer Vorlage das ty:formmanager-Tag mit global=”true” platziert, so wird das gewählte Formular auf allen Seiten angezeigt, welche diese Vorlage verwenden.	true	optional
id	Über das Attribut id wird ein Formular-Tag eindeutig bezeichnet.
javaScriptFile	Dieses Attribut wird nur in Sonderfällen benötigt: Wird ein Formular per Ajax geladen so muss für die Formular-Validierung per JavaScript nötige JavaScript bereits im Template enthalten sein. Diese wird durch Setzen von javaScriptFile="true" in das Template eingebunden. Weiterer HTML-Code wird nicht erzeugt. Beispiel: <ty:formmanager javaScriptFile="true"/>	true	optional
method	Mit diesem Attribut wird die Versand-Methode des Formulars überschrieben. Sonderfall: method="ajax" In diesem Fall werden die Formulardaten per Ajax übermittelt. Dies ist in der aktuellen Version nur für Formulare ohne Datei-Upload möglich. Über das Unter-Tag <ty-formmanager:javascript event="EVENT"> können für verschiedene Ereignisse (z.B. Erfolgsfall oder Fehlerfall) JavaScript-Code ausgeführt werden.	ajax, post, get	optional
validation	Mit der Angabe validation="javaScript" wird die Formularvalidierung per JavaScript aktiviert. Die serverseitige Validierung der Formulardaten wird damit nicht deaktiviert. Folgende Formularelemente werden in der aktuellen Version überprüft: Pflichtfelder, E-Mail-Textfelder, Captchas und Passwort-Wiederholung Im Fehlerfall wird die CSS-Klasse mytyFormError, im Erfolgsfall mytyFormSuccess an die Formularelemente und deren div-Container ergänzt.	javaScript	optional

ty-formmanager:error
[ Beispiel ]

Über dieses Tag kann eine allgemeine Fehlermeldung ausgegeben werden. Der Inhalt wird immer dann angezeigt, wenn ein Formular mit nicht befüllten Pflichtfeldern oder fehlerhafte Daten (z.B keine Mail-Adresse) abgesendet wurde.

ty-formmanager:form

Dieses Tag liefert den HTML-Quelltext des Formulars.

Attribut	Beschreibung	Werte	Optional
hideOnSuccess	Durch die Angabe von <ty-formmanager:form hideOnSuccess="true"/> wird nach erfolgreichen Formularversand das Formular ausgeblendet. Beim Versand per Ajax (method="ajax") das Formular per JavaScript ausgeblendet. Hinweis: verfügbar ab Revision 7049	true,false	optional

Attribut

Beschreibung

Werte

Optional

hideOnSuccess

Durch die Angabe von <ty-formmanager:form hideOnSuccess="true"/> wird nach erfolgreichen Formularversand das Formular ausgeblendet.

Beim Versand per Ajax (method="ajax") das Formular per JavaScript ausgeblendet.

Hinweis: verfügbar ab Revision 7049

true,false

optional

ty-formmanager:javascript

Dieses Tag ermöglicht die Erweiterung von JavaScript-Ereignissen bei der Formularverarbeitung. Der Code wird nur verarbeitet wenn am ty:formmanager - Tag die validation="javaScript" definiert ist.

Für jeden Ereignis-Typ (Werte für das Attribut event) kann dieses Tag einmal verwendet werden.

Attribut	Beschreibung	Werte	Optional
event	onSubmit : Dieses Ereignis wird beim Formularversand ausgelöst. Der JavaScript-Code wird in einen eigene Funktion eingebettet. Wird darin return false; übergeben wird das Formular nicht versendet. onError : Der JavaScript-Code wird ausgelöst wenn die JavaScript-Validierung des gesamten Formulars oder bei Versand per Ajax die serverseitige Validierung nicht erfolgreich war. onSuccess : Der JavaScript-Code wird ausgelöst wenn der Versand per Ajax erfolgreich war.	onSubmit, onError, onSuccess

ty-formmanager:success

Über dieses Tag kann eine Erfolgsmeldung ausgegeben werden. Der Inhalt wird immer dann angezeigt, wenn ein Formular erfolgreich versendet wurde.

ty:homepage

Informationen zur Startseite

Mit dem ty:homepage Tag kann man einen Link zur Startseite der Webseite erzeugen

Attribut	Beschreibung	Werte	Optional
key	Werte: url: Pfad zur Startseite caption: Ausgebe der Startseiten-Bezeichnung

Attribut

Beschreibung

Werte

Optional

key

Werte:

url: Pfad zur Startseite
caption: Ausgebe der Startseiten-Bezeichnung

ty:image

Bildfunktion in der Vorlageseite

Der ty:image Tag bietet zusätzliche Funktionen für die Plazierung und Darstellung von Bildern in der Vorlageseite. Der Designer hat mit dem Tag die Möglichkeiten den Redakteur in seinen Rechten einzuschränken.

Attribut	Beschreibung	Werte	Optional
align	Bildausrichtung	left, right, center
border	Bildrand in Pixel
container	definiert, ob label, description, bild und "Bild entfernen"-Button in einem div-Element ausgegeben werden sollen	true \| false	optional
cutalign	Ausrichtung des eingepassten Bildes (nur bei resizemode="fill")	left, center, right	optional
default	default gibt den Pfad zum Standardbild an.
description	Gibt eine Beschreibung zum Bild aus.		optional
height	Bildhöhe in Pixel
id	id des Bildes
label	Gibt eine Bezeichnung für das Bild aus.		optional
popup	Bei popup="true" öffnet sich ein neues Fenster mit dem Bild in Originalgröße.	true	optional
removeable	Gibt einen Button aus, um das Bild zu löschen.	true \| false	optional
resizemode	kleinste Bildseite auf die angegebenen Dimension vergrößern / verkleinern ACHTUNG: width und height muss angegeben werden!	fill	optional
style	CSS Styles
valign	vertikale Ausrichtung des eingepassten Bildes (nur in Verbindung mit resizemode="fill")	top, middle, bottom	optional
width	Bildbreite in Pixel		optional

ty:imagebutton

dynamische Textgrafiken erzeugen

Der ty:imagebutton Tag wird dann verwendet, wenn grafische, dynamische Textgrafiken generiert werden sollen, die Ermöglicht dem Grafiker mehr Gestaltungsspielraum und gibt dem Redakteur die Chance Textgrafiken mit besonderen Schriften selbst zu generieren. Hilfreich ist dies z.B.: beim Übersetzen von Textgrafiken, es wir keine zusätzliche Software benötigt.

Via Popup kann der Redakteur die Textänderungen, Größenanpassung und Achsenverschiebungen selbst in die Hand nehmen. Änderungen gehen sofort online, es gibt keinen Änderungsworkflow. Die Grafik kann jedoch deaktiviert werden, wobei der Inhalt bestehen bleibt.

Die Tag-Attribute entsprechen denen von ty:button ohne Außnahme, bitte entnehmen Sie diese daher bitte aus der Beschreibung dieses Tags.

Mit ty:imagebutton können ohne Programmierkentnisse, und ohne grossen Aufwand echte Textgrafiken mit eigenen Schriften erzeugt werden. Dazu muss die gewünschte Schrift jedoch auf den Webserver hochgeladen werden.

Attribut	Beschreibung	Werte	Optional
bgcolor	Mit bgcolor können Sie die Hintergrundfarbe als Hexadezimalwert (ohne #) angeben. bgcolor wird nur verwendet, wenn kein Attribut template verwendet wurde.
border	mit dem Attribut border kann die Dicke des Rahmens um einen Imagebutton festgelegt werden
caption	Im Attribut caption wird der Text angegeben der in der Grafik angezeigt werden soll. Auf Hochkommas sowie ausgefallene Sonderzeichen sollten Sie verzichten.
case	case wandelt alle Text in Gross- oder Kleinschreibung um. 1. case=""upper" -> Texte werden in Grossschreibung umgewandelt 2. case=""lower" -> Texte werden in Kleinschreibung umgewandelt Sonderzeichen und Umlaute werden nicht umgewandelt.	upper, lower	optional
font	Mit dem optionalen Attribut font können Sie den Pfad zu einer True Type Schrifftart angeben. Sollte es fehlen, wird automatisch Arial benutzt.
fontSize	Das Attribut fontSize legt die Schriftgröße auf dem Imagebutton fest.
startX	Textabstand von links in Pixel
startY	Textabstand von oben in Pixel

ty:keyword

Stichwortindex ausgeben

Der ty:keyword Tag gibt die Schlüsselbegriffe aus, die zu einer bestimmten Seite im tyCON zugewiesen wurden. Der Tag kann zum Beispiel verwendet werden, um die META Informationen einer Seite zu erweitern oder um ein sog. Stichwort-Verzeichnis zu erzeugen.

ty-keyword:keyword

Ausgabe des Stichwortes

ty-keyword:kwEnd

HTML Code am Ende

ty-keyword:kwStart

HTML Code am Anfang

ty-keyword:urlEnd

ty-keyword:urlShow

ty-keyword:caption

ty-keyword:url

ty-keyword:urlStart

ty:lang

Sprachen auslesen [Modul: Multi Language]

Der ty:lang Tag erlaubt das Auslesen der dynamischen Sprachnavigation.

Mit dem ty:lang Tag können Sie sehr einfach einen Sprachumschalter in Ihre Vorlage integrieren.

Attribut	Beschreibung	Werte	Optional
caption	caption wird durch die Bezeichnung der Sprache ersetzt. (z.B. english bei englisch)
iso	iso wird durch das Sprachkürzel ersetzt. (z.B de bei deutsch)
this	Mit this können Sie die aktuell gewählte Sprache optisch von den anderen Sprachen abheben.
url	url wird durch einen Link ersetzt, der die neue Sprachvariable enthält

ty:nav

Navigationsstruktur auslesen

Der ty:nav Tag erlaubt das Auslesen der im tyCON administrierten Seiten-/Navigationsstruktur. Funktionen: die Verschiedenen Navigationsebenen können getrennt von einander ausgelesen werden, Unterpunkte können gleichzeitig dargestellt werden, Aktivstati können durch erweiterte Darstellungsoptionen visualisiert werden ...

Das ty-nav tag erlaubt es Ihnen eine dynamische Navigation in Ihre Vorlage zu integrieren. Diese Navigation können Sie mit HTML beliebig formatieren.

Attribut	Beschreibung	Werte	Optional
excluded	Alle in excluded enthaltenen Seiten werden in der Navigation nicht mit ausgegeben. excluded="topic1,topic2,topicN" Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird.
excludedEdit	Alle in excludedEdit enthaltenen Seiten werden in der Navigation mit ausgegeben, allerdings nicht beim angemeldeten Redakteur. excludedEdit="topic1,topic2,topicN" Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird.
excludedNormal	Alle in excludedNormal enthaltenen Seiten werden in der Navigation nicht mit ausgegeben. Beim angemeldeten Redakteur werden diese Seiten in der Navigation angezeigt. excludedNormal="topic1,topic2,topicN" Dieses Attribut funktioniert nur, wenn ty-nav:iterate nicht verwendet wird.
hidefirst	In Verbindung mir recurse="true" , type="all" und wahlweise gesetztem topic, wird die Seite der höchsten Ebene aus der Navigation ausgeblendet. Hilfreich für CSS/JS Menüs.	true	optional
level	Mit level können Sie angeben ab welcher Ebene die Navigationstruktur angezeigt werden soll.
limit	Es werden nur limit Seiten angezeigt
mode	Bei mode= "siteuser", werden dem angemeldetetn Siteuser alle ihm zugänglichen Seiten angezeigt.
offset, limit	gibt an, ab welchem Element die Ausgabe erfolgen soll bzw. im Fall "limit" wie viele Elemente ausgegeben werden sollen. Übergibt man eine Zahl (z.B. 2), bedeutet das, die Ausgabe der Navigationspunkte erfolgt erst z.B. ab dem 2. Element Übergibt man mehrere mit Semikolon getrennte Zahlen kann man für jede Iteration das Offset angeben (z.B. 0;3;8) Dieses Attribut kann in Verbindung mit dem Attribut limit dafür verwendet werden nur einen Teilausschnitt der Navigation auszugeben.	s. Beschreibung	optional
recurse	Wenn recurse="true" ist, werden alle Seiten ausgegeben. Damit lässt sich z.B. eine Sitemap generieren. (Beispiel) Vorraussetzungen: ty-nav:iterate mit type="all"
topic	Es werden alle Unterseiten zur Seite topic ausgegeben. Diese Funktion ist derzeit noch nicht vollständig implementiert.
type	Mit type können verschiedene Navigationsmodule ausgewählt werden.	static

ty-nav:afterList

ty-nav:beforeList

ty-nav:caption

caption zeigt die Seitenbezeichnung in der aktuellen Sprache an.

ty-nav:childs

Gibt Inhalt der in dem Tag steht zurück, wenn es weitere Unterpunkte gibt.

ty-nav:first

Mit ty-nav:first kann im jeweiligen Navigationslevel des erste Element ermittelt werden.

ty-nav:ifIterates

Der Inhalt dieses Tags wird ausgegeben, wenn Unterpunkte existieren und diese mit dem ty-nav:iterate-Tag ausgegeben werden. (aus Kompatibilitätsgründen auch mit den Tags ty-nav:beforeIterate und ty-nav:afterIterate gleichzusetzen)

ty-nav:isLevel

Prüft, ob der Navigationspunkt in einem bestimmten Level ist.

Attribut	Beschreibung	Werte	Optional
level	Gibt den Level an, auf den geprüft werden soll (mehrere Werte-Komma separiert sind zulässig) z.B. level="0,2"	integer,integer,...

ty-nav:isParentTopic

liest aus, ob das Topic (Navigationpunkt) ein Elternpunkt ist. Mit dem Tag kann man dann zum Beispiel den CSS Style beinflussen. Der Tag muss wieder geschlossen werden. Dazwischen steht der optionale Text/HTML

ty-nav:isPrevious

Gibt Inhalt der im Tag steht bei dem vorherigen Punkt in der selben Ebene zurück.

ty-nav:isSubtopic

Funktioniert genauso wie bei isTopic, ist nur für Unterpunkte gedacht.

ty-nav:isTopic
[ Beispiel ]

Mit isTopic hat man die Möglichkeit die aktuelle Seite optisch von den anderen Seiten abheben zu lassen.

ty-nav:itemNumber

Gibt eine laufende Nummer der aktuellen Ebene zurück.

ty-nav:iterate

iterate zeigt alle Unterpunkte der aktuellen Seite mit an.

Attribut	Beschreibung	Werte	Optional
type	zeigt die Unterpunkte aller Seiten an	all

ty-nav:last

Mit ty-nav:last kann im jeweiligen Navigationslevel des letzte Element ermittelt werden.

ty-nav:level

level zeigt die Ebenennummer an.

ty-nav:seo

Ruft das ty:seo modul mit dem Topic des Navigationspunktes auf.Alle untertags des Modules ty:seo können genutzt werden z.B. ty-seo:title

ty-nav:target

target gibt das Zielfenster zur Seite zurück (_self oder _blank).

ty-nav:topic

Mit topic wird der Seitennamen angezeigt.

ty-nav:url

url gibt den relativen Pfad zur Seite zurück.

ty-nav:var

durch das Attribut colvalue kann die Varibale ausgegeben werden. z.B. <ty-nav:var colvalue="color"/>

ty:optional

Optionale Content-Bereiche definieren

Der ty:optional Tag erlaubt das definieren von optionalen Bereichen im HTML-Code der Vorlageseite. Funktionsweise: innerhalb der tyCON Navigations-Verwaltung können die vordefinierten "optionalen" Bereiche aktiviert oder deaktiviert werden. Durch diese Funktion lassen sich zum beispiel sehr einfach zus. Informationsboxen einstellen. Eine Vorlage kann so für die Darstellung verschiedener Seitentypen verwendet werden und sein Aussehen unabhängig vom Content verändern.

Mit ty:optional können Sie einzelne Bereiche einer Vorlage ein- und ausschaltbar machen. Redakteure können bei den Naviagtionsoptionen einstellen, ob der Bereich angezeigt werden soll, oder nicht. ty:optional eignet sich zum Beispiel um Boxen in der Vorlage zu platzieren. Das hat den Vorteil das wesentlich weniger tyCON-Vorlagen gemacht werden müssen.

Attribut	Beschreibung	Werte	Optional
id	Das Attribut id besteht aus einer kurzen Beschreibung (maximal 50 Zeichen). Diese Beschreibung wird dann bei den Navigationsoption ausgelesen. Sie sollte immer eindeutig sein.

ty:pageFeatures

Informationen zur aktuellen Seite

Mit den Page Features können verschiedene Informationen zur Seite angezeigt werden.

ty-pageFeatures:editorMail

Gibt die e-Mail-Adresse des Redakteurs aus, der das Dokument, die Seite zuletzt bearbeitet hat. Dadurch kann zum Beispiel ein Hyperlink erzeugt werden.

ty-pageFeatures:editorName

Gibt den Namen des Redakteurs aus, der das Dokument, die Seite zuletzt bearbeitet hat.

ty-pageFeatures:lastModified

Datum der letzten Veröffentlichung des Dokumentes, des Seite anzeigen.

Attribut	Beschreibung	Werte	Optional
format		strftime String

ty-pageFeatures:printSite

Funktion die den Drucken Dialog des Browsers aufruft.

ty:pager

Blätterfunktion

Der ty:pager Tag erlaubt das Einbinden einer sog. Listenfunktion, welche die Ergebnisdarstellung beim Auslesen einer Datentabelle optimiert und z.B. in Seiten á 20 Ergebnisse einteilt.

Die Blätterfunktion lässt sich bei ty:db und ty:search einbinden.

Ein fertigen Pager, zum kopieren, mit Erklärung finden Sie im Beispielbereich von ty:db unter Pager einfügen.

Die Blätterfunktion lässt sich bei ty:db und ty:search einbinden.

Attribut	Beschreibung	Werte	Optional
maxPages
minPages	Anzahl der Seiten, ab wann der Pager angezeigt werden soll	integer	optional

ty-pager:count

letztes Element auf der Seite

ty-pager:maxcount

Gesamtanzahl der Elemente

ty-pager:offset

Erstes Element auf der Seite

ty-pager:pages

ty-pager-pages:active

ty-pager-pages:first

ty-pager-pages:last

ty-pager-pages:page

ty-pager-pages:page-url

ty-pager-pages:after

ty-pager-pages:before

before only if more pages are found than maxPages

ty-pager-pages:firstPage

Seitenzahl der ersten Seite

ty-pager-pages:firstUrl

ty-pager-pages:inactive

ty-pager-pages:first

ty-pager-pages:last

ty-pager-pages:page

ty-pager-pages:page-url

ty-pager-pages:lastPage

Seitenzahl der letzte Seite

ty-pager-pages:lastUrl

ty-pager-pages:nextUrl

ty-pager-pages:previousUrl

ty-pager-pages:separator

ty:search

Suche

Der ty:search Tag erlaubt das Einbinden einer einfachen Volltext-Suchfunktion in einer Vorlageseite. Verschiedene Bedingungen können zusätzlich definiert werden.

Attribut	Beschreibung	Werte	Optional
limit	Anzahl der Ergebnisse pro Seite
pages	Einbindung der Blätterfunktion	true
type	Definiert den Typ (Plugin) der Suchfunktion. Mögliche Werte sind zur Zeit: suggest (AJAX basierte Suggest-Suche) standard (Suche per Formular) Standardeinstellung ist "standard"	suggest, standard	optional

Attribut

Beschreibung

Werte

Optional

limit

Anzahl der Ergebnisse pro Seite

pages

Einbindung der Blätterfunktion

true

type

Definiert den Typ (Plugin) der Suchfunktion. Mögliche Werte sind zur Zeit:

suggest (AJAX basierte Suggest-Suche)
standard (Suche per Formular)

Standardeinstellung ist "standard"

suggest, standard

optional

ty-search-db:Tabelle

Damit auch alle Tabellen durchsucht werden können, müssen diese einzelt angebunden werden. Tabelle steht für den Tabellennamen.

ty-search-db-Tabelle:detail

Attribut	Beschreibung	Werte	Optional
template	Template der Detailseite

ty-search-db-Tabelle:id

Attribut	Beschreibung	Werte	Optional
row	Primärschlüsselfeld

ty-search-db-Tabelle:relevance

Relevanz geht nur wenn die Spalte als FULLTEXT gesetzt wurde

Attribut	Beschreibung	Werte	Optional
row

ty-search-db-Tabelle:search

durchsuchbare Spalten

Attribut	Beschreibung	Werte	Optional
rows	Werte mit Komma getrennt

ty-search-db-Tabelle:text

Attribut	Beschreibung	Werte	Optional
row	Tabellenfeld aus dem bei den Suchergebnissen ein textabschitt angezeigt wird.

ty-search-db-Tabelle:title

Attribut	Beschreibung	Werte	Optional
row	Tabellenfeld welches bei den Suchergebnissen als Titel angezeigt wird.

ty-search-db-Tabelle:topic

Attribut	Beschreibung	Werte	Optional
topic	Topic der Detailseite

ty-search:comment

Kommentare, wie viel gefunden wird und welche angezeigt werden

ty-search-comment:from

zeigt an ab welchem Ergebnis angezeigt wird

ty-search-comment:num

Anzahl der Ergebnisse gesamt

ty-search-comment:to

gibt an bis zu welchem Ergebnis ausgegeben wird

ty-search:noResults

Wenn nichts gefunden wird das ausgegeben.

ty-search:pager

einbinden der Blätterfunktion

ty-search:relevance

anzeigen der Relevanz

Attribut	Beschreibung	Werte	Optional
normalize

ty-search:resultsAfter

nächste Ergebnisse

ty-search:resultsBefore

vorherige Ergebnisse

ty-search:text

gibt den Text des Suchergebnisses zurück

ty-search:title

gibt den Titel des Suchergebnisses zurück

ty-search:url

gibt die url des Suchergebnisses zurück

ty:search type="suggest"

AJAX basierte Suggest-Suche

Stellt eine AJAX basierte Vorschlagssuchfunktion zur Verfügung mit der man Textinhalte, Shop-Artikel und Datenbanken durchsuchen kann.

ty-search:config

Dieses Tag ist als Tag-Container für die Konfigurationseinstellungen der Suggest-Suche zu verstehen. Die darin enthaltenen Untertags definieren dann, was durchsucht werden soll.

ty-search-config:content

Konfiguriert den Suchvorgang nach Textinhalten.

Attribut

Beschreibung

Werte

Optional

excludetopics

Die darin angegebenen Seiten-Identifikatoren werden von der Suche ausgeschlossen.

Mehrere Seiten können durch das Trennzeichen "," angegeben werden.

optional

limit

Damit limitiert man die Anzahl der gefundenen Ergebnisse

positive Ganzzahlen

subtopics

Wenn dieses Attribut angegeben wurde werden nur die Seiten mit den definierten Seiten-Identifikatoren und deren Unterseiten durchsucht.

Mehrere Seiten können durch das Trennzeichen "," angegeben werden.

optional

ty-search-config:db

Konfiguriert den Suchvorgang in Datentabellen. Dieses Tag kann mehrmals untereinander verwendet werden, um z.B. in mehreren unabhängigen Datentabellen zu suchen.

ty-search:form

Dieses Tag gibt das Formular für die Suggest-Suche aus. Der Inhalt des Tags kann wiederum Elemente des Typs ty-search enthalten (z.B. <ty-search:input/>). Damit ist es möglich, den eingegebenen Wert auch an die Standard-Suchfunktion (per Formular) zu übergeben.

Attribut	Beschreibung	Werte	Optional
class	Definiert die CSS-Klassen für das Formular-Element.		optional

ty-search:input

Dieser Tag erzeugt ein Formularelement vom typ "text" (<input type="text" ... />). In dieses Element wird der Suchbegriff eingegeben.

ty:seo

Suchmaschinenoptimierung

ty:seo steuert Ausgaben, welche im Headbereich einer Website ausgegeben werden können. Diese Informationen sind vor allem für Suchmaschinen relevant, da Angaben wie Schlüsselwörter, Beschreibungstexte und Angaben zum Author der Website im Suchindex aufgenommen werden.

Attribut	Beschreibung	Werte	Optional
topic	Angabe eines Topic, von welchem die Seo Informationen ausgelesen werden sollen. Siehe auch ty-nav:seo	string	optional

ty-seo:link

Ausgabe der Linkinformationen

Attribut

Beschreibung

Werte

Optional

html

Dieses Attribut beeinflusst die HTML Ausgabe.
html="false" erzwingt die Unterdrückung der HTML-Ausgabe (zugehöriger Inhaltswert wird als Text ausgegeben, sofern vorhanden).

false|0

optional

type

Der typ gibt an, wo die Ersetzung, welche im Template angegeben wurde an das HTML -Tag angefügt werden soll.

<ty-seo:title type="addbefore">Titel - </ty-seo:title>

Ausgabe : <title>Titel - Navigationspunkt1</title>

<ty-seo:title type="addafter"> - Titel</ty-seo:title>

Ausgabe : <title>Navigationspunkt1 - Titel</title>

<ty-seo:title type="replace">Titel</ty-seo:title>

Ausgabe : <title>Titel</title>

replace|addbefore|addafter

ty-seo:linklist

Gibt eine komplette Liste aller für diesen Navigationspunkt definierten Linkdaten aus.

Attribut	Beschreibung	Werte	Optional
html	Dieses Attribut beeinflusst die HTML Ausgabe. html="false" erzwingt die Unterdrückung der HTML-Ausgabe (zugehöriger Inhaltswert wird als Text ausgegeben, sofern vorhanden).	false\|0	optional

ty-seo:meta

Ausgabe einzelner Metadaten, wie keywords, description etc.

Attribut	Beschreibung	Werte	Optional
html	Dieses Attribut beeinflusst die HTML Ausgabe. html="false" erzwingt die Unterdrückung der HTML-Ausgabe (zugehöriger Inhaltswert wird als Text ausgegeben, sofern vorhanden).	false\|0	optional
inherit	Kann nur bei ty-meta:keywords verwendet werden. Gibt an, ob die Schlüsselwörter von übergeordneten Navigationspunkten mit ausgegeben werden sollen.	true\|false	optional
name	Name der Metainformation einer Seite.
type	Der typ gibt an, wo die Ersetzung, welche im Template angegeben wurde an das HTML -Tag angefügt werden soll. <ty-seo:title type="addbefore">Titel - </ty-seo:title> Ausgabe : <title>Titel - Navigationspunkt1</title> <ty-seo:title type="addafter"> - Titel</ty-seo:title> Ausgabe : <title>Navigationspunkt1 - Titel</title> <ty-seo:title type="replace">Titel</ty-seo:title> Ausgabe : <title>Titel</title>	replace\|addbefore\|addafter

ty-seo:metalist

Gibt eine komplette Liste aller für diesen Navigationspunkt definierten Metadaten aus.

Attribut	Beschreibung	Werte	Optional
html	Dieses Attribut beeinflusst die HTML Ausgabe. html="false" erzwingt die Unterdrückung der HTML-Ausgabe (zugehöriger Inhaltswert wird als Text ausgegeben, sofern vorhanden).	false\|0	optional

ty-seo:title

Ausgabe des Seitentitels

Attribut

Beschreibung

Werte

Optional

html

Dieses Attribut beeinflusst die HTML Ausgabe.
html="false" erzwingt die Unterdrückung der HTML-Ausgabe (zugehöriger Inhaltswert wird als Text ausgegeben, sofern vorhanden).

false|0

optional

type

Der typ gibt an, wo die Ersetzung, welche im Template angegeben wurde an das HTML -Tag angefügt werden soll.

<ty-seo:title type="addbefore">Titel - </ty-seo:title>

Ausgabe : <title>Titel - Navigationspunkt1</title>

<ty-seo:title type="addafter"> - Titel</ty-seo:title>

Ausgabe : <title>Navigationspunkt1 - Titel</title>

<ty-seo:title type="replace">Titel</ty-seo:title>

Ausgabe : <title>Titel</title>

replace|addbefore|addafter

ty:shop

Erstellen eines Online Shops

Erlaubt die vollständige Integration eines Shopsystems mittels ty-Tags.

Vor der Erstellung eines Shops müssen Sie im tyCON-Menü Shop unter Shop Einstellungen (Papiersymbol rechts unten neben "Modul") das
Template für Login-Seite,
Template für Bestellbestätigungs-Seite,
Template für Warenkorb,
Template für Artikel-Detail,
Template für Bestellung,
Template für Benutzerdatenformular
einrichten!
Es empfiehlt sich auch die Mehrwertsteuer-Felder und die Felder für die Emailaddressen (an welche die Bestellung gesendet wird) auszufüllen. Diese Felder können im Nachhinein noch Editiert werden

Desweiteren müssen Sie im Modul Shop folgende Einstellungen vornehmen um die Funktion und die korrekte Darstellung der Tags in den Shop-Templates sicherzustellen :

Regionen: Legen Sie hier eine Region (Land) an. Das ist wichtig damit der Tag <ty-Shop:userCountry/> funktioniert.
Zahlungsarten: Legen Sie hier bitte eine Zahlungsart an. Geben Sie Ihr einen Namen und weisen Sie ihr Regionen zu. In der Bestellübersicht am Ende des Bestellvorganges erscheint diese dann. Das ist wichtig damit der Bestellvorgang abgeschickt werden kann.
Versandkosten: Legen Sie mindestens einen Versandkosten-Wert fest damit in Ihrem Bestellvorgang und der Rechnung die Versandkosten mit erfasst werden und berechnet werden können.

Alle Einstellungen lassen sich nachträglich Editieren.

mode="conditional"

ty:shop element="article"

Start-Tag für die Ausgabe eines Artikels

ty-Shop:articleDirectory

Gibt id der Artikel Directory aus

ty-Shop:articleDynamicFields
[ Beispiel ]

Dieses Tag wird dazu benutzt, die dynamischen Artikelstammdaten per ty-db-Tags auszulesen. Innerhalb dieses Tags kann mittels ty-db:... weitergearbeitet werden.

Die Funktionalitäten und Attribute dieses Tags entsprechen dem ty:db-Tag.

ty:shop element="basket"
[ Beispiel ]

ty-Shop:basketGoToBasket

Mit diesem Tag erzeugt man einen Link der zum Warenkorb weiterleitet

<ty-Shop:basketGoToBasket>Zur Bestellung</ty-Shop:basketGoToBasket>

Attribut	Beschreibung	Werte	Optional
order_id	Mit dem Attribut ist es möglich, einen Verweis auf einen bestimmten Basket zu erzeugen. <ty-Shop:basketGoToBasket order_id="83">Basket</ty-Shop:basketGoToOrder>	int

ty-Shop:basketGoToOrder

Mit diesem Tag erzeugt man einen Link der zum Bestellvorgang weiterleitet

<ty-Shop:basketGoToOrder>Zur Bestellung</ty-Shop:basketGoToOrder>

ty-Shop:basketOrderId

Gibt die Order_id des Aktuell geladenen Baskets zurück. Der Basket muss dazu schon gespeichert sein (DB).

<ty-Shop:basketOrderId />

Attribut	Beschreibung	Werte	Optional
format	Formatierung des zurückgegeben Wertes. Default => 000000018 Bsp. < format="%d" > 18

ty-Shop:basketPayment

Start-Tag zu Payment

ty-Shop:paymentPrice

Zusätzlicher Preis der Zahlungsart

ty-Shop:basketPostage

Ausgabe der Versandkosten

ty-Shop:basketProductIfHasDiscount

Start-Tag zum Prüfen ob es Rabatt für dieses Produkt gibt

ty-Shop:basketProductDiscountPercent

Wenn ja dann wird der Rabatt mit diesem Tag ausgegeben

ty-Shop:basketProductIfHasNoDiscount

Sollte es für das Produkt keinen Rabatt geben so kann mit diesem Tag ein Hinweis ausgegeben werden.

ty-Shop:basketProducts

Start-Tag für Ausgabe der Produkte im Warenkorb

ty-Shop:basketProductOptionId

Artikelnummer der gewählten Option (Variante des Produktes)

ty-Shop:basketProductPriceSingle

Einzelpreis des Produktes

ty-Shop:basketProductPriceSum

Gesamtpreis -> ergibt sich aus Anzahl und Einzelpreise des Produktes

ty-Shop:basketProductQuantity

Anzahl der Bestellten Produkte eines Produktes

ty-Shop:basketProductRemove

Mit diesem Tag kann man einen Artikel aus dem Warenkorb löschen. Als Löschbutton kann man eine Grafik oder Text verwenden welche einfach zwischen Start und End-Tag eingefügt wird.

<ty-Shop:basketProductRemove>Bild o. Text</ty-Shop:basketProductRemove>

ty-Shop:basketSumBrutto

Ausgabe Summe (brutto)

ty-Shop:basketSumBruttoTotal

Ausgabe Summe (gesamt brutto)

ty-Shop:basketSumNetto

Ausgabe Summe (netto)

ty-Shop:basketSumNettoTotal

Ausgabe Summe (gesamt netto)

ty-Shop:basketSumQuantity

Summe aller bestellten Artikel

ty-Shop:basketSumVat

Ausgabe der Mehrwertsteuer

ty-Shop:basketSumVatTotal

Ausgabe MwSt (gesamt)

ty-Shop:basketTrackingNr

Gibt die Trackingnr des Aktuell geladenen Baskets zurück. Der Basket muss dazu schon gespeichert sein (DB) und eine Trackingnr. vorhanden.

<ty-Shop:basketTrackingNr />

ty-Shop:basketUpdateBasket

Mit diesem Tag erzeugt man einen Aktualiesierungslink für den Warenkorb

<ty-Shop:basketUpdateBasket>AKTUALISIEREN</ty-Shop:basketUpdateBasket>

ty:shop element="basketlist"

Liest Warenkörbe als Schleife aus

Attribut	Beschreibung	Werte	Optional
status	Gibt nur die Warenkörbe mit entsprechenden Status zurück! Bis jetzt ist nur erlaubt Warenkörbe mit Status = queue sich anzeigen zu lassen. Es werden nur die Warenkörbe zurückgegeben von dem User der angemeldet ist!	queue	optional

ty:shop element="currencies"
[ Beispiel ]

Start-Tag für die Arbeit mit Währungen

ty-Shop:currency

Setzt Eigenschaften durch das Attribut mode

Attribut	Beschreibung	Werte	Optional
mode	Setzt Einstellungen für das Arbeiten mit <ty:shop element="currencies">	readonly

ty-Shop:currencyCode

Gibt den Code (Abkürzung) der Währung aus.

ty-Shop:currencySymbol

Gibt das Währungszeichen der Währung aus

ty:shop element="listOfArticles"
[ Beispiel ]

Attribut	Beschreibung	Werte	Optional
campaignFilter	"campaign" => gibt an, ob nur Artikel ausgelesen werden sollen, die mindestens eine Variante besitzen, zu welcher eine Kampagne angegeben ist. "nocampaign" => gibt an, ob nur Artikel ausgelesen werden sollen die mindestens eine Variante besitzen, zu welcher keine Kampagne angegeben ist.	campaign\|nocampaign	optional
keywordId	Nur gültig für source="keywordFilter". Erzeugt eine Artikelliste gefiltert nach Artikeln mit dem angegebenen Keyword.	integer
rel	dem Attribut rel kann ein Teil einer MySQL Where-Bedingung übergeben werden, die als zusätzliche AND-Bedingung in die Abfrage-Syntax der Artikeldatentabelle integriert wird.	String	optional
source / count	Dem Attribut source kann der Wert "random" zugewiesen werden. Dieser bewirkt das eine Zufällige Auswahl an Produkten angezeigt wird. Zusätzlich kann das Attribut count angewendet werden welches die maximal angezeigten Produkte auf einer Seite definiert. Mit lastvisited können die zuletzt besuchten Artikel ausgegeben werden. Diese müssen zuvor mit dem Tag <ty-Shop:articleAddToLastVisited /> hinzugefügt werden.	random, all, id, search, topic, articleDetailListe, keywordCrossselling, keywordFilter, topicextended, lastvisited	optional
use_main_topic	Beeinflusst, ob die angezeigte Artikelliste als Datengrundlage die Artikelliste des Hauptnavigationspunktes einer kopierten Navigation nutzt. Beispiel: Navigation wurde kopiert von Seite A nach B danach zu C, in Seite C und B erfolgt nun die Ausgabe der Artikel von Seite A	true\|1\|false\|0	optional

ty-Shop:articleGoBack

Zurück von der Detailseite zur Produktübersicht

<ty-Shop:articleGoBack>zurück</ty-Shop:articleGoBack>

ty-Shop:articleGoToArticle

Link auf Detailseite des Produktes mit Produktvarianten (html kann eingefügt werden zb. Bild oder Text Link)

<ty-Shop:articleGoToArticle><img src="" /></ty-Shop:articleGoToArticle>

ty-shop:articleListOfTopics

Das Tag ermöglicht das auslesen der zugewiesneen Artikelseiten an einem Artikel.

ty-shop:articleIsParentTopic

Prüft, ob die aktuelle Seite eine übergeordnete Seite der zugewiesenen Artikelseite, des aktuellen Elements ist.

ty-shop:articleIsSubTopic

Prüft, ob die aktuelle Seite eine untergeordnete Seite der zugewiesenen Artikelseite, des aktuellen Elements ist.

ty-shop:articleIsTopic

Prüft, ob die aktuelle Seite die Seite des zugewiesenen Artikels, des aktuellen Elements ist.

ty-shop:articleTopic

Gibt das Topic der aktuellen Seite zurück.

ty-Shop:articleOptions
[ Beispiel ]

Start-Tag für das Auslesen der Produkt Varianten

ty-shop:optionAdditionalData

gibt evtl. hinzugefügte zusätzliche Informationen zur Variante aus.

ty-Shop:optionBundleArticles

Iteriert über die in dem Bundle enthaltenen Artikel (gibt eine Liste von Artikeln in diesem Bundle aus).

Es wird keine Ausgabe erzeugt, wenn die Variante kein Bundle ist oder keine Artikel zugewiesen wurden.

ty-Shop:bundleArticleOptions

Iteriert über alle zu der Bundle Variante gehörenden Artikelvarianten.

Es können alle Tags zur Ausgabe der Varianteninformationen genutzt werden, wie diese für ty-Shop:articleOptions dokumentiert sind.

Bitte beachten Sie hierbei jedoch, das diesen Untertags ein neues Prefix hinzugefügt wurde, somit wird aus "ty-Shop:optionPrice" das Tag "ty-Shop:bundleOptionPrice".

ty-Shop:bundleOptionSelect
[ Beispiel ]

Ist in einem Bundle ein enthaltener Artikel mit mehr als einer Variante freigeschalten, so kann eine dieser Varianten vom Shopkunden ausgewählt werden können. Dieses Tag erzeugt hierzu einen Auswahlknopf vom typ <input type="radio".../>. Ist nur eine mögliche Variante, eines Artikel, zugelassen, so bedarf es keiner Auswahl, wodurch der Auswahlknopf verschwindet.

ty-shop:optionChoice

Gibt entweder einen Radio-Button oder eine Checkbox aus. Mit diesem Auswahlfeld kann man die einzelnen Komponenten auswählen.

Das Label des Auswahlfeldes wird erzeugt, wenn man die Bezeichnung innerhalb dieses Tags schreibt. (<ty-shop:optionChoice/>Beschreibung</ty-shop:optionChoice>)

Dieser Tag funktioniert nur in Verbindung mit dem Komponenten-System.

Attribut	Beschreibung	Werte	Optional
class	Gibt die CSS-Klasse an, die an das Auswahlfeld geschrieben wird.	Zeichenkette	optional
errorClass	Gibt die CSS-Klasse an, die im Fehlerfall an das Auswahlfeld geschrieben wird.	Zeichenkette	optional
labelClass	Gibt die CSS-Klasse an, die an das Label-Tag des Auswahlfelds geschrieben wird.	Zeichenkette	optional
labelErrorClass	Gibt die CSS-Klasse an, die im Fehlerfall an das Label des Auswahlfelds geschrieben wird.	Zeichenkette	optional

ty-shop:optionComponentsAvailable

Gibt den Inhalt des Tags aus, wenn die aktuelle Variante Komponenten zur Auswahl anbieten kann.

Das Gegenteil dieses Tags ist ty-shop:optionComponentsNotAvailable

ty-shop:optionComponentsErrorConditional

Gibt den Inhalt des Tags aus, wenn Fehler bei der Komponentenauswahl aufgetreten sind.

Das Gegenteil dieses Tags ist: ty-shop:optionComponentsErrorConditionalFallback

ty-Shop:optionDaysToSupply

Ausgabe der Lieferzeit des Produktes

ty-Shop:optionDirectory

Ausgabe der Option-Ordner-id

ty-shop:optionDiscountGroupName

gibt den Namen des Rabattes aus, der verwendet wird.

ty-shop:optionDynamicFields
[ Beispiel ]

Dieses Tag gibt die dynamisch verknüpften Stammdaten (über Formularmanager-Formular) einer Variante aus.

Innerhalb dieses Tags muss mit den "ty-db"-Tags gearbeitet werden.

Attribut	Beschreibung	Werte	Optional
formId	Mit diesem Attribut kann man bestimmen, welches der verknüpften Formulare ausgegeben werden soll.	positive Ganzzahlen	optional

ty-shop:optionDynamicFieldsConditional

Gibt den geparsten Inhalt des Tags aus, wenn dynamische Stammdaten für diese Variante vorhanden sind.

ty-shop:optionDynamicFieldsFallback

Gibt den Inhalt des Tags aus, wenn keine dynamischen Stammdaten für die aktuelle Variante vorhanden sind.

ty-Shop:optionEAN

Ausgabe der EAN Nr. (frei definierte Artikelnummer)

ty-shop:optionFooter

Gibt den Inhalt des Tags aus, wenn die letzte Variante der Liste iteriert wird. Achtung! Der Tag wird an der Stelle ausgegeben, wo er im Quelltext steht.

ty-Shop:optionGoToOption

Link auf die Detailseite des Produktes

<ty-Shop:optionGoToOption>DETAILS</ty-Shop:optionGoToOption>

ty-shop:optionHeader

Gibt den Inhalt des Tags aus, wenn die erste Variante iteriert wird. Der Inhalt wird an der Stelle ausgegeben, wo auch der Tag steht.

ty-Shop:optionHighestBundleBruttoPrice

Gibt den höchst möglichen Bruttopreis des Bundles aus.

ty-Shop:optionHighestBundleNettoPrice

Gibt den höchst möglichen Nettopreis des Bundles aus.

ty-Shop:optionHighestBundlePrice

Gibt den höchst möglichen Preis des Bundles aus.

ty-Shop:optionIfHasCampaign

Start-Tag für Regulären Preis ohne Abzüge von zB. Rabatt

ty-Shop:optionRegularPrice

Dieser Tag gib den Regulären Preis ohne den Prozentualen Abzug, zB. einer Rabattaktion, aus.

<ty:Shop:optionIfHasCampaign><ty-Shop:optionRegularPrice/></ty-Shop:optionIfHasCampaign>

ty-Shop:optionImage

Bild der ausgewählten Produktoption

Attribut	Beschreibung	Werte	Optional
height	Maximale Bildhöhe in Pixel
width	Maximale Bildbreite in Pixel

ty-Shop:optionIsBundle

der enthaltene Quelltext wird ausgegeben, wenn diese Variante ein Bundle ist.

ty-Shop:optionIsNoBundle

der enthaltene Quelltext wird ausgegeben, wenn diese Variante kein Bundle ist.

ty-Shop:optionLowestBundleBruttoPrice

Gibt den niedrigst möglichen Bruttopreis des Bundles aus.

ty-Shop:optionLowestBundleNettoPrice

Gibt den niedrigst möglichen Nettopreis des Bundles aus.

ty-Shop:optionLowestBundlePrice

Gibt den niedrigst möglichen Preis des Bundles aus.

ty-Shop:optionPrice

Ausgabe des zu bezahlenden Preises der Produktvariante

Abwandlungen:
- Brutto: optionBruttoPrice
- Netto: optionNettoPrice

Attribut	Beschreibung	Werte	Optional
nopricetext	wenn variante nicht bestellbar ist, und preis 0 Euro und das Attribut nopricetext definiert ist, wird dieser Text zurückgegeben	{Text}

ty-shop:optionRoleDiscountConditional
[ Beispiel ]

Gibt den Inhalt des Tags zurück, wenn ein Rollenabhängiger Preis eingestellt wurde.

ty-shop:optionRoleDiscount

gibt den Rabatt der Rolle in Prozent aus

ty-shop:optionRoleDiscountPrice

gibt den Wert des Rabattes aus.

Abwandlungen:
- Brutto: optionRoleDiscountBruttoPrice
- Netto: optionRoleDiscountNettoPrice

ty-shop:optionRoleDiscountConditionalFallback

gibt den Inhalt des Tags zurück, wenn kein Rollenabhängiger Preis definiert wurde.

ty-shop:optionScalePriceList

übergeordneter Tag für die Rabattbezogenen Preisausgaben

ty-shop:optionScalePriceId

ID des verwendeten Rabattes

ty-shop:optionScalePriceMaxCount

maximale Anzahl der zu bestellenden Artikel, um Rabatt zu erhalten

ty-shop:optionScalePriceMinCount

minimale Anzahl der zu bestellenden Artikel, um den Rabatt zu erhalten.

ty-shop:optionScalePricePercent

gibt den Prozentwert des verwendeten Rabattes aus.

ty-shop:optionScalePricePrice

neuer Preis nach Abzug des Rabattes

Abwandlungen:
- Bruttopreis: optionScalePricePriceBrutto
- Nettopreis: optionScalePricePriceNetto

ty-shop:optionScalePricePriceDiscount

gibt den Wert aus, wieviel vom Regulären Preis abgezogen wurde.

Abwandlungen:
- Brutto: optionScalePricePriceBruttoDiscount
- Netto: optionScalePricePriceNettoDiscount

ty-shop:optionScalePriceSign

gibt den Vergleichsoperator für den Vergleich der Bestellmenge mit den eingegebenen Werten für den Mengenrabatt aus (z.B. kleiner als)

ty-Shop:optionTitle

Ausgabe der Überschrift der Produktvariante

ty-Shop:optionToBasket

Erzeugt ein Eingabefeld in dem Sie festlegen können wieviel mal der Artikel in den Warenkorb gelegt werden sollen. Es sind auch Kommastellen möglich.
Bitte beachten Sie hierzu die notwendigen Attribute.

<ty-Shop:optionToBasket class="button" withButton="no" editable="yes">test</tyShop:optionToBasket>

class => Variables Attribut: definiert das Ausehen des Buttons durch eine zugewiesene Klasse
withButton="no" => Notwendiges Attribut
editable="yes" => Notwendiges Attribut
type="submit" => optionales Attribut (es wird ein submit Button erzeugt)

Falls der Artikel Komponenten zugewiesen bekommen hat wird über diesen Button der erste Konfigurationsschritt aufgerufen und das Produkt noch nicht im Warenkorb hinzugefügt.

ty-Shop:optionToBasketButton

Produkt "in den Warenkorb" legen (html kann eingefügt werden zb. Bild oder Text link)
<ty-Shop:optionToBasketButton><img src=""></ty-Shop:optionToBasketButton>

ty-Shop:optionToNotice

Erzeugt einen Button, zum hinzufügen dieser Variante zu einer Merkliste.

Attribute:
type="submit" => optional (Erzeugt einen etwas Button vom typ input type="submit")
class="" => optional (angabe einer CSS-Klasse)

ty-Shop:optionToRequest

Wie optiontoBasket nur markiert Artikel als Anfrage

ty-Shop:optionVar1NameConditional

Zeigt Inhalt des Tags an, wenn Optionsvariante 1 gegeben ist.
Var1 - Var5 ist möglich.

ty-Shop:optionVar1Entity

Liest Name/Bezeichnung der Variante 1 aus. Kann in ty:content geschrieben werden, damit es übersetzbar wird. Tag ist selbst schließend.

ty-Shop:optionVar1Value

Liest Wert der Variante 1 aus. Kann in ty:content geschrieben werden, damit es übersetzbar wird. Tag ist selbst schließend.

ty-Shop:listOfArticlesArticle

Start-Tag für das Auslesen der Produktliste

Attribut	Beschreibung	Werte	Optional
count	legt die Anzahl der Angezeigten Produkte fest count="2" es werden maximal zwei Produkte aus der Liste angezeigt

ty-Shop:articleAddToLastVisited

Fügt den Artikel zur Liste der zuletzt besuchten Artikel hinzu.

Attribut	Beschreibung	Werte	Optional
maxEntries	Begrenzt die Liste der zuletzt besuchten Artikel. Standardeinstellung ist 10. Sollen mehr zuletzt besuchte Artikel ausgegeben werden, muss die Anzahl hier erhöht werden.		optional

ty-Shop:articleDescription

Ausgabe der Produktbeschreibung allgemein

ty-shop:articleDTPObject

gibt die ID des DTP-Objektes aus, welches am Artikel eingestellt wurde

ty-shop:articleHighestPrice

gibt den höchsten Preis aller Varianten des Artikels aus (s. optionPrice).

ty-Shop:articleId

ID Nr. aus der Datenbank

ty-Shop:articleImage

Ausgabe des Produkt Bildes

Attribut	Beschreibung	Werte	Optional
align	mit align legt man die Ausrichtung des Bildes fest
class	mit diesem Attribut kann man dem Image eine Stylecheet-Definition zuweisen
height	legt die maximale Bildhöhe in Pixeln fest
width	legt die maximale Bildbreite in Pixeln fest

ty-Shop:articleImages

Start-Tag für die Auflistung aller dem Produkt zugewiesenen Bilder

Attribut

Beschreibung

Werte

Optional

count

legt fest wieviele Bilder angezeigt werden sollen

count="2" es werden zwei Bilder angezeigt beginnend vom dem mit dem Attribut start festgelegten Wert

ignoreEmpty

ignoriert nicht vorhandene Bilder Standardwert ist "0"

1|true|0|false

optional

start

legt fest welches Bild als erstes angezeigt wird zb.
start="1" für erstes Bild in der Datenbank

ty-Shop:image

Ausgabe aller Produkt Bilder

Attribut	Beschreibung	Werte	Optional
height	maximale Bildhöhe in Pixel
width	maximale Bildbreite in Pixel

ty-Shop:articlelistOfKeywords

Übertag, um die Schlüsselwörter des Artikels auszugeben

gibt ein einzelnes Keyword aus

ty-Shop:articleLowestPrice

Ausgabe des Preises ab: "niedrigster Preis für Produkt" bezogen auf Produktvarianten

ty-Shop:articleManufacturer

ausgabe des Herrstellers des Produktes

ty-Shop:articleName

Ausgabe des Produkt Namens

Attribut	Beschreibung	Werte	Optional
maxlength	Die Ausgabe wird mit diesem Attribut auf eine gewisse Zeichenanzahl begrenzt maxlength="50" es werden maximal 50 Zeichen ausgegeben dieses Attribut ist auch auf die Tags <ty-Shop:articleTeaser/> ; <ty-Shop:articleDescription/> ; <ty-Shop:optionTitle/> anwendbar

ty-Shop:articleTeaser

Ausgabe der Kurzbeschreibung des Produktes

ty-Shop:articleVat

Liefert Informationen über den Mehrwertsteuerprozentsatz

ty-Shop:listOfArticlesNoArticles

Hinweis das kein Artikel in dieser Kategorie vorhanden ist

<ty-Shop:listOfArticlesNoArticles>In dieser Kategorie ist kein Artikel vorhanden!</ty-Shop:listOfArticlesNoArticles>

ty:shop element="listOfComponents"
[ Beispiel ]

Dieser Tag stellt die Funktionalität des Komponentensystems bereit. Er wird verwendet, um die Komponenten(-gruppen) eines ausgewählten Artikels auszulesen.

Die Untertags benutzen den Namespace "ty-shop-components".

ty-shop-components:conditional

Gibt den Inhalt des Tags aus, wenn im aktuellen Konfigurator-Schritt konfigurierbare Komponenten zugewiesen wurden.

Andernfalls wird nichts ausgegeben.

ty-shop-components:fallback

Gibt den Inhalt aus, wenn keine Komponentengruppen im aktuellen Schritt zugewiesen wurden.

Andernfalls wird nichts ausgegeben.

ty-shop-components:form

Dieser Tag gibt einerseits das Formular aus, um die Auswahl der Komponenten abzuspeichern.

Andererseits stellt dieses Tag Schaltflächen bereit, mit denen man Schrittweise vor und zurück springen kann oder die Konfiguration abzuschließen und das Produkt in den Warenkorb zu legen.

Es können hier alle Attribute eines "form"-Tags benutzt werden, außer "method" und "action".

Dieser Tag ist notwendig, für den Komponenten-Konfigurator!

ty-shop-components-form:addToBasket

Gibt einen Button und optional ein Eingabefeld aus, um das konfigurierte Produkt in den Warenkorb zu legen.

Als Attribute können alle unterstützten HTML-Attribute vergeben werden, außer die Attribute "type", "name" und "value".

Attribut

Beschreibung

Werte

Optional

type

Gibt den Typ des Eingabefeldes für die Bestellmenge an.

Wenn kein Typ definiert ist wird ein verstecktes Eingabefeld mit der Menge 1 erzeugt.

Falls der Typ "select" definiert wurde kann man über das Attribut "values" die einzelnen Auswahlwerte Komma-getrennt angeben.

Den Standardwert definiert man über das Attribut "value".

editable, select

optional

ty-shop-components-form:inBasket

Gibt den Inhalt des Tags aus, wenn der aktuell gewählte Hauptartikel bereits im Warenkorb hinzugefügt wurde.

ty-shop-components-form:nextsStepAvailable

Gibt den Inhalt des Tags aus, wenn es nach dem aktuellen Konfigurationsschritt einen weiteren aufrufbaren Schritt gibt.

ty-shop-components-form:nextStep

Gibt einen Submit-Button aus, der zum nächsten Konfigurationsschritt leitet. Die Auswahl der Komponenten wird dabei gespeichert.

Als Attribute können alle unterstützten HTML-Attribute vergeben werden, außer die Attribute "type", "name" und "value".

ty-shop-components-form:nextStepNotAvailable

Gibt den Inhalt des Tags aus, wenn es nach dem aktuellen Konfigurationsschritt keinen weiteren aufrufbaren Schritt gibt.

ty-shop-components-form:notInBasket

Gibt den Inhalt des Tags aus, wenn der aktuell gewählte Hauptartikel noch nicht dem Warenkorb hinzugefügt wurde.

ty-shop-components-form:previousStep

Gibt einen Submit-Button aus, der zum vorherigen Konfigurationsschritt leitet. Die Auswahl der Komponenten wird dabei gespeichert.

Als Attribute können alle unterstützten HTML-Attribute vergeben werden, außer die Attribute "type", "name" und "value".

ty-shop-components-form:previousStepAvailable

Gibt den Inhalt des Tags aus, wenn es vor dem aktuellen Konfigurationsschritt einen weiteren aufrufbaren Schritt gibt.

ty-shop-components-form:previousStepNotAvailable

Gibt den Inhalt des Tags aus, wenn es vor dem aktuellen Konfigurationsschritt keinen weiteren aufrufbaren Schritt gibt.

ty-shop-components-form:updateBasket

Gibt einen Button und optional ein Eingabefeld für die Menge aus, mit dem man die aktuelle Konfiguration des gewählten Produktes im Warenkorb aktualisieren kann.

Als Attribute können alle unterstützten HTML-Attribute vergeben werden, außer die Attribute "type", "name" und "value".

Attribut

Beschreibung

Werte

Optional

type

Gibt den Typ des Eingabefeldes für die Bestellmenge an.

Wenn kein Typ definiert ist wird ein verstecktes Eingabefeld mit der Menge 1 erzeugt.

Falls der Typ "select" definiert wurde kann man über das Attribut "values" die einzelnen Auswahlwerte Komma-getrennt angeben.

editable, select

optional

ty-shop-components:groups

Iteriert über alle im aktuellen Schritt zugewiesenen Komponentengruppen

ty-shop-components-groups:articles

Iteriert über die der Gruppe zugewiesenen Komponenten. Innerhalb dieses Tags wird mit dem Prefix "ty-shop:article..." weitergearbeitet.

ty-shop-components-groups:conditional

Gibt den Inhalt des Tags aus, wenn Komponenten dieser Gruppe zugewiesen sind.

ty-shop-components-groups:fallback

Gibt den Inhalt des Tags aus, wenn keine Komponenten der Gruppe zugewiesen sind.

ty-shop-components-groups:name

Gibt den Namen der Komponentengruppe aus.

Dieser ist gleich des Namens der eingestellten Artikelgruppe der zugewiesenen Artikel.

Attribut	Beschreibung	Werte	Optional
htmlentities		true, false	optional

ty:shop element="listOfKeywords"

ty-shop:listOfKeywords

iteriert über Keywordliste

Attribut	Beschreibung	Werte	Optional
articleId	Liefert die Keywords eines speziellen Artikels zurück. Wenn dieses Attribut nicht angegeben ist und die Liste auf der Artikeldetailseite ausgegeben wird, wird die Keywortliste des angezeigten Artikels generiert. (nur in Kombination source="article" gültig)	integer	optional
crossselling	Keywords von Seitenabhängigen Artikeln beziehen sich auf die alternativen Crossellingartikellisten der angegebenen Seiten und nicht auf die Standard Artikellisten dieser Seiten.	0,1	optional
ids	gibt eine Menge von ArtikelIds an (nur in Kombination source="id" gültig)	1,2,3,4,5,...	optional
source	gibt die Quelle an, welche als Artikelliste genutzt werden soll	id,article,search,topic,articleDetailList,topicextended	optional
topic	topic welches bei der auslesung der Keywords genutzt werden soll, default ist aktuelles Topic der Seite	topic1,topic2,topic3	optional
topic_menge	gibt an, wie die Artikellisten behandelt werden sollen, wenn mehr als ein topic angegeben wurde. Bildet bei mehreren Artikleln eine Vereinigungs- oder Schnittmenge der Artikellisten zu den Seiten.	union,intersection	optional

ty-shop:KeywordCaption

ty-shop:KeywordId

ty-shop:KeywordLanguage

ty:shop element="listOfNotices"

Erzeugt eine Liste von Notizzetteln des aktuellen Nutzers

Attribut	Beschreibung	Werte	Optional
order	Sortiert Merklisten zur Ausgabe nach einem bestimmten Merkmal.	name	optional
type	Es wird ein Formular ausgegeben. Dieses Attribut ist erforderlich, sobald Schaltflächen oder Eingabefelder verwendet werden. Das Attribut kann entfallen, wenn bereits ein Formular existiert.	form

ty-Shop:listOfNoticesCreate

Erzeugt eine neue Merkliste.

ty-Shop:listOfNoticesNoNotices

Gibt den enthaltenen Quelltext aus, wenn keine Merklisten vorhanden sind.

ty-Shop:listOfNoticesNotice

iteriert über Notizzettel des Nutzers

Attribut	Beschreibung	Werte	Optional
limit	Limitiert die Ausgabe der Merklisten auf eine bestimmte Anzahl.	0\|integer	optional

ty-Shop:noticeActivate

Ausgabe einer Checkbox, eines Buttons oder einer Schaltfläche zum Aktivieren dieser Merkliste.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input\|checkbox	optional

ty-Shop:noticeActive

Der Status aktiv bezieht sich auf das hinzufügen eines Artikels zu einer Merkliste. Klickt der Nutzer auf zur Merkliste hinzufügen Button, wird der Artikel zur aktiven Merkliste hinzugefügt. Ausgabe des enthaltenen Quelltextes, wenn die liste aktiv ist.

ty-Shop:noticeAddToBasket

Fügt alle Produkte der Merkliste zum Warenkorb hinzu. Sind bereits Produkte im Warenkorb, so wird deren Anzahl entsprechend erhöht.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input	optional

ty-Shop:noticeIndex

Gibt eine interne Nummer des Notizzettels aus.

ty-Shop:noticeMoveSelectedToBasket

Fügt die markierten Produkte der Merkliste dem Warenkorb hinzu. Der Inhalt des Warenkorbes wird dabei ersetzt!

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input	optional

ty-Shop:noticeMoveToBasket

Fügt die alle Produkte der Merkliste dem Warenkorb hinzu. Der Inhalt des Warenkorbes wird dabei ersetzt.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input	optional

ty-Shop:noticeName

ty-Shop:noticeNotActive

Ausgabe des enthaltenen Quelltextes, wenn die liste nicht aktiv ist.

ty-Shop:noticeNoticeListError

Gibt den enthaltenen Quelltext beim auftreten eines Fehlers aus.
Ist das Attribut error="Name des Fehlers" gesetzt, so wird ein bestimmter FehlerCode abgefragt.

folgende Fehlercodes sind möglich:
"noticeListSended" => wird gesetzt, wenn ein Merkzettel als EMail versandt wurde.
"noNoticeListTemplate" => es wurde versucht eine Merklisten EMail zu versenden, obwohl kein Mailvorlagentemplate eingestellt ist.
"noticeListRecipient" => keine gültige Empfängeradresse / Adresse besitzt falsches Format
"noNoticeListRecipient" => keine Empfängeradresse angegeben

Attribut	Beschreibung	Werte	Optional
error	Gibt einen speziellen Fehler aus.	noticeListSended\|noNoticeListTemplate\|noticeListRecipient\|noNoticeListRecipient	optional

ty-Shop:noticeNoticeListRecipient

Gibt ein Eingabefeld zur Eingabe der EMailadresse des Empfängers einer bestimmten Merkliste aus.

ty-Shop:noticeProducts

Jede Merklisten wird als Warenkorb behandelt, daher können Warenkorb Tags ebenso genutzt werden, der Prefix basket wird jedoch für Merklisten durch notice ersetzt.

Beispiel: <ty-Shop:basektProducts>...</ty-Shop:basketProducts> wird in einer Merkliste durch <ty-Shop:noticeProducts>...</ty-Shop:noticeProducts> verarbeitet.

ty-Shop:noticeProductOptionCheckbox

Erzeugt eine Auswahlbox, diese bezieht sich auf die Aktionen, welche mit einer Merkliste durchgeführt werden (z.B. ausgewählte Artikel zum Warenkorb hinzufügen, Artikel aus der Merkliste löschen)

ty-Shop:noticeRemove

Entfernt die komplette Merkliste des Nutzers inclusive aller darin befindlichen Artikel.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input\|checkbox	optional

ty-Shop:noticeRemoveSelected

Entfernt nur die markierte Artikel aus einer bestimmten Merkliste des Nutzers.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input	optional

ty-Shop:noticeSendNoticeList

erzeugt eine Schaltfläche zum versenden der Merkliste per EMail.

Attribut	Beschreibung	Werte	Optional
class	HTML - "class" Attribut		optional
id	HTML - "id" Attribut		optional
style	HTML - "style" Attribut		optional
type	HTML - "type" Attribut	button\|input	optional

ty:shop element="listOfOrders"

Gibt eine Liste mit allen Bestellungen des aktuellen Nutzers aus

Attribut	Beschreibung	Optional
count	Gibt an wieviele Bestellungen pro Seite ausgegeben werden sollen	optional
order	Hier kann die Sortierung der Bestellungen im SQL Format angegeben werden	optional
rel	Hier können Bedingungen für die Bestellungen im SQL Format angegeben werden, z.B. rel="payment = 'unpaid'"	optional
userId	Ist dieses Attribut gesetzt, werden die Bestellungen des angegebenen Nutzers ausgegeben und nicht die des aktuell angemeldeten. Sinnvoll z.B. bei Übersichten für Administratoren	optional

ty-shop:flipflop

Gibt einen Wert zwischen 0 und 1 aus, wenn das Attribut "rate" nicht gesetzt ist. Ansonsten wird ein Wert zwischen 0 und rate - 1 ausgegeben

ty-shop:orderArticleCount

Gibt aus, wieviele Artikel sich in der Bestellung befinden

ty-shop:orderArticles

Gibt alle Artikel der Bestellung aus. Als Untertags können weitestgehend auch die Tags der normalen Artikelliste verwendet werden, allerdings in folgender Form:

<ty-shop-orderArticles:articleName/> für Eigenschaften der Artikel

<ty-shop-orderArticles:optionFreeoption3/> für Eigenschaften der Artikelvariante

ty-shop:orderBills

Gibt alle Rechnungen zur aktuellen Bestellung aus

ty-shop:orderId

Gibt die Id der Bestellung aus

ty-shop:pager

Gibt einen Pager für die Bestellungen aus. Verwendet die selben Untertags wie die anderen Pager

ty:shop element="login"

Start-Tag für den Login

ty-Shop:loginEmail
[ Beispiel ]

Textfeld für den Eintrag der Emailadresse

ty-Shop:loginErrorMessage

Ausgabe der Fehlermeldung bei Falscheingabe

ty-Shop:loginPassword

Textfeld für den Eintrag des Passwortes

ty-Shop:loginTryLogin

Anmeldefunktion

<ty-Shop:loginTryLogin>Anmelden</ty-Shop:loginTryLogin>

ty:shop element="order"
[ Beispiel ]

ty-Shop:orderAcceptTermsAndConditions

Erzeugt eine Checkbox und eine Abfrage ob diese angewählt wurde. Ist im Setup die Einstellung aktiviert, das die AGBs zwingend akzeptiert werden müssen, so schlägt die Bestellung fehl, wenn die Checkbox nicht angewählt wurde.

ty-shop:orderGoToCustomerForm

Erzeugt einen Link, der auf die Nutzerdaten-Eingabe-Seite verweist

ty-shop:orderGoToPaymentForm

Erzeugt einen Link, der auf die Zahlungsarten-Auswahl-Seite verweist

ty-Shop:orderIfPaymentIsNotSelected

gibt nachfolgenden inhalt (fehlermeldung) aus, wenn keine zahlungsart gewählt wurde

ty-Shop:orderPayments

Start-Tag für Zahlungsarten

ty-Shop:orderErrorMessage

Fehlermeldung bei Bestellung

ty-Shop:orderSubmitOrder

Bestellung abschicken

<ty-Shop:orderSubmitOrder>Bestellen</ty-Shop:orderSubmitOrder>

ty-shop:paymentAuthorizationErrorConditional

Gibt den Inhalt des Tags aus, wenn ein Fehler bei der Überprüpfung seitens des Kreditkartenbetreibers aufgetreten ist bzw. wenn der Nutzer die Authorisierung abgebrochen hat.

ty-shop:paymentAuthorizationErrorMessage

Dieser Tag gibt eine Fehlermeldung aus, wenn ein Fehler bei der Überprüfung der Kreditkartendaten durch den Kreditkartenbetreiber aufgetreten ist.

Er kann als Selbstschließender Tag oder auch mit benutzerdefiniertem Inhalt verwendet werden. Die Ausgabe ist über per globalem Textfeld übersetzbar bzw. änderbar.

ty-shop:paymentAuthorizationFrame
[ Beispiel ]

Dieser Tag gibt einen IFrame aus, der auf die Überprüfungsseite des Kreditkartenbetreibers leitet. Dort wird dann die Überprüfung der Kreditkartendaten nach dem (3D-Secure-Verfahren) durchgeführt.

Dem Tag können alle Attribute, die laut W3C für das Tag iframe erlaubt sind, angegeben werden.

Alternativ kann auch der Tag <ty-shop:paymentAuthorizationLink/> genutzt werden, welcher lediglich die URL zum Kreditkartenbetreiber ausgibt.

ty-shop:paymentAuthorizationFrameConditional

Dieser Tag gibt seinen Inhalt aus, wenn eine Authorisierung seitens des Kreditkartenbetreibers für die gewählte Zahlungsart nötig ist (3D-Secure-Verfahren).

Falls keine Authorisierung nötig ist wird nichts ausgegeben.

ty-shop:paymentAuthorizationFrameFallback

Dieser Tag gibt seinen Inhalt aus, wenn keine Authorisierung seitens des Kreditkartenbetreibers (3D-Secure-Verfahren) nötig ist.

Andernfalls wird der Inhalt des Tags ausgegeben.

ty-Shop:paymentPrice

Zahlungsart Preis

ty-Shop:paymentSelect

Alle Zahlungsmethoden

ty-Shop:paymentName

Zahlungsart Name

ty-shop:orderStorePaymentData

Erzeugt das HTML-Element <button>, der als Aktion die Speicherung der ausgewählten Zahlungsart und die Weiterleitung zum nächsten Schritt zur Folge hat.

Attribut	Beschreibung	Werte	Optional
class	mit diesem Attribut lassen sich die CSS-Klasse(n) für dieses HTML-Element definieren		optional
id	bestimmt das Attribut "id" des HTML-Tags		optional

ty:shop element="request"

ty:shop element="user"

Start-Tag für die Erfassung und Ausgabe der Daten des Käufers

ty-Shop:userAdditional

Zusätzliche Angaben des Benutzers

ty-Shop:userAddress

Addresse

ty-Shop:userBirthday

Geburtstag

ty-Shop:userCity

Stadt

ty-Shop:userCompany

Firma

ty-Shop:userCountry

Land

ty-shop:userDataStorage

Dieses Tag gibt eine Checkbox aus, die verwendet wird um vom Nutzer abzufragen, dass er der Speicherung seiner persönlichen Daten zustimmt.

Attribut	Beschreibung	Werte	Optional
class	mit diesem Attribut lassen sich die CSS-Klasse(n) für dieses HTML-Element definieren		optional
id	bestimmt das Attribut "id" des HTML-Tags		optional

ty-Shop:userEmail

ty-Shop:userErrorMessages

Start-Tag für die Fehlerausgabe

ty-Shop:message

Fehlerausgabe bei Falscheingabe der User-Daten

ty-shop:userErrorMessagesConditional

Dieses Tag gibt den Inhalt von sich selbst aus, wenn bei der Speicherung der Nutzerdaten Fehler aufgetreten sind.

Beispielsweise, wenn der Nutzer ein Pflichtfeld nicht korrekt ausgefüllt hat.

ty-Shop:userFax

Faxnummer

ty-Shop:userFirstname

Vorname

ty-Shop:userGotoCustomerForm

Link auf Formular zum Ändern der Kundendaten oder
zur Bestellung ohne Login

<ty-Shop:userGotoCustomerForm></ty-Shop:userGotoCustomerForm>

ty-Shop:userLastname

Nachname

ty-shop:userNotes

Gibt die Bemerkungen des Nutzers zur Bestellung aus bzw. generiert ein Eingabe- oder Textfeld

Attribut	Beschreibung	Werte	Optional
cols	gibt an, wieviele Spalten das Textfeld breit sein soll	Ganzzahl	optional
rows	gibt an, wieviel Zeilen das Textfeld hoch sein soll	Ganzzahl	optional
tag	gibt an, ob das Formularelement ein Eingabefeld oder ein Textfeld sein soll	textarea	optional

ty-Shop:userPhone

Telefonnummer

ty-shop:userSalutation

Erzeugt das Formularelement für die Anrede

Attribut

Beschreibung

Werte

Optional

type

Definiert den Typ des Formularelements.

Mögliche Werte sind:

select - Auswahlfeld mit den Optionen "Bitte wählen", "Frau", "Herr". Die Bezeichnungen sind globale Textfelder

Das Standard-Formularelement ist ein Textfeld.

select

optional

ty-Shop:userStoreUserData

Funktion zum Speichern der User-Daten

<ty-Shop:userStoreUserData>Speichern</ty-Shop:userStoreUserData>

ty-shop:userVATID

gibt die Umsatzsteuer-ID des Kunden aus bzw. stellt das Formularfeld für die Eingabe zur Vefügung

ty-Shop:userZip

Postleitzahl

ty:shortsitemap

Short Sitemap

Der ty:shortsitemap Tag erlaubt das Auslesen des aktuellen Navigationspfades. Diese Funktion ist auch bekannt als "bread crumble path"...

Attribut	Beschreibung	Werte	Optional
show	Anzeige von unsichtbaren Navigationspunkten erzwingen. Standardmäßig werden diese ausgeblendet.	invisible	optional

ty-shortsitemap:caption

Ausgabe als Text

ty-shortsitemap:url

der aktuelle Navigationspfad wird als URL ausgegeben

ty:siteroles

Rechtemanagement für die Webseite

Ermöglicht das Setzen von Zugriffsrechten auf bestimmte Bereiche.

mode="access"
[ Beispiel ]

Der nachfolgende Bereich wird angezeigt, wenn der Benutzer mindestens eine Richtlinie besitzt, welche es ihm erlaubt in dem Modul „freidefinierbar_aber_existent„ auf die Resource: “ freidefinierbar/freidefinierbar“ die aktion: “freidefinierbar“ auszuführen.

Attribut	Beschreibung	Werte	Optional
action	Gibt die aktion an, welche auf Ausführbarkeit geprüft werden soll.
modul	Gibt das modul an, auf welchen der zugriff geprüft werden soll.
ressource	Gibt die ressource an, auf welche der zugriff geprüft werden soll.

mode="addrole"
[ Beispiel ]

Fügt einem Nutzer eine neue Rolle hinzu. Der Rollenname wird wie bei register durch "role" angegeben.

mode="attribut-value"
[ Beispiel ]

Ermöglicht die Ausgabe von Attributwerten.

Attribut	Beschreibung	Werte	Optional
name	Wählt das Attribut aus.

ty-siteroles:name

Gibt den Namen des ausgewählten Attributs aus (sinnvoll bei Verwendung in Schleifen)

ty-siteroles:value

Gibt den Wert des ausgewählten Attributs wieder.

mode="attributes"
[ Beispiel ]

Geht der Reihe nach alle Attribute durch. Ausgabe erfolgt durch die selben Befehle wie bei attribut-value.

mode="delrole"

Entfernt eine Rolle vom Nutzer. Funktionsweise identisch mit "addrole", Beispiel siehe "addrole".

mode="error"

gibt den Code aus, wenn die Meldung im Attribut "name" gesetzt ist.

Die jeweiligen Statusmeldungen entnehmen Sie bitte der Tagbeschreibung für den jeweiligen Anwendungsfall.

mode="forgot"
[ Beispiel ]

Schickt ein neues Passwort an den Nutzer, falls dieser seins vergessen hat. Der Submitbutton des Formulars muss den Namen "forgot" haben.

mode="inrole"

Gibt den Inhalt des Tags aus, wenn der Nutzer in der Rolle ist, die in role="..." angegeben wurde.

mode="loggedin"
[ Beispiel ]

Überprüft ob man eingeloggt ist und führt wenn man eingeloggt ist den nachfolgenden Code aus.

mode="loggedout"

Überprüft ob man eingeloggt ist und führt wenn man nicht eingeloggt ist den nachfolgenden Code aus. Beispiel siehe mode="loggedin".

mode="noaccess"

Funktionsweise wie mode="access" nur für den Fall, das man keinen Zugriff hat. Beispiel siehe mode="access".

mode="noerror"

gibt den Code aus, wenn die Meldung im Attribut "name" nicht gesetzt ist.

Die jeweiligen Statusmeldungen entnehmen Sie bitte der Tagbeschreibung für den jeweiligen Anwendungsfall.

mode="notinrole"

Gibt den Inhalt des Tags zurück, wenn der Nutzer nicht in der in role="..." angegebenen Rolle ist

mode="optinout"
[ Beispiel ]

stellt z.B. den Opt-In-Link zur Verfügung

Folgende Statusmeldungen werden nach dem Opt-Vorgang zurückgeliefert:

Opt-In:

optin_success - Opt-In erfolgreich
optin_failure - Fehler bei Opt-In
allready_in_status - Benutzer ist schon freigeschalten

Opt-Out:

optout_success - Opt-Out erfolgreich
optout_failure - Opt-Out nicht erfolgreich

Generelle Meldungen:

wrong_signature - Signatur stimmt nicht überein
wrong_user - Benutzer stimmt nicht überein
user_not_found - Benutzer konnte nicht anhand des Links gefunden werden

Die Statusmeldungen können dann mit:
<ty:siteroles mode="error" name="[status]">Ausgabe</ty:siteroles>
abgefragt werden.

ty-siteroles:optinLink

Gibt den Opt-In-Link für den aktuell registrierten Nutzer aus

Attribut	Beschreibung	Werte	Optional
rewrite	gibt an, ob der Link umschrieben werden soll im Format /OptIn/user/.../signature/... Standard ist yes Für dieses Attribut muss mod_rewrite auf dem Server installiert sein	yes oder no	optional
ssl	gibt an, ob der Link über https:// aufgerufen werden soll. Standard ist "false"	true oder false	optional

ty-siteroles:optoutLink

Gibt den Opt-Out-Link für den aktuell registrierten Nutzer aus

mode="register"
[ Beispiel ]

Registriert einen Nutzer mit einem nachfolgenden Formular. Der Submitbutton des verwendeten Formulars muss den Namen "siteroles_register" haben.

Attribut	Beschreibung	Werte	Optional
attributes	Enthält die Namen aller Attribute die für den Nutzer registriert werden sollen.
role	Gibt den Namen der Rolle an, zu der der Nutzer hinzugefügt werden soll

mode="roles"
[ Beispiel ]

Geht der Reihe nach alle Rollen durch, denen der Nutzer angehört

ty-role:name

Gibt den Namen der aktuellen Rolle aus.

ty:topicinformation

Informationen eines Topics

Mit diesem Tag kann man verschiedene Informationen eines Topics ausgeben.

Attribut

Beschreibung

Werte

Optional

key

Werte:

url: Ausgabe der Adresse
caption: Ausgabe der Topicbezeichnung

url, caption

topic

Hier kann ein Topic ausgewählt werden, zu dem Informationen ausgegeben werden sollen. Ist das Attribut nicht angegeben, wird das aktuelle Topic genommen.

topic

optional

Vervielftigung, Nutzung bzw. Abwandlung der Texte und Bilder ist ohne vorherige Genehmigung nicht gestattet.
Quelle: wwww.myty.de - Support Portal des Internet basierenden Marketing-Framworks myty.
Copyright by tyclipso.net 2007.

zurück

| Seite drucken | letzte Aktualisierung: 27.04.10 | Autor: Denis Bartelt

Bitte wählen Sie die Version des myty aus: