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 AbfragePrüfen ob die Seite mit dem Namen "Testseite" angezeigt wird. <?php if(is_page('Testseite')) { ?> |
|
Einfache Abfrage mit alternativer AusgabePrüfen ob die Seite mit dem Namen "Testseite" angezeigt wird. Wenn nicht, dann etwas anderes ausgeben. <?php if(is_page('Testseite')) { ?> |
|
Negation einer AbfrageAlle 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()) { ?> |
|
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();.
|
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.
|
Ist Adminbereich is_admin();
is_admin();
Wenn das Dashboard des Adminbereichs odere andere Seiten des Adminmenüs angezeigt werden.
|
Ist ein einzelner Beitrag is_single();
is_single();
Wenn ein Beitrag in seiner Einzelansicht angezeigt wird.
AllgemeinWenn ein Beitrag in seiner Einzelansicht angezeigt wird. <?php is_single(); ?> |
|
IDWenn der Beitrag mit der ID 4 als einzelener Beitrag angezeigt wird. <?php is_single('4'); ?> |
|
TitelWenn der Beitrag mit dem Titel "Otternasen und Hasenohren" als einzelner Beitrag angezeigt wird. <?php is_single('Otternasen und Hasenohren'); ?> |
|
PermalinktitelWenn der Beitrag mit dem Permalinktitel "otternasen-und-hasenohren" als einzelner Beitrag angezeigt wird. <?php is_single('otternasen-und-hasenohren'); ?> |
|
ArrayWenn der Beitrag entweder die ID 4, den Titel "Otter und Hasen" oder den Permalinktitel "otter-und-hasen" hat. <?php is_single(array(4,'Otter und Hasen','otter-und-hasen')); ?> |
|
Ist Kommentar-PopUp is_comments_popup();
is_comments_popup();
Wenn PopUp-Fenster für die Kommentarein-/ausgabe.
|
Kommentieren zulässig comments_open();
comments_open();
Wenn für diesen Beitrag das Kommentieren erlaubt ist.
|
Pingen zulässig pings_open();
pings_open();
Wenn für diesen Beitrag das Pingen erlaubt ist.
|
Ist eine Seite is_page();
is_page();
Wenn eine (statische) Seite angezeigt wird.
AllgemeinWenn eine Seite angezeigt wird. <?php is_page(); ?> |
|
IDWenn die Seite mit der ID 4 an angezeigt wird. <?php is_page('4'); ?> |
|
TitelWenn die Seite mit dem Titel "Hallo Welt" angezeigt wird. <?php is_page('Hallo Welt'); ?> |
|
PermalinktitelWenn die Seite mit dem Permalinktitel "hallo-welt" angezeigt wird. <?php is_page('hallo-welt'); ?> |
|
ArrayWenn die Seite entweder die ID 4, den Titel "Hallo Welt" oder den Permalinktitel "gutes-wetter" hat. <?php is_page(array(4,'Hallo Welt','gutes-wetter')); ?> |
|
Ist eine Unterseite is_page() && $post->post_parent
is_page() && $post->post_parent
Um eine Unterseite zu ermitteln muss folgende Syntax benutzt werden:
CodeWenn 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 } ?> CodeWenn 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 } ?> |
|
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.
AllgemeinWenn ein Seitentemplate benutzt wird. <?php is_page_template(); ?> |
|
TemlatedateinameWenn das Seitentemplate mit dem Dateinamen "about.php" genutzt wird. <?php is_page_template('about.php'); ?> |
|
Ist eine Kategorie is_category();
is_category();
Wenn eine Kategorie angezeigt wird.
AllgemeinWenn ein Kategoriearchiv angezeigt wird. <?php is_category(); ?> |
|
IDWenn das Archiv für die Kategorie mit der Nummer 4 angezeigt wird. <?php is_category('4'); ?> |
|
KategorienameWenn das Archiv für die Kategorie mit dem Namen "Allgemein" angezeigt wird. <?php is_category('Allgemein'); ?> |
|
PermalinktitelWenn das Archiv für die Kategorie mit dem Permalinktitel "allgemein" angezeigt wird. <?php is_category('allgemein'); ?> |
|
ArrayWenn das Archiv für die Kategorie mit der ID 4, dem Namen "Allgemein" oder dem Permalinktitel "neues" angezeigt wird. <?php is_category(array(4,'Allgemein','neues')); ?> |
|
Ist in Kategorie in_category();
in_category();
Wenn Beitrag in einer bestimmten Kategorie ist.
IDWenn 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.
AllgemeinWenn das Archiv eines beliebigen Tags (Schlagwort) angezeigt wird. <?php is_tag(); ?> |
|
PermalinktitelWenn das Archiv des Tags (Schlagwort) mit dem Permalinktitel "intern" angezeigt wird. <?php is_tag('intern'); ?> |
|
ArrayWenn das Archiv des Tags (Schlagwort) mit den Permalinktiteln "intern", "extern" oder "mittendrin" angezeigt wird. <?php is_tag(array('intern','extern','mittendrin')); ?> |
|
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.
AllgemeinWenn ein Beitrag mit einem beliebigen Tag (Schlagwort) versehen ist. <?php has_tag(); ?> |
|
PermalinktitelWenn ein Beitrag mit dem Tag (Schlagwort) mit dem Permalinktitel "extern" versehen ist. <?php has_tag('extern'); ?> |
|
ArrayWenn ein Beitrag mit den Tags (Schlagwort) mit den Permalinktiteln "extern", "intern" oder "mittendrin" versehen ist. <?php has_tag(array('extern','intern','mittendrin')); ?> |
|
Ist eine Autorenseite is_author();
is_author();
Wenn eine Seite über einen Autor oder dessen Autorenarchiv angezeigt wird.
AllgemeinWenn eine beliebige Autorenseite angezeigt wird. <?php is_author(); ?> |
|
IDWenn das Archiv für den Autor mit der ID 4 angezeigt wird. <?php is_author('4'); ?> |
|
Name im BlogWenn das Archiv für den Autor mit dem Namen (Nickname) "John" angezeigt wird. <?php is_author('John'); ?> |
|
PermalinknameWenn das Archiv für den Autor mit dem Permalinknamen "john-doe" angezeigt wird. <?php is_author('john-doe'); ?> |
|
ArrayWenn das Archiv für den Autor mit der ID 4, dem Namen "John" oder dem Permalinknamen "john-doe" angezeigt wird. <?php is_author(array(4,'John','john-doe')); ?> |
|
Ist Datumsarchiv is_date();
is_date();
Wenn ein datumsbasiertes (jährlich, monatlich, täglich usw.) Archiv angezeigt wird.
|
Ein Jahresarchiv is_year();
is_year();
Wenn ein beliebiges Jahresarchiv angezeigt wird (z.B. alle Beiträge des Jahres 2008).
|
Ist Monatsarchiv is_month();
is_month();
Wenn ein beliebiges Monatsarchiv angezeigt wird (z.B. alle Beiträge des Monats Juli).
|
Ist Tagesarchiv is_day();
is_day();
Wenn ein beliebiges Tagesarchiv angezeigt wird (z.B. alle Beiträge vom 23.5.2008).
|
Ist Zeitarchivis_time();
is_time();
Wenn ein stündliches, minütliches oder sekündliches Archiv angezeigt wird.
|
Ist ein Archiv is_archive();
is_archive();
Wenn ein beliebiger Typ von Archiv (Kategoriearchiv, Tagarchiv, Autorenarchiv, Datumsarchiv etc.) angezeigt wird.
|
Ist Suchergebnis is_search();
is_search();
Wenn eine Seite mit Suchergebnissen angezeigt wird.
|
Ist Fehler 404 is_404();
is_404();
Wenn eine Seite mit der HTTP-Fehlermeldung 404 "Seite nicht gefunden" ausgegeben wird.
|
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.
|
Ist Dateianhang is_attachment();
is_attachment();
Wenn eine im Beitrag hochgeladene Datei (z.B. ein Bild) auf einer eigenen Seite angezeigt wird.
|
Ist Feed is_feed();
is_feed();
Wenn dies ein Feed (RSS, Atom...) ist. Üblicherweise nur intern und von Pluginautoren verwendet.
|
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.
|
Ist Vorschau is_preview();
is_preview();
Wenn ein Beitrag in der Vorschauansicht, da er noch nicht veröffentlich ist, angesehen wird.
|
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.
|
Ist eine Pluginseite is_plugin_page();
is_plugin_page();
Wenn dies die Optionsseite eines Plugin ist.
|
Ist Aufruf von Suchmaschinenrobot is_robots();
is_robots();
Wenn ein Suchmaschinenrobot eine robots.txt aufrufen möchte.
|
Ist Benutzer eingegloggt is_user_logged_in();
is_user_logged_in();
Wenn ein beliebiger Benutzer eingeloggt ist.
|