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; ?>
要了解更多详情,请参阅 官方日志。
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。