钩子文档

get_tags

💡 云策文档标注

概述

本文档介绍了 WordPress 中的 'get_tags' 过滤器,用于过滤 'post_tag' 分类法返回的术语对象数组。开发者可以通过此 Hook 修改或处理标签数据。

关键要点

  • 'get_tags' 过滤器应用于 'post_tag' 分类法的术语对象数组。
  • 参数包括 $tags(WP_Term 数组、整数计数或 WP_Error)和 $args(参数数组,参考 get_terms())。
  • 源代码示例展示了如何使用 apply_filters 调用此过滤器。

代码示例

$tags = apply_filters( 'get_tags', $tags, $args );

注意事项

此过滤器自 WordPress 2.3.0 版本引入,相关函数 get_tags() 用于检索所有文章标签。


📄 原文内容

Filters the array of term objects returned for the ‘post_tag’ taxonomy.

Parameters

$tagsWP_Term[]|int|WP_Error
Array of 'post_tag' term objects, a count thereof, or WP_Error if any of the taxonomies do not exist.
$argsarray
An array of arguments. See get_terms().

Source

$tags = apply_filters( 'get_tags', $tags, $args );

Changelog

Version Description
2.3.0 Introduced.