WordPress 5.7添加了两个期待已久的函数来确定文章是否具有父级并获取相关的父级文章对象。这些功能使用起来非常简单。它们减少了主题和插件所需的逻辑。

提醒WordPress开发人员：如果您在任何自定义插件或主题中使用get_parent_post()或has_parent_post()函数，请在WP 5.7之前为它们添加前缀，以避免任何PHP错误。

新模板标签：get_parent_post()

这个新的模板标签接受一个参数：一个文章ID或一个WP_Post对象。默认情况下，它使用全局变量（$post如果可用）。它检索给定文章WP_Post的父级对象。

新条件标签：has_parent_post()

这个新的条件标签接受一个参数：文章ID或WP_Post对象。默认情况下，它使用全局变量$post可用。如果文章具有父项则返回true，否则返回false。

基本使用示例

可以组合使用这两个函数来显示“返回父级文章”链接：

<?php if ( has_parent_post( get_the_ID() ) ) : ?>
<a href=\"<?php the_permalink( get_parent_post( get_the_ID() ) ); ?>\">
<?php
echo sprintf(
esc_html__( \'Back to parent page: %s\', \'text-domain\' ),
get_the_title( get_parent_post( get_the_ID() ) )
);
?>
</a>
<?php endif; ?>

要了解更多详情，请参阅 官方日志。