Anmelden oder neues Benutzerkonto anlegen.

 

Doku » Template Tags/wp list categories




Diese Seite wurde neu erstellt und wartet auf eine Korrekturlesung... ;)


Inhaltsverzeichnis

[bearbeiten] Beschreibung

Zeigt eine Liste aller Kategorien an. Die Links sind zum jeweiligen Archiv der Kategorie verlinkt. Dieser Template-Tag ist der Nachfolger von wp_list_cats, welches ab WordPres-Version 2.1 veraltet ist.


[bearbeiten] Verwendung 

<?php wp_list_categories('parameter'); ?>


[bearbeiten] Standardverwendung 

<ul><?php wp_list_categories('title_li=<h2>Kategorien</h2>'); ?></ul>


Ergibt folgende (beispielhafte Ausgabe): 

<ul><li class="categories"><h2>Kategorien</h2><ul>
<li><a href="http://example.org/?cat=1" title="Alle unter Allgemein abgelegten Beiträge ansehen">Allgemein</a></li>
</ul></li></ul>

[bearbeiten] Weitere Anwendungsbeispiele

[bearbeiten] Kategorien ausschließen

Die Kategorien 4, 2 und 9 werden nicht angezeigt. 

<ul>
<?php wp_list_categories('exclude=2,4,9'); ?>
</ul>

Sortierung nach Name. Die Kategorien 4, 2 und 9 werden nicht angezeigt. 

<ul>
<?php wp_list_categories('orderby=name&exclude=2,4,9'); ?>
</ul>

[bearbeiten] Keine Überschrift anzeigen

<ul>
<?php wp_list_categories('title_li='); ?>
</ul>

[bearbeiten] RSS

Link zu RSS-Feed mit Textlink: 

<ul>
<?php wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>
</ul>

Link zu RSS-Feed mit Icon: 

<ul>
<?php wp_list_categories('orderby=name&show_count=1
&feed_image=http://example.org/images/example/rss.gif'); ?>
</ul>

[bearbeiten] CSS-Styling der aktuellen Kategorie

Wird ein Kategoriearchiv angezeigt, so erhält die angezeigte Kategorie in der Auflistung die Klasse current-cat: 

<li class="current-cat">Aktuelle Kategorie</li>


[bearbeiten] Parameter

show_option_all
(string) Zeichenkette welche vor den anderen Kategorien angezeigt wird und auf die Startseite verlinkt ist. Standardwert: leer
orderby 
(string) Ordnungschema der Kategorien.
  • ID
  • name (Standard)
  • count
order
(string) Sortierschema. Aufsteigend oder Absteigend.
  • ASC (Standard)
  • DESC
show_last_updated
(boolean) Bestimmt ob das Datum des letzten Beitrags der jeweiligen Kategorie angezeigt wird.
  • 1 Ja
  • 0 (Standard) Nein
style
(string) Bestimmt ob die Kategorien als Liste erscheinen oder nur mit Zeilenumbrüchen getrennt werden sollen.
  • list (Standard)
  • none
show_count
(boolean) Es wird die Anzahl der sich in der jeweiligen Kategorie befindenden Beiträge hinter der Kategorie angezeigt.
  • 1 Ja
  • 0 (Standard) Nein
hide_empty
(boolean) Kategorien ohne Beiträge werden nicht angezeigt.
  • 1 (Standard) Ja
  • 0 Nein
use_desc_for_title
(boolean) Kategoriebeschreibung wird als Linktitel verwendet.
  • 1 (Standard) Ja
  • 0 Nein
child_of
(integer) Nur Kategorien angezeigen welche untergeordnete Kategorien der festgelegten Kategorie(-ID) sind. hide_empty muss auf 0 gesetzt werden, wenn dieser Parameter genutzt wird. Es ist kein Standardwert vorgegeben.
feed
(string) Zeigt einen Link zum RSS2-Feed der jeweiligen Kategorie. Es ist kein Standardwert vorgeben. Die eingegebene Zeichenkette wird als Link angezeigt.
feed_Image
(string) Verwende hier die URL eines Bildes (z.B. eines kleinen RSS-Icons) welches dann als Link zum jeweligen RSS-Feed der Kategorie angezeigt wird. Es ist kein Standardwert vorgegeben.
exclude
(string) Eine oder mehrere Kategorien von der Anzeige ausschließen. Es müssen die Kategorie-IDs, von einem Komma (ohne Leerzeichen) getrennt, in aufsteigender Reihenfolge angegeben werden. Es ist kein Standardwert vorgegeben.
include
(string) Zeige nur diese Kategorien an. Es müssen die Kategorie-IDs, von einem Komma (ohne Leerzeichen) getrennt, in aufsteigender Reihenfolge angegeben werden. Es ist kein Standardwert vorgegeben.
hierarchical
(boolean) Zeige Unterkategorien eingerückt und unter der jeweiligen Oberkategorie.
  • 1 (Standard) Ja
  • 0 Nein
title_li
(string) Überschrift und dessen Formatierung festlegen. Wird title_li nicht verwendet, so wird Kategorien ausgegeben. Wird title_li verwendet aber keine Zeichenkette angegeben, so wird keine Überschrift ausgegeben.
number
(integer) Maximale Anzahl an anzuzeigenden Kategorien. Standardmäßig gibt es keine Limitierung.


[bearbeiten] Ähnliches



Original Dokument: http://codex.wordpress.org/Template_Tags/wp_list_categories



Zurück zum Template Tags Verzeichnis
Von „http://doku.wordpress-deutschland.org/Template_Tags/wp_list_categories“