rest_pre_insert_(post_type) │ filter-hook │ WP 4.7.0

Filters a post before it is inserted via the REST API.

The dynamic portion of the hook name, $this->post_type, refers to the post type slug.

Possible hook names include:

• rest_pre_insert_post
• rest_pre_insert_page
• rest_pre_insert_attachment

Usage

add_filter( 'rest_pre_insert_(post_type)', 'wp_kama_rest_pre_insert_post_type_filter', 10, 2 );

/**
 * Function for `rest_pre_insert_(post_type)` filter-hook.
 * 
 * @param stdClass        $prepared_post An object representing a single post prepared for inserting or updating the database.
 * @param WP_REST_Request $request       Request object.
 *
 * @return stdClass
 */
function wp_kama_rest_pre_insert_post_type_filter( $prepared_post, $request ){

	// filter...
	return $prepared_post;
}

$prepared_post(stdClass)

An object representing a single post prepared for inserting or updating the database.

$request(WP_REST_Request)

Request object.

Changelog

Where the hook is called

return apply_filters( "rest_pre_insert_{$this->post_type}", $prepared_post, $request );

return apply_filters( "rest_pre_insert_{$this->post_type}", $changes, $request );

Where the hook is used in WordPress

add_filter( 'rest_pre_insert_wp_navigation', 'block_core_navigation_update_ignore_hooked_blocks_meta' );

add_filter( 'rest_pre_insert_wp_template', 'inject_ignored_hooked_blocks_metadata_attributes' );

add_filter( 'rest_pre_insert_wp_template_part', 'inject_ignored_hooked_blocks_metadata_attributes' );

add_filter( 'rest_pre_insert_wp_navigation', 'update_ignored_hooked_blocks_postmeta' );