WordPress как на ладони
wordpress jino

wp_delete_post() WP 1.0.0

Удаляет запись (пост, вложение, страницу, произвольный тип) из базы данных.

При удалении записи, также удаляются все данные связанные с ней, это:

  • произвольные поля
  • комментарии
  • связь с разделами (таксономией)

Связь с wp_trash_post()

  • wp_delete_post() передает управление функции wp_trash_post(), если: параметр $force_delete = false И тип записи post или page И запись еще не в корзине И корзина не отключена (EMPTY_TRASH_DAYS).

  • Использует: событие (action) delete_post до удаления записи, не распространяется на тип записи attachment.

  • Использует: событие (action) deleted_post после того, как запись удалена, не распространяется на тип записи attachment.

  • Использует: wp_delete_attachment(), если тип записи attachment.
Хуки из функции:
Возвращает

Объект (WP_post)/false.

  • false при неудачной попытке удаления
  • объект wpdb при удачном удалении.

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

wp_delete_post( $postid, $force_delete );
$postid(число)
Идентификатор записи, поста.
$force_delete(логический)
Удалять мимо корзины, если она включена. true - принудительное удаление навсегда.
По умолчанию: false

Примеры

#1. Удалим пост по умолчанию "Hello World", ID которого равен 1:

$deleted = wp_delete_post(1);

print_r( $deleted );

/*
stdClass Object
(
	[ID]                    => 1
	[post_author]           => 0
	[post_date]             => 2016-08-08 17:07:49
	[post_date_gmt]         => 2016-08-08 12:07:49
	[post_content]          => 
	[post_title]            => Hello World
	[post_excerpt]          => 
	[post_status]           => publish
	[comment_status]        => closed
	[ping_status]           => closed
	[post_password]         => 
	[post_name]             => hello-world
	[to_ping]               => 
	[pinged]                => 
	[post_modified]         => 2016-08-08 17:07:49
	[post_modified_gmt]     => 2016-08-08 12:07:49
	[post_content_filtered] => 
	[post_parent]           => 0
	[guid]                  => http://wp-site.ru/hello-world
	[menu_order]            => 0
	[post_type]             => post
	[post_mime_type]        => 
	[comment_count]         => 0
	[filter]                => raw
)
*/

Код wp delete post: wp-includes/post.php WP 4.9

<?php
function wp_delete_post( $postid = 0, $force_delete = false ) {
	global $wpdb;

	$post = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM $wpdb->posts WHERE ID = %d", $postid ) );

	if ( ! $post ) {
		return $post;
	}

	$post = get_post( $post );

	if ( ! $force_delete && ( 'post' === $post->post_type || 'page' === $post->post_type ) && 'trash' !== get_post_status( $postid ) && EMPTY_TRASH_DAYS ) {
		return wp_trash_post( $postid );
	}

	if ( 'attachment' === $post->post_type ) {
		return wp_delete_attachment( $postid, $force_delete );
	}

	/**
	 * Filters whether a post deletion should take place.
	 *
	 * @since 4.4.0
	 *
	 * @param bool    $delete       Whether to go forward with deletion.
	 * @param WP_Post $post         Post object.
	 * @param bool    $force_delete Whether to bypass the trash.
	 */
	$check = apply_filters( 'pre_delete_post', null, $post, $force_delete );
	if ( null !== $check ) {
		return $check;
	}

	/**
	 * Fires before a post is deleted, at the start of wp_delete_post().
	 *
	 * @since 3.2.0
	 *
	 * @see wp_delete_post()
	 *
	 * @param int $postid Post ID.
	 */
	do_action( 'before_delete_post', $postid );

	delete_post_meta($postid,'_wp_trash_meta_status');
	delete_post_meta($postid,'_wp_trash_meta_time');

	wp_delete_object_term_relationships($postid, get_object_taxonomies($post->post_type));

	$parent_data = array( 'post_parent' => $post->post_parent );
	$parent_where = array( 'post_parent' => $postid );

	if ( is_post_type_hierarchical( $post->post_type ) ) {
		// Point children of this page to its parent, also clean the cache of affected children.
		$children_query = $wpdb->prepare( "SELECT * FROM $wpdb->posts WHERE post_parent = %d AND post_type = %s", $postid, $post->post_type );
		$children = $wpdb->get_results( $children_query );
		if ( $children ) {
			$wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => $post->post_type ) );
		}
	}

	// Do raw query. wp_get_post_revisions() is filtered.
	$revision_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'revision'", $postid ) );
	// Use wp_delete_post (via wp_delete_post_revision) again. Ensures any meta/misplaced data gets cleaned up.
	foreach ( $revision_ids as $revision_id )
		wp_delete_post_revision( $revision_id );

	// Point all attachments to this post up one level.
	$wpdb->update( $wpdb->posts, $parent_data, $parent_where + array( 'post_type' => 'attachment' ) );

	wp_defer_comment_counting( true );

	$comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $postid ));
	foreach ( $comment_ids as $comment_id ) {
		wp_delete_comment( $comment_id, true );
	}

	wp_defer_comment_counting( false );

	$post_meta_ids = $wpdb->get_col( $wpdb->prepare( "SELECT meta_id FROM $wpdb->postmeta WHERE post_id = %d ", $postid ));
	foreach ( $post_meta_ids as $mid )
		delete_metadata_by_mid( 'post', $mid );

	/**
	 * Fires immediately before a post is deleted from the database.
	 *
	 * @since 1.2.0
	 *
	 * @param int $postid Post ID.
	 */
	do_action( 'delete_post', $postid );
	$result = $wpdb->delete( $wpdb->posts, array( 'ID' => $postid ) );
	if ( ! $result ) {
		return false;
	}

	/**
	 * Fires immediately after a post is deleted from the database.
	 *
	 * @since 2.2.0
	 *
	 * @param int $postid Post ID.
	 */
	do_action( 'deleted_post', $postid );

	clean_post_cache( $post );

	if ( is_post_type_hierarchical( $post->post_type ) && $children ) {
		foreach ( $children as $child )
			clean_post_cache( $child );
	}

	wp_clear_scheduled_hook('publish_future_post', array( $postid ) );

	/**
	 * Fires after a post is deleted, at the conclusion of wp_delete_post().
	 *
	 * @since 3.2.0
	 *
	 * @see wp_delete_post()
	 *
	 * @param int $postid Post ID.
	 */
	do_action( 'after_delete_post', $postid );

	return $post;
}

Cвязанные функции

Из раздела: Вставка, удаление, обновл.

wp_delete_post 6 комментариев
  • Удаляет ли данная функция ревизии данного поста?

    Ответить3.2 года назад #
    • Kama4558

      Да, удаляет: в коде функции есть:

      // Do raw query. wp_get_post_revisions() is filtered
      	$revision_ids = $wpdb->get_col( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'revision'", $postid ) );
      	// Use wp_delete_post (via wp_delete_post_revision) again. Ensures any meta/misplaced data gets cleaned up.
      	foreach ( $revision_ids as $revision_id )
      		wp_delete_post_revision( $revision_id );

      Рекурсия на данную функцию, только для ревизий...

      2
      Ответить3.2 года назад #
  • Павел cайт: company21age.ru

    $postid - принимает массив?

    Ответить1.9 года назад #
  • Слава

    Намекните логику реализации) Если удалить пост, то wp ссылку на этот пост тоже удалит?
    Суть затеи вот в чем: когда автор заходит на свой пост, а он при этом удалён, его нужно известить сообщением "Твой пост удалён".

    Никак не получится если пост удалять?

    Если просто помещать пост в корзину, и в single проверять статус поста, если в корзине и если id автора совпал с id того кто зашел, то это действительно автор, и выдать ему месагу "Твой пост удалён". Если все иначе, то кто-то заблудился и вежливо сообщить "поста нет, иди другое читай"

    Так корзина со временем наполнится, хорошо это или плохо не знаю. Думаю много мусора никогда хорошо не бывает.

    Ответить1.6 года назад #
    • Я бы реализовал следующим образом :
      1) К постам добавить свой статус, к примеру: На удалении
      2) При удалении не перемещать в корзину, а присваивать статус
      3) Выдавать сообщение если id текущего юзера равен id юзера поста и статус равен "На удалении"
      4) Ну и при желании можно по крону каждый месяц очищать все записи со статусом "На удалении"
      Удачи в реализации smile

      3
      Ответить1.6 года назад #

Здравствуйте, !

Ваш комментарий