WEB制作のための情報サイト / unazuki Library
ウィジェットを配置するためのエリアを登録します。
register_sidebar($args);| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第１引数 $args | 任意 | 登録されるウィジェットに関する情報を文字列あるいはその配列で指定。主なパラメーターは下記の通りです。 name 管理画面に表示するウィジェットの名前（文字列）id ウィジェットID（文字列）、ウィジェットを呼び出すときに必要description ウィジェットの説明文（文字列）before_sidebar サイドバー（ウィジェット全体）の前に追加するHTMLafter_sidebar サイドバー（ウィジェット全体）の後に追加するHTMLbefore_widget ウィジェット（個別のパーツ）の前に追加するHTMLafter_widget ウィジェット（個別のパーツ）の後に追加するHTML各パラメーターの詳細はこちら（英文） https://developer.wordpress.org/reference/functions/register_sidebar/ 初期値： []（空の配列） |
ウィジェットを配置するためのエリアを登録します。
管理画面の「外観」→「ウィジェット」から登録したエリアにウィジェットを登録できます。
function my_theme_register_sidebar() {
register_sidebar([
'name' => 'メインサイドバー',
'id' => 'sidebar-main',
'description' => '記事ページ右側に表示されるメインサイドバーです。',
'before_sidebar' => '<aside id="sidebar-main" class="sidebar-wrapper">',
'after_sidebar' => '</aside>',
'before_widget' => '<div id="%1$s" class="widge %2$s">',
'after_widget' => '</div>',
]);
}
add_action('widgets_init', 'my_theme_register_sidebar');8行目のbefore_widgetにおいて、%1$s はidを、%2$sはclassを自動生成します。
このコードのウィジェットをテンプレートファイルで呼び出すためには、dynamic_sidebar()を使います。
【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。
