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 删除。

评论 (0)COMMENT

登录 账号发表你的看法,还没有账号?立即免费 注册