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

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

提供: WordPress Codex 日本語版
< 関数リファレンス
2014年7月21日 (月) 23:26時点におけるGblsm (トーク | 投稿記録)による版 (en:Function Reference/wp_get_post_terms 09:23, 6 June 2014 Juniperpaul 版を流し込み。)

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

このページ「関数リファレンス/wp get post terms」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

Description

Retrieve the terms for a post.

There is only one default for this function, called 'fields' and by default is set to 'all'. Other values can be 'names' or 'ids'. There are other defaults that can be overridden in wp_get_object_terms().

Usage

<?php $terms = wp_get_post_terms( $post_id, $taxonomy, $args ); ?>

Parameters

$post_id
integer) (optional) The Post ID
初期値: 0
$taxonomy
string|array) (optional) The taxonomy for which to retrieve terms. Defaults to post_tag.
初期値: 'post_tag'
$args
array) (optional) Overwrite the defaults
初期値: array

Default Arguments

$args = array('orderby' => 'name', 'order' => 'ASC', 'fields' => 'all');

Return Values

(array) 
List of post tags.

Variables in Returned Object

term_id 
the id of the term itself
name 
the term name
slug 
a slug generated from the term name
term_group 
the term_id of the parent term (also stored as 'parent')
term_taxonomy_id 
the id of the taxonomy that the term belongs to
taxonomy 
the name of the taxonomy that the term belongs to
description 
the taxonomy description
parent 
the term_id of the parent term (also stored as 'term_group')
count 
the number of uses of this term

Examples

//Returns All Term Items for "my_taxonomy"
$term_list = wp_get_post_terms($post->ID, 'my_taxonomy', array("fields" => "all"));
print_r($term_list);

//Returns Array of Term Names for "my_taxonomy"
$term_list = wp_get_post_terms($post->ID, 'my_taxonomy', array("fields" => "names"));
print_r($term_list);

//Returns Array of Term ID's for "my_taxonomy"
$term_list = wp_get_post_terms($post->ID, 'my_taxonomy', array("fields" => "ids"));
print_r($term_list);

Notes

Change Log

Since: 2.8.0

Source File

wp_get_post_terms() is located in wp-includes/post.php.

Related

タームタグ: is_term(), term_exists(), get_objects_in_term(), get_term(), get_term_by(), get_term_children(), get_term_link(), get_terms(), get_the_terms(), get_the_term_list(), has_term(), sanitize_term(), the_terms(), get_object_taxonomies() is_object_in_taxonomy() the_taxonomies() wp_get_object_terms(), wp_set_object_terms(), wp_get_post_terms(), wp_set_post_terms(), wp_delete_object_term_relationships()



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


最新英語版: WordPress Codex » Function Reference/wp_get_post_terms最新版との差分