<we:category />
Zeigt die Kategorie(n) im Frontend an, die in der Ansicht "Eigenschaft" dem webEdition-Dokument zugeordnet wurden. Wenn es mehrere Kategorien sind, werden sie durch Kommas getrennt angezeigt.
Ab Version 6.3.9 wird bei der Verwendung des Attributs name dem Redakteur im Editmode eine Auswahllister aller zugeordneten Kategorien angeboten.
ab Version | 1.3.0.0 |
Endtag erforderlich | nein |
Pflichtattribute |
Attribute
- delimiter
- doc
- showpath
- rootdir
- onlyindir
- onlyindirID
- field
- id
- separator
- name
- multiple
- to
- nameto
- categoryids
- pass_*
- rootdirID
Bei diesem Attribut gibst Du als Wert das Trennzeichen an, welches Du verwenden möchtest. Wenn das Attribut nicht gesetzt wird, werden standardmässig Kommata verwendet.
ab Version | 1.3.0.0 |
Typ | string |
Standardwert | , |
Wenn Du als Wert dieses Attributs "self" angibst, bezieht es sich auf das aktuelle webEdition-Dokument. Handelt es sich dabei um ein webEdition-Dokument, welches in ein anderes eingefügt wird (siehe <we:include />), so wird ein Bezug auf das eingefügte webEdition-Dokument hergestellt. Wenn Du als Wert dieses Attributs "top" angibst oder das Attribut nicht setzt, dann bezieht es sich auf das Haupt-webEdition-Dokument, auch wenn es sich dabei um ein webEdition-Dokument handelt, welches in ein anderes eingefügt wird (siehe <we:include />).
Wird das Tag innerhalb einer verwendet und das Attribut auf "listview" gesetzt, wird die ID der Seite, auf die der <we:listview /> verweist, ausgegeben.
ab Version | 1.3.0.0 |
Typ | string |
mögliche Werte | top, self, listview |
Standardwert | top |
ab Version | 2.3.0.0 |
Typ | boolean |
mögliche Werte | true, false |
Standardwert | false |
Bei diesem Attribut gibst Du als Wert einen Verzeichnispfad (bei den Kategorien) an, der bei der Anzeige ausgeblendet werden soll (wenn showpath="true"). Dies ist z.B. notwendig, wenn Du alle Kategorien in einem Verzeichnis "Neue Kategorien" gespeichert hast. Es würde dann immer "/Neue Kategorien/Sport/Handball" angezeigt werden. Hast Du aber als Wert dieses Attributs "/Neue Kategorien" eingetragen, dann wird nur "/Sport/Handball" ausgegeben.
ab Version | 2.2.0.0 |
Typ | string |
Standardwert | - |
Mit diesem Attribut kannst Du die Kategorieauswahl auf einen Unterordner im Kategoriebaum bzw. einen Kategoriebaum selbst einschränken. Dies ist zum Beispiel hilfreich, wenn Du einem Dokument zwei Kategorien bzw. Kategoriebäume zugeordnet hast, aber nur eine Kategorie im Web-Dokument ausgeben willst.
ab Version | 1.3.0.0 |
Typ | string |
Standardwert | - |
Mit diesem Attribut kannst Du die Kategorieauswahl auf einen Unterordner im Kategoriebaum bzw. einen Kategoriebaum selbst einschränken. Dies ist zum Beispiel hilfreich, wenn Du einem Dokument zwei Kategorien bzw. Kategoriebäume zugeordnet hast, aber nur eine Kategorie im Web-Dokument ausgeben willst.
ab Version | 1.3.0.0 |
Typ | number |
Standardwert | 0 |
Das Attribut "field" erlaubt den Zugriff auf die Felder der Kategorie. Setze das Attribut auf den Namen des Feldes, das augegeben werden soll.
ab Version | 1.3.0.0 |
Typ | string |
mögliche Werte | ID, ParentID, Path, Text, Title, Description |
Standardwert | - |
Bei diesem Attribut gibst Du als Wert die ID einer Kategorie an. Mit dem Attribut "id" kann eine bestimmte Kategorie (unabhängig vom Dokument) ausgelesen werden.
ab Version | 3.5.0.0 |
Typ | number |
Standardwert | - |
Bei diesem Attribut gibst Du als Wert das Trennzeichen an. Ist der Wert des Attributs leer oder wird das Attribut nicht gesetzt, dann ist das Trennzeichen "/".
ab Version | 4.0.0.0 |
Typ | string |
Standardwert | / |
Bei diesem Attribut gibst Du einen eindeutigen Namen an. Durch die Angabe des Namens wird im Editmode dem Redakteur eine Auswahliste aller dem Dokument zugeordneten Kategorien (Reiter Eigenschaften) angeboten.
ab Version | 6.3.0.0 |
Typ | string |
Standardwert | - |
Wenn Du als Wert dieses Attributs "true" angibst, können mehrere Pfade innerhalb dieses DropDown-Menüs ausgewählt werden. Wenn Du als Wert dieses Attributs "false" angibst oder das Attribut nicht setzt, dann kann nur ein Pfad ausgewählt werden.
Das Attribut "multiple" kann nur in Kombination mit dem Attribut "name" genutzt werden.
ab Version | 6.3.0.0 |
Typ | boolean |
mögliche Werte | true, false |
Standardwert | false |
Bestimmt wie / wohin die Ausgabe erfolgt. Dabei wird der Code, der sonst auf der Seite ausgegeben würde, in exakt derselben Weise an die auszuwählende Variable übergeben. Dies ist eine praktische Alternative zu <we:setVar>, bitte vergleiche und entnimm weitere Details zu den einzelnen möglichen Werten dort.
Ab webEdition 6.1.0.2: post
, get
Ab webEdition 9.0.8: local
: Erlaubt den Wert einer lokalen Variable zuzuordnen und dann im Tag attribut="$name"
zu nutzen.
ab Version | 6.1.0.0 |
Typ | string |
mögliche Werte | screen, request, post, get, global, local, session, top, self, sessionfield |
Standardwert | screen |
Name der Variable, in die die Ausgabe erfolgt.
Ab webEdition 6.3.7 können auch Arrays mit folgender Syntax geschrieben werden werden:
<we:xxxx to="global" nameto="meinArray[abc]"/>
oder<we:xxxx to="global" nameto="meinArray[]"/>
oder<we:xxxx to="global" nameto="meinArray[][def]"/>
.
Wichtig ist hierbei, dass innerhalb der eckigen Klammern keine Hochkommata oder Anführungszeichen genutzt werden!
ab Version | 6.1.0.0 |
Typ | string |
Standardwert | - |
Mit dem Attribut categoryids können eine oder mehrere Kategorien angezeigt werden: <we:listview type="category" categoryids ="7,9">. Das Attribut categoryids kann auch in einer normalen listview benutzt werden. Es dient dann als Ersatz für das Attribut categories. Sollte categories und categoryids gesetzt sein, so hat categoryids immer Vorrang!
ab Version | 3.5.0.0 |
Typ | array |
Standardwert | - |
Für das * - also nach dem "_" (Unterstrich) - kann ein beliebiger Wert (HTML-Attribut) vergeben werden. Dieses wird dann so an die Ausgabe weritergegeben.
Zum Beispiel kann man dadurch einem Formular eine ID verpasst werden. Denn das Attribut "id" kann ja nicht verwendet werden, da dieses schon ein webEdition-Attribut ist. In einem solchen Fall kann man "pass_id" verwenden.
Dieses Attribut gibt es übrigens bei allen Tags die eine Ausgabe produzieren.
ab Version | 3.2.0.0 |
Typ | string |
Standardwert | - |
Durch die Angabe dieses Attributes kannst Du das Startverzeichnis für die vom Redakteur bei gesetztem Attribut "name" auszuwählenden Dateien wählen. Wird dieses Attribut nicht gesetzt sind alle Verzeichnisse durchsuchbar.
ab Version | 9.2.3 (Cardada) |
Typ | number |
Standardwert | 0 |
Syntax
<we:category delimiter="" doc="top|self|listview" showpath="true|false" onlyindir="" onlyindirID="" field="ID|ParentID|Path|Text|Title|Description" id="" separator="" name="" multiple="true|false" to="screen|request|post|get|global|local|session|top|self|sessionfield" nameto="" categoryids="" pass_*="" rootdirID=""/>
Beispiele
Beispiel #1
<we:category tokken=" - " doc="top" showpath="true"/>
Beispiel #2
Sie befinden sich im Bereich: <we:category/>
Beispiel #3
<we:listview> <ul> <we:repeat> <li> Kategorie: <we:category tokken="/" showpath="true"/><br> Titel: <we:field name="Title" alt="we_path" hyperlink="true"/><br> Beschreibung: <we:field name="Description" alt="we_text" max="200"/> </li> </we:repeat> </ul> </we:listview>
Hilf mit!
Hast Du eine Ergänzung für die Tag-Referenz, dann werde bitte aktiv.
Entweder über einen Eintrag unter qa.webedition.org oder
einfach formlos per E-Mail an
websites@webedition.org.
Fehler oder Erweiterungswünsche zu webEdition selbst bitte über qa.webedition.org melden.