钩子文档

get_terms_defaults

💡 云策文档标注

概述

get_terms_defaults 是一个 WordPress 过滤器钩子,用于修改 get_terms() 函数的默认查询参数。它允许开发者在执行术语查询前自定义默认设置。

关键要点

  • 这是一个过滤器钩子,用于过滤 get_terms() 的默认参数数组。
  • 参数包括 $defaults(默认参数数组)和 $taxonomies(分类法名称数组)。
  • 建议使用 get_terms_args 过滤器来过滤传递的参数。
  • 相关函数:WP_Term_Query::parse_query() 用于解析查询参数。
  • 引入版本:WordPress 4.4.0。

📄 原文内容

Filters the terms query default arguments.

Description

Use ‘get_terms_args’ to filter the passed arguments.

Parameters

$defaultsarray
An array of default get_terms() arguments.

More Arguments from get_terms( … $args )

Array or string of arguments. See WP_Term_Query::__construct() for information on accepted arguments.

$taxonomiesstring[]
An array of taxonomy names.

Source

$this->query_var_defaults = apply_filters( 'get_terms_defaults', $this->query_var_defaults, $taxonomies );

Changelog

Version Description
4.4.0 Introduced.