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

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