共计 853 个字符，预计需要花费 3 分钟才能阅读完成。
WordPress 函数 is_active_widget() 用于在小工具初始化之后检测指定的外观小工具（如搜索小工具）是否被启用（即被添加到侧边栏）。如果该小工具被启用了，则函数返回 true 或包含小工具的侧边栏ID。如果该小工具未启用，则返回 false 或侧边栏ID为空。需要注意的是，这个函数似乎只对旧版小工具有效，不支持区块小工具。
以下是 is_active_widget() 函数的代码和参数说明：
is_active_widget( callable|false $callback = false, string|false $widget_id = false, string|false $id_base = false, bool $skip_inactive = true )参数说明：
$callback（可选）：要检查的小工具回调。默认值为false。$widget_id（可选）：小工具的ID。需要进行检查。默认值为false。$id_base（可选）：通过扩展WP_Widget创建的小工具的基本ID。默认值为false。$skip_inactive（可选）：是否跳过 “wp_inactive_widgets”。默认值为true。
以下是示例代码，用于判断分类小工具是否启用：
<?php
if (is_active_widget(false, false, 'categories', true)) {
echo '分类小工具已启用';
} else {
echo '分类小工具未启用';
}
?>上述代码将检查是否有名为 “categories” 的小工具被启用。根据返回结果，它会输出相应的提示信息。
如果想获取分类小工具所在的侧边栏ID，可以使用如下代码：
print_r(is_active_widget(false, false, 'categories', true));通过输出结果，可以看到分类小工具所在的侧边栏ID。
该函数的源代码文件为 wp-includes/widgets.php。
请注意，该函数似乎只适用于旧版小工具，对于区块小工具可能无法正常工作。
正文完
