pre_trash_post │ filter-hook │ WP 4.9.0

Filters whether a post trashing should take place.

Usage

add_filter( 'pre_trash_post', 'wp_kama_pre_trash_post_filter', 10, 3 );

/**
 * Function for `pre_trash_post` filter-hook.
 * 
 * @param bool|null $trash           Whether to go forward with trashing.
 * @param WP_Post   $post            Post object.
 * @param string    $previous_status The status of the post about to be trashed.
 *
 * @return bool|null
 */
function wp_kama_pre_trash_post_filter( $trash, $post, $previous_status ){

	// filter...
	return $trash;
}

$trash(true|false|null)

Whether to go forward with trashing.

$post(WP_Post)

Post object.

$previous_status(string)

The status of the post about to be trashed.

Changelog

Where the hook is called

$check = apply_filters( 'pre_trash_post', null, $post, $previous_status );

$check = apply_filters( 'pre_trash_post', null, $post, $previous_status );

Where the hook is used in WordPress