<we:listview type="document"  />

Mit listview type="document" erstellst Du eine Übersicht über webEdition Dokumente.

Ab Version 6.4 wertet listview type="document" die Request-Variable we_lv_search_* genauso aus, wie listview type="search" und kann somit für die Suche genutzt werden.

ab Version 1.3.0.0
Endtag erforderlich nein
Pflichtattribute

Attribute

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.

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 -
doctypeIDs Pflichtfeld: nein
Gib hier alle IDs der Dokumenttypen an, für die das Tag gilt.
ab Version 9.0.3 (Barrhorn)
Typ number_list
Standardwert 0
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 -
id Pflichtfeld: nein
Kommaseparierte Auflistung von Ids, welche in der Listview angezeigt werden sollen
ab Version 1.3.0.0
Typ string
Standardwert -
condition Pflichtfeld: nein

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

Sollen Attribute für den Vergleich benutzt werden, muß bei einem Vergleich mit den Dokumenteigenschaften der Prefix "WE_" und bei Eigenschaften des Objektes der Prefix "OF_" verwendet werden.

ab Version 1.3.0.0
Typ string
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
calendar Pflichtfeld: nein
deprecated bis Version 9.2.0 (Cardada)
ab Version 1.3.0.0
Typ string
mögliche Werte year, month, month_table, day
Standardwert -

Syntax

<we:listview type="document" name="" doctype="" doctypeIDs="" 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" id="" condition="" 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