側欄是主題的任何窗口小部件區域。小部件區域是主題中用戶可以添加自己的小部件的位置。您不需要在主題中包含側邊欄，但是包含側邊欄意味著用戶可以通過“定制程序”或“微件管理面板”將內容添加到微件區域。
小工具可用于多種目的，從列出最近的帖子到進行實時聊天。
- 官方文檔：wordpress
快速開始：
在functions.php中添加以下代碼：
function lifet_widgets_init() {
register_sidebar( array(
'name' => esc_html__( '小工具', 'lifet' ),
'id' => 'sidebar-1',
'description' => esc_html__( '添加小工具到這里', 'lifet' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'lifet_widgets_init' );在需要調用的地方添加以下代碼：
<?php dynamic_sidebar( 'sidebar-1' ); ?>自定義側邊欄：
添加下列代碼到functions.php 文件中第一個<?php 之后:
function xitou_widgets_init2() {
register_sidebar( array(
'name' => esc_html__( 'Sidebar-single', 'xitou' ),
'id' => 'sidebar-2',
'description' => esc_html__( ' Sidebar of single', 'xitou' ),
'before_widget' => '<section id="%1$s" class="widget %2$s">',
'after_widget' => '</section>',
'before_title' => '<h2 class="widget-title">',
'after_title' => '</h2>',
) );
}
add_action( 'widgets_init', 'xitou_widgets_init2' );在主題的根目錄創建文件夾sidebar，在sidebar 文件夾內創建名為：sidebar-single.php 文件，填入下列代碼：
<?php
/**
*
* Single頁的工具欄
*
* @link https://developer.wordpress.org/themes/basics/template-files/#template-partials
*
* https://developer.wordpress.org/themes/functionality/sidebars/
*
* @package xitou
*/
if ( ! is_active_sidebar( 'sidebar-2' ) ) {
return;
}
?>
<aside id="secondary" class="widget-area">
<?php dynamic_sidebar( 'sidebar-2' ); ?>
</aside><!-- #secondary -->
在single.php 中相應位置添加下列代碼調用：
<?php dynamic_sidebar( 'sidebar/single' );?>官方文檔：
- 添加側邊欄：官方文檔
小部件可用于多種目的，從列出最近的帖子到進行實時聊天。
注冊側邊欄
要使用側邊欄，您必須在中注冊它們functions.php。
首先，register_sidebar()?有幾個應始終定義的參數，無論它們是否被標記為可選參數。這些包括x，y和z。
- 名稱?-側邊欄的名稱。這是用戶將在“窗口小部件”面板中看到的名稱。
- id?–必須為小寫。您將使用
dynamic_sidebar函數在主題中調用它。 - description-邊欄的描述。這也將顯示在管理窗口小部件面板中。
- class?–分配給小部件的HTML的CSS類名稱。
- before_widget?–每個小部件之前放置的HTML。
- after_widget?–放置在每個小部件之后的HTML。應該用來關閉中的標簽
before_widget。 - before_title?–放在每個小部件標題之前的HTML，例如標頭標記。
- after_title?–每個標題之后的HTML。應該用來關閉中的標簽
before_title。
要注冊側邊欄，我們使用register_sidebar和widgets_init函數。
function themename_widgets_init() {
register_sidebar( array(
'name' => __( 'Primary Sidebar', 'theme_name' ),
'id' => 'sidebar-1',
'before_widget' => '<aside id="%1$s" class="widget %2$s">',
'after_widget' => '</aside>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
) );
register_sidebar( array(
'name' => __( 'Secondary Sidebar', 'theme_name' ),
'id' => 'sidebar-2',
'before_widget' => '<ul><li id="%1$s" class="widget %2$s">',
'after_widget' => '</li></ul>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
) );
}注冊側邊欄告訴WordPress，您正在“?外觀”>“窗口小部件”中創建一個新的窗口小部件區域，用戶可以將其窗口小部件拖動到其中。有兩個注冊邊欄的功能：
第一個讓您注冊一個側邊欄，第二個讓您注冊多個側邊欄。
建議您單獨注冊側邊欄，因為它可以為每個側邊欄賦予唯一的描述性名稱。
范例
對于頁眉和頁腳中的窗口小部件區域，將它們命名為“ Header Widget Area”和“ Footer Widget Area”，而不是“ Sidebar 1”和“ Sidebar 2”（默認設置）。這提供了有關側邊欄位置的有用描述。
添加了以下代碼以functions.php注冊邊欄：
add_action( 'widgets_init', 'my_register_sidebars' );
function my_register_sidebars() {
/* Register the 'primary' sidebar. */
register_sidebar(
array(
'id' => 'primary',
'name' => __( 'Primary Sidebar' ),
'description' => __( 'A short description of the sidebar.' ),
'before_widget' => '<div id="%1$s" class="widget %2$s">',
'after_widget' => '</div>',
'before_title' => '<h3 class="widget-title">',
'after_title' => '</h3>',
)
);
/* Repeat register_sidebar() code for additional sidebars. */
}該代碼執行以下操作：
register_sidebar?–告訴WordPress您正在注冊邊欄'name' => __( 'Primary Widget Area', 'mytheme' ),?–是在“外觀”>“小部件”中顯示的小部件區域的名稱'id' => 'sidebar-1'–為邊欄分配一個ID。WordPress使用“ id”將小部件分配給特定的側邊欄。before_widget/?after_widget–分配給邊欄的小部件的包裝器元素。應該始終分別保留“％1 $ s”和“％2 $ s”?id，class以便插件可以使用它們。默認情況下，WordPress將這些設置為列表項，但在以上示例中，它們已更改為div。before_title/?after_title–小部件標題的包裝元素。默認情況下，WordPress將其設置為h2，但使用h3使其更具語義。
一旦注冊了側邊欄，便可以在主題中顯示它。
在主題中顯示側邊欄
現在您的側邊欄已注冊，您將想要在主題中顯示它們。為此，有兩個步驟：
- 創建??
sidebar.php?模板文件并使用dynamic_sidebar功能顯示側邊欄 - 使用
get_sidebar功能加載主題
創建側邊欄模板文件
側欄模板包含側欄的代碼。WordPress可以識別名稱為的文件 ??sidebar.php? 和任何模板文件sidebar-{name}.php。這意味著您可以使用每個側邊欄將其組織在自己的模板文件中。
示例：
1.建立?sidebar-primary.php
2.添加以下代碼：
<div id="sidebar-primary" class="sidebar">
<?php dynamic_sidebar( 'primary' ); ?>
</div>請注意，它dynamic_sidebar采用的單個參數$index，該參數可以是邊欄的名稱或ID。
加載側邊欄
要將側欄加載到主題中，請使用??get_sidebar函數。應該將其插入到要顯示邊欄的模板文件中。要加載默認值，請sidebar.php使用以下命令：
<?php get_sidebar(); ?>要顯示主要側邊欄，請將$name參數傳遞給函數：
<?php get_sidebar( 'primary' ); ?>顯示默認邊欄內容
如果用戶尚未向側邊欄添加任何小部件，則可能希望顯示內容。為此，您可以使用該is_sidebar_active()功能檢查邊欄是否有任何小部件。這接受$index參數，該參數應該是您要檢查的側邊欄的ID。
此代碼檢查側邊欄是否處于活動狀態，如果未激活，則顯示一些內容：
<div id="sidebar-primary" class="sidebar">
<?php if ( is_active_sidebar( 'primary' ) ) : ?>
<?php dynamic_sidebar( 'primary' ); ?>
<?php else : ?>
<!-- Time to add some widgets! -->
<?php endif; ?>
</div>顯示默認小部件
您可能希望默認情況下在側邊欄中填充一些小部件。例如，顯示搜索，存檔和元窗口小部件。為此，您可以使用：
</p>
<div id="primary" class="sidebar">
<?php do_action( 'before_sidebar' ); ?>
<?php if ( ! dynamic_sidebar( 'sidebar-primary' ) ) : ?>
<aside id="search" class="widget widget_search">
<?php get_search_form(); ?>
</aside>
<aside id="archives" class"widget">
<h3 class="widget-title"><?php _e( 'Archives', 'shape' ); ?></h3>
<ul>
<?php wp_get_archives( array( 'type' => 'monthly' ) ); ?>
</ul>
</aside>
<aside id="meta" class="widget">
<h3 class="widget-title"><?php _e( 'Meta', 'shape' ); ?></h3>
<ul>
<?php wp_register(); ?>
<li><?php wp_loginout(); ?></li>
<?php wp_meta(); ?>
</ul>
</aside>
<?php endif; ?>
</div>