WordPress filter hook · part of WordPress core

pre_trash_post

A WordPress core filter that 7 plugins also fire themselves, running on 8,550+ sites between them.

“This filter is documented in wp-includes/post.php”

How to use pre_trash_post

It's a filter: your callback receives the value and 1 more argument, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'pre_trash_post', function( $value, $post ) {
	// Change $value here.
	return $value;
}, 10, 2 );

Argument names come from ALD's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

7 plugins that fire pre_trash_post

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. ALD icon ALD8,000+ installs apply_filters( 'pre_trash_post', null, $post ) includes/ali-product-table.php:584
  2. TMDS icon TMDS400+ installs apply_filters( 'pre_trash_post', null, $post ) includes/class/tmds-products-table.php:588
  3. ChinaDS icon ChinaDS100+ installs apply_filters( 'pre_trash_post', null, $post ) admin/taobao-products-table.php:586
  4. HANDMADE icon HANDMADE30+ installs apply_filters( 'pre_trash_post', null, $post ) includes/class/handmade-products-table.php:588
  5. MediaPilot AI icon MediaPilot AI10+ installs apply_filters( 'pre_trash_post', null, $post, $previousStatus ) includes/Media/MediaTrash.php:491
  6. Post ID Optimizer icon Post ID Optimizer10+ installs apply_filters( 'pre_trash_post', null, $post ) post-poidopt.php:2968
  7. Checknaut icon ChecknautFewer than 10 installs apply_filters( 'pre_trash_post', null, $post, $was ) includes/class-dvc-fixer.php:1031

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.