Описание функции wp_get_post_revisions()
Функция wp_get_post_revisions() возвращает массив ревизий для указанной записи. Ревизии — это сохраненные версии записи, которые позволяют пользователям восстанавливать предыдущие состояния. Эта функция используется в админ-панели и может быть полезна для разработки плагинов и тем, когда необходимо работать с историей изменений записей.
Функция поддерживает фильтрацию по количеству возвращаемых ревизий и может возвращать объекты WP_Post.
Параметры
$post_id
Тип: int
Обязательный: Да
По умолчанию: null
Описание: ID записи, для которой нужно получить ревизии
Возможные значения:
greater_than: 0
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для получения ревизий
Возможные значения:
number: Количество возвращаемых ревизий
orderby: date, modified
order: ASC, DESC
Возвращаемое значение
Тип: array
Описание: Массив объектов WP_Post, представляющих ревизии записи
Возможные значения:
• Массив объектов WP_Post при наличии ревизий
• Пустой массив если ревизии не найдены
• WP_Error в случае ошибки
Примеры использования
Базовый пример получения всех ревизий для записи с ID 123
$revisions = wp_get_post_revisions(123);
foreach($revisions as $revision) {
echo $revision->post_title . ', ';
}
Ревизии могут включать различные версии записи
Получение последних 5 ревизий, отсортированных по дате
$args = array(
'number' => 5,
'orderby' => 'date',
'order' => 'DESC'
);
$revisions = wp_get_post_revisions(123, $args);
Параметры позволяют настроить количество и порядок
Безопасность
Валидация входных данных: Параметр post_id проходит валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для названий ревизий
— Связанные функции
Сохраняет новую ревизию записи
Получает конкретную ревизию по ID
— Хуки
Фильтрует результаты ревизий перед их возвратом
— Примечания
– Ограничения
Возвращает только ревизии, связанные с постами, у которых включено сохранение ревизий
– Частые проблемы
- Пустой массив при отсутствии ревизий для данной записи
- Ошибки при неверном ID записи
