WordPress 站点的文章页或自定义文章类型的文章页中都会用上一篇和下一篇功能以便用户查看上下篇文章,这就涉及到 WordPress 的上一篇函数 previous_post_link()和下一篇函数 next_post_link(),今天就重点跟大家介绍一下 WordPress 的下一篇函数 next_post_link()函数。
next_post_link()函数介绍
显示与当前文章相邻的下一个文章链接
- next_post_link( string $format = ‘%link »’, string $link = ‘%title’, bool $in_same_term = false, array|string $excluded_terms = ”, string $taxonomy = ‘category’ )
参数:
- $format(字符串):(可选)链接锚点格式,默认为“« %link”,默认值:“%link »”。
- $link(字符串):(可选)链接永久链接格式,默认的“%title”,默认值:“%title”。
- $in_same_term(布尔型):(可选)链接是否应使用相同的分类术语,默认值:false。
- $excluded_terms(数组|字符串):(可选)以数组或逗号分隔的排除项 ID 列表,默认值:”。
- $taxonomy(字符串):(可选)分类法,如果$in_same_term 为 true,默认值:“category”。
函数所在文件:wp-includes/link-template.php
- function next_post_link( $format = ‘%link »’, $link = ‘%title’, $in_same_term = false, $excluded_terms = ”, $taxonomy = ‘category’ ) {
- echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
- }
next_post_link()函数使用示例
示例:默认用法
显示以标题为链接文本的下一篇文章的链接(按发布日期的时间顺序),其后是直角引号(“我的下一篇文章»”),如果没有下一个帖子,则该功能不打印任何内容。
- <?php next_post_link(); ?>
示例:替换下一个帖子文本
将默认的“«%link”格式更改为帖子标题,删除默认的双箭头,可以替换%title 为替代文本。
- <?php next_post_link(‘%link’, ‘%title’); ?>
示例:粗体标题标题为链接
显示带有以’strong’标签包裹的下一个按时间顺序排列的标题的链接(“我的下一个标题”)。
- <?php next_post_link( ‘<strong>%link</strong>’ ); ?>
示例:在同一类别中但不在类别 ID 为 13 中
显示链接到同一类别中的下一个帖子,只要该帖子不在类别 13 中(类别 ID#)即可。您可以将数字更改为要排除的任何类别。通过使用“and”作为分隔符来排除多个类别。
- <?php next_post_link( ‘%link’, ‘Next post in category’, TRUE, ’13’ ); ?>
示例:在同一个文章分类中
显示链接到同一文章分类中的下一个帖子。
- <?php next_post_link(‘%link’,‘%title’, TRUE,”, ‘category’); ?>
示例:在同一个自定义类型文章分类 wenda 中
显示链接到同一自定义类型文章分类 wenda 中的下一个帖子。
- <?php next_post_link(‘%link’,‘%title’, TRUE,”, ‘wenda’); ?>