wppaste
WordPress

apply_filters( 'wp_insert_term_duplicate_term_check', object $duplicate_term, string $term, string $taxonomy, array $args, int $tt_id )

Since
5.1.0
Filters the duplicate term check that takes place during term creation.

Description

Term parent + taxonomy + slug combinations are meant to be unique, and wp_insert_term() performs a last-minute confirmation of this uniqueness before allowing a new term to be created. Plugins with different uniqueness requirements may use this filter to bypass or modify the duplicate-term check.

Parameters

$duplicate_termobject
Duplicate term row from terms table, if found.
$termstring
Term being inserted.
$taxonomystring
Taxonomy name.
$argsarray
Arguments passed to wp_insert_term().
$tt_idint
term_taxonomy_id for the newly created term.

Fired at · 1

  • wp-includes/taxonomy.php:2641wp_insert_term()

Source

	 * @param object $duplicate_term Duplicate term row from terms table, if found.	 * @param string $term           Term being inserted.	 * @param string $taxonomy       Taxonomy name.	 * @param array  $args           Arguments passed to wp_insert_term().	 * @param int    $tt_id          term_taxonomy_id for the newly created term.	 */	$duplicate_term = apply_filters( 'wp_insert_term_duplicate_term_check', $duplicate_term, $term, $taxonomy, $args, $tt_id ); 	if ( $duplicate_term ) {		$wpdb->delete( $wpdb->terms, array( 'term_id' => $term_id ) );		$wpdb->delete( $wpdb->term_taxonomy, array( 'term_taxonomy_id' => $tt_id ) ); 		$term_id = (int) $duplicate_term->term_id;

History

Introduced in 5.1.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 6.8.8 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.