当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

テンプレートタグ/get the tags

提供: WordPress Codex 日本語版
< テンプレートタグ
2008年3月31日 (月) 02:01時点におけるBleu (トーク)による版

移動先: 案内検索

記事に付けられているタグをそれぞれ一つのオブジェクトにし、そのオブジェクトの配列を返します。このタグはループ内で使用しなければなりません。


使い方

このファンクションは何も表示しません。オブジェクトにアクセスし、echo もしくは使いたいメンバ変数を使用します。

以下の例は記事に付けられているタグを表示します (the_tags() を使うのと似ていますが、タグにリンクが無く、コンマの代わりにスペースが使われています) 。

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo $tag->name . ' '; 
}
}
?>

用例

タグのイメージを表示

これは term_id にちなんだファイル名のタグイメージを alt 属性にタグ名を付けて表示します。また、他のメンバ変数を代わりに使うことも出来ます。

<?php
$posttags = get_the_tags();
if ($posttags) {
foreach($posttags as $tag) {
echo '<img src="http://example.com/images/' . $tag->term_id . '.jpg" 
alt="' . $tag->name . '" />'; 
}
}
?>

最初のタグだけを表示する

<?php
$tag = get_the_tags(); 
if ($tag) {
$tag = $tag[0]; echo $tag->name;
}
?>

メンバ変数

term_id 
タグのID
name 
タグ名
slug 
タグのスラッグ
term_group 
タグのグループ (もしあれば)
taxonomy 
この場合は常に「post_tag」になります
description 
タグの説明
count 
このタグの総使用回数

変更履歴

  • 2.3 : 新規テンプレートタグ


タグ: get_tag(), get_tag_link(), get_tags(), get_the_tag_list(), get_the_tags(), is_tag(), the_tags(), single_tag_title(), tag_description(), wp_generate_tag_cloud(), wp_tag_cloud()


テンプレートタグへのクエリ文字列型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Template Tags/get_the_tags最新版との差分