direkt zum Inhalt springen zur Schnellnavigation zur Navigationshilfe

<we:listview type="object"></we:listview>

Endtag erforderlich: ja

Beschreibung

Dieses Tag erzeugt eine Übersicht über Objekte einer bestimmten Klasse.

Attribute

  • type

    Typ: string | mögliche Werte: object | Standardwert: - | Pflichtfeld: ja

    erforderliches Modul: DB/Objekt Modul
  • name

    Typ: string | Standardwert: - | Pflichtfeld: ja

    Bei diesem Attribut geben Sie als Wert einen eindeutigen Namen an.
  • categories

    Typ: string | Standardwert: - | Pflichtfeld: ja

    Bei diesem Attribut geben Sie als Wert den Namen bzw. den Pfad der Kategorie(n) kommasepariert an.
  • catOr

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

    Haben Sie als Wert des Attributs "categories" mehrere Kategorien und als Wert dieses Attributs "true" angegeben, dann wird eine ODER-Verknüpfung hergestellt. Somit müssen die aufgelisteten webEdition-Dokumente bzw. Objekte mindestens eine der angegebenen Kategorien haben. Wenn Sie als Wert "false" angeben, oder dieses Attribut nicht setzen, dann wird eine UND-Verknüpfung hergestellt. Somit müssen die aufgelisteten webEdition-Dokumente bzw. Objekte alle angegebenen Kategorien haben.
  • rows

    Typ: number | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert eine Zahl an, die die maximale Anzahl angezeigter Einträge definiert. Werden mehr Einträge gefunden als angezeigt werden können, dann kann man mit <we:back> und <we:next> Zurück- und Weiter-Buttons erzeugen.
  • cols

    Typ: number | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut (cols>1) kann eine mehrspaltige Ausgabe der Listview-Ergebnisse erzeugt werden. Dabei kann dann mit den Tags <we:tr>..</we:tr> und <we:ifTdNotEmpty> eine Tabelle erzeugt werden, die z.B. (cols=3) drei Listview-Ergebnisse nebeneinander anzeigt.
  • order

    Typ: string | mögliche Werte: random(), we_creationdate, we_filename, we_id, we_published, we_moddate | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie den Namen des Feldes an, nach dem die Auflistung sortiert werden soll.

    Ab Version 6.3:
    Sortierung nach we_path möglich.
    Die Sortierung nach mehreren Feldern ist nun möglich. Angabe der Werte kommasepariert. Bitte beachten Sie, dass mehrere Felder als Sortierkriterium die Datenbank belasten und damit Performance kostet.
  • desc

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

    Wenn Sie den Wert dieses Attributs auf "true" setzen, dann wird die Sortierreihenfolge der Auflistung umgekehrt. Wenn Sie den Wert dieses Attributs nicht setzen, dann wird die Sortierreihenfolge beibehalten.
  • offset

    Typ: number | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert eine Zahl an, die definiert, bei welchem Eintrag die Auflistung beginnen soll.
  • classid

    Typ: number | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert die ID der Klasse an, über welche die Übersicht erstellt werden soll.
  • condition

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert eine SQL-Bedingung an um die Anzeige einzuschränken. Wenn Sie größer/kleiner Vergleiche benutzen möchten, müssen Sie anstelle der spitzen Klammern (< >) die HTML-Codierung der spitzen Klammern benutzen (&lt; für "<" und &gt; für ">"). Bei Datumsvergleichen müssen Sie darauf achten, dass webEdition ein Datum als Unix-Timestamp (Sekunden seit 01.01.1970) ablegt. Wenn Sie Datumsvergleiche machen möchten, müssen Sie dafür die MySql Funktion UNIX_TIMESTAMP() bzw. FROM_UNIXTIME() benutzen. Sie können auch den Wert für dieses Attribut zuvor mit dem Tag <we:condition> bzw. mit PHP konstruieren.
  • triggerid

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert die ID des dynamisch abgespeicherten webEdition-Dokuments an, welches als Basis dienen soll, um das Objekt anzuzeigen, wenn es über <we:field name="Feldname" hyperlink="true"/> verlinkt wird. Die Anzeige des Objekts richtet sich dann danach, in welchem Arbeitsbereich (Verzeichnis) das webEdition-Dokument gespeichert wurde.
  • searchable

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

    Setzen Sie dieses Attribut auf "true", dann wird bei der Listview die Eigenschaft "durchsuchbar" der Dokumente oder Objekte  (-> Reiter Eigenschaften) beachtet. Es werden dann nur die Dokumente und Objekte gezeigt, die auf durchsuchbar gestellt sind. Wenn das Attribut auf "false" gesetzt wird, wird die Eigenschaft "durchsuchbar" nicht beachtet.

  • cfilter

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

    Dieses Attribut gibt an, ob die auf dem Dokument/ Objekt eingestellten Kundenfilter angewendet werden sollen.
  • docid

    Typ: number | Standardwert: - | Pflichtfeld: nein

    Bei diesem Attribut geben Sie als Wert die ID eines dynamischen webEdition-Dokuments an, auf dem sich ein <we:object>-Tag befindet, mit welchem man die Informationen des Objekts ausgibt.
  • customers

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Hier wird die ID des Kunden aus der Kundenverwaltung für eine Filterung der Datensätze eingetragen.
  • id

    Typ: string | Standardwert: - | Pflichtfeld: nein

    Kommaseparierte Auflistung von Ids, welche in der Listview angezeigt werden sollen
  • languages

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

    Schränkt die Ausgabe auf Dokumente ein, die im Eigenschafts-Tab die entsprechende Sprache zugewiesen bekommen haben. Übergabe als Einzelwert oder Komma-separierte Liste. Ab Version 6.1.0 sind auch die Werte self und top möglich, die sich dann auf die das Objekt einbettende Seite beziehen.

Syntax

<we:listview type="object" name="" categories="" catOr="true|false" rows="" cols="" order="random()|we_creationdate|we_filename|we_id|we_published|we_moddate" desc="true" offset="" classid="" condition="" triggerid="" searchable="true|false" cfilter="true|false|auto" docid="" customers="" id="" languages="">
...
</we:listview>

Beispiele

Beispiel #1

Code 
<we:listview type="object" classid="1">
  <we:ifFound>
    <p>
      Seite: <we:listviewPageNr/> von <we:listviewPages/> |
      Eintrag: <we:listviewStart/> bis <we:listviewEnd/>
      <we:ifBack> | <we:back>zurück</we:back></we:ifBack>
      <we:ifNext> | <we:next>weiter</we:next></we:ifNext>
    </p>
    <ul>
      <we:repeat>
        <li><we:field name="Title" alt="we_path" hyperlink="true"/></li>
      </we:repeat>
    </ul>
    <p>
      Seite: <we:listviewPageNr/> von <we:listviewPages/> |
      Eintrag: <we:listviewStart/> bis <we:listviewEnd/>
      <we:ifBack> | <we:back>zurück</we:back></we:ifBack>
      <we:ifNext> | <we:next>weiter</we:next></we:ifNext>
    </p>
  </we:ifFound>
  <we:ifNotFound>
    <p>
      Es konnten keine Einträge gefunden werden.
    </p>
  </we:ifNotFound>
</we:listview>

Beispiel #2 - Sortierung über mehrere Spalten einer Listview

Die Beispielklasse "1" hat die Felder Name und Vorname.
Hier wird nach Name absteigend und nach Vorname aufsteigend sortiert.
Es sollte dann aber kein desc="true" angeben.
Code 
<we:listview type="object" classid="1" order="Name ASC,Vorname DESC" >
<we:repeat>
  <we:field name="Name" />
  <we:field name="Vorname"/>
  

</we:repeat>
</we:listview>

Siehe auch

Bitte helfen Sie mit

Haben Sie eine Ergänzung für die Tag-Referenz, dann werden Sie 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.
zum Seitenanfang