◆ WordPress に関するドキュメントは 『WordPress Codex 日本語版』へ移動しました。 ◆
最新情報はリンク先でお読みください。
テンプレートタグ/the tags
出典: ps*wiki
このテンプレートタグ the tags()は、現在の記事に付けられたタグへのリンクを表示します。 ループの中で使います。
注: このタグは WordPress 2.3 以上でのみ使えます。
<?php the_tags('前', '区切り文字', '後'); ?>
タグの一覧をカンマ区切りで表示した後、改行します。
<?php the_tags('Tags:', ', ', '<br />'); ?>
デフォルトのまま使うと、各タグ(複数のとき)をカンマ(,)で区切り、先頭に Tags: という文字付きで、タグの一覧を表示します。
<p><?php the_tags(); ?></p>
各タグを矢印(>)で区切り、先頭に Social tagging: という文字を付けて、タグへのリンクを表示します。
<?php the_tags('Social tagging: ',' > '); ?>
各タグを中点(•)で区切り、先頭に Tagged with: という文字を付けて、タグへのリンクを表示し、その後で改行します。
<?php the_tags('Tagged with: ',' • ','<br />'); ?>
リスト表示
タグのリストを (X)HTML のリスト (<ul> / <ol> / <dl>) で表示します。
<?php the_tags('<ul><li>','</li><li>','</li></ul>');?>
カテゴリとタグの統合
既にある記事にカテゴリを付けていて、これからタグを付けようとする場合、各記事のカテゴリとタグを一つのリストにまとめたいと思うかもしれません。例えば、ある記事に Culture と Media というカテゴリを付けていて、「Arts」と「Painting」というタグを新たに付けたとすると、読者にとってわかりやすく、シンプルに見せるために、以下のように表示したいと思うかもしれません。
Tags: Culture, Media, Arts, Painting
以下のコードを使えば、カテゴリもタグも、設定されているときだけ表示されます。
Tags:
<?php if (the_category(', ')) the_category(); ?>
<?php if (get_the_tags()) the_tags(); ?>
- 前
- (文字列) タグ一覧の前に表示する文字列。初期値は Tags: 。
- 区切り文字
- (文字列) 各タグリンクの間に表示する文字列・記号。初期値では、各タグ間をカンマ(, )で区切ります。
- 後
- (文字列) 最後のタグの後ろに表示する文字列。初期値では何も表示しません。
the_tags, get_the_tags, get_the_tag_list, single_tag_title, is_tag, get_tag_link, wp_tag_cloud, wp_generate_tag_cloud,
