_wp_post_revision_fields filter-hookWP 2.6.0

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_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' );