Описание функции wp_trash_post()
Функция wp_trash_post() перемещает указанную запись в корзину. Это позволяет пользователям восстанавливать записи позже, если они были удалены случайно. Функция обрабатывает как обычные записи, так и пользовательские типы записей, обеспечивая управление содержимым на сайте.
При вызове функции происходит проверка прав пользователя на удаление записи и выполнение необходимых действий, связанных с перемещением записи в корзину.
Параметры
$post_id
Тип: int
Обязательный: Да
Описание: ID записи, которую нужно переместить в корзину
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном перемещении записи в корзину, иначе false
Возможные значения:
• true при успешном выполнении
• false если запись не найдена или произошла ошибка
Примеры использования
Базовый пример перемещения записи с ID 123 в корзину
$result = wp_trash_post(123);
if ($result) {
echo 'Запись перемещена в корзину';
} else {
echo 'Ошибка при перемещении записи';
}
Выводит сообщение о результате операции
Попытка перемещения несуществующей записи в корзину
$post_id = 999;
$result = wp_trash_post($post_id);
if ($result) {
echo 'Запись перемещена в корзину';
} else {
echo 'Запись не найдена или ошибка';
}
Выводит сообщение об ошибке
Безопасность
Валидация входных данных: ID записи проверяется на корректность внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Убедитесь, что у пользователя есть права на удаление записи перед вызовом функции
— Связанные функции
Удаляет запись без возможности восстановления
Восстанавливает запись из корзины
— Примечания
– Ограничения
Не может переместить в корзину записи без прав доступа
– Частые проблемы
- Неверный ID записи приводит к ошибке
- Проблемы с правами пользователя могут вызвать сбои
