do_action( 'before_delete_post', int $postid, WP_Post $post )

Fires before a post is deleted, at the start of wp_delete_post() .

Contents

Description
- See also
Parameters
More Information
Source
Related
- Used By
Changelog
User Contributed Notes
- Feedback

Description

See also

wp_delete_post()

Parameters

$postid int: Post ID.
$post WP_Post: Post object.

More Information

This hook runs:

Just before other data associated with the post is deleted – like meta data. After the other data is deleted, the delete_post action executes, the primary post is removed, and then the deleted_post action is executed.
When items marked for trash are going through final (forced) deletion (e.g. the trash is disabled and an item is deleted).

This hook does not run:

For posts that are being marked as trash (unforced). The wp_trash_post hook is the functional equivalent, executed just before items are marked as trash.
For attachments. The delete_attachment hook is the functional equivalent, executed just before posts of type attachment are processed. With attachments, exactly as with other post types, meta data is removed, the delete_post action is run, then the attachment is removed from the database, and finally, the deleted_post action is run.

Source

File: wp-includes/post.php. View all references

do_action( 'before_delete_post', $postid, $post );

View on Trac View on GitHub

Used By

Used By
Used By	Description
wp_delete_post() wp-includes/post.php	Trashes or deletes a post or page.

Changelog

Changelog
Version	Description
5.5.0	Added the `$post` parameter.
3.2.0	Introduced.

User Contributed Notes

3

Contributed by ahsynv — 2 years ago

<?php
add_action( 'before_delete_post', 'wpdocs_my_func', 99, 2 );
function wpdocs_my_func( $postid, $post ) {
 
    if ( 'wpdocs_my_custom_post_type' !== $post->post_type ) {
        return;
    }
 
    // My custom stuff for deleting my custom post type here
}
?>

Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

Contributed by Collins Mbaka — 2 years ago
Let’s suppose you have a plugin and when a certain post_type is deleted you want to perform some action.
```
<?php
add_action( 'before_delete_post', 'wpdocs_my_func' );
function wpdocs_my_func( $postid ) {

    // We check if the global post type isn't ours and just return
    global $post_type;   

    if ( 'wpdocs_my_custom_post_type' !== $post_type ) {
        return;
    }

    // My custom stuff for deleting my custom post type here
}
?>
```
Top ↑
Feedback
- It would be a good practice not to use global variables when the needed information is available in parameters because global variables can easily be broken by different context, plugins or updates. — By Teemu Suoranta — 10 months ago
Log in to add feedback

You must log in before being able to contribute a note or feedback.