wp_insert_post_empty_content filter-hookWP 3.3.0

Filters whether the post should be considered "empty".

The post is considered "empty" if both:

  1. The post type supports the title, editor, and excerpt fields
  2. The title, editor, and excerpt fields are all empty

Returning a truthy value from the filter will effectively short-circuit the new post being inserted and return 0. If $wp_error is true, a WP_Error will be returned instead.

Usage

add_filter( 'wp_insert_post_empty_content', 'wp_kama_insert_post_empty_content_filter', 10, 2 );

/**
 * Function for `wp_insert_post_empty_content` filter-hook.
 * 
 * @param bool  $maybe_empty Whether the post should be considered "empty".
 * @param array $postarr     Array of post data.
 *
 * @return bool
 */
function wp_kama_insert_post_empty_content_filter( $maybe_empty, $postarr ){

	// filter...
	return $maybe_empty;
}
$maybe_empty(true|false)
Whether the post should be considered "empty".
$postarr(array)
Array of post data.

Changelog

Since 3.3.0 Introduced.

Where the hook is called

wp_insert_post()
wp_insert_post_empty_content
wp-includes/post.php 4247
if ( apply_filters( 'wp_insert_post_empty_content', $maybe_empty, $postarr ) ) {

Where the hook is used in WordPress

wp-includes/class-wp-customize-nav-menus.php 975
add_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );
wp-includes/class-wp-customize-nav-menus.php 977
remove_filter( 'wp_insert_post_empty_content', '__return_false', 1000 );