目次
single_tag_title()の用途
single_tag_title() は、WordPressのタグアーカイブページ（例：タグ「WordPress」に属する投稿一覧ページ）で、現在表示しているタグの名前（タイトル）を取得・出力するためのテンプレートタグです。
single_tag_title()の使用方法
single_tag_title( string $prefix = '', bool $display = true )single_tag_title()のパラメータ
| 引数 | 型 | 説明 |
|---|---|---|
$prefix | string | タイトルの前に付ける文字列（任意） |
$display | bool | true（デフォルト）の場合はタイトルを出力（echo）、false なら返すだけ |
single_tag_title()の返り値
$displayがtrue（デフォルト）の場合： タイトルがそのまま画面に出力される$displayがfalseの場合： タイトルが文字列として返る
single_tag_title()の使用例
タグ名を表示する（通常）
<h1><?php single_tag_title(); ?></h1>例：現在のタグが「WordPress」の場合 → <h1>WordPress</h1>
プレフィックスを追加する
<h1><?php single_tag_title( 'タグ: ' ); ?></h1>出力例：<h1>タグ: WordPress</h1>
タグ名を取得して加工する
<?php
$tag_title = single_tag_title( '', false );
echo '<h1 class="tag-title">' . esc_html( $tag_title ) . '</h1>';
?>single_tag_title()の注意点
single_tag_title()は **タグアーカイブページ（is_tag()が true）**でのみ機能します。- 通常は
tag.phpまたはarchive.phpテンプレートで使用されます。 the_archive_title()を使うと、より汎用的にカテゴリやタグなどにも対応可能ですが、single_tag_title()の方がシンプルにタグ名だけを取り出せます。
single_tag_title()の類似関数との違い
| 関数名 | 用途 | 備考 |
|---|---|---|
single_tag_title() | タグページでタグ名を取得 | タグ専用。簡潔 |
single_cat_title() | カテゴリーページでカテゴリ名取得 | カテゴリ専用 |
single_term_title() | 任意のタクソノミーで使用 | 柔軟だがより複雑 |
the_archive_title() | 投稿タイプ・カテゴリ・タグ等のアーカイブタイトル | 幅広く対応可能 |
single_tag_title()のまとめ
- タグアーカイブページ専用のタイトル表示関数
- HTMLタグに囲んで見出しなどに使用しやすい
- シンプルにタグ名だけを表示したいときに最適
