wp_is_post_revision() WP 2.6.0

Определяет является ли указанная запись (пост) ревизией (редакцией записи).

Работает на основе: wp_get_post_revision()

✈ 1 раз = 0.000741с = медленно | 50000 раз = 1.31с = быстро

Хуков нет.

Возвращает

False/число.

False — не ревизия.
ID записи, которому текущий пост является ревизией.

Использование

wp_is_post_revision( $post );

$post(число/WP_Post) (обязательный): ID поста или его объект (WP_Post).

Примеры

#1 Проверка что мы редактируем не ревизию

Это пример из кода функции WordPress add_post_meta(). Где прежде чем добавить метаданные посту, проверяется не является ли запись ревизией:

function add_post_meta( $post_id, $meta_key, $meta_value, $unique = false ) {
	// Убедимся что текущий пост не ревизия.
	if ( $the_post = wp_is_post_revision($post_id) )
		$post_id = $the_post;

	return add_metadata('post', $post_id, $meta_key, $meta_value, $unique);
}

Список изменений

С версии 2.6.0

Введена.

Код wp is post revision: `wp-includes/revision.php` ^{WP 5.4.2}

<?php
function wp_is_post_revision( $post ) {
	$post = wp_get_post_revision( $post );
	if ( ! $post ) {
		return false;
	}

	return (int) $post->post_parent;
}