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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2010年2月23日 (火) 18:51時点におけるMizuno (トーク | 投稿記録)による版 (13:17, 1 November 2009 MichaelH に更新)

移動先: 案内検索

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


使い方

このファンクションは何も表示しません。オブジェクトにアクセスし、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最新版との差分