wp_delete_post ( $postid = 0, $force_delete = false )
- (int) $postid Optional. Post ID. Default 0.
- (bool) $force_delete Optional. Whether to bypass trash and force deletion. Default false.
- (WP_Post|false|null) Post data on success, false or null on failure.
- Introduced in WordPress: 1.0.0
- Deprecated in WordPress: —
Trash or delete a post or page.
When the post and page is permanently deleted, everything that is tied to
it is deleted also. This includes comments, post meta fields, and terms
associated with the post.
The post or page is moved to trash instead of permanently deleted unless
trash is disabled, item is already in the trash, or $force_delete is true.