Inhaltsverzeichnis 1 Beschreibung 2 Verwendung 3 Beispiele 3.1 Standardliste 3.2 Sortiert nach dem Kategorienamen 3.3 Liste unter ausschluß einzelner Kategorien 4 Hinweis zur Benutzung 5 Parameter 6 Ähnliches

[bearbeiten] Beschreibung

Erzeugt eine Link-Liste aller Kategorien. Arbeitet wie der wp_list_cats-Tag, nur dass dieses Tag eine lange Parameterzeichenkette benutzt und das andere Tag zeichenbasierete Parameter.

[bearbeiten] Verwendung

<?php list_cats(optionall, 'all', 'sort_column', 'sort_order', 'file', list, optiondates,
optioncount, hide_empty, use_desc_for_title, children, child_of, 'categories', recurse,
'feed', 'feed_img', 'exclude', hierarchical); ?>

[bearbeiten] Beispiele

[bearbeiten] Standardliste

Erzeugt die Kategorieliste unter Benutzung der Standardeinstellungen (siehe Parameter):

<?php list_cats(); ?>

[bearbeiten] Sortiert nach dem Kategorienamen

Erzeugt eine Liste der Kategorien, ohne einen Eintrag für "alle Kategorien", und sortiert diese nach den Kategorienamen:

<?php list_cats(FALSE, ' ', 'name'); ?>

[bearbeiten] Liste unter ausschluß einzelner Kategorien

Erstellt die Liste ohne alle Kategorien aufzunehmen, was durch die später beschriebenen Parameter bestimmt wird. Sortierung nach den Kategorie-ID-Nummern in einer ungeordneten Liste (<ul><li>), ohne Datumsangaben oder Beitragsanzahl. Leer Kategorien werden nicht verborgen. Die Kategorie-Beschreibung wird für das title-attribut der Links benutzt, Unterkategorien werden nicht angezeigt und die Kategorien 1 und 33 werden ausgeschlossen:

<?php list_cats(FALSE, '', 'ID',
                'asc', '', TRUE, FALSE, 
                FALSE, FALSE, TRUE, 
                FALSE, FALSE, '', FALSE, 
                '', '', '1,33', 
                TRUE); ?>

[bearbeiten] Hinweis zur Benutzung

Wird der 'LIST'-Parameter für die Ausgabe einer ungeordneten Liste gesetzt, beginnt und endet die Ausgabe der list_cats()-Funktion automatisch mit dem UL<tt>-Tag und jeder Eintrag wird mit einer <tt>LI-Tag-Klammerung versehen.

[bearbeiten] Parameter

optionall 

(boolean) Gibt an ob ein Eintrag zur Anzeige "aller Kategorien" vorhanden sein soll. Gültige Werte:

• TRUE (Default)
• FALSE

all 

(string) Zeichenkette die für den Eintrag zur Anzeige "aller Kategorien" verwendet werden soll. Standardwert: 'All'

sort_column 

(string) Schlüsselfeld zur Sortierung der Liste. Gültige Werte:

• 'ID' (Default)
• 'name'

sort_order 

(string) Sortierreihenfolge für die Liste. Gültige Werte:

• 'asc' (Default)
• 'desc'

file 

(string) Die php-Datei mit der die Kategorien verknüpft werden sollen. Standardwert ist 'index.php'. Die Datei muß in Ihrem aktuellen Theme enthalten sein.

list 

(boolean) Gibt an ob die Kategorien als ungeordnete Liste (<ul><li>) ausgegeben werden sollen. Gültige Werte:

• TRUE (Default)
• FALSE

optiondates 

(boolean) Gibt an ob das Datum des letzten Beitrags der jeweiligen Kategorie ausgegeben werden soll. Gültige Werte:

• TRUE
• FALSE (Default)

optioncount 

(boolean) Gibt an ob die Beitragsanzahl der jeweiligen Kategorie ausgegeben werden soll. Gültige Werte:

• TRUE
• FALSE (Default)

hide_empty 

(boolean) Gibt an ob Kategorien ohne Beiträge angezeigt werden sollen. Gültige Werte:

• TRUE (Default)
• FALSE

use_desc_for_title 

(boolean) Gibt an ob die Kategoriebeschreibung als Title-Attribut der Verknüpfung ausgegeben werden soll (z. Bsp.: <a title="Category Description" href="...). Gültige Werte:

• TRUE (Default)
• FALSE

children 

(boolean) Gibt an ob Unterkategorien angezeigt werden sollen oder nicht. Gültige Werte:

• TRUE
• FALSE (Default)

child_of 

(integer) Es werden nur die Kategorien angezeigt, welche der übergebenen Kategorie-ID untergeordnet sind. Es gibt keinen Standardwert.

categories 

(integer) Dieser Parameter sollte immer auf 0 gesetzt werden, wenn diese Funktion aufgerufen wird. Um nicht zu verwirren: Der Parameter wird nur intern genutzt, wenn von dieser Funktion eine hierarchische Liste aufgebaut wird.

recurse 

(boolean) Gibt an ob die Liste sofort angezeigt (FALSE) oder als Rückgabevariable zur weiteren Verwendung in PHP (TRUE) genutzt werden soll. Standardwert: FALSE

feed 

(string) Zeichenkette die für den RSS2-Feed der jeweiligen Kategorie angezeigt werden soll. Standardwert ist (kein Text), so das keine Verknüpfung auf die Feeds stattfindet.

feed_image 

(string) Pfad und Dateiname einer Grafik die als Link zum RSS2-Feed der jeweiligen Kategorie dienen werden soll. Übersteuert den feed-Parameter.

exclude 

(string) Bestimmt die auszuschließenden Kategorien. Geben Sie die Kategorien als kommaseparierte Liste an (z.Bsp.: 1, 2, 3').

hierarchical 

(boolean) Gibt an ob die Unterkategorien in einer hierarchischen Liste unter der jeweiligen Oberkategorie ausgegeben werden sollen. Gültige Werte:

• TRUE (Default)
• FALSE

Hinweis: Der Parameter hierarchical ist erst ab WordPress-Version 1.5 verfügbar.

[bearbeiten] Ähnliches

Um einen Parameterstring zur Übergabe der Parameter zur Erzeugung der Kategorieliste zu benutzen, sehen Sie sich den Tag wp_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