get_bloginfo() の使い方|説明・引数・注意点

説明

get_bloginfo() は、サイトの情報(名前、説明、URL、バージョンなど)を取得する関数です。

基本構文

get_bloginfo( string $show = '', string $filter = 'raw' ): string

引数

  • $show:項目名(name、description、url、charset、language など)
  • $filter:フィルターの種類

戻り値

項目の値。

使い方(サンプル)

echo esc_html( get_bloginfo( 'name' ) );

注意点

  • 出力する場合は、esc_html() などでエスケープします。
  • サイトのURLは home_url() を使うほうが推奨です。

実務での使いどころ

  • サイト名、キャッチフレーズ、文字コード、言語などの、サイトの基本情報を、取得するとき。

よくあるミスと対処

  • echo し忘れる。この関数は、値を返す。出力する関数は、bloginfo()。
  • 出力時に、エスケープしていない。
  • URLの取得に、使っている。URLは、home_url() などの、専用の関数を使う。

NG例

get_bloginfo( 'name' ); // 返すだけで、出力されない

OK例

echo esc_html( get_bloginfo( 'name' ) );

使い分け早見表

関数 役割
get_bloginfo() サイトの情報を、値として返す
bloginfo() サイトの情報を、出力する
home_url() サイトのトップページのURLを、取得する

関連項目

bloginfo()、home_url()

公式リファレンス:get_bloginfo() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました