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

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