wp_insert_term( string $term, string $taxonomy, array|string $args = array() ): array|WP_Error

2407function wp_insert_term( $term, $taxonomy, $args = array() ) {2408	global $wpdb;2409 2410	if ( ! taxonomy_exists( $taxonomy ) ) {2411		return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );2412	}2413 2414	/**2415	 * Filters a term before it is sanitized and inserted into the database.2416	 *2417	 * @since 3.0.02418	 * @since 6.1.0 The `$args` parameter was added.2419	 *2420	 * @param string|WP_Error $term     The term name to add, or a WP_Error object if there's an error.2421	 * @param string          $taxonomy Taxonomy slug.2422	 * @param array|string    $args     Array or query string of arguments passed to wp_insert_term().2423	 */2424	$term = apply_filters( 'pre_insert_term', $term, $taxonomy, $args );2425 2426	if ( is_wp_error( $term ) ) {2427		return $term;2428	}2429 2430	if ( is_int( $term ) && 0 === $term ) {2431		return new WP_Error( 'invalid_term_id', __( 'Invalid term ID.' ) );2432	}2433 2434	if ( '' === trim( $term ) ) {2435		return new WP_Error( 'empty_term_name', __( 'A name is required for this term.' ) );2436	}2437 2438	$defaults = array(2439		'alias_of'    => '',2440		'description' => '',2441		'parent'      => 0,2442		'slug'        => '',2443	);2444	$args     = wp_parse_args( $args, $defaults );2445 2446	if ( (int) $args['parent'] > 0 && ! term_exists( (int) $args['parent'] ) ) {2447		return new WP_Error( 'missing_parent', __( 'Parent term does not exist.' ) );2448	}2449 2450	$args['name']     = $term;2451	$args['taxonomy'] = $taxonomy;2452 2453	// Coerce null description to strings, to avoid database errors.2454	$args['description'] = (string) $args['description'];2455 2456	$args = sanitize_term( $args, $taxonomy, 'db' );2457 2458	// expected_slashed ($name)2459	$name        = wp_unslash( $args['name'] );2460	$description = wp_unslash( $args['description'] );2461	$parent      = (int) $args['parent'];2462 2463	// Sanitization could clean the name to an empty string that must be checked again.2464	if ( '' === $name ) {2465		return new WP_Error( 'invalid_term_name', __( 'Invalid term name.' ) );2466	}2467 2468	$slug_provided = ! empty( $args['slug'] );2469	if ( ! $slug_provided ) {2470		$slug = sanitize_title( $name );2471	} else {2472		$slug = $args['slug'];2473	}2474 2475	$term_group = 0;2476	if ( $args['alias_of'] ) {2477		$alias = get_term_by( 'slug', $args['alias_of'], $taxonomy );2478		if ( ! empty( $alias->term_group ) ) {2479			// The alias we want is already in a group, so let's use that one.2480			$term_group = $alias->term_group;2481		} elseif ( ! empty( $alias->term_id ) ) {2482			/*2483			 * The alias is not in a group, so we create a new one2484			 * and add the alias to it.2485			 */2486			$term_group = $wpdb->get_var( "SELECT MAX(term_group) FROM $wpdb->terms" ) + 1;