1. 首页
  2. WordPress 函数手册

get_page_hierarchy()

get_page_hierarchy( WP_Post[] $pages, int $page_id )

在一个简单的列表中为父母以下的孩子排序。
Order the pages with children under parents in a flat list.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

它使用辅助结构来保持父子关系,并以O(N)复杂度运行


参数(Parameters)

参数 类型 必填 说明
$pages (WP_Post[]) 必需 Posts数组(通过引用传递)。
$page_id (int) 可选 父页ID。默认为0。

返回(Return)

(string[])按ID键控并按层次结构排列的帖子名称数组。孩子们立即跟随父母。


源码(Source)

/**
 * Order the pages with children under parents in a flat list.
 *
 * It uses auxiliary structure to hold parent-children relationships and
 * runs in O(N) complexity
 *
 * @since 2.0.0
 *
 * @param array $pages   Posts array, passed by reference.
 * @param int   $page_id Optional. Parent page ID. Default 0.
 * @return array A list arranged by hierarchy. Children immediately follow their parents.
 */
function get_page_hierarchy( &$pages, $page_id = 0 ) {
	if ( empty( $pages ) ) {
		return array();
	}

	$children = array();
	foreach ( (array) $pages as $p ) {
		$parent_id = intval( $p->post_parent );
		$children[ $parent_id ][] = $p;
	}

	$result = array();
	_page_traverse_name( $page_id, $children, $result );

	return $result;
}
更新版本 源码位置 使用 被使用
2.0.0 wp-includes/post.php:5111 1 function 1 function

笔记(Notes)

get_page_hierarchy()返回一个ID=>page_title数组:键是页的ID,值是页的标题。

get_page_hierarchy() 为WP2原创文章,链接:https://www.wp2.cn/functions/get_page_hierarchy/

发表评论

您的电子邮箱地址不会被公开。