wp_unique_term_slug( string $slug, object $term ): string

3084function wp_unique_term_slug( $slug, $term ) {3085	global $wpdb;3086 3087	$needs_suffix  = true;3088	$original_slug = $slug;3089 3090	// As of 4.1, duplicate slugs are allowed as long as they're in different taxonomies.3091	if ( ! term_exists( $slug ) || get_option( 'db_version' ) >= 30133 && ! get_term_by( 'slug', $slug, $term->taxonomy ) ) {3092		$needs_suffix = false;3093	}3094 3095	/*3096	 * If the taxonomy supports hierarchy and the term has a parent, make the slug unique3097	 * by incorporating parent slugs.3098	 */3099	$parent_suffix = '';3100	if ( $needs_suffix && is_taxonomy_hierarchical( $term->taxonomy ) && ! empty( $term->parent ) ) {3101		$the_parent = $term->parent;3102		while ( ! empty( $the_parent ) ) {3103			$parent_term = get_term( $the_parent, $term->taxonomy );3104			if ( is_wp_error( $parent_term ) || empty( $parent_term ) ) {3105				break;3106			}3107			$parent_suffix .= '-' . $parent_term->slug;3108			if ( ! term_exists( $slug . $parent_suffix ) ) {3109				break;3110			}3111 3112			if ( empty( $parent_term->parent ) ) {3113				break;3114			}3115			$the_parent = $parent_term->parent;3116		}3117	}3118 3119	// If we didn't get a unique slug, try appending a number to make it unique.3120 3121	/**3122	 * Filters whether the proposed unique term slug is bad.3123	 *3124	 * @since 4.3.03125	 *3126	 * @param bool   $needs_suffix Whether the slug needs to be made unique with a suffix.3127	 * @param string $slug         The slug.3128	 * @param object $term         Term object.3129	 */3130	if ( apply_filters( 'wp_unique_term_slug_is_bad_slug', $needs_suffix, $slug, $term ) ) {3131		if ( $parent_suffix ) {3132			$slug .= $parent_suffix;3133		}3134 3135		if ( ! empty( $term->term_id ) ) {3136			$query = $wpdb->prepare( "SELECT slug FROM $wpdb->terms WHERE slug = %s AND term_id != %d", $slug, $term->term_id );3137		} else {3138			$query = $wpdb->prepare( "SELECT slug FROM $wpdb->terms WHERE slug = %s", $slug );3139		}3140 3141		if ( $wpdb->get_var( $query ) ) { // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared3142			$num = 2;3143			do {3144				$alt_slug = $slug . "-$num";3145				++$num;3146				$slug_check = $wpdb->get_var( $wpdb->prepare( "SELECT slug FROM $wpdb->terms WHERE slug = %s", $alt_slug ) );3147			} while ( $slug_check );3148			$slug = $alt_slug;3149		}3150	}3151 3152	/**3153	 * Filters the unique term slug.3154	 *3155	 * @since 4.3.03156	 *3157	 * @param string $slug          Unique term slug.3158	 * @param object $term          Term object.3159	 * @param string $original_slug Slug originally passed to the function for testing.3160	 */3161	return apply_filters( 'wp_unique_term_slug', $slug, $term, $original_slug );3162}