WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Справочник по функциям/wp delete post

Описание

Функция удаляет запись, вложение или страницу.

Когда запись и страница удаляется, то все что связанно с ними удаляется тоже.Сюда включаются комментарии, дополнительные поля записи и условия связанные с этой записью.

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

<?php wp_delete_post$postid$force_delete ); ?>

Параметры

$postid
(integer) (optional) ID записи.
Default: 0
$force_delete
(bool) (optional) Обходит корзину и принудительно удаляет (добавлено в Wordpress 2.9).
Default: false

Возвращаемые значения

(mixed) 
False on failure and a random wpdb object on success.

Примеры

Удаление Записи

Удаление записи, имеющейся по умолчанию "Привет Мир" с ID равным '1'.

 <?php wp_delete_post(1); ?> 

Примечание

  • wp_delete_post() автоматически возвращается к wp_trash_post() если параметр $force_delete равен false, post_type параметра $postid является страницей или записью, $postid не находится уже в корзине и если функция корзины разрешена (которая есть по умолчанию).
  • Используется: do_action() в 'delete_post' перед удалением, если тип записи 'вложение'.
  • Используется: do_action() в 'deleted_post' после удаления, если тип записи вложение.
  • Используется: wp_delete_attachment() если тип записи вложение.
  • Используется глобальная переменная $wpdb: (object) wpdb
  • Используется глобальная переменная $wp_rewrite: (object) WP_Rewrite

История изменений

С версии: 1.0.0

Исходный файл

Функция wp_delete_post() располагается в wp-includes/post.php.

Схожее

Post, Page, Attachment and Bookmarks Functions: wp_trash_post(), wp_update_post(), wp_delete_attachment(), wp_insert_attachment(), wp_insert_post()

См. также содержание справочника по функциям и список тегов шаблонов.