widget_categories_dropdown_args
云策文档标注
概述
widget_categories_dropdown_args 是一个 WordPress 过滤器钩子，用于修改 Categories 小部件下拉菜单的参数。它允许开发者在调用 wp_dropdown_categories() 函数前自定义参数数组。
关键要点
- 这是一个过滤器钩子，用于过滤 Categories 小部件下拉菜单的参数。
- 接受两个参数：$cat_args（参数数组）和 $instance（当前小部件设置数组）。
- 在 wp_dropdown_categories() 函数中通过 apply_filters 调用，用于自定义下拉菜单行为。
- 从 WordPress 2.8.0 版本引入，4.9.0 版本添加了 $instance 参数。
注意事项
- 确保在添加过滤器时正确处理 $cat_args 和 $instance 参数，以避免影响其他小部件或功能。
- 参考 wp_dropdown_categories() 函数文档以了解可用参数，确保自定义参数的有效性。
原文内容
Filters the arguments for the Categories widget drop-down.
Description
See also
Parameters
$cat_argsarray-
An array of Categories widget drop-down arguments.
$instancearray-
Array of settings for the current widget.
Source
wp_dropdown_categories( apply_filters( 'widget_categories_dropdown_args', $cat_args, $instance ) );