描述
另见
参数
- $format
-
(string) (可选) 链接锚格式,默认值“%link »”。
默认值: '%link »'
- $link
-
(string) (可选) 链接固定链接格式,默认''%title''
默认值: '%title'
- $in_same_term
-
(bool) (可选) 链接是否应位于同一分类法项目(term)中。
默认值: false
- $excluded_terms
-
(int[]|string) (可选) 排除的term ID的数组或逗号分隔列表。
默认值: ''
- $taxonomy
-
(string) (可选) 分类法(taxonomy),如果 $in_same_term 为true。
默认值: 'category'
源码
更新日志
版本 | 描述 |
---|---|
1.5.0 | 开始引入 |
使用示例
链接加粗
显示下一个按时间顺序排列的文章标题的链接,该标题用“strong”标记(“我的下一个文章标题”)。<?php next_post_link( '<strong>%link</strong>' ); ?>
在同一类别内(排除一个)
显示同一类别的下一篇文章的链接,只要它不在类别13(类别ID #)。你可以把这个数字改为你想排除的任何类别。数组或逗号分隔的ID可以排除多个类别。<?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
在同一自定义分类中
显示指向同一自定义分类项目中下一篇文章的链接。<?php next_post_link( '%link', 'Next post in taxonomy', TRUE, '', 'my_custom_taxonomy' ); ?>
替换 下一篇/上一篇 文章文本
将默认的“«%link”格式更改为文章标题,删除默认的双箭头。
<?php previous_post_link('%link', '%title'); ?> <?php next_post_link('%link', '%title'); ?>
可以用替代文本替换
%title
。注
参见 previous_post_link().Hola,如果使用引导,您将遇到无法修改类(a)的问题,
这些都是在single.php文件:
<ul class="pagination justify-content-center mb-4"> <ul class="pagination justify-content-center mb-4"> <li class="page-item"> <?php next_post_link( '%link', '<i class="fas fa-arrow-right"></i> %title' ); ?> </li> <li class="page-item"> <?php previous_post_link( '%link', '%title <i class="fas fa-arrow-left"></i>' ); ?> </li> </ul> </ul>
这在functions.php文件中:
function wpdocs_add_post_link( $html ){ $html = str_replace( '<a ', '<a class="page-link" ', $html ); return $html; } add_filter( 'next_post_link', 'wpdocs_add_post_link' ); add_filter( 'previous_post_link', 'wpdocs_add_post_link' );
我用FontAwesome制作图标,你可以随意更改
示例:默认用法显示下一篇文章的链接(按发布日期按时间顺序),文章标题作为链接文本,后跟直角引号(“我的下一篇文章标题 »”)。
<?php next_post_link(); ?>
如果没有下一篇文章,该函数不会打印任何内容。
文本作为链接,不带文章标题,在同一类别内
显示自定义文本作为链接,指向与当前文章在同一类别内的下一篇文章。此处不包括文章标题。“Next post in category”是本例中的自定义文本。<?php next_post_link( '%link', 'Next post in category', TRUE ); ?>