钩子文档

wp_get_object_terms_args

💡 云策文档标注

概述

wp_get_object_terms_args 是一个 WordPress 过滤器钩子,用于修改检索对象术语时的参数数组。它允许开发者在调用 wp_get_object_terms() 函数时自定义查询条件。

关键要点

  • 这是一个过滤器钩子,名称为 wp_get_object_terms_args。
  • 它接收三个参数:$args(参数数组)、$object_ids(对象ID数组)和 $taxonomies(分类法名称数组)。
  • 主要用于调整 wp_get_object_terms() 函数的行为,例如修改查询参数或添加自定义逻辑。
  • 在 WordPress 4.9.0 版本中引入。

代码示例

$args = apply_filters( 'wp_get_object_terms_args', $args, $object_ids, $taxonomies );

注意事项

使用此钩子时,需确保参数数组符合 wp_get_object_terms() 的要求,以避免查询错误。


📄 原文内容

Filters arguments for retrieving object terms.

Parameters

$argsarray
An array of arguments for retrieving terms for the given object(s).
See wp_get_object_terms() for details.
$object_idsint[]
Array of object IDs.
$taxonomiesstring[]
Array of taxonomy names to retrieve terms from.

Source

$args = apply_filters( 'wp_get_object_terms_args', $args, $object_ids, $taxonomies );

Changelog

Version Description
4.9.0 Introduced.