wppaste
WordPress

apply_filters( "rest_pre_insert_{$this->post_type}", stdClass $prepared_post, WP_REST_Request $request )

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

Description

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

Compatibility

WordPress
since 4.7.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$prepared_poststdClass
An object representing a single post prepared for inserting or updating the database.
$requestWP_REST_Request
Request object.

Where this hook fires · 2

  • wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php:1531WP_REST_Posts_Controller::prepare_item_for_database()
  • wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php:661WP_REST_Templates_Controller::prepare_item_for_database()

Source code

		 * @since 4.7.0		 *		 * @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 apply_filters( "rest_pre_insert_{$this->post_type}", $prepared_post, $request );	} 	/**	 * Checks whether the status is valid for the given post.	 *	 * Allows for sending an update request with the current status, even if that status would not be acceptable.

Changelog

Introduced in 4.7.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.