钩子文档

add_term_relationship

💡 云策文档标注

概述

add_term_relationship 是一个 WordPress 动作钩子,在对象与术语关系建立前立即触发。它允许开发者在关系添加前执行自定义代码,常用于数据验证或日志记录。

关键要点

  • 触发时机:在对象与术语关系添加前立即执行。
  • 参数:$object_id(对象ID)、$tt_id(术语分类法ID)、$taxonomy(分类法slug)。
  • 相关函数:与 wp_set_object_terms() 函数关联,用于创建术语和分类法关系。
  • 版本历史:从 2.9.0 版本引入,4.7.0 版本添加了 $taxonomy 参数。

代码示例

do_action( 'add_term_relationship', $object_id, $tt_id, $taxonomy );

注意事项

  • 此钩子仅用于动作,不返回值,开发者应避免在此处修改关系数据。
  • 参数 $taxonomy 在 4.7.0 版本后可用,确保代码兼容性。

📄 原文内容

Fires immediately before an object-term relationship is added.

Parameters

$object_idint
Object ID.
$tt_idint
Term taxonomy ID.
$taxonomystring
Taxonomy slug.

Source

do_action( 'add_term_relationship', $object_id, $tt_id, $taxonomy );

Changelog

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