当前浏览:首页 / WordPress函数 / next_post_link()

next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' )

显示与当前文章相邻的下一篇文章链接。

linkmore...

next 下一...

postmore...


描述

另见


参数

$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开始引入

使用示例

  • 示例1

    链接加粗
    显示下一个按时间顺序排列的文章标题的链接,该标题用“strong”标记(“我的下一个文章标题”)。

    <?php next_post_link( '<strong>%link</strong>' ); ?>
  • 示例2

    在同一类别内(排除一个)
    显示同一类别的下一篇文章的链接,只要它不在类别13(类别ID #)。你可以把这个数字改为你想排除的任何类别。数组或逗号分隔的ID可以排除多个类别。

    <?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
  • 示例3

    在同一自定义分类中
    显示指向同一自定义分类项目中下一篇文章的链接。

    <?php next_post_link( '%link', 'Next post in taxonomy', TRUE, '', 'my_custom_taxonomy' ); ?>
  • 示例4

    替换 下一篇/上一篇 文章文本

    将默认的“«%link”格式更改为文章标题,删除默认的双箭头。

    <?php previous_post_link('%link', '%title'); ?>
    <?php next_post_link('%link', '%title'); ?>
    

    可以用替代文本替换%title

  • 示例5
  • 示例6

    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制作图标,你可以随意更改

  • 示例7

    示例:默认用法显示下一篇文章的链接(按发布日期按时间顺序),文章标题作为链接文本,后跟直角引号(“我的下一篇文章标题 »”)。

    <?php next_post_link(); ?>

    如果没有下一篇文章,该函数不会打印任何内容。

  • 示例8

    文本作为链接,不带文章标题,在同一类别内
    显示自定义文本作为链接,指向与当前文章在同一类别内的下一篇文章。此处不包括文章标题。“Next post in category”是本例中的自定义文本。

    <?php next_post_link( '%link', 'Next post in category', TRUE ); ?>