fk:Blog – Fabians Weblog

wp_list_pages(): Statische Seiten Auflisten lassen

Heute wollen wir den Template Tag wp_list_pages einmal behandeln.

wp_list_pages gibt alle in WordPress Angelegten “Seiten” aus. Der Template-Tag wird häufig in der sidebar.php verwendet oder in der header.php um eine Navigation zu erzeugen. Den Tag kann man aber auch in anderen Template-Dateien verwenden um seinen Theme inviduell zu gestallten.

Verwendung

Der Tag wird in den Theme Templates wie folgt eingebunden:
<?php wp_list_pages('parameter'); ?>

Der Tag kann ohne Parameter direkt in das Template eingebunden werden.
<?php wp_list_pages(); ?>
Bei Verwendung ohne Parameter, greift der Template-Tag auf einige vordefinierte Parameter Werte zurück.
So könnte z.B. die Ausgabe wie folgt aussehen:

Seiten

• Seite1
  • Seite1.1
• Seite2
  • Seite2.1
• Seite3
• Seite4

Damit hätte man eine Auflistung aller Seiten die in WordPress angelegt wurden.

Hinweis!!!
Bei verwendung des Tags muss der Öffnende und schließende <ul> selbst hinzugefügt werden.

Parameter

Der Template Tag wp_list_pages(); unterstützt eine reihe nützlicher Parameter zur Ausgabe der Seiten Auflistung.

• child_of – Zeigt nur Unterseiten einer Oberseite an. Standartwert ist 0.
• sort_column – Sortiert die Seiten aufgrund seiner definierten Option:

• post_title – Alphabetisch nach Seiten Titel.
• menu_order – nach Seitenreihenfolge (kann beim Schreiben festgelegt werden).
• past_date – Sortierung nach Erstellungsdatum.
• post_modified – Sortierung nach letzter Änderung.
• id – Sortierung nach Seiten ID.
• post_author – Sortierung nach Autoren ID.
• post_name – Sortierung nach Seiten Name.

sort_order – Reihenfolge der Sortierung

• ASC – Aufsteigend (Standart Wert)
• DESC – Absteigend

exclude – Auszuschließende Seiten.

depth – Anzeige für Tiefe der Auflistung von Unterseiten.
Standart Wert ist 0 für Alle Seiten. 1 nur für TOP Seiten, Anzeige von Unterseiten wird Deaktiviert.

show_date – Zeigt das Erstellungsdatum An.

• – Keine Datumsanzeige (Standart Wert)
• modified – Datum der letzten Änderung.
• xxx – Jeder andere Wert “modifid” führt zur Darstellung des Erstellungsdatum.

date_format – Ausgabe für Datums Anzeige. Standart Einstellung ist der WordPress Wert aus den Einstellungen.

title_li – Wert für Überschrift. Bleibt der String Leer, wird keine Überschrift Erzeugt. Die zusätzliche <ul&qt; Markierung bleibt dann weg.

echo – Zeigt die Link Liste an (1 – true) oder gibt die Liste als HTML Text String zurück (0 – false). Standwart Wert ist 1.

Zusätzlich stellt der Template-Tag 4 CSS-Klassen zur Vergügung:

.pagenav
.page_item
.current_page_item
.current_page_parent

Beispiel für die Benutzung der Parameter

Möchte man Beispielsweise eine Navigation wie die Top-Navigation im hier erstellen, könnte der Template Tag wp-list-pages() wie folgt Verwendet werden:
<?php wp_list_pages('include=16,20,5,6,43&sort_column=post_title&title_li=0'); ?&qt;
Hier werden die Seiten ID’s “16 , 20, 5, 6, 43” in die Top-Navigation eingefügt, Dadurch werden alle anderen Seiten nicht in die Liste Aufgelistet.
Des weiteren sorgen wir mit dem & dafür, das wird mehrere Parameter in dem Template-Tag verwenden können. In diesem Tag geben wir noch die 2 Parameter “sort_colum und title_li mit an. Durch = (Gleichheitszeichen) Übergeben wir dem Parameter den entsprechenden Wert.

Nützliches

In meinen Tutorial “wp_list_pages: Aktive Seiten hervorheben” erkläre ich wie man die CSS-Klassen mit Hilfe von CSS Hervorheben kann.