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

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

関数リファレンス/wp get post tags

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

指定した投稿、または現在の投稿についているタグのリストを取得します。

使い方

<?php wp_get_post_tags( $post_id, $args ) ?>

パラメータ

$post_id
整数) (オプション) 投稿 ID
初期値: 0 (現在の投稿)
$args
配列) (オプション) デフォルトの引数を上書きする。
初期値: array()

$args に指定できるオプションの一覧は wp_get_object_terms() を参照してください。

戻り値

(配列) 
投稿タグのリスト。

用例

タグ tag2, tag5, tag6 が付いた投稿に対して、次のコード:

$t = wp_get_post_tags($post->ID);
print_r($t);

を実行すると、下記のように表示されます。

Array
(
   [0] => stdClass Object
       (
           [term_id] => 4
           [name] => tag2
           [slug] => tag2
           [term_group] => 0
           [term_taxonomy_id] => 4
           [taxonomy] => post_tag
           [description] => 
           [parent] => 0
           [count] => 7
       )

   [1] => stdClass Object
       (
           [term_id] => 7
           [name] => tag5
           [slug] => tag5
           [term_group] => 0
           [term_taxonomy_id] => 7
           [taxonomy] => post_tag
           [description] => 
           [parent] => 0
           [count] => 6
       )

   [2] => stdClass Object
       (
           [term_id] => 16
           [name] => tag6
           [slug] => tag6
           [term_group] => 0
           [term_taxonomy_id] => 16
           [taxonomy] => post_tag
           [description] => 
           [parent] => 0
           [count] => 2
       )

)


ある投稿に付いているタグの ID だけのリストを取得するには:

global $post;
$tag_ids = wp_get_post_tags( $post->ID, array( 'fields' => 'ids' ) );

上記のコードを最初の例と同じ投稿データに対して実行すると、$tag_ids には次のような値が入ります:

[4, 7, 16]

参考

変更履歴

バージョン 2.3.0 から導入されました。

ソースファイル

wp_get_post_tags()wp-includes/post.php にあります。

wp_get_object_terms(), wp_get_post_terms()


タグ: 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 » Function Reference/wp_get_post_tags最新版との差分