get_post_ancestors() | wordpress通过页面ID获取其父页面函数

函数

get_post_ancestors( $post );

描述

get_post_ancestors() 函数的作用是获取指定页面的父页面 ID，函数会以数组的形式返回指定页面的所有父页面 ID，比如一个三级页面，通过该 WordPress 函数返回的数组包含了二级页面ID和一级页面的ID，其中数组第一个值的 ID 为直系父页面，最后一个值的 ID 为最顶级的父页面。

参数

$post – 页面ID或页面对像

返回值

数组，如果没有父页面，则返回空数组，如果有父页面，则返回所有父页面ID数组

例子

获取当前页面的父页面 ID

global $post;
$pageArray = get_post_ancestors($post->ID);
echo $pageArray[0];

获取最高级页面别名作为 body 的样式名

/* Get the Page Slug to Use as a Body Class, this will only return a value on pages! */
$class = '';
/* is it a page */
if( is_page() ) {
	global $post;
        /* Get an array of Ancestors and Parents if they exist */
	$parents = get_post_ancestors( $post->ID );
        /* Get the top Level page->ID count base 1, array base 0 so -1 */
	$id = ($parents) ? $parents[count($parents)-1]: $post->ID;
	/* Get the parent and set the $class with the page slug (post_name) */
        $parent = get_post( $id );
	$class = $parent->post_name;
}

获取父页面的 Meta 数据。以下代码是获取顶级页面中名称为“body_class”的自定义字段的值作为 body 的样式名

$class = '';
if( is_page() ) {
	global $post;
	$parents = get_post_ancestors( $post->ID );
	$id = ($parents) ? $parents[count($parents)-1]: $post->ID;
	$class = get_post_meta( $id, 'body_class', true );
}

获取顶级页面的特色图像

global $post;
$parents = get_post_ancestors( $post->ID );
/* Get the ID of the 'top most' Page if not return current page ID */
$id = ($parents) ? $parents[count($parents)-1]: $post->ID;
if(has_post_thumbnail( $id )) {
	get_the_post_thumbnail( $id, 'thumbnail');
}

源文件

wp-includes/post.php

官方文档

https://codex.wordpress.org/Function_Reference/get_post_ancestors