Inhaltsverzeichnis 1 Beschreibung 2 Verwendung 3 Standardverwendung 4 Parameter 5 Ähnlich

[bearbeiten] Beschreibung

Dieser Tag erzeugt seit der Version 1.5 eine ungeordnete HTML Liste der über das Admin Panel erstellten Seiten. Beispielsweise wird dieses Template Tag bei den mit der WordPress Installation mitgelieferten Themes in der sidebar.php verwendet.

Dabei werden alle erstellten Seiten im HTML Listentag (<li>) mit der Klasse class="page_item" versehen. Befindet sich die aktuell angezeigte Seite dabei unter den aufgelisteten Seiten, dann erhält dieser Listenpunkt die Klasse class="current_page_item":

<li class="page_item current_page_item">
   [the current page]
 </li>
 <li class="page_item">
   [another page]
 </li>

Dadurch besteht die Möglichkeit die Einträge unterschiedlich mit CSS zu formatieren:

.page_item { ... }
.current_page_item { ... }

[bearbeiten] Verwendung

<?php wp_list_pages('arguments'); ?>

[bearbeiten] Standardverwendung

Dieser Tag wird im Classic Template wie folgt eingesetzt:

  <?php wp_list_pages('title_li=<h2>Pages</h2>' ); ?>

was den folgenden HTML code zur Folge hat:

  <li class="pagenav"><h2>Pages</h2>
   <ul>
      <li class="page_item"><a href="http://abc" title="Seite1">Seite1</a>
      <ul>
         <li class="page_item"><a href="http://abc" title="Seite1.1">Seite1.1</a></li>
      </ul></li>
      <li class="page_item"><a href="http://abc" title="Seite2">Seite2</a>
      <ul>
         <li class="page_item"><a href="http://abc" title="Seite2.1">Seite2.1</a></li>
      </ul></li>
      <li class="page_item"><a href="http://abc" title="Seite3">Seite3</a></li>
      <li class="page_item"><a href="http://abc" title="Seite4">Seite4</a></li>
   </ul>
   </li>

Erklärung

Der übergebende Parameter title_li=<h2>Pages</h2> bewirkt den ersten Aufzählungspunkt (mit der class="pagenav").

Anschliessend werden alle Seiten und deren Unterseiten nacheinander aufgeführt.

Für Unter Unterseiten werden in der Liste eingerückt dargestellt (durch einen eigenen <ul>)

Achtung

Das umschliessende <ul> oder <ol> muss selbstständig um den Tag geschrieben werden, da es von diesem nicht erstellt wird.

[bearbeiten] Parameter

child_of

(integer) Zeigt nur die Unterseiten einer bestimmten Seite an. Die hier angegebene Zahl steht dabei für die entsprechenden Seite. Default ist 0 (wodurch alle Seiten angezeigt werden).

sort_column

(string) Sortiert die Seiten basierend auf einer der folgenden Optionen:

• 'post_title' - Alphabetisch nach Seiten-/ Beitragstitle (Default).
• 'menu_order' - nach Seitenrangfolge (diese kann bei der Seitenerstellung festgelegt werden).
• 'post_date' - nach Erstellungszeit.
• 'post_modified' - nach Datum der letzten Änderung.
• 'ID' - nach der Seiten ID.
• 'post_author' - nach der ID des Erstellers
• 'post_name' - Alphabetisch nach Post slug.
• Anmerkung: Der sort_column Wert kann der jeder Spaltenname wp_post mySQL Tabelle sein.

sort_order

(string) Sortierungsreihenfolge:

• 'ASC' - Aufsteigend (Default).
• 'DESC' - Absteigend.

exclude

(string) Aufzählung der Seiten (deren IDs), die nicht angezeigt werden sollen. Die Aufzählung muss durch ein Komma getrennt sein (Beispiel: 'exclude=10, 20, 30'). Es gibt die kein default Wert.

depth

(integer) Nummerischer Wert für die angezeigte Tiefe der Unterseiten. Defaults ist 0 (dabei werden alle Seiten angezeigt); depth=-1 es werden keine Unterseiten angezeigt; depth=1 zeigt nur die TOP Seiten; jeder Wert grösser als 1 zeigt die Anzahl der Unterseiten bis auf die jeweilige tiefe.

show_date

(string) Zeigt zusätzlich das Erstelldatum oder das Datum der letzten Modifikation an. Gültige Werte sind:

• '' - Kein Datum anzeigen (Default).
• 'modified' - Datum der letzten Modifizierung.
• 'xxx' - jeder andere Wert modified führt zur Anzeige des Erstellungsdatums (post_date) an dem die Seite erstellt wurde.

date_format

(string) Gibt an, wie das Datum dargestellt werden soll. Default ist der Wert aus den WordPress Einstellungen.

title_li

(string) Text für die Überschrift der Aufzählung. Defaults ist '__('Pages')', was in der jeweiligen Sprache "Pages" bzw. "Seiten" anzeigt (das __('') is used for localization purposes). Ist der Wert 0 oder ohne Inhalt (''), wird keine Überschrift angezeigt und die nachfolgende Liste wird nicht zusätzlich mit <ul> und </ul> Tags umschlossen.

echo

(boolean) - Zeigt die Link Liste an (1 - true) oder gibt die Liste als HTML text String zurück (zur Verwendung z.B. in PHP) (0 - false). Defaults ist 1.

[bearbeiten] Ähnlich

• wp_get_archives
• wp_list_cats
• get_links_list