<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.

Endtag erforderlich nein
Pflichtattribute

Attribute

delimiter Pflichtfeld: nein

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.

Typ string
Standardwert ,
doc Pflichtfeld: nein

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.

Typ string
mögliche Werte top, self, listview
Standardwert top
showpath Pflichtfeld: nein
Wird der Wert dieses Attributs auf "true" gesetzt, wird der komplette Pfad angezeigt. Wird der Wert dieses Attributs "false" gesetzt oder wird das Attribut nicht gesetzt, wird nur der Name angezeigt.
ab Version 0.0
Typ boolean
mögliche Werte true, false
Standardwert false
rootdir Pflichtfeld: nein

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.

Typ string
Standardwert -
onlyindir Pflichtfeld: nein

Mit diesem Attribut kannst Du die Kategorieauswahl auf einen Unterordner im Kategoriebaum bzw. einen Kategoriebaum selbst einschränken. Dies ist zum Beispiel hilfreich, wenn Sie einem Dokument zwei Kategorien bzw. Kategoriebäume zugeordnet haben, aber nur eine Kategorie im Web-Dokument ausgeben wollen.

ab Version 6.0.0.6
Typ string
Standardwert -
field Pflichtfeld: nein

Das Attribut "field" erlaubt den Zugriff auf die Felder der Kategorie. Setze das Attribut auf den Namen des Feldes, das augegeben werden soll.

Typ string
mögliche Werte ID, ParentID, Path, Text, Title, Description
Standardwert -
id Pflichtfeld: nein

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.

Typ number
Standardwert -
separator Pflichtfeld: nein

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 "/".

Typ string
Standardwert /
name Pflichtfeld: nein

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.9
Typ string
Standardwert -
multiple Pflichtfeld: nein

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.9
Typ boolean
mögliche Werte true, false
Standardwert false
to Pflichtfeld: nein

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.

Erst ab Version 6.1.1: post, get

ab Version 1
Typ string
mögliche Werte screen, request, post, get, global, session, top, self, sessionfield
Standardwert screen
nameto Pflichtfeld: nein

Name der Variablen, in die die Ausgabe erfolgt.

Ab Version 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.1
Typ string
Standardwert -
categoryids Pflichtfeld: nein

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!

Typ array
Standardwert -

Syntax

<we:category delimiter="" doc="top|self|listview" showpath="true|false" rootdir="" onlyindir="" field="ID|ParentID|Path|Text|Title|Description" id="" separator="" name="" multiple="true|false" to="screen|request|post|get|global|session|top|self|sessionfield" nameto="" categoryids=""/>						

Beispiele

Beispiel #1

Code
<we:category tokken=" - " doc="top" showpath="true"/>

Beispiel #2

Code
Sie befinden sich im Bereich: <we:category/>

Beispiel #3

Code
<we:listview>
  <ul>
    <we:repeat>
      <li>
        Kategorie: <we:category tokken="/" showpath="true"/>
Titel: <we:field name="Title" alt="we_path" hyperlink="true"/>
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.

powered by webEdition CMS