wp_check_term_hierarchy_for_loops() – Checks the given subset of the term hierarchy for hierarchy loops.

You appear to be a bot. Output may be restricted

Description

Checks the given subset of the term hierarchy for hierarchy loops.

Prevents loops from forming and breaks those that it finds. Attached to the wp_update_term_parent filter.

Usage

$int = wp_check_term_hierarchy_for_loops( $parent_term, $term_id, $taxonomy );

Parameters

$parent_term
( int ) requiredterm_id of the parent for the term we're checking.
$term_id
( int ) required – The term we're checking.
$taxonomy
( string ) required – The taxonomy of the term we're checking.

Returns

int The new parent for the term.

Source

File name: wordpress/wp-includes/taxonomy.php


Lines:

1 to 30 of 30
function wp_check_term_hierarchy_for_loops( $parent_term, $term_id, $taxonomy ) {
  // Nothing fancy here - bail.
  if ( ! $parent_term ) {
    return 0;
  }

  // Can't be its own parent.
  if ( $parent_term === $term_id ) {
    return 0;
  }

  // Now look for larger loops.
  $loop = wp_find_hierarchy_loop( 'wp_get_term_taxonomy_parent_id', $term_id, $parent_term, array( $taxonomy ) );
  if ( ! $loop ) {
    return $parent_term; // No loop.
  }

  // Setting $parent_term 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_term;
}
 

 View on GitHub View on Trac