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 ) required –
term_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; }