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

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

提供: WordPress Codex 日本語版
< 関数リファレンス
2014年8月17日 (日) 22:39時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/wp_get_post_tags 18:48, 30 November 2013 Mistercat 版を和訳。)

(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)
移動先: 案内検索

投稿に付いているタグのリストを取得します。

使い方

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

パラメータ

$post_id
整数) (オプション) 投稿 ID
初期値: 0
$args
配列) (オプション) デフォルトの引数を上書きする。指定できる有効なオプションの一覧は wp_get_object_terms() を参照。
初期値: array

戻り値

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

用例

タグ 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最新版との差分