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 );