wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_check_term_hierarchy_for_loops › WordPress Function

Since3.1.0
Deprecatedn/a
wp_check_term_hierarchy_for_loops ( $parent_term, $term_id, $taxonomy )
Parameters: (3)
  • (int) $parent_term `term_id` of the parent for the term we're checking.
    Required: Yes
  • (int) $term_id The term we're checking.
    Required: Yes
  • (string) $taxonomy The taxonomy of the term we're checking.
    Required: Yes
Returns:
  • (int) The new parent for the term.
Defined at:
Codex:

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

Prevents loops from forming and breaks those that it finds. Attached to the {@see 'wp_update_term_parent'} filter.


Source

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;
}