Question

wp_set_post_categories( int $post_ID,  array|int $post_categories = array(),  bool $append = false )

Set categories for a post.

---

description

If the post categories parameter is not set, then the default category is going used.

---

参数

$post_ID

(int) (Optional) The Post ID. Does not default to the ID of the global $post. Default 0.

$post_categories

(array|int) (Optional) List of categories or ID of category.

Default value: array()

$append

(bool) (Optional) If true, don't delete existing categories, just add on. If false, replace the categories with the new categories.

Default value: false

---

返回值

(array|false|WP_Error) Array of term taxonomy IDs of affected categories. WP_Error or false on failure.

---

源代码

File: wp-includes/post.php

function wp_set_post_categories( $post_ID = 0, $post_categories = array(), $append = false ) {
	$post_ID = (int) $post_ID;
	$post_type = get_post_type( $post_ID );
	$post_status = get_post_status( $post_ID );
	// If $post_categories isn't already an array, make it one:
	$post_categories = (array) $post_categories;
	if ( empty( $post_categories ) ) {
		if ( 'post' == $post_type && 'auto-draft' != $post_status ) {
			$post_categories = array( get_option('default_category') );
			$append = false;
		} else {
			$post_categories = array();
		}
	} elseif ( 1 == count( $post_categories ) && '' == reset( $post_categories ) ) {
		return true;
	}

	return wp_set_post_terms( $post_ID, $post_categories, 'category', $append );
}

---

更新日志

Version	description
2.1.0	Introduced.

---

相关函数

Uses

• wp-includes/option.php: get_option()
• wp-includes/post.php: wp_set_post_terms()
• wp-includes/post.php: get_post_type()
• wp-includes/post.php: get_post_status()

---

Used By

• wp-admin/includes/taxonomy.php: wp_create_categories()
• wp-includes/deprecated.php: wp_set_post_cats()
• wp-includes/post.php: wp_insert_post()
• wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mt_setPostCategories()

---

User Contributed Notes