钩子文档

rest_delete_{$this->taxonomy}

💡 云策文档标注

概述

rest_delete_{$this->taxonomy} 是一个 WordPress REST API 钩子,在通过 REST API 删除单个分类法术语后触发。钩子名称的动态部分基于分类法 slug,允许针对特定分类法进行定制。

关键要点

  • 钩子名称格式为 rest_delete_{$this->taxonomy},其中 $this->taxonomy 是分类法 slug,例如 rest_delete_category 或 rest_delete_post_tag。
  • 触发时机:在通过 REST API 成功删除单个术语后执行。
  • 参数包括:$term(已删除的 WP_Term 对象)、$response(WP_REST_Response 响应数据)和 $request(WP_REST_Request API 请求)。
  • 相关函数:WP_REST_Menus_Controller::delete_item() 和 WP_REST_Terms_Controller::delete_item() 使用此钩子来删除分类法中的术语。
  • 版本历史:自 WordPress 4.7.0 版本引入。

📄 原文内容

Fires after a single term is deleted via the REST API.

Description

The dynamic portion of the hook name, $this->taxonomy, refers to the taxonomy slug.

Possible hook names include:

  • rest_delete_category
  • rest_delete_post_tag

Parameters

$termWP_Term
The deleted term.
$responseWP_REST_Response
The response data.
$requestWP_REST_Request
The request sent to the API.

Source

do_action( "rest_delete_{$this->taxonomy}", $term, $response, $request );

Changelog

Version Description
4.7.0 Introduced.