_wp_post_revision_fields
Filters the list of fields saved in post revisions.
Included by default: 'post_title', 'post_content' and 'post_excerpt'.
Disallowed fields: 'ID', 'post_name', 'post_parent', 'post_date', 'post_date_gmt', 'post_status', 'post_type', 'comment_count', and 'post_author'.
Usage
add_filter( '_wp_post_revision_fields', 'wp_kama__wp_post_revision_fields_filter', 10, 2 ); /** * Function for `_wp_post_revision_fields` filter-hook. * * @param string[] $fields List of fields to revision. Contains 'post_title', 'post_content', and 'post_excerpt' by default. * @param array $post A post array being processed for insertion as a post revision. * * @return string[] */ function wp_kama__wp_post_revision_fields_filter( $fields, $post ){ // filter... return $fields; }
- $fields(string[])
- List of fields to revision. Contains 'post_title', 'post_content', and 'post_excerpt' by default.
- $post(array)
- A post array being processed for insertion as a post revision.
Changelog
Since 2.6.0 | Introduced. |
Since 4.5.0 | The $post parameter was added. |
Where the hook is called
_wp_post_revision_fields
wp-includes/revision.php 54
$fields = apply_filters( '_wp_post_revision_fields', $fields, $post );
Where the hook is used in WordPress
wp-includes/blocks/footnotes.php 126
add_filter( '_wp_post_revision_fields', 'wp_add_footnotes_to_revision' );