README

此函数返回章节信息，具体取决于您正在查看的页面类型。几个条件检查被组合成这个函数，以便您可以通过一个函数获得综合的章节数据，而不是一个详尽的条件语句列表。

它支持自定义文章类型页面：例如，如果您有一个“电影”的文章类型，创建一个slug为“电影”的页面将返回页面数据，而不是文章类型对象的数据。这对于在CMS中保留复杂的文章类型存档内容非常有用。

参数

check_for_page：是否在文章类型/分类存档/单页上检查匹配slug的页面。也将对slug为'搜索'和'404'的页面进行检查。默认值'true'。

post_type_pages：函数将默认为文章类型页面检查的文章类型名称，但您可以使用此参数手动覆盖它。包括搜索和404的默认值。

返回值

$ancestor = array(
	'id'          => Ancestor ID,
	'title'       => Ancestor title,
	'name'        => Ancestor slug,
	'object'      => Ancestor post/term object,
	'found_posts' => Conditional. Number of search results
);

过滤器

您可以通过添加以下过滤器来调整此函数的输出：add_filter( 'cnp_get_highest_ancestor', 'custom_filter_title', 20, 1 )。接受的参数是ancestor变量。在您的过滤器函数中返回它以更改输出。

场景

分层文章类型 (is_post_type_hierarchical)

返回当前文章的最高祖先数据。如果当前文章是顶级文章，则返回当前文章数据。

平面文章类型 (else)

返回文章类型数据。如果$args['check_page']为true，将检查与文章类型具有相同slug的页面，否则返回基本文章类型数据。

默认主页 (is_home && is_front_page)

返回基本主页数据。

静态主页 (page_on_front)

根据阅读设置中定义的前置文章对象返回数据。

文章页面 (page_for_posts)

根据阅读设置中定义的文章页面返回数据。

分类术语 (is_tax, is_category, is_tag)

根据当前分类术语返回数据。

搜索结果 (is_search)

返回基本搜索结果数据。

404页面 (is_404)

返回基本404页面数据。

cnp / wp-highest-ancestor

维护者

详细信息