wp_set_post_categories
函数
wp_set_post_categories ( $post_ID = 0, $post_categories = array(), $append = false )
- 参数
-
-
(int)
$post_ID
Optional. The Post ID. Does not default to the ID of the global $post. Default 0.- Required: 否
-
(int[]|int)
$post_categories
Optional. List of category IDs, or the ID of a single category. Default empty array.- Required: 否
- Default: array()
-
(bool)
$append
If true, don’t delete existing categories, just add on. If false, replace the categories with the new categories.- Required: 否
- Default: false
-
(int)
- 返回值
-
- (array|false|WP_Error) Array of term taxonomy IDs of affected categories. WP_Error or false on failure.
- 定义位置
-
-
wp-includes/post.php
, line 5280
-
wp-includes/post.php
- 引入
- 2.1.0
- 弃用
- –
Sets categories for a post.
If no categories are provided, the default category is used.
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 ) ) { /** * Filters post types (in addition to 'post') that require a default category. * * @since 5.5.0 * * @param string[] $post_types An array of post type names. Default empty array. */ $default_category_post_types = apply_filters( 'default_category_post_types', array() ); // Regular posts always require a default category. $default_category_post_types = array_merge( $default_category_post_types, array( 'post' ) ); if ( in_array( $post_type, $default_category_post_types, true ) && is_object_in_taxonomy( $post_type, 'category' ) && '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 ); }
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。