• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

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

提供: WordPress Codex 日本語版
移動先: 案内検索

投稿に付けられているタグをそれぞれ一つのオブジェクトにし、そのオブジェクトの配列を返します。 このテンプレートタグをループ内で使用する場合は、投稿 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 
(整数) このタグの総使用回数

参考

  • get_the_tags()get_the_terms() を経由して wp_get_object_terms() を使用します。そして wp_get_object_terms()sanitize_term() を経由して sanitize_term_field() を呼び出し、その中で次のメンバー変数が整数型に変換されます:term_id, 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最新版との差分