get_category_parents()
get_category_parents( int $id, bool $link = false, stri…
get_category_parents( int $id, bool $link = false, string $separator = ‘/’, bool $nicename = false, array $deprecated = array() )
使用分隔符检索类别父级。
Retrieve category parents with separator.
目录锚点:#参数#返回#源码#笔记
参数(Parameters)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
$id | (int) | 必需 | 类别ID。 |
$link | (bool) | 可选 | 是否用链接格式化。 |
$separator | (string) | 可选 | 如何分类。 |
$nicename | (bool) | 可选 | 是否使用好的名称显示。 |
$deprecated | (array) | 可选 | 不使用。 |
返回(Return)
(string|WP_Error)成功时的类别父级列表,失败时的类别父级列表。
源码(Source)
/** * Retrieve category parents with separator. * * @since 1.2.0 * * @param int $id Category ID. * @param bool $link Optional, default is false. Whether to format with link. * @param string $separator Optional, default is '/'. How to separate categories. * @param bool $nicename Optional, default is false. Whether to use nice name for display. * @param array $visited Optional. Already linked to categories to prevent duplicates. * @return string|WP_Error A list of category parents on success, WP_Error on failure. */ function get_category_parents( $id, $link = false, $separator = '/', $nicename = false, $visited = array() ) { $chain = ''; $parent = get_term( $id, 'category' ); if ( is_wp_error( $parent ) ) return $parent; if ( $nicename ) $name = $parent->slug; else $name = $parent->name; if ( $parent->parent && ( $parent->parent != $parent->term_id ) && !in_array( $parent->parent, $visited ) ) { $visited[] = $parent->parent; $chain .= get_category_parents( $parent->parent, $link, $separator, $nicename, $visited ); } if ( $link ) $chain .= ''.$name.'' . $separator; else $chain .= $name.$separator; return $chain; }
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
4.8.0 | wp-includes/category-template.php:46 | 2 | 2 |
笔记(Notes)
基本示例
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!