WordPress.org
Get WordPress

Make WordPress Core

Opened 4 months ago

Last modified 4 months ago

#63729 new enhancement

Fix misleading summary in PHPDoc for wp_insert_post()

Reported by: rutujaparamane2004's profile rutujaparamane2004 Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version:
Component: Posts, Post Types Keywords: has-patch
Focuses: docs Cc:

Description

This patch improves the inline documentation for the wp_insert_post() function by clarifying that it inserts or updates a post depending on the presence of an ID. Previously, the docblock implied it only inserts posts.

Change History (8)

#1 follow-up: @Presskopp
4 months ago

Hi and welcome Rutuja. May I ask, where do we find your patch?

#2 @vladimiraus
4 months ago

Cannot see the patch either. Should we change to needs patch?

This ticket was mentioned in ​PR #9288 on ​WordPress/wordpress-develop by ​@vladimiraus.
4 months ago #3

Added examples for wp_insert_post and fixed minor typos.

#4 @vladimiraus
4 months ago

  • Keywords needs-testing added
  • Type changed from defect (bug) to enhancement

Added pull request.

#5 in reply to: ↑ 1 @sabernhardt
4 months ago

  • Keywords needs-testing removed
  • Version 6.5 deleted

Hi and welcome Rutuja. May I ask, where do we find your patch?

The pull request preceded the ticket: ​9286

@rutujaparamane2004 If you add a link to the ticket in the pull request's first comment, the PR should connect to the ticket automatically.

Regarding the version, [53456] added the 's' to 'Inserts' for WordPress 6.1, but the rest of the function description goes back much earlier to [8669], [23311] and [25628].

#6 @vladimiraus
4 months ago

  • Keywords needs-testing added

#7 @SirLouen
4 months ago

  • Keywords needs-testing removed

Docs don't need a needs-testing tag.

#8 @vladimiraus
4 months ago

Thanks @SirLouen. I wasn't sure.

Note: See TracTickets for help on using tickets.