# _wp_preview_meta_filter()

URL: https://chugunov.pro/api-wordpress/functions/_wp_preview_meta_filter/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 6.4.0.

## Сигнатура

```php
_wp_preview_meta_filter( mixed $value, int $object_id, string $meta_key, bool $single ): mixed
```

## Описание

Фильтрует только ключи метаданных, включённые в ревизии.

## Параметры

- `$value` `mixed` — обязательный. Значение метаданных для фильтрации.
- `$object_id` `int` — обязательный. Идентификатор объекта.
- `$meta_key` `string` — обязательный. Ключ метаданных, значение которого нужно отфильтровать.
- `$single` `bool` — обязательный. Возвращать ли одно значение.

## Возвращаемое значение

`mixed`

## Исходный код

Файл: `wp-includes/revision.php:1107`

```php
function _wp_preview_meta_filter( $value, $object_id, $meta_key, $single ) {
	$post = get_post();

	if ( empty( $post )
		|| $post->ID !== $object_id
		|| ! in_array( $meta_key, wp_post_revision_meta_keys( $post->post_type ), true )
		|| 'revision' === $post->post_type
	) {
		return $value;
	}

	$preview = wp_get_post_autosave( $post->ID );

	if ( false === $preview ) {
		return $value;
	}

	return get_post_meta( $preview->ID, $meta_key, $single );
}
```

## История изменений

- 6.4.0 — Introduced.

## Связанные

Использует: [`wp_post_revision_meta_keys`](https://chugunov.pro/api-wordpress/functions/wp_post_revision_meta_keys/), [`wp_get_post_autosave`](https://chugunov.pro/api-wordpress/functions/wp_get_post_autosave/), [`get_post_meta`](https://chugunov.pro/api-wordpress/functions/get_post_meta/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/_wp_preview_meta_filter/