get_bloginfo()

get_bloginfo()
目次

get_bloginfo()の用途

get_bloginfo() は、WordPress サイトの情報を「取得して返す」ためのテンプレートタグ関数です。
bloginfo() が情報を画面に 直接出力する のに対して、get_bloginfo() は 値として返すだけ なので、後で使ったり加工したりする用途に適しています。

get_bloginfo()の使用方法

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

get_bloginfo()のパラメータ

引数説明
$showstring取得したい情報の種類(例:'name', 'description' など)
$filterstring返す文字列にフィルターをかけるかどうか(通常は 'raw' でOK)

get_bloginfo()の主な $show の値と内容

$show内容
'name'サイトの名前例:My Blog
'description'キャッチフレーズ例:Just another WordPress site
'wpurl'WordPress アドレス例:https://example.com/wp
'url' または 'home'サイトアドレス例:https://example.com
'admin_email'管理者メールアドレス例:admin@example.com
'charset'サイトの文字コード例:UTF-8
'language'サイトの言語コード例:ja
'version'WordPress のバージョン例:6.5.3
'stylesheet_url'使用中のテーマの style.css のURL例:https://example.com/wp-content/themes/mytheme/style.css
'template_url'使用中のテーマフォルダのURL例:https://example.com/wp-content/themes/mytheme
'pingback_url'ピンバック用のURL
'atom_url'Atom フィードのURL
'rss2_url'RSS 2.0 フィードのURL

get_bloginfo()の使用例

取得して変数に格納する

<?php
$site_name = get_bloginfo('name');
echo '<h1>' . esc_html($site_name) . '</h1>';
?>

スタイルシートURLをリンクタグで使う

<link rel="stylesheet" href="<?php echo esc_url( get_bloginfo('stylesheet_url') ); ?>">

WordPressバージョンを取得して表示

<p>現在のWPバージョンは <?php echo get_bloginfo('version'); ?> です。</p>

get_bloginfo()bloginfo() の違い

比較項目bloginfo()get_bloginfo()
動作情報を出力(echo)情報を返す(return)
用途HTML に直接表示したいとき値を使って加工・条件分岐などしたいとき
<?php bloginfo('name'); ?><?php echo get_bloginfo('name'); ?>

get_bloginfo()のよく使う組み合わせ

  • esc_url( get_bloginfo('template_url') )
    → テーマフォルダのパスを取得して安全にURLとして使う
  • esc_html( get_bloginfo('description') )
    → サイトのキャッチフレーズをHTMLに出力する際のサニタイズ処理

get_bloginfo()の注意点

  • 'url' は古い呼び方で、現在は 'home' がより推奨されます。
  • $filter'display' を指定すると、wptexturize()convert_chars() などが適用されますが、通常は 'raw' のままで問題ありません。

get_bloginfo()のまとめ

特徴説明
主な用途サイト情報の取得(出力はしない)
利点加工・組み合わせ・条件処理に便利
注意点安全な出力には esc_html()esc_url() と併用すること

<head>内でのget_bloginfo()の活用例

基本的な <head> テンプレート例(functions.php など不要)

<head>
  <meta charset="<?php bloginfo('charset'); ?>">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title><?php wp_title('|', true, 'right'); ?><?php bloginfo('name'); ?></title>
  <meta name="description" content="<?php bloginfo('description'); ?>">

  <!-- WordPressのバージョンをメタ情報として表示(任意) -->
  <meta name="generator" content="WordPress <?php echo get_bloginfo('version'); ?>">

  <!-- スタイルシートの読み込み -->
  <link rel="stylesheet" href="<?php echo esc_url( get_bloginfo('stylesheet_url') ); ?>">

  <!-- RSS フィードリンク -->
  <link rel="alternate" type="application/rss+xml" title="<?php bloginfo('name'); ?> RSS2 Feed" href="<?php echo esc_url( get_bloginfo('rss2_url') ); ?>">

  <!-- ピンバックURL(古いブログ機能で使用) -->
  <link rel="pingback" href="<?php echo esc_url( get_bloginfo('pingback_url') ); ?>">

  <?php wp_head(); ?>
</head>

get_bloginfo()の補足と解説

説明
<meta charset="...">サイトの文字コードを設定。UTF-8 が一般的です。
<meta name="viewport">スマホなどのレスポンシブ対応。
<title>wp_title()bloginfo('name') を組み合わせたタイトル出力。SEO対応。
<meta name="description">サイトのキャッチフレーズをメタディスクリプションとして使用。
<meta name="generator">WordPressバージョンを明記。省略可。
<link rel="stylesheet">テーマの style.css を読み込み。
<link rel="alternate">RSS フィードのURL(読者向けの購読機能)
<link rel="pingback">ピンバック機能用のURL(使わないなら削除してもOK)
<?php wp_head(); ?>WordPressが必要とするスクリプトやスタイルを自動で挿入(必須)

get_bloginfo()のよくあるカスタマイズ例

Google Fonts を追加

<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Noto+Sans+JP&display=swap">

favicon(ファビコン)追加

<link rel="icon" href="<?php echo esc_url( get_template_directory_uri() ); ?>/favicon.ico" type="image/x-icon">

get_bloginfo()<head> 内で以下のような用途に適しています

  • charset → 文字コード指定
  • description → 検索エンジン向けの説明文
  • stylesheet_url → style.css 読み込み
  • rss2_url → フィードURL
  • pingback_url → ピンバックURL
  • version → WPバージョン(任意で使用)
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

初めてホームページを作成したのは1996年。
2000年よりフリーランスで主に中小企業、学校、各種公的団体、個人事業主のWordPressを活用したホームページ制作を行っています。WordPressテーマはそれぞれのクライアントに合わせて作成しています。
WordPressを活用したサイト運営のための情報発信をしていきます。

目次