设置帖子的类别。

原型

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

描述

如果未设置post categories参数,则使用默认类别。

参数

$post_ID (int) (Optional)  邮政编码。不默认为全局$ post的ID。默认值为0。

$post_categories (array|int) (Optional)  类别列表或类别ID。

$append (bool) (Optional) 如果为true,请不要删除现有类别,只需添加即可。如果为false,请使用新类别替换类别。

返回值

(array|false|WP_Error)  受影响类别的术语分类ID的数组。

源文件

路径:wp-includes/post.php

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

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_set_post_categories/