Anmelden oder neues Benutzerkonto anlegen.
Doku » Template Tags/wp list cats
Inhaltsverzeichnis |
[bearbeiten] Beschreibung
Erzeugt eine Linkliste aller Kategorien. Diese Funktion arbeitet genauso wie die Funktion list_cats(). Der einzige Unterschied ist, das die Parameter in Form einer Zeichenkette übergeben werden.
[bearbeiten] Verwendung
<?php wp_list_cats('arguments'); ?>
[bearbeiten] Beispiele
[bearbeiten] Standard
Als Standard sind für die Parameter folgende Werte eingestellt:
- optionall - es wird ein Eintrag zur Anzeige aller Kategorien ausgegeben
- all - ist der Eintrag zur Anzeige aller Kategorien
- sort_column - die Kategorien werden nach ihrer ID sortiert ausgegeben
- sort_order - die Sortierung erfolgt aufsteigend
- file - für die Anzeige der Kategorien wird die index.php genutzt
- list - die Kategorien werden in einer unsortierten Liste ausgegeben (<ul><li>)
- optioncount - die Anzahl der Beiträge in den Kategorien wird nicht ausgegeben
- hide_empty - entsprechend den ersten beiden Parametern (optionall and all), werden Kategorien ohne Beiträge nicht ausgegeben
- use_desc_for_title - die Kategoriebeschreibung wird als Linktitel benutzt
- children - es werden auch die Unterkategorien der angezeigten Kategorien aufgeführt
- hierarchical - die Unterkategorien werden hierarchisch unter der jeweilig übergeordneten Kategorie dargestellt
<?php wp_list_cats(); ?>
[bearbeiten] Ausschluß von Kategorien
Erzeugt Kategorielinks sortier nach Name. Angezeigt wird die Anzahl der Posts per Kategorie. Die Kategorien 10 und 15 werden von der Liste ausgeschlossen.
<ul>
<?php wp_list_cats('sort_column=name&optioncount=1&exclude=10, 15'); ?>
</ul>
[bearbeiten] Unterkategorien einer bestimmten Kategorie anzeigen
Erzeugt Kategorielinks sortiert nach der ID, ohne die Anzahl der Beiträge per SubKategorie anzuzeigen. Es werden nur die SubKategorie-Titel (nicht die Beschreibungen) angezeigt. Ausgewertet werden nur die SubKategorien der durch den child_of-Parameter angegebenen Kategorie.
<?php wp_list_cats('sort_column=id&optioncount=0&
use_desc_for_title=0&child_of=8'); ?>
Hinweis: Wenn in einer Haupt-Kategorie keine Beiträge enthalten sind, werden ihre SubKategorien ebenfalls nicht angezeigt. Dies kann durch Angabe des folgenden Parameters umgangen werden: hide_empty=0
[bearbeiten] Kategorien mit RSS-Feed-Links anzeigen
Erzeugt Kategorielinks sortiert nach den Namen. Die Anzahl der Beiträge pro Kategorie wird nicht angezeigt, dafür aber die Links zum RSS-Feed der entsprechenden Kategorie.
<?php wp_list_cats('sort_column=name&optioncount=0&feed=RSS'); ?>
[bearbeiten] Hinweis zur Verwendung
Sollte der list-Parameter für unsortiere Listen gesetzt sein, muß das wp_list_cats()-Tag in öffnende und schließende UL-HTML-Tags geklammert sein. Alle Kategorien werden automatisch in LI-HTML-Tags gefaßt.
[bearbeiten] Parameters
- optionall
- (boolean) Bestimmt ob eine Option zur Anzeige aller Kategorien generiert wird. Gültige Werte:
- 1 (True)
- 0 (False - Standard)
- all
- (string) Diese Zeichenkette wird als Ausgabetext für die Option zur Anzeige aller Kategorien verwendet. Standard ist 'All'.
- sort_column
- (string) Schlüssel nach dem die Links sortiert werden. Gültige Werte:
- ID (Standard)
- name
- sort_order
- (string) Sortierreihenfolge für die Links. Gültige Werte:
- asc Aufsteigend (Standard)
- desc Absteigend
- file
- (string) Die php-Datei mit der ein Kategorielink angezeigt wird. Standard ist 'index.php'.
- list
- (boolean) Bestimmt ob die Kategorien in einer ungeordneten Liste (<ul><li>) dargestellt werden. Gültige Werte:
- 1 (True - Standard)
- 0 (False)
- optiondates
- (boolean) Bestimmt ob das Datum des letzten Beitrags der jeweiligen Kategorie angezeigt wird. Gültige Werte:
- 1 (True)
- 0 (False - Standard)
- optioncount
- (boolean) Bestimmt ob die Anzahl der Beiträge per Kategorie angezeigt wird. Gültige Werte:
- 1 (True)
- 0 (False - Standard)
- hide_empty
- (boolean) Bestimmt ob Kategorien ohne Beiträge angezeigt werden. Gültige Werte:
- 1 (True - Standard)
- 0 (False)
- use_desc_for_title
- (boolean) Bestimmt of die Kategoriebeschreibung als Linktitel (z.Bsp. <a title="Category Description" href="...) angezeigt wird. Gültige Werte:
- 1 (True - Standard)
- 0 (False)
- children
- (boolean) Bestimmt ob die SubKategorien der jeweiligen Kategorie angezeigt wird. Gültige Werte
- 1 (True - Standard)
- 0 (False)
- child_of
- (integer) Bestimmt die Hauptkategorie derren SubKategorien angezeigt werden. Es gibt keinen Standardwert.
- feed
- (string) Dieser Text wird als Bezeichner für den Link zum RSS-Feed der jeweiligen Kategorie benutzt. Standard ist (kein Text), wodurch auch kein Link angezeigt wird.
- feed_image
- (string) Pfad und Dateiname für eine Grafikdatei die als Link zum RSS2-Feed der Kategorien dient. Übersteuert den feed-Parameter.
- exclude
- (string) Bestimmt welche Kategorien ausgeschlossen werden. Geben Sie eine durch Kommatas getrennte Liste der Kategorieschlüssel an. Zum Beispiel: 1, 2, 3. Standard ist (keine Angabe).
- hierarchical
- (boolean) Bestimmt ob die Unterkategorien hierarchisch unter den übergeordneten Kategorien eingerückt werden. Gültige Werte:
- 1 (True - Standard)
- 0 (False)
- Hinweis: Der hierarchical-Parameter wird erst ab WordPress Version 1.5 unterstützt!
[bearbeiten] Ähnliches
Um direkte Parameter zur Übergabe der Parameter für die Erzeugung der Kategorieliste zu benutzen, sehen Sie sich den Tag list_cats() an.
the_category the_category_rss the_category_ID the_category_head single_cat_title category_description dropdown_cats list_cats wp_list_cats in_category get_category_parents get_the_category