钩子文档

rest_delete_{$this->post_type}

💡 云策文档标注

概述

rest_delete_{$this->post_type} 是一个 WordPress REST API 钩子,在通过 REST API 删除或移至回收站单个文章类型时立即触发。钩子名称动态部分基于文章类型 slug。

关键要点

  • 钩子名称格式为 rest_delete_{$this->post_type},例如 rest_delete_post、rest_delete_page、rest_delete_attachment。
  • 触发时机:在通过 REST API 删除或移至回收站单个文章类型后立即执行。
  • 参数包括:$post(WP_Post 对象,表示被删除或移至回收站的文章)、$response(WP_REST_Response 对象,包含响应数据)、$request(WP_REST_Request 对象,表示 API 请求)。
  • 相关函数:WP_REST_Posts_Controller::delete_item() 用于删除单个文章。
  • 版本历史:自 WordPress 4.7.0 引入。

📄 原文内容

Fires immediately after a single post is deleted or trashed via the REST API.

Description

They dynamic portion of the hook name, $this->post_type, refers to the post type slug.

Possible hook names include:

  • rest_delete_post
  • rest_delete_page
  • rest_delete_attachment

Parameters

$postWP_Post
The deleted or trashed post.
$responseWP_REST_Response
The response data.
$requestWP_REST_Request
The request sent to the API.

Source

do_action( "rest_delete_{$this->post_type}", $post, $response, $request );

Changelog

Version Description
4.7.0 Introduced.