• name

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert den Namen der Variablen an in der der Wert der Auswahl gespeichert wird. Bei Benutzung für Frontend-Eingaben, muss das Attribut gesetzt werden, der Wert muss aber leer sein! Wenn das Attribut nicht gesetzt ist, dann wird zum Auswählen einer Kategorie beim Anlegen bzw. Editieren eines webEdition-Dokuments oder Objekts benutzt. Je nachdem ob das Attribut gesetzt ist, kann das DropDown-Menü als Eingabemöglichkeit bei der Erzeugung von webEdition-Dokumenten bzw. Objekten oder als Auswahlmöglichkeit für benutzt werden. Wird das Attribut gesetzt, dann wird es 1:1 als Wert des Attributs "name" des erzeugten <select> </select>
• type

  Typ: string | mögliche Werte: request | Standardwert: - | Pflichtfeld: nein

  Wenn Sie als Wert dieses Attributs "request" angeben, dann wird der Eintrag des DropDown-Menüs ausgewählt der mit der an die Seite übergebenen Request-Variablen (eine Kategorie) übereinstimmt. Wird dieses Attribut nicht gesetzt, dann wird anstelle der Request-Variable der Inhalt einer globalen Variablen zum Vergleich herangezogen.
  
  Unter einer "Request-Variablen" versteht man eine Variable, welche entweder an den URL der Seite angehängt ist (seite.php?category=Film) oder per "get" bzw. "post" durch ein Formular an die Folgeseite übergeben wird. Haben Sie z.B. im Attribut "name" den Wert "category" stehen und <we:categorySelect> befindet sich innerhalb eines Formulars (<we:form>), dann wird beim Abschicken des Formulars die "Request-Variable" mit dem Namen "category" erzeugt. Befindet sich auf der Folgeseite (kann auch die gleiche Seite sein) ein <we:categorySelect name="category">, dann wird automatisch die richtige Kategorie ausgewählt. Die "Request-Variable" kann dann mit Hilfe des Tags <we:setVar> in eine globale Variable kopiert werden. Diese globale Variable kann dann der <we:listview> übergeben werden (<we:listview categories="\$category">). Haben Sie in Ihrer PHP Konfiguration (php.ini-Datei) "register_globals" gesetzt, dann brauchen Sie in "type"nichts einzutragen und der Schritt mit <we:setVar> kann auch entfallen. Wir empfehlen allerdings immer type="request" zu verwenden, da webEdition in Zukunft auch ohne "register_globals" funktionieren wird und es dann vorkommen kann, dass Ihre Vorlage nicht mehr funktioniert.
  
• showpath

  ab Version: 0.0 | Typ: boolean | mögliche Werte: true, false | Standardwert: false | 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.
• rootdir

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Bei diesem Attribut geben Sie als Wert einen Verzeichnispfad (bei den Kategorien) an, der bei der Anzeige ausgeblendet werden soll (wenn showpath="true"). Dies ist z.B. notwendig, wenn Sie alle Kategorien in einem Verzeichnis "Neue Kategorien" gespeichert haben. Es würde dann immer "/Neue Kategorien/Sport/Handball" angezeigt werden. Haben Sie aber als Wert dieses Attributs "/Neue Kategorien" eingetragen, dann wird nur "/Sport/Handball" ausgegeben.
• firstentry

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Als Wert dieses Attributs wird der Text angegeben, der als erster Eintrag des Dropdown-Menüs erscheinen soll, zum Beispiel: "Bitte auswählen…".
  
• multiple

  Typ: boolean | mögliche Werte: true, false | Standardwert: false | Pflichtfeld: nein

  Wenn Sie als Wert dieses Attributs "true" angeben, können mehrere Pfade innerhalb dieses DropDown-Menüs ausgewählt werden. Wenn Sie als Wert dieses Attributs "false" angeben oder das Attribut nicht setzen, dann kann nur ein Pfad ausgewählt werden.
• indent

  Typ: string | Standardwert: - | Pflichtfeld: nein

  Durch Angabe dieses Attributes können Sie festlegen, wie Einrückung der einzelnen Kategorien aussehen soll. Pro Unterverzeichnis wird der übergebene Wert einmal wiederholt.
• cachelifetime

  Typ: number | Standardwert: 0 | Pflichtfeld: nein

  Mit diesem Attribut definieren Sie die Gültigkeit des Caches in Sekunden für diesen we-Tag. Dieses Attribut wird nur verwendet, wenn in der Vorlage "we-Tag-Cache" bzw. "kein Cache" eingestellt ist.
• to

  ab Version: 1 | Typ: string | mögliche Werte: screen, request, post, get, global, session, top, self, sessionfield | Standardwert: screen | 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 vergleichen Sie und entnehmen weitere Details zu den einzelnen möglichen Werten dort.
  
  Erst ab Version 6.1.1: post, get
  
• nameto

  ab Version: 6.1.1 | Typ: string | Standardwert: - | Pflichtfeld: nein

  Name der Variable in die die Ausgabe erfolgt.
  

<we:categorySelect name="" type="request" showpath="true|false" rootdir="" firstentry="" multiple="true|false" indent="" cachelifetime="" to="screen|request|post|get|global|session|top|self|sessionfield" nameto="">
...
</we:categorySelect>