apply_filters( 'wp_save_post_revision_post_has_changed', bool $post_has_changed, WP_Post $latest_revision, WP_Post $post )
- Since
- 4.1.0
Filters whether a post has changed.
Description
By default a revision is saved only if one of the revisioned fields has changed.
This filter allows for additional checks to determine if there were changes.
Compatibility
- WordPress
- since 4.1.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
$post_has_changedbool- Whether the post has changed.
$latest_revisionWP_Post- The latest revision post object.
$postWP_Post- The post object.
Where this hook fires · 1
wp-includes/revision.php:208wp_save_post_revision()
Source code
* @since 4.1.0 * * @param bool $post_has_changed Whether the post has changed. * @param WP_Post $latest_revision The latest revision post object. * @param WP_Post $post The post object. */ $post_has_changed = (bool) apply_filters( 'wp_save_post_revision_post_has_changed', $post_has_changed, $latest_revision, $post ); // Don't save revision if post unchanged. if ( ! $post_has_changed ) { return null; } }Changelog
Introduced in 4.1.0. Unchanged from 6.7.7 through 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.