Question

cat_is_ancestor_of( int|object $cat1,  int|object $cat2 )

Check if a category is an ancestor of another category.

---

description

You can use either an id or the category object for both parameters. If you use an integer the category will be retrieved.

---

参数

$cat1

(int|object) (Required) ID or object to check if this is the parent category.

$cat2

(int|object) (Required) The child category.

---

返回值

(bool) Whether $cat2 is child of $cat1

---

源代码

File: wp-includes/category.php

function cat_is_ancestor_of( $cat1, $cat2 ) {
	return term_is_ancestor_of( $cat1, $cat2, 'category' );
}

---

更新日志

Version	description
2.1.0	Introduced.

---

相关函数

Uses

• wp-includes/taxonomy.php: term_is_ancestor_of()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Basic Example

   This example, placed in a theme’s archive.php, uses Conditional Tags to show different content depending on the category being displayed. This is helpful when it is necessary to include something for any child category of a given category, instead of using category-slug.php method where you’d have to create category-slug.php files for each and every category.

   The code snip below checks to see if the category called ‘Music’ (ID 4) is being processed, and if so, presents a wp_nav_menu for the Music archive page, and any subcategories of Music (e.g. jazz, classical.)

   
   <?php 
     // if the category is music or a music SUBcategory, 
     if (cat_is_ancestor_of(4, $cat) or is_category(4)):  ?>
     <div id="music_subnav_menu" class="subnav_menu">
       <?php wp_nav_menu( array('menu' => 'Music' )); ?>
     </div>
   <?php endif; ?>