Question

wp_update_category( array $catarr )

Aliases wp_insert_category() with minimal args.

---

description

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

---

参数

$catarr

(array) (Required) The 'cat_ID' value is required. All other keys are optional.

---

返回值

(int|bool) The ID number of the new or updated Category on success. Zero or FALSE on failure.

---

源代码

File: wp-admin/includes/taxonomy.php

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);
}

---

更新日志

Version	description
2.0.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/taxonomy.php: wp_insert_category()
• wp-includes/formatting.php: wp_slash()
• wp-includes/category.php: _make_cat_compat()
• wp-includes/taxonomy.php: get_term()

---

User Contributed Notes