WordPress侧边栏（sidebar）的使用

Posted 2021-02-04 zhaoweidong

相关内容分为两个部分：

• 小工具（widgets）的制作
• 侧边栏的使用

这里主要是说明侧边栏的使用，小工具（widgets）的制作见《WordPress小工具（widget）制作》

 

 注册小工具区域

register_sidebar(
　　array(
　　　　‘name‘ => __( ‘Footer‘, ‘twentynineteen‘ ),
　　　　‘id‘ => ‘sidebar-1‘,
　　　　‘description‘ => __( ‘Add widgets here to appear in your footer.‘, ‘twentynineteen‘ ),
　　　　‘before_widget‘ => ‘<section id="%1$s" class="widget %2$s">‘,
　　　　‘after_widget‘ => ‘</section>‘,
　　　　‘before_title‘ => ‘<h2 class="widget-title">‘,
　　　　‘after_title‘ => ‘</h2>‘,
　　)
);

备注：案例来自二〇一九（2019）主题

 

部分样式通过register_sidebar()设置，剩下样式通过模板文件设置。

判断

is_active_sidebar(‘sidebar-1‘ ) 

 

显示：

相关函数

dynamic_sidebar( ‘sidebar-1‘ )

<?php
if ( is_active_sidebar( ‘sidebar-1‘ ) ) {
?>
    <div class="widget-column footer-widget-1">
    <?php dynamic_sidebar( ‘sidebar-1‘ ); ?>
    </div>
<?php
    }
?>

备注：案例来自二〇一九（2019）主题

说明：“sidebar-1”是在主题文件中通过注册侧边栏：register_sidebar()定义的小工具区域（widgets area），通过is_active_sidebar()函数判断是否激活（后台激活）。

 

3、构建模板文件sidebar.php（或sidebar-xxx.php）及使用

除了把相关代码直接放到相关模板文件中，也可以构建模板文件sidebar.php，在需要使用的模板文件中调用sidebar.php。

<?php get_sidebar(); ?>
或

<?php get_sidebar(‘xxx’); ?>

激活（配置小工具和侧边栏的关系）

1）后台设置

2）通过主题程序配置

以上在构建侧边栏时，要为生成搜索框新建一个 searchform.php 文件，其内容如下：
代码从第三行开始，分别通过包含 searchform.php 显示搜索表单；
调用 get_calendar() 函数显示日历；
调用 wp_list_pages() 函数显示页面导航；
调用 wp_list_cats() 函数显示分类导航；
调用 wp_get_archives() 函数显示存档导航；
调用 get_links() 函数显示链接导航。

get_search_form()
wp_list_categories( ‘title_li‘ )
wp_get_archives( ‘type=monthly‘ )

widget_title()
wp_get_archives

 

 

 

模板文件
小工具制作（另外）

相关函数

注册侧边栏：register_sidebar()

https://developer.wordpress.org/reference/functions/register_sidebar/