wp_get_object_terms()获取文章/页面所属的分类信息

目录

描述

译文

在已知分类法中检索与已知对象联合的term。

以下信息与$args参数有关,涉及函数中的字符串或数组所包含内容。

第一个参数是'orderby',默认值为'name'。另一个有效值为'count'。

第二个参数是'order',默认值为'ASC'。另一个有效值为'DESC'。

最后一个参数是'field',默认值为'all'。同时还有多个有效值,包括:'all','ids','names',以及'all_with_object_id'。

字段变量决定返回的内容。若值为'all'或'all_with_object_id',以及默认值,返回所有匹配的term对象。如果值为'ids'或'names',则分别返回所有匹配的term编号或term名称。

原文

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

wp_get_object_terms() 描述

用法

<?php wp_get_object_terms$object_ids$taxonomies$args ); ?>

wp_get_object_terms() 用法

参数

$object_ids

(string|array) (必填) The id's of objects to retrieve terms from.

默认值: None

$taxonomies

(string|array) (必填) The taxonomies to retrieve terms from. For example: 'category', 'post_tag', 'taxonomy slug'

默认值: None

$args

(array|string) (可选) Change what is returned

默认值: array

Default Arguments

Argument Options

The following information has to do with 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 term's objects will be returned
  • ids : term's ids will be returned
  • names : term's names will be returned
  • slugs : term's slugs will be returned
  • all_with_object_id : all matching term's objects will be returned
  • tt_ids : term's taxonomy's ids will be returned

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

wp_get_object_terms() 参数

返回值

(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.

wp_get_object_terms() 返回值

示例

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

wp_get_object_terms() 示例

注意

wp_get_object_terms() 注意

历史

添加于 版本: 2.3.0

wp_get_object_terms() 历史

源文件

wp_get_object_terms() 函数的代码位于 wp-includes/taxonomy.php.

wp_get_object_terms() 源文件

相关