Функция помещает пост с указанным ID в корзину, если же корзина отключена, то удаляет полностью. Возвращает объект перемещенного в корзину поста.
Если указанный пост уже находится в корзине, то возвращает false
.
По сути, всё, что делает функция, это меняет статус поста на trash
+ комменты к посту пропадают из общего списка в админке.
wp_trash_post($post_id = 0)
- $post_id
- (целое число) ID поста. Если не указан, то используется ID текущего поста.
Пример
wp_trash_post( 123 );
или
$trashed_post_obj = wp_trash_post( 123 );
В итоге пост с ID=123 окажется в корзине.