get_sidebar

説明

void | false get_sidebar( [ string $name = null [ , array $args = array() ] ] )
サイドバーパーツを記述したメインサイドバーファイルsidebar.php(またはサブサイドバーファイルsidebar-???.php)を読み込む。

パラメータ

  • $name
    [2.8.0]サブサイドバーファイルの識別名を指定(省略時はnull)。
  • $args
    [5.5.0]サイドバーファイルに引き継ぐパラメータを指定(省略時はarray())。

返り値

戻り値はありません。

[5.5.0]フッターファイルが見つからなかった場合はfalseを返す。


注意

パラメータ$nameが指定された場合でも、対応するサブサイドバーファイルが存在しない場合は、sidebar.phpを読み込む。

[5.5.0]パラメータ$argsが追加され、サイドバーファイルが見つからなかった場合のみfalseを返すように変更された。


使用例

  • sidebar.phpを読み込む。
    <?php get_sidebar(); ?>
  • sidebar-right.phpを読み込む。
    <?php get_sidebar('right'); ?>

フィルター

直接実行するフィルターはありません。

アクション

[2.2.0]はじめに'get_sidebar'アクションを呼び出す。[2.8.0]パラメータ$nameが追加され、本関数が受け取った内容が格納されている。[5.5.0]パラメータ$argsが追加され、本関数が受け取った内容が格納されている。
do_action( 'get_sidebar', $name, $args );

ソースファイル

/wp-includes/general-template.php

最終更新 : 2020年08月18日 11:19



お勧め

CSSやJavaScriptファイルのバージョン番号を変える(2018年5月27日 更新)

WordPress 4.7系の脆弱性をついた攻撃も落ち着いた感じなので、標準でヘッダーやフッター内に出力されるWordPressのバージョン番号について一考しました。

テーブルブロックを投稿メタ(カスタムフィールド)に保存する(2022年1月5日 更新)

ふと「テーブルブロックの内容を投稿メタ(カスタムフィールド)として保存できたら便利なのでは」と思い、投稿メタの使い方を調べてみた。

カスタム投稿タイプの投稿保存には専用アクションを使おう(2014年7月4日 更新)

カスタム投稿タイプを登録して、専用ウィジェット(meta_box)を使って拡張情報を入力させ、それらの情報をsave_postアクションで保存する。これまではこんな感じだったのだが、久しぶりにカスタム投稿タイプを使ったら、save_postアクションの前にsave_postに投稿タイプ名がくっついたアクションが追加されていた。

Fotepo:プラグイン作ってみました(2019年9月19日 更新)

仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。

5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)

この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。