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

ab Version 1.3.0.0
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.

ab Version 1.3.0.0
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 2.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
rootdir Pflichtfeld: nein
deprecated

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

ab Version 1.3.0.0
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.

ab Version 3.5.0.0
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 "/".

ab Version 4.0.0.0
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.0.0
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.0.0
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.

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
nameto Pflichtfeld: nein

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

ab Version 3.5.0.0
Typ array
Standardwert -
pass_* Pflichtfeld: nein

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 -
rootdirID Pflichtfeld: nein

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
Typ number
Standardwert 0

Syntax

<we:category delimiter="" doc="top|self|listview" showpath="true|false" onlyindir="" 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

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

powered by webEdition CMS