判断某个分类是否是另一个分类的子类

描述

译文

这是一个简单函数，用于评定某个类别是否是另一个类别的子类。

原文

cat_is_ancestor_of() 方法用于判断某个分类是否是另一个分类的子类，例如下方的代码表示：若类别1是类别2的上级，函数返回true。只要是上级，无论多少层级，一律返回true。变量可以是整数类别编号或类别对象。

注意 若变量是整数的字符串形式而不是真正的整数，cat_is_ancestor_of返回false。

用法

 <?php cat_is_ancestor_of( $cat1, $cat2 ); ?> 

参数

$cat1

(int/object) (必填) ID or object to check if this is the parent category.

默认值: None

$cat2

(int/object) (必填) The child category.

默认值: None

返回值

(boolean) 

True if cat1 is an ancestor of cat2, False if not.

示例

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.)

注意

• The function evaluates if the second category is a child of the first category.
• Any level of ancestry will return True.
• Arguments should be either integer or objects, If arguments are string representations of integers and not true integers cat_is_ancestor_of will return False.

历史

添加于 版本: 2.1.0

源文件

cat_is_ancestor_of() 函数的代码位于 wp-includes/category.php.

相关

• Article(文章): Introduction to WordPress conditional functions
• Function(函数): comments_open()
• Function(函数): is_404()
• Function(函数): is_admin()
• Function(函数): is_admin_bar_showing()
• Function(函数): is_archive()
• Function(函数): is_attachment()
• Function(函数): is_author()
• Function(函数): is_category()
• Function(函数): is_comments_popup()
• Function(函数): is_date()
• Function(函数): is_day()
• Function(函数): is_feed()
• Function(函数): is_front_page()
• Function(函数): is_home()
• Function(函数): is_local_attachment()
• Function(函数): is_main_query
• Function(函数): is_multi_author
• Function(函数): is_month()
• Function(函数): is_new_day()
• Function(函数): is_page()
• Function(函数): is_page_template()
• Function(函数): is_paged()
• Function(函数): is_plugin_active()
• Function(函数): is_plugin_active_for_network()
• Function(函数): is_plugin_inactive()
• Function(函数): is_plugin_page()
• Function(函数): is_post_type_archive()
• Function(函数): is_preview()
• Function(函数): is_search()
• Function(函数): is_single()
• Function(函数): is_singular()
• Function(函数): is_sticky()
• Function(函数): is_tag()
• Function(函数): is_tax()
• Function(函数): is_taxonomy_hierarchical()
• Function(函数): is_time()
• Function(函数): is_trackback()
• Function(函数): is_year()
• Function(函数): in_category()
• Function(函数): in_the_loop()
• Function(函数): is_active_sidebar()
• Function(函数): is_active_widget()
• Function(函数): is_blog_installed()
• Function(函数): is_rtl()
• Function(函数): is_dynamic_sidebar()
• Function(函数): is_user_logged_in()
• Function(函数): has_excerpt()
• Function(函数): has_post_thumbnail()
• Function(函数): has_tag()
• Function(函数): pings_open()
• Function(函数): email exists()
• Function(函数): post_type_exists()
• Function(函数): taxonomy_exists()
• Function(函数): term_exists()
• Function(函数): username exists()
• Function(函数): wp_attachment_is_image()
• Function(函数): wp_script_is()

• 原文：http://codex.wordpress.org/Function_Reference/cat_is_ancestor_of