Filter hook 'pre_trash_post'

Hook Information

Hook Parameters

Usage Examples

<?php
// Hook into pre_trash_post
add_filter('pre_trash_post', 'my_custom_filter', 10, 1);

function my_custom_filter($post) {
    // Your custom filtering logic here
    return $post;
}

Source Code Context

<?php
3085  		}
3086  
3087  		$previous_status = $post->post_status;
3088  
3089  		/** This filter is documented in wp-includes/post.php */
3090  		$check = apply_filters( 'pre_trash_post', null, $post, $previous_status );
3091  		if ( null !== $check ) {
3092  			return $check;
3093  		}
3094  
3095  		/** This action is documented in wp-includes/post.php */

PHP Documentation

<?php
/**
	 * Trashes or deletes a changeset post.
	 *
	 * The following re-formulates the logic from `wp_trash_post()` as done in
	 * `wp_publish_post()`. The reason for bypassing `wp_trash_post()` is that it
	 * will mutate the the `post_content` and the `post_name` when they should be
	 * untouched.
	 *
	 * @since 4.9.0
	 *
	 * @see wp_trash_post()
	 * @global wpdb $wpdb WordPress database abstraction object.
	 *
	 * @param int|WP_Post $post The changeset post.
	 * @return mixed A WP_Post object for the trashed post or an empty value on failure.
	 */