钩子文档

wp_sitemaps_taxonomies_query_args

💡 云策文档标注

概述

wp_sitemaps_taxonomies_query_args 是一个 WordPress 过滤器,用于修改在生成站点地图时查询分类法术语的 WP_Term_Query 参数。它允许开发者在查询前自定义参数,以控制哪些分类法术语被包含在站点地图中。

关键要点

  • 这是一个过滤器钩子,用于修改 WP_Term_Query 的参数数组。
  • 参数包括 $args(WP_Term_Query 参数数组)和 $taxonomy(分类法名称)。
  • 默认参数包括 taxonomy、orderby、number、hide_empty、hierarchical 和 update_term_meta_cache。
  • 与 WP_Sitemaps_Taxonomies::get_taxonomies_query_args() 方法相关,用于站点地图提供者。
  • 从 WordPress 5.5.0 版本开始引入。

代码示例

$args = apply_filters(
    'wp_sitemaps_taxonomies_query_args',
    array(
        'taxonomy'               => $taxonomy,
        'orderby'                => 'term_order',
        'number'                 => wp_sitemaps_get_max_urls( $this->object_type ),
        'hide_empty'             => true,
        'hierarchical'           => false,
        'update_term_meta_cache' => false,
    ),
    $taxonomy
);

📄 原文内容

Filters the taxonomy terms query arguments.

Description

Allows modification of the taxonomy query arguments before querying.

See also

Parameters

$argsarray
Array of WP_Term_Query arguments.
$taxonomystring
Taxonomy name.

Source

$args = apply_filters(
	'wp_sitemaps_taxonomies_query_args',
	array(
		'taxonomy'               => $taxonomy,
		'orderby'                => 'term_order',
		'number'                 => wp_sitemaps_get_max_urls( $this->object_type ),
		'hide_empty'             => true,
		'hierarchical'           => false,
		'update_term_meta_cache' => false,
	),
	$taxonomy
);

Changelog

Version Description
5.5.0 Introduced.