wp_insert_post documentation missing post_title

[atimmer]

The documentation for the $postarr for wp_insert_post is missing post_title as an argument.

[atimmer]

31359.diff adds post_title to the documentation.

[SergeyBiryukov]

Seems like post_content is missing too.

[SergeyBiryukov]

We should probably synchronize that block with the list of fields in the wp_posts table:

ID
post_author
post_date
post_date_gmt
post_content
post_title
post_excerpt
post_status
comment_status
ping_status
post_password
post_name
to_ping
pinged
post_modified
post_modified_gmt
post_content_filtered
post_parent
guid
menu_order
post_type
post_mime_type
comment_count

[atimmer]

Great idea, I will look further into this with more time.

[atimmer]

31359.2.diff adds all missing possibilities. I would love feedback on the textual content, I tried to mimic the pre-existing documentation.

I wonder if we should order all the variables the same way they are ordered in the database. Thoughts?

[SergeyBiryukov]

Replying to atimmer:

I wonder if we should order all the variables the same way they are ordered in the database. Thoughts?

I would expect that, yes.

[atimmer]

31359.3.diff is the same as 31359.2.diff except that the documentation is ordered the same way as the database.

[SergeyBiryukov]

$comment_status and $ping_status should be changed to string, they can be 'open' or 'closed'. Apparently this was an oversight in [25628].

Looks good to me otherwise.

[atimmer]

Done, see 31359.4.diff

[DrewAPicture]

In 31486:

Clarify and complete default argument documentation for wp_insert_post().

Props atimmer, SergeyBiryukov.
Fixes #31359.

[SergeyBiryukov]

In 31496:

Remove a stray single quote in wp_insert_post() documentation.

see #31359.