Описание функции wp_save_post_revision()
Функция wp_save_post_revision() сохраняет ревизию записи в базе данных. Она позволяет создавать резервные копии содержимого записи, что дает возможность восстанавливать старые версии. Это особенно полезно при редактировании записей, когда необходимо вернуть изменения назад.
Функция вызывается автоматически при сохранении записи, если включена поддержка ревизий для данного типа записи.
Параметры
$post
Тип: WP_Post
Обязательный: Да
Описание: Объект WP_Post, представляющий запись, для которой сохраняется ревизия
Возможные значения:
Возвращаемое значение
Тип: int|false
Описание: ID сохраненной ревизии или false в случае ошибки
Возможные значения:
• ID ревизии при успешном сохранении
• false если произошла ошибка
Примеры использования
Базовый пример сохранения ревизии для записи с ID 1
$post = get_post(1);
$revision_id = wp_save_post_revision($post);
// $revision_id будет содержать ID новой ревизии
ID ревизии успешно сохранен
Проверка на ошибки при сохранении ревизии
$post = get_post(1);
$revision_id = wp_save_post_revision($post);
if (!$revision_id) {
echo 'Ошибка сохранения ревизии';
}
Сообщение об ошибке при неудаче
Безопасность
Валидация входных данных: Функция проверяет, является ли переданный объект валидным WP_Post
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Убедитесь, что вы передаете корректный объект WP_Post
— Связанные функции
Получает все ревизии для конкретной записи
Удаляет конкретную ревизию из базы данных
— Примечания
– Ограничения
Функция работает только для типов записей, которые поддерживают ревизии
– Частые проблемы
- Не сохраняются ревизии для типов записей без поддержки
- Проблемы с сохранением при отсутствии прав у пользователя
