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

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

このファンクションは何も表示しません。オブジェクトにアクセスし、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
$posttags = get_the_tags();
$count=0;
if ($posttags) {
foreach($posttags as $tag) {
$count++;
if (1 == $count) {
echo $tag->name . ' ';
}
}
}
?>

このコードは、投稿にあるタグが含まれるか否かによって HTML コードを表示します。必要ならば、else if ステートメントを好きなだけ追加してください。

<?php 
if ($all_the_tags);
$all_the_tags = get_the_tags();
foreach($all_the_tags as $this_tag) {
	if ($this_tag->name == "sometag" ) {
?>

<p>SOME HTML CODE <img src="someimage.jpg"></p>

<?php 	} else if ($this_tag->name == "someothertag" ) { ?>

<p>SOME OTHER HTML CODE <img src="someotherimage.jpg"></p>

<?php 	} else {	
		// it's neither, do nothing
?>
		<!-- not tagged as one or the other -->
<?
	}
}
}
?>

この関数は、タグをドロップダウンで出力します。

function drop_tags()
{
    echo "<select onChange=\"document.location.href=this.options[this.selectedIndex].value;\">";
    echo "<option>Tags</option>\n";
    foreach (get_the_tags() as $tag)
    {
        echo "<option value=\"";
        echo get_tag_link($tag->term_id);
        echo "\">".$tag->name."</option>\n";
    }
    echo "</select>";
}

term_id 

タグのID

name 

タグ名

slug 

タグのスラッグ

term_group 

タグのグループ (もしあれば)

taxonomy 

この場合は常に「post_tag」になります

description 

タグの説明

count 

このタグの総使用回数

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

テンプレート:Tag Tags

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