wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_update_category › WordPress Function

Since2.0.0
Deprecatedn/a
› wp_update_category ( $catarr )
Parameters:
  • (array) $catarr The 'cat_ID' value is required. All other keys are optional.
    Required: Yes
Returns:
  • (int|false) The ID number of the new or updated Category on success. Zero or FALSE on failure.
Defined at:
Codex:

Aliases wp_insert_category() with minimal args.

If you want to update only some fields of an existing category, call this function with only the new values set inside $catarr.


Related Functions: wp_delete_category, wp_create_category, wp_update_term, wp_update_core, update_category_cache

Source 

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

	if ( isset( $catarr['category_parent'] ) && ( $cat_id === (int) $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 );
}