<we:listview type="collectionitems"  />

Mit listview type="collectionitems" erstellst Du eine Übersicht über webEdition Dokumente innerhalb einer bestimmten Sammlung.

Mit dem Attribut "id" bestimmst Du die Sammlung, die ausgelesen werden soll. Innerhalb der Sammlung kannst Du wie bei listview type="document" die Sortierung bestimmen, Kategorie-Filter setzen ect.

Hinweis 1: Wird <we:listview type="collectionitems"> zusammen mit dem Sammlungs-Wähler <we:collectionSelect> verwendet, erfolgt die Übergabe der gewählten Sammlung automatisch, wenn <we:collectionSelect> und <we:listview type="collectionitems"> den gleichen Namen besitzen.
Hinweis 2: Es können noch keine Objekte ausgegeben werden.
Hinweis 3: Zur Ausgabe von Grafik-Dokumenten sollte searchable="false" gesetzt werden

ab Version 7.0
Endtag erforderlich nein
Pflichtattribute

Attribute

id Pflichtfeld: nein

Die ID der auszugebenden Sammlung. Wird <we:listview type="collectionitems"> zusammen mit dem Sammlungs-Wähler <we:collectionSelect> verwendet, erfolgt die Übergabe der gewählten Sammlung automatisch, wenn <we:collectionSelect> und <we:listview type="collectionitems"> den gleichen Namen besitzen.

ab Version 1.3.0.0
Typ number
Standardwert -
type Pflichtfeld: ja
ab Version 1.3.0.0
Typ string
mögliche Werte document
Standardwert -
name Pflichtfeld: ja

Bei diesem Attribut gibst Du als Wert einen eindeutigen Namen an.

Wird <we:listview type="collectionitems"> zusammen mit dem Sammlungs-Wähler <we:collectionSelect> verwendet, erfolgt die Übergabe der gewählten Sammlung automatisch, wenn <we:collectionSelect> und <we:listview type="collectionitems"> den gleichen Namen besitzen.

ab Version 2.0.0.0
Typ string
Standardwert -
doctype Pflichtfeld: nein
Bei diesem Attribut gibst Du den Dokument-Typ der webEdition-Dokumente an, über die die Übersicht erstellt werden soll. Man kann als Wert nur einen Dokument-Typ angeben.

Ab WE 9.0.3 ist es möglich eine Liste von Documenttypen anzugeben,

ab Version 1.3.0.0
Typ string_list
Standardwert -
categories Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Kategorie(n) der webEdition-Dokumente bzw. Objekte an, über die die Übersicht erstellt werden soll. Bei mehreren angegeben Kategorien erfolgt eine UND-Verknüpfung, d.h. ein webEdition-Dokument bzw. Objekt muss um angezeigt zu werden alle angegebenen Kategorien haben. Für eine ODER-Verknüpfung gibt es das Attribut "catOr". Beachte bitte, dass es seit Version 2.0 mehrstufige Kategorien gibt und die Kategorien als Pfad eingegeben werden müssen. Es sei denn, die Kategorien liegen in der obersten Ebene. Hier reicht es, wenn man nur den Namen der Kategorie angibt.

ab Version 1.3.0.0
Typ string
Standardwert -
categoryids Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert kommasepariert die Kategorie-IDs der webEdition-Dokumente bzw. Objekte an, über die die Übersicht erstellt werden soll. Bei mehreren angegeben Kategorien erfolgt eine UND-Verknüpfung, d.h. ein webEdition-Dokument bzw. Objekt muss um angezeigt zu werden alle angegebenen Kategorien haben. Für eine ODER-Verknüpfung gibt es das Attribut "catOr".

ab Version 1.3.0.0
Typ string
Standardwert -
catOr Pflichtfeld: nein

Hast Du 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 Du als Wert "false" angibst, oder dieses Attribut nicht setzt, dann wird eine UND-Verknüpfung hergestellt. Somit müssen die aufgelisteten webEdition-Dokumente bzw. Objekte alle angegebenen Kategorien haben.

ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
rows Pflichtfeld: nein

Bei diesem Attribut gibst Du 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.

ab Version 1.3.0.0
Typ number
Standardwert -
cols 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.
ab Version 1.3.0.0
Typ number
Standardwert -
order Pflichtfeld: nein

Bei diesem Attribut gibst Du 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 beachte, dass mehrere Felder als Sortierkriterium die Datenbank belasten und damit Performance kosten.

Ab Version 7.0:
Eine Listview vom Typ "collection" wird nach der manuellen Reihenfolge der Sammlung sortiert, wenn für dieses Attribut kein Wert angegeben wird.

Besonderheiten bei Listview Typ "search":
Ist bei der Sortierung random() angegeben erfolgt eine zufällige Sortierung. In allen anderen Fällen wird zunächst nach der Wichtigkeit des Suchergebnisses gewichtet. Hier spielt die Häufigkeit des ganzen Suchwortes im Dokument sowie deren Position eine Rolle. Für die Gewichtung kommt der Fulltext-Index von MySQL zum Einsatz. Weitere Details/Tuning kann hier auf Ebene der Datenbank durchgeführt werden.

Typ "search"##FROM_INSIDE_TINYMCE##
ab Version 1.3.0.0
Typ string
mögliche Werte random(), we_creationdate, we_filename, we_id, we_published, we_moddate
Standardwert -
desc Pflichtfeld: nein

Wenn Du den Wert dieses Attributs auf "true" setzt, dann wird die Sortierreihenfolge der Auflistung umgekehrt. Wenn Du den Wert dieses Attributs nicht setzt, dann wird die Sortierreihenfolge beibehalten.

ab Version 1.3.0.0
Typ string
mögliche Werte true
Standardwert -
offset Pflichtfeld: nein

Bei diesem Attribut gibst Du als Wert eine Zahl an, die definiert, bei welchem Eintrag die Auflistung beginnen soll.

ab Version 1.3.0.0
Typ number
Standardwert -
searchable Pflichtfeld: nein

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

ab Version 3.1.0.0
Typ boolean
mögliche Werte true, false
Standardwert true
workspaceID Pflichtfeld: nein

Bei diesem Attribut gibst Du die Id's der Verzeichnisse als kommaseparierte Liste an, auf welches die Suche begrenzt sein soll. Es werden nur webEdition-Dokumente angezeigt, die sich in diesem Verzeichnis befinden. Es werden nur Objekte angezeigt, denen das Verzeichnis als Arbeitsbereich zugeordnet ist.

Bei einer we:listview type="object" wird das Attribut verwendet um die anzuzeigenden Objekte auf einen Objektordner zu beschränken.

ab Version 1.3.0.0
Typ number
Standardwert -
cfilter Pflichtfeld: nein

Dieses Attribut gibt an, ob die auf dem Dokument/ Objekt eingestellten Kundenfilter angewendet werden sollen. Das Attribut cfilter lässt sich im Listview nur auf dynamische Dokumente/Objekte anwenden.

Hinweis:
Ab Version 6.4.1 kann das Attribut cfilter auch auf Binär-Dateien wie PDF etc. angewandt werden

ab Version 5.1.0.0
Typ string
mögliche Werte true, false
Standardwert false
recursive Pflichtfeld: nein

In Verbindung mit dem Attribut "workspaceID" können die Ergebnisse der "listview" auf Elemente der durch "workspaceID" angegebenen Ordner eingeschränkt werden.

ab Version 5.1.0.0
Typ boolean
mögliche Werte true, false
Standardwert true
customers Pflichtfeld: nein
Hier wird die ID des Kunden aus der Kundenverwaltung für eine Filterung der Datensätze eingetragen.
ab Version 5.1.0.0
Typ string
Standardwert -
contenttypes Pflichtfeld: nein
Bei dem Attribut contenttypes gibst Du - kommasepariert - Datei-Typen an, nach denen gefiltert werden soll. Mehrere Typen werden mit dem boolschen Operator OR (Oder) verknüpft.
ab Version 1.3.0.0
Typ csv
mögliche Werte text/webedition, image/*, text/html, text/plain, text/xml, text/js, text/css, application/*, video/quicktime
Standardwert -
numorder Pflichtfeld: nein
Sortiert die Ausgabe der Listview numerisch (also 1,2,12,20,22,30 statt 1,12,2,20,22,30)
ab Version 1.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert false
languages Pflichtfeld: nein

Schränkt die Ausgabe auf Dokumente ein, die im Eigenschafts-Tab die entsprechende Sprache zugewiesen bekommen haben. Übergabe als Einzelwert oder kommaseparierte 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.

ab Version 1.3.0.0
Typ string
Standardwert -
hidedirindex Pflichtfeld: nein

Über das Attribut kann gesteuert werden, ob im ausgegebenen SEO-URL DirectoryIndex-Dateinamen angezeigt oder unterdrückt werden. 

Es können in der Konfiguration beliebige DirectoryIndex-Dateinamen für diese Funktion definiert werden.

ab Version 6.3.0.0
Typ boolean
mögliche Werte true, false
Standardwert Wird über globale Einstellungen (Extras -> Einstellungen -> Allgemein -> SEO-Links) individuell konfiguriert

Syntax

<we:listview id="" type="document" name="" doctype="" categories="" categoryids="" catOr="true|false" rows="" cols="" order="random()|we_creationdate|we_filename|we_id|we_published|we_moddate" desc="true" offset="" searchable="true|false" workspaceID="" cfilter="true|false" recursive="true|false" customers="" contenttypes="text/webedition|image/*|text/html|text/plain|text/xml|text/js|text/css|application/*|video/quicktime" numorder="true|false" languages="" hidedirindex="true|false"/>						

Beispiele

Beispiel #1

Code
<we:listview type="document">
  <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>

Siehe auch

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