wp_update_category() WordPress Function

The wp_update_category() function is used to update an existing category in WordPress. The function takes two parameters: the category ID and an array of arguments. The array of arguments can include the following: - name: The new name for the category. - slug: The new slug for the category. - parent: The new parent category for the category. - description: The new description for the category. The function will return a WP_Error object on failure or true on success.

wp_update_category( array $catarr ) #

function wp_update_category( $catarr ) {
	$cat_ID = (int) $catarr['cat_ID'];

	if ( isset( $catarr['category_parent'] ) && ( $cat_ID == $catarr['category_parent'] ) ) {
		return false;
	}

	// First, get all of the original fields.
	$category = get_term( $cat_ID, 'category', ARRAY_A );
	_make_cat_compat( $category );

	// Escape data pulled from DB.
	$category = wp_slash( $category );

	// Merge old and new fields with new fields overwriting old ones.
	$catarr = array_merge( $category, $catarr );

	return wp_insert_category( $catarr );
}