<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
- type
- name
- doctype
- categories
- categoryids
- catOr
- rows
- cols
- order
- desc
- offset
- searchable
- workspaceID
- cfilter
- recursive
- customers
- contenttypes
- numorder
- languages
- hidedirindex
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 | - |
ab Version | 1.3.0.0 |
Typ | string |
mögliche Werte | document |
Standardwert | - |
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 | - |
Ab WE 9.0.3 ist es möglich eine Liste von Documenttypen anzugeben,
ab Version | 1.3.0.0 |
Typ | string_list |
Standardwert | - |
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 | - |
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 | - |
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 |
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 | - |
ab Version | 1.3.0.0 |
Typ | number |
Standardwert | - |
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.
ab Version | 1.3.0.0 |
Typ | string |
mögliche Werte | random(), we_creationdate, we_filename, we_id, we_published, we_moddate |
Standardwert | - |
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 | - |
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 | - |
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 |
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 | - |
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 |
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 |
ab Version | 5.1.0.0 |
Typ | string |
Standardwert | - |
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 | - |
ab Version | 1.3.0.0 |
Typ | boolean |
mögliche Werte | true, false |
Standardwert | false |
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 | - |
Ü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
<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
- <we:listview ></we:listview>
- <we:listview type="banner" ></we:listview type="banner">
- <we:listview type="category" ></we:listview type="category">
- <we:listview type="customer" ></we:listview type="customer">
- <we:listview type="document" ></we:listview type="document">
- <we:listview type="languagelink" ></we:listview type="languagelink">
- <we:listview type="multiobject" ></we:listview type="multiobject">
- <we:listview type="object" ></we:listview type="object">
- <we:listview type="onlinemonitor" ></we:listview type="onlinemonitor">
- <we:listview type="orderitem" ></we:listview type="orderitem">
- <we:listview type="order" ></we:listview type="order">
- <we:listview type="search" ></we:listview type="search">
- <we:listview type="variant" ></we:listview type="variant">
- <we:listview type="sql" ></we:listview type="sql">
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.