term_is_ancestor_of( int|object $term1, int|object $term2, string $taxonomy )

Check if a term is an ancestor of another term.

Description

You can use either an id or the term object for both parameters.

Parameters

$term1

(Required) ID or object to check if this is the parent term.

$term2

(Required) The child term.

$taxonomy

(Required) Taxonomy name that $term1 and $term2 belong to.

Return

(bool) Whether $term2 is a child of $term1.

Source

File: wp-includes/taxonomy.php 

function term_is_ancestor_of( $term1, $term2, $taxonomy ) {
	if ( ! isset( $term1->term_id ) )
		$term1 = get_term( $term1, $taxonomy );
	if ( ! isset( $term2->parent ) )
		$term2 = get_term( $term2, $taxonomy );

	if ( empty( $term1->term_id ) || empty( $term2->parent ) )
		return false;
	if ( $term2->parent == $term1->term_id )
		return true;

	return term_is_ancestor_of( $term1, get_term( $term2->parent, $taxonomy ), $taxonomy );
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/taxonomy.php: term_is_ancestor_of()

Check if a term is an ancestor of another term.
wp-includes/taxonomy.php: get_term()

Get all Term data from database by Term ID.

Used By

Used By
Used By Description
wp-includes/category.php: cat_is_ancestor_of()

Check if a category is an ancestor of another category.
wp-includes/taxonomy.php: term_is_ancestor_of()

Check if a term is an ancestor of another term.
wp-admin/includes/taxonomy.php: wp_insert_category()

Updates an existing Category or creates a new Category.

Changelog

Changelog
Version Description
WP-3.4.0 Introduced.