wp_set_post_categories( int $post_ID, array|int $post_categories = array(), bool $append = false )
Set categories for a post.
Description Description
If the post categories parameter is not set, then the default category is going used.
Parameters Parameters
- $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 category IDs, or the ID of a single 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
Return Return
(array|false|WP_Error) Array of term taxonomy IDs of affected categories. WP_Error or false on failure.
Source Source
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 ); }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
2.1.0 | Introduced. |