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

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

提供: WordPress Codex 日本語版
< テンプレートタグ
2014年8月10日 (日) 15:11時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/get_the_tags 13:16, 13 September 2013 MichaelH 版を反映して残りを和訳。)

移動先: 案内検索

投稿に付けられているタグをそれぞれ一つのオブジェクトにし、そのオブジェクトの配列を返します。 このタグをループ内で使用する場合は、投稿 ID を省略して構いません。

使い方

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

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

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

パラメータ

$id
整数) (オプション) 投稿 ID
初期値: 現在の投稿の ID

用例

タグの画像を表示

次の例は term_id を画像のファイル名に使ってタグの画像を表示します。 また、画像の alt 属性に name を設定します。 他のメンバー変数を代わりに使うこともできます。

<?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();
if ( $posttags[0] ) {
  echo $posttags[0]->name;
}
?>

異なるタグ値に基づくコードを表示する

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

<?php 
$all_the_tags = get_the_tags();
if ( $all_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 {
      // どちらでも無ければ何もしない
?>
<!-- どちらのタグも付いていない場合のコードが必要なら、ここへ -->
<?php
    }
  }
}
?>

タグをドロップダウンで表示する関数

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

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 
タグのスラッグ
description 
タグの説明
count 
このタグの総使用回数

変更履歴

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

ソースファイル

get_the_tags()wp-includes/category-template.php にあります。


タグ: 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() , get_the_terms(), wp_get_object_terms()


関数リファレンステンプレートタグ目次もご覧ください。


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