function wp_check_term_hierarchy_for_loops( $parent, $term_id, $taxonomy ) {}

Checks the given subset of the term hierarchy for hierarchy loops.
Prevents loops from forming and breaks those that it finds.


  • int $parent: term_id of the parent for the term we’re checking.
  • int $term_id: The term we’re checking.
  • string $taxonomy: The taxonomy of the term we’re checking.

Return values

returns:The new parent for the term.

Source code

function wp_check_term_hierarchy_for_loops( $parent, $term_id, $taxonomy ) {

	// Nothing fancy here - bail

	if ( !$parent )

		return 0;

	// Can't be its own parent

	if ( $parent == $term_id )

		return 0;

	// Now look for larger loops

	if ( !$loop = wp_find_hierarchy_loop( 'wp_get_term_taxonomy_parent_id', $term_id, $parent, array( $taxonomy ) ) )

		return $parent; // No loop

	// Setting $parent to the given value causes a loop

	if ( isset( $loop[$term_id] ) )

		return 0;

	// There's a loop, but it doesn't contain $term_id.  Break the loop.

	foreach ( array_keys( $loop ) as $loop_member )

		wp_update_term( $loop_member, $taxonomy, array( 'parent' => 0 ) );

	return $parent;



No comments yet... Be the first to leave a reply!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: