single_tag_title()
は、タグアーカイブページで現在のタグ名を取得・表示するためのテンプレートタグです。
機能の説明
single_tag_title()
は、タグアーカイブページにおいて、現在表示されているタグの名前を取得し、表示するために使用されます。タグアーカイブページとは、特定のタグに紐づいた投稿を一覧で表示するページです。
シンプルなコード例
single_tag_title();
このコードは、現在のタグアーカイブページに表示されているタグ名を出力します。
使い方の解説
single_tag_title()
は、タグアーカイブページで現在のタグ名を表示するために使用されます。タグ名の前にカスタムテキストを追加したい場合は、引数を使ってテキストを設定できます。
<h1><?php single_tag_title( 'タグ: ' ); ?></h1>
このコードでは、<h1>
タグ内に「タグ: タグ名」という形式で、現在のタグアーカイブページのタイトルが表示されます。例えば、タグ「WordPress」のアーカイブページでは、「タグ: WordPress」というタイトルが表示されます。
一緒に使うことが多い関連タグ
get_the_tag_list()
get_the_tag_list()
は、特定の投稿に関連付けられているタグのリストをカスタムフォーマットで取得・表示するためのテンプレートタグです。主に投稿ページなどで、記事に付与されたタグを表示する際に使用します。
使用例
<?php echo get_the_tag_list( '<ul><li>', '</li><li>', '</li></ul>' ); ?>
このコードは、投稿に関連するタグをリスト形式で表示します。<ul>
と <li>
タグを使ってタグを箇条書きにする例です。表示される形式を自由にカスタマイズすることが可能です。
get_tag_link()
get_tag_link()
は、特定のタグのリンク URL を取得するテンプレートタグです。このタグは、タグのアーカイブページへのリンクを作成する際に使われます。
使用例
<?php
$tag_id = get_queried_object()->term_id;
$tag_link = get_tag_link( $tag_id );
?>
<a href="<?php echo esc_url( $tag_link ); ?>">タグページへ移動</a>
このコードでは、現在のタグのリンクを取得し、そのリンクを表示しています。「タグページへ移動」としてタグアーカイブページへのリンクを出力しています。
追加情報を取得したい場合
get_tag()
で取得できる情報
get_tag()
は、タグの詳細情報(ID、スラッグ、名前など)を取得するテンプレートタグです。この関数を使うことで、特定のタグに関する追加情報を取得できます。
ソースコード例
$tag = get_tag( get_queried_object_id() );
echo $tag->name; // タグ名を出力
echo $tag->slug; // タグのスラッグを出力
get_tag()
で出力できる情報
- name: タグの名前
- slug: タグのスラッグ(URL フレンドリーな名前)
- term_id: タグの ID
- count: そのタグに関連する投稿数
想定されるトラブル
タイトルが表示されない
タグアーカイブページ以外のページで single_tag_title()
を使用している可能性があります。
解決方法
このテンプレートタグはタグアーカイブページ専用なので、is_tag()
でページがタグアーカイブか確認する条件文を追加する必要があります。
プレフィックスが表示されない
single_tag_title()
の引数が正しく設定されていない可能性があります。
解決方法
プレフィックス(例えば「タグ: 」など)を表示するためには、single_tag_title( 'プレフィックス: ' )
のように引数を渡します。
Q&A
まとめ
single_tag_title()
は、タグアーカイブページで現在のタグ名を表示するために使用される非常に便利なテンプレートタグです。関連するテンプレートタグと組み合わせて使用することで、タグに関連する情報を豊富に表示できます。