钩子文档

set_object_terms

💡 云策文档标注

概述

set_object_terms 是一个 WordPress 动作钩子,在对象的术语设置完成后触发,常用于处理术语关联的后续操作。

关键要点

  • 触发时机:在对象(如文章、页面)的术语(如分类、标签)通过 wp_set_object_terms() 设置后立即执行。
  • 参数说明:包括对象 ID、术语数组、术语分类 ID 数组、分类法 slug、是否追加术语标志和旧的术语分类 ID 数组。
  • 相关函数:与 wp_set_object_terms() 函数紧密关联,用于创建术语和分类法关系。
  • 版本历史:自 WordPress 2.8.0 版本引入。

📄 原文内容

Fires after an object’s terms have been set.

Parameters

$object_idint
Object ID.
$termsarray
An array of object term IDs or slugs.
$tt_idsarray
An array of term taxonomy IDs.
$taxonomystring
Taxonomy slug.
$appendbool
Whether to append new terms to the old terms.
$old_tt_idsarray
Old array of term taxonomy IDs.

Source

do_action( 'set_object_terms', $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids );

Changelog

Version Description
2.8.0 Introduced.