wordpress5.3主题开发第九课：小工具的使用

wordpress5.3版本自带主题twentytwenty有一个小工具，具体操作：外观 - 小工具

 左侧是系统自带的一些小工具，右侧是定义的侧边栏。我们可以把左边的一些小工具添加到侧边栏中，然后在模板中引入侧边栏即可。

如果是自己创建的主题，默认是没有“小工具”的。需要在functions.php添加如下代码：

//注册侧边栏
function mytheme_register_sidebar()
{
    register_sidebar(array(
        'name'          => 'sidebar-left',
		'id'            => "sidebar-1",
		'description'   => '左侧-侧边栏',
		'class'         => '',
		'before_widget' => '<li id="%1$s" class="widget %2$s">',
		'after_widget'  => "</li>\n",
		'before_title'  => '<h2 class="widgettitle">',
		'after_title'   => "</h2>\n",
    ));
}
add_action( 'widgets_init', 'mytheme_register_sidebar' );

参数

args

（字符串/数组）（可选）创建基于“name”和“id”的侧边栏。

默认值： None

• name - 侧边栏的名字（默认是 'Sidebar' 加 数字 ID）
• id - 侧边栏 ID，必须全部小写，不带空格（默认是一个自动递增的数字 ID）
• description - 用来说明侧边栏是什么，在哪里显示的文字。会在小工具管理界面显示。（默认为空）
• class - 分配到小工具 HTML输出 中的CSS选择器名字（默认为空）
• before_widget - 在每个小工具前面输出的 HTML代码（默认： '<li id="%1$s" class="widget %2$s">'）注：使用sprintf的变量替换
• after_widget - 在每个小工具后面输出的 HTML代码（默认： "</li>\n"）
• before_title - 在标题前输出的 HTML代码（默认： <h2 class="widgettitle">）
• after_title - 在标题后输出的 HTML代码 （默认："</h2>\n"）

 

 创建成功后，自己定义的主题会出现小工具 ，点开【小工具】，有一个叫sidebar-left的侧边栏

你可以调整侧边栏中的小工具的数量

下面介绍如何在模板中使用侧边栏

在模板的任何部位可以编写如下代码

<?php
if(is_active_sidebar('leftbar-1')){
    dynamic_sidebar('leftbar-1');
}

上面的代码可以写到sidebar.php文件，然后再使用 get_sidebar(); 加载sidebar.php文件