要在 WordPress 中添加一个自定义的小工具区域(也就是侧边栏),你需要通过主题的 functions.php 文件注册一个新的侧边栏。完成后,你就可以在后台“外观 > 小工具”中使用它了。
1. 注册自定义小工具区域
打开你当前主题目录下的 functions.php 文件,在文件末尾添加以下代码:
function my_custom_sidebar() {
register_sidebar( array(
'name' => __( '自定义侧边栏', 'textdomain' ),
'id' => 'custom-sidebar',
'description' => __( '这是一个自定义的小工具区域。', 'textdomain' ),
'before_widget' => '',
'after_widget' => '',
'before_title' => '',
'after_title' => '',
) );
}
add_action( 'widgets_init', 'my_custom_sidebar' );
name:在后台显示的名称。
id:唯一标识符,必须是小写字母、短横线组成,不能重复。
description:可选,帮助用户理解这个区域用途。
before_widget / after_widget:包裹每个小工具的 HTML 结构。
before_title / after_title:标题前后包裹的标签。
2. 在模板中调用小工具区域
注册完成后,需要在主题的某个模板文件中(如 sidebar.php、footer.php 或自定义页面模板)插入以下代码来显示这个区域:
<?php if ( is_active_sidebar( ‘custom-sidebar’ ) ) : ?>
<aside id=”custom-sidebar-area” class=”widget-area”>
<?php dynamic_sidebar( ‘custom-sidebar’ ); ?>
</aside>
<?php endif; ?>
这段代码会判断该区域是否有启用的小工具,如果有,就输出内容。
3. 注意事项
确保 id 唯一,避免与其他侧边栏冲突。
如果你使用的是子主题,应将代码加在子主题的 functions.php 中。
修改后刷新后台的“小工具”页面,就能看到新区域了。
可以注册多个区域,只需再调用一次 register_sidebar() 并设置不同 ID 和名称。
基本上就这些。添加后你就可以拖动小工具进去,并在前端看到效果了。
