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

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

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

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

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

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

Description

Retrieves the terms associated with the given object(s), in the supplied taxonomies.

Usage

<?php wp_get_object_terms( $object_ids, $taxonomies, $args ) ?>

Parameters

$object_ids
string|array) (必須) The id's of objects to retrieve terms from.
初期値: なし
$taxonomies
string|array) (必須) The taxonomies to retrieve terms from. For example: 'category', 'post_tag', 'taxonomy slug'
初期値: なし
$args
array|string) (optional) Change what is returned
初期値: array

Default Arguments

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

Argument Options

The following information has to do the $args parameter and for what can be contained in the string or array of that parameter, if it exists.

order 
(string)
  • ASC - Default
  • DESC
orderby 
(string)
  • name - Default
  • count
  • slug
  • term_group
  • term_order
  • term_id
  • none
fields 
(string)
  • all - Default : all matching terms objects will be returned.
  • ids : terms ids will be returned
  • names : terms names will be returned
  • slugs : terms slugs will be returned
  • all_with_object_id : all matching terms objects will be returned.
  • tt_ids : terms taxonomies ids will be returned

NOTE: Arguments are passed in the format used by wp_parse_args(). e.g.

Return Values

(array|WP_Error) 
Array of requested term objects or empty array if no terms found. WP_Error if $taxonomy does not exist. See is_wp_error() for more information.

Examples

Return a list of all 'product' taxonomy terms which are applied to $post:

$product_terms = wp_get_object_terms($post->ID, 'product');
if(!empty($product_terms)){
  if(!is_wp_error( $product_terms )){
    echo '<ul>';
    foreach($product_terms as $term){
      echo '<li><a href="'.get_term_link($term->slug, 'product').'">'.$term->name.'</a></li>'; 
    }
    echo '</ul>';
  }
}

Notes

Change Log

Since: 2.3.0

Source File

wp_get_object_terms() is located in wp-includes/taxonomy.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_object_terms最新版との差分