Wie benutze ich Conditional Tags? Kurzeinführung

Kurzeinführung

Sinnvoll ist die Verwendung von Conditional Tags eigentlich nur in Verbindung mit einer if-Abfrage. Damit wird geprüft, ob die abgefragte Eigenschaft wahr bzw. erfüllt ist. Anhand dessen kann man beispielsweise unterschiedliche Ausgaben einblenden.

Einfache Abfrage

Prüfen ob die Seite mit dem Namen "Testseite" angezeigt wird.

<?php if(is_page('Testseite')) { ?>
Dieser Text wird nur angezeigt, wenn Seite mit dem Namen "Testseite" angezeigt wird. Hier kann jeglicher HTML-Code benutzt werden.
<?php } ?>

 

Einfache Abfrage mit alternativer Ausgabe

Prüfen ob die Seite mit dem Namen "Testseite" angezeigt wird. Wenn nicht, dann etwas anderes ausgeben.

<?php if(is_page('Testseite')) { ?>
Dieser Text wird nur angezeigt, wenn Seite mit dem Namen "Testseite" angezeigt wird.
<?php } else { ?>
Dieser Text wird immer dann angezeigt, wenn die Seite mit dem Namen "Testseite" nicht angezeigt wird.
<?php } ?>

 

Negation einer Abfrage

Alle Conditional Tags können auch negativ abgefragt werden, so dass das Ergebnis auf Unwahrheit geprüft wird. Dazu wird in der Abfrage der Operator ! verwendet.

Prüfen ob NICHT die Hauptseite angezeigt wird:

<?php if(!is_home()) { ?>
Dieser Text wird nur angezeigt, wenn dies nicht die Hauptseite ist.
<?php } ?>

 

Ist Hauptseite is_home();

is_home();

Wenn die Hauptseite des Blogs angezeigt wird.
Hinweis: Wenn du in den Einstellungen >> Lesen eine statische Seite als Startseite festgelegt hast, so gilt diese Abfrage nur für die festgelegte Artikelseite.
Siehe auch is_front_page();.

Keine Parameter

Ist Startseite is_front_page();

is_front_page();

Wenn dies die Startseite des Blogs ist - egal ob normale Seite mit Beiträgen oder statische Seite (sofern in den Einstellungen >> Lesen als Startseite festgelegt).
Hinweis: Dieser Conditional Tag kann erst ab WordPress 2.5 benutzt werden.

Keine Parameter

Ist Adminbereich is_admin();

is_admin();

Wenn das Dashboard des Adminbereichs odere andere Seiten des Adminmenüs angezeigt werden.

Keine Parameter

Ist ein einzelner Beitrag is_single();

is_single();

Wenn ein Beitrag in seiner Einzelansicht angezeigt wird.

Allgemein

Wenn ein Beitrag in seiner Einzelansicht angezeigt wird.

<?php is_single(); ?>

 

ID

Wenn der Beitrag mit der ID 4 als einzelener Beitrag angezeigt wird.

<?php is_single('4'); ?>

Integer

Titel

Wenn der Beitrag mit dem Titel "Otternasen und Hasenohren" als einzelner Beitrag angezeigt wird.

<?php is_single('Otternasen und Hasenohren'); ?>

String

Permalinktitel

Wenn der Beitrag mit dem Permalinktitel "otternasen-und-hasenohren" als einzelner Beitrag angezeigt wird.

<?php is_single('otternasen-und-hasenohren'); ?>

String

Array

Wenn der Beitrag entweder die ID 4, den Titel "Otter und Hasen" oder den Permalinktitel "otter-und-hasen" hat.
Hinweis: Die Eingabe als Array kann erst ab WordPress 2.5 benutzt werden.

<?php is_single(array(4,'Otter und Hasen','otter-und-hasen')); ?>

array (Integer / String)

Ist Kommentar-PopUp is_comments_popup();

is_comments_popup();

Wenn PopUp-Fenster für die Kommentarein-/ausgabe.

Keine Parameter

Kommentieren zulässig comments_open();

comments_open();

Wenn für diesen Beitrag das Kommentieren erlaubt ist.

Keine Parameter

Pingen zulässig pings_open();

pings_open();

Wenn für diesen Beitrag das Pingen erlaubt ist.

Keine Parameter

Ist eine Seite is_page();

is_page();

Wenn eine (statische) Seite angezeigt wird.

Allgemein

Wenn eine Seite angezeigt wird.

<?php is_page(); ?>

 

ID

Wenn die Seite mit der ID 4 an angezeigt wird.

<?php is_page('4'); ?>

Integer

Titel

Wenn die Seite mit dem Titel "Hallo Welt" angezeigt wird.

<?php is_page('Hallo Welt'); ?>

String

Permalinktitel

Wenn die Seite mit dem Permalinktitel "hallo-welt" angezeigt wird.

<?php is_page('hallo-welt'); ?>

String

Array

Wenn die Seite entweder die ID 4, den Titel "Hallo Welt" oder den Permalinktitel "gutes-wetter" hat.
Hinweis: Die Eingabe als Array kann erst ab WordPress 2.5 benutzt werden.

<?php is_page(array(4,'Hallo Welt','gutes-wetter')); ?>

array (Integer / String)

Ist eine Unterseite is_page() && $post->post_parent

is_page() && $post->post_parent

Um eine Unterseite zu ermitteln muss folgende Syntax benutzt werden:

Code

Wenn die Seite eine beliebige Unterseite ist.

<?php
// Get $post if you're inside a function
global $post;

// erstes Beispiel
if (is_page() && $post->post_parent ) {
	// ist eine Unterseite
} else {
	// ist keine Unterseite
}


?>


Code

Wenn eine bestimmte Seite oder alle Unterseiten dieser bestimmten Seite. Dafür muss zweimal die ID der Seite eingetragen werden.

<?php
// Get $post if you're inside a function
global $post;

if (is_page('4') || $post->post_parent == '4' ) {
	// Ist die Seite 4 oder eine Unterseite der Seite 4
}


?>
Code

Ist ein Seitentemplate is_page_template();

is_page_template();

Wenn ein Seitentemplate benutzt wird.
Hinweis: Dieser Conditional Tag kann erst ab WordPress 2.5 benutzt werden.

Allgemein

Wenn ein Seitentemplate benutzt wird.

<?php is_page_template(); ?>

 

Temlatedateiname

Wenn das Seitentemplate mit dem Dateinamen "about.php" genutzt wird.

<?php is_page_template('about.php'); ?>

String

Ist eine Kategorie is_category();

is_category();

Wenn eine Kategorie angezeigt wird.

Allgemein

Wenn ein Kategoriearchiv angezeigt wird.

<?php is_category(); ?>

 

ID

Wenn das Archiv für die Kategorie mit der Nummer 4 angezeigt wird.

<?php is_category('4'); ?>

Integer

Kategoriename

Wenn das Archiv für die Kategorie mit dem Namen "Allgemein" angezeigt wird.

<?php is_category('Allgemein'); ?>

String

Permalinktitel

Wenn das Archiv für die Kategorie mit dem Permalinktitel "allgemein" angezeigt wird.

<?php is_category('allgemein'); ?>

String

Array

Wenn das Archiv für die Kategorie mit der ID 4, dem Namen "Allgemein" oder dem Permalinktitel "neues" angezeigt wird.
Hinweis: Die Eingabe als Array kann erst ab WordPress 2.5 benutzt werden.

<?php is_category(array(4,'Allgemein','neues')); ?>

array (Integer / String)

Ist in Kategorie in_category();

in_category();

Wenn Beitrag in einer bestimmten Kategorie ist.

ID

Wenn ein Beitrag in der Kategorie 5 ist.

<?php in_category('5'); ?>

 

Ist Tag (Schlagwort) is_tag();

is_tag();

Wenn das Archiv eines Tags (Schlagwort) angezeigt wird.

Allgemein

Wenn das Archiv eines beliebigen Tags (Schlagwort) angezeigt wird.

<?php is_tag(); ?>

 

Permalinktitel

Wenn das Archiv des Tags (Schlagwort) mit dem Permalinktitel "intern" angezeigt wird.

<?php is_tag('intern'); ?>

String

Array

Wenn das Archiv des Tags (Schlagwort) mit den Permalinktiteln "intern", "extern" oder "mittendrin" angezeigt wird.
Hinweis: Die Parameterübergabe als Array kann erst ab WordPress 2.5 genutzt werden.

<?php is_tag(array('intern','extern','mittendrin')); ?>

array (String)

Hat einen Tag (Schlagwort) has_tag();

has_tag();

Wenn Beitrag einen Tag (Schlagwort) hat.
Hinweis: Dieser Conditional Tag kann erst ab WordPress 2.6 genutzt werden.

Allgemein

Wenn ein Beitrag mit einem beliebigen Tag (Schlagwort) versehen ist.

<?php has_tag(); ?>

 

Permalinktitel

Wenn ein Beitrag mit dem Tag (Schlagwort) mit dem Permalinktitel "extern" versehen ist.

<?php has_tag('extern'); ?>

String

Array

Wenn ein Beitrag mit den Tags (Schlagwort) mit den Permalinktiteln "extern", "intern" oder "mittendrin" versehen ist.

<?php has_tag(array('extern','intern','mittendrin')); ?>

array (String)

Ist eine Autorenseite is_author();

is_author();

Wenn eine Seite über einen Autor oder dessen Autorenarchiv angezeigt wird.

Allgemein

Wenn eine beliebige Autorenseite angezeigt wird.

<?php is_author(); ?>

 

ID

Wenn das Archiv für den Autor mit der ID 4 angezeigt wird.

<?php is_author('4'); ?>

Integer

Name im Blog

Wenn das Archiv für den Autor mit dem Namen (Nickname) "John" angezeigt wird.

<?php is_author('John'); ?>

String

Permalinkname

Wenn das Archiv für den Autor mit dem Permalinknamen "john-doe" angezeigt wird.

<?php is_author('john-doe'); ?>

String

Array

Wenn das Archiv für den Autor mit der ID 4, dem Namen "John" oder dem Permalinknamen "john-doe" angezeigt wird.
Hinweis: Die Parameterübergabe als Array kann erst ab WordPress 2.5 genutzt werden.

<?php is_author(array(4,'John','john-doe')); ?>

array (String)

Ist Datumsarchiv is_date();

is_date();

Wenn ein datumsbasiertes (jährlich, monatlich, täglich usw.) Archiv angezeigt wird.

Keine Parameter

Ein Jahresarchiv is_year();

is_year();

Wenn ein beliebiges Jahresarchiv angezeigt wird (z.B. alle Beiträge des Jahres 2008).

Keine Parameter

Ist Monatsarchiv is_month();

is_month();

Wenn ein beliebiges Monatsarchiv angezeigt wird (z.B. alle Beiträge des Monats Juli).

Keine Parameter

Ist Tagesarchiv is_day();

is_day();

Wenn ein beliebiges Tagesarchiv angezeigt wird (z.B. alle Beiträge vom 23.5.2008).

Keine Parameter

Ist Zeitarchivis_time();

is_time();

Wenn ein stündliches, minütliches oder sekündliches Archiv angezeigt wird.

Keine Parameter

Ist ein Archiv is_archive();

is_archive();

Wenn ein beliebiger Typ von Archiv (Kategoriearchiv, Tagarchiv, Autorenarchiv, Datumsarchiv etc.) angezeigt wird.

Keine Parameter

Ist Suchergebnis is_search();

is_search();

Wenn eine Seite mit Suchergebnissen angezeigt wird.

Keine Parameter

Ist Fehler 404 is_404();

is_404();

Wenn eine Seite mit der HTTP-Fehlermeldung 404 "Seite nicht gefunden" ausgegeben wird.

Keine Parameter

Ist eine paginierte Ansicht is_paged();

is_paged();

Wenn eine Ansicht paginiert, also auf mehrere Seiten verteilt ist (z.B. ein Archiv oder die Blogeinträge).
Dieser Conditional Tag funktioniert nicht bei mittels <!--nextpage--> geteilten statischen Seiten.

Keine Parameter

Ist Dateianhang is_attachment();

is_attachment();

Wenn eine im Beitrag hochgeladene Datei (z.B. ein Bild) auf einer eigenen Seite angezeigt wird.

Keine Parameter

Ist Feed is_feed();

is_feed();

Wenn dies ein Feed (RSS, Atom...) ist. Üblicherweise nur intern und von Pluginautoren verwendet.

Keine Parameter

Ist Trackback is_trackback();

is_trackback();

Wenn die angeforderte Seite als Trackback verarbeitet wird (ein Hook für Trackbackengine von WordPress ist). Üblicherweise nur intern und von Pluginautoren verwendet.

Keine Parameter

Ist Vorschau is_preview();

is_preview();

Wenn ein Beitrag in der Vorschauansicht, da er noch nicht veröffentlich ist, angesehen wird.

Keine Parameter

Hat einen Auszug (Exzerpt) $post->post_excerpt

!empty($post->post_excerpt);

Da es keine Funktion gibt um zu überprüfen, ob ein Beitrag einen Auszug (Exzerpt) hat, kann dieser Code benutzt werden. Entferne das ! um abzufragen, ob kein Exzerpt vorhanden ist.

Keine Parameter

Ist eine Pluginseite is_plugin_page();

is_plugin_page();

Wenn dies die Optionsseite eines Plugin ist.

Keine Parameter

Ist Aufruf von Suchmaschinenrobot is_robots();

is_robots();

Wenn ein Suchmaschinenrobot eine robots.txt aufrufen möchte.

Keine Parameter

Ist Benutzer eingegloggt is_user_logged_in();

is_user_logged_in();

Wenn ein beliebiger Benutzer eingeloggt ist.

Keine Parameter