_wp_post_revision_fields │ filter-hook │ WP 2.6.0

Filters the list of fields saved in post revisions.

Included by default: post_title, post_content 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

Where the hook is called

$fields = apply_filters( '_wp_post_revision_fields', $fields, $post );

Where the hook is used in WordPress

add_filter( '_wp_post_revision_fields', 'wp_add_footnotes_to_revision' );