Wrong documentation for wp_insert_post

[nabil_kadimi]

The post_category parameter accepts IDs or array of IDs, the doc says: "Array of category names, slugs, or IDs".

Here's a patch.

[nabil_kadimi]

Corrected patch.

[nabil_kadimi]

Just noticed only arrays are working, updating patch again.

[nabil_kadimi]

Corrected patch.

[kovshenin]

Might also be worth fixing the docs in the other related functions:

• wp_set_post_categories
• wp_set_post_terms

For reference, from wp_set_post_terms:

/*
 * Hierarchical taxonomies must always pass IDs rather than names so that
 * children with the same names but different parents aren't confused.
 */
if ( is_taxonomy_hierarchical( $taxonomy ) ) {
	$tags = array_unique( array_map( 'intval', $tags ) );
}

[desrosj]

@nabil_kadimi are you able to refresh the patch and make the changes @kovshenin suggested?

[angelagibson]

I'm new to contributing but I took a look at this. If I understand correctly, after reviewing the code it looks like the updates referenced above have already been made. wp_set_post_categories() and wp_insert_post() were both changed in ticket:45171 changeset:44660. wp_set_post_terms() was updated in ticket:42505 changeset:42664

[Hareesh Pillai]

Duplicate of #45171.

Closing this ticket as the proposed change is already made.