pre_delete_post │ filter-hook │ WP 4.4.0

Filters whether a post deletion should take place.

Usage

add_filter( 'pre_delete_post', 'wp_kama_pre_delete_post_filter', 10, 3 );

/**
 * Function for `pre_delete_post` filter-hook.
 * 
 * @param WP_Post|false|null $check        Whether to go forward with deletion. Anything other than null will short-circuit deletion.
 * @param WP_Post            $post         Post object.
 * @param bool               $force_delete Whether to bypass the Trash.
 *
 * @return WP_Post|false|null
 */
function wp_kama_pre_delete_post_filter( $check, $post, $force_delete ){

	// filter...
	return $check;
}

$check(WP_Post|false|null)

Whether to go forward with deletion. Anything other than null will short-circuit deletion.

$post(WP_Post)

Post object.

$force_delete(true|false)

Whether to bypass the Trash.

Changelog

Where the hook is called

$check = apply_filters( 'pre_delete_post', null, $post, $force_delete );

Where the hook is used in WordPress