Changeset 43570

Timestamp:

08/15/2018 07:49:50 PM (7 years ago)

Author:

boonebgorges

Message:

Introduce wp_insert_term_duplicate_term_check filter.

This filter allows plugins to intervene in the duplicate-term check
that takes place at the time of term creation. See [30238], #22023.

Props strategio.
Fixes #43271.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (1 diff)

trunk/src/wp-includes/taxonomy.php

@@ -2313 +2313 @@
      * are not fired.
      */
-    $duplicate_term = $wpdb->get_row( $wpdb->prepare( "SELECT t.term_id, tt.term_taxonomy_id FROM $wpdb->terms t INNER JOIN $wpdb->term_taxonomy tt ON ( tt.term_id = t.term_id ) WHERE t.slug = %s AND tt.parent = %d AND tt.taxonomy = %s AND t.term_id < %d AND tt.term_taxonomy_id != %d", $slug, $parent, $taxonomy, $term_id, $tt_id ) );
+    $duplicate_term = $wpdb->get_row( $wpdb->prepare( "SELECT t.term_id, t.slug, tt.term_taxonomy_id, tt.taxonomy FROM $wpdb->terms t INNER JOIN $wpdb->term_taxonomy tt ON ( tt.term_id = t.term_id ) WHERE t.slug = %s AND tt.parent = %d AND tt.taxonomy = %s AND t.term_id < %d AND tt.term_taxonomy_id != %d", $slug, $parent, $taxonomy, $term_id, $tt_id ) );
+
+    /**
+     * Filters the duplicate term check that takes place during term creation.
+     *
+     * 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.
+     *
+     * @since 5.0.0
+     *
+     * @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           Term arguments passed to the function.
+     * @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 ) );