目次
get_bloginfo()の用途
get_bloginfo()
は、WordPress サイトの情報を「取得して返す」ためのテンプレートタグ関数です。
bloginfo()
が情報を画面に 直接出力する のに対して、get_bloginfo()
は 値として返すだけ なので、後で使ったり加工したりする用途に適しています。
get_bloginfo()の使用方法
get_bloginfo( string $show = '', string $filter = 'raw' ) : string
get_bloginfo()のパラメータ
引数 | 型 | 説明 |
---|
$show | string | 取得したい情報の種類(例:'name' , 'description' など) |
---|
$filter | string | 返す文字列にフィルターをかけるかどうか(通常は 'raw' でOK) |
---|
get_bloginfo()の主な $show
の値と内容
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バージョン(任意で使用)