bloginfo() は、WordPress サイトの基本情報(サイト名、URL、バージョン情報など)をテンプレート内で出力するためのテンプレートタグです。
引数に応じてさまざまな情報を取得でき、HTML出力も伴うため、テーマの header.php や footer.php などで頻繁に使用されます。
目次
機能の説明
どんなテンプレートタグか?
- サイトに関する情報(例:サイト名・URL・説明・言語など)を取得・表示する関数。
- 引数によって返す情報の種類が変化。
echoで直接出力される関数です(出力ではなく値を取得したい場合はget_bloginfo()を使用)。
どういう時に使うか?
- ヘッダー・フッターでサイト情報を出力する際。
- RSSフィードや
<meta>情報の埋め込みに活用。 - WordPress のバージョンを表示する場合など。
シンプルなコード例
<!DOCTYPE html>
<html lang="<?php bloginfo( 'language' ); ?>">
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php bloginfo( 'name' ); ?></title>
<meta name="description" content="<?php bloginfo( 'description' ); ?>">
</head>使い方の説明
bloginfo( string $show );主な引数一覧($show)
| 引数 | 内容 |
|---|---|
'name' | サイトのタイトル |
'description' | キャッチフレーズ(一般設定で設定可能) |
'wpurl' | WordPress のインストール URL |
'url' | サイトの URL(ホーム URL) |
'admin_email' | 管理者メールアドレス |
'charset' | サイトの文字コード(通常は UTF-8) |
'language' | サイトの言語(例:ja) |
'version' | WordPress のバージョン番号 |
'stylesheet_url' | 使用中テーマの style.css の URL |
'template_url' | テーマディレクトリの URL(親テーマ) |
'pingback_url' | ピンバック URL |
'atom_url', 'rss2_url' | フィード URL |
一緒に使うことが多い関連タグ
get_bloginfo()
値だけを取得したい場合に使用(出力されない):
$charset = get_bloginfo( 'charset' );home_url(), site_url()
WordPress のルートURLを取得:
echo home_url();
echo site_url();get_template_directory_uri(), get_stylesheet_directory_uri()
テーマフォルダのURL取得に便利:
<link rel="stylesheet" href="<?php echo get_stylesheet_directory_uri(); ?>/style.css">追加情報で取得したい場合
get_bloginfo() を使うことで、取得した値を変数に格納可能:
$site_title = get_bloginfo( 'name' );
$site_desc = get_bloginfo( 'description' );このテンプレートタグを利用してのカスタマイズ
カスタムHTMLヘッダー作成例
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<title><?php bloginfo( 'name' ); ?> | <?php bloginfo( 'description' ); ?></title>
</head>WordPress バージョンをフッターに表示
<footer>
Powered by WordPress <?php bloginfo( 'version' ); ?>
</footer>想定されるトラブル
意図せず HTML 出力される
bloginfo() は echo されるため、値だけ欲しい場合は get_bloginfo() を使用しましょう。
解決方法
// echoされてしまう例
$site_name = bloginfo( 'name' ); // 期待した値は入らない
// 値を取得する正しい方法
$site_name = get_bloginfo( 'name' );Q&A
まとめ
bloginfo()はサイトに関する基本情報をテンプレート内で出力する関数。- 取得できる内容は多岐にわたり、主に
<head>や<footer>で利用される。 - 値だけ取得したい場合は
get_bloginfo()を使うのがベスト。
コメント