钩子文档

deleted_term_relationships

💡 云策文档标注

概述

deleted_term_relationships 是一个 WordPress 动作钩子,在对象与术语的关系被删除后立即触发。它主要用于处理对象 ID、术语分类 ID 数组和分类法 slug 等参数。

关键要点

  • 这是一个动作钩子,用于在对象-术语关系删除后执行自定义代码。
  • 参数包括 $object_id(对象 ID)、$tt_ids(术语分类 ID 数组)和 $taxonomy(分类法 slug)。
  • 在 WordPress 4.7.0 版本中添加了 $taxonomy 参数,最初在 2.9.0 版本引入。
  • 与 wp_remove_object_terms() 函数相关,用于移除与对象关联的术语。

代码示例

do_action( 'deleted_term_relationships', $object_id, $tt_ids, $taxonomy );

注意事项

  • 确保在开发插件或主题时正确使用此钩子,以避免影响其他功能。
  • 注意参数类型:$object_id 为整数,$tt_ids 为数组,$taxonomy 为字符串。

📄 原文内容

Fires immediately after an object-term relationship is deleted.

Parameters

$object_idint
Object ID.
$tt_idsarray
An array of term taxonomy IDs.
$taxonomystring
Taxonomy slug.

Source

do_action( 'deleted_term_relationships', $object_id, $tt_ids, $taxonomy );

Changelog

Version Description
4.7.0 Added the $taxonomy parameter.
2.9.0 Introduced.