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

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

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

linkmore...

postmore...

previous 上一...


描述

另见


参数

$format

(string) (可选) 链接锚格式,默认 '« %link'

默认值: '« %link'

$link

(string) (可选) 链接固定链接格式。

默认值: '%title'

$in_same_term

(bool) (可选) 链接是否应位于同一分类法项目(term)中。

默认值: false

$excluded_terms

(int[]|string) (可选) 排除的term ID的数组或逗号分隔列表。

默认值: ''

$taxonomy

(string) (可选) 分类法(taxonomy),如果 $in_same_term 为 true。

默认值: 'category'


说明

此模板标签用于单页文章固定链接页面,显示指向前一文章的链接,该链接按时间顺序存在于当前文章中。此标签必须在循环中使用。

$format是链接的格式字符串。这是控制链接前后内容的地方。字符串中的'%link'将替换为声明为'link'的任何内容(请参阅下一个参数)。'Go to %link'将生成“Go to <a href="…”,将HTML标签放在此处以设置最终结果的样式。

$in_same_term 表示前一文章是否必须在与当前文章相同的term(分类法项目)内。如果设置为 "true",将只显示当前term中的文章。如果文章同时出现在父分类和子分类中,或者出现在一个以上的term中,那么前一文章的链接将指向这些term中的前一文章。

$excluded_terms是一个数组或一个逗号分隔的term ID数字列表,下一文章不应该从这个列表中列出。例如array(1, 5)'1,5'。这个参数曾经接受一个由'and'分隔的ID列表,这在WordPress 3.3中被废弃了。



源码

查看源码 官方文档


更新日志

版本描述
1.5.0开始引入

使用示例

  • 示例1

    文章标题作为链接,在相同的自定义分类中

    显示指向同一自定义分类项目中上一篇文章的链接。您有一个称为 Buildings 的自定义文章类型和一个称为 neighbour 的自定义分类法

    Previous Title in Neighborhood

    <?php previous_post_link( '%link', '%title', true, ' ', 'neighborhood' ); ?>
    
  • 示例2

    粗体文章标题作为链接

    显示与上一篇按时间顺序排列的文章标题的链接,标题用“strong”标标包装(通常将文本设置为粗体)。

    Previous Post Title

    <?php previous_post_link( '<strong>%link</strong>' ); ?> 
    
  • 示例3

    默认用法

    显示带有左角引号(«)的链接,后跟上一篇文章的文章标题(按时间顺序排列的文章日期顺序)。

    « Previous Post Title

    <?php previous_post_link(); ?> 
    
  • 示例4

    文本作为链接,没有文章标题,在同一类别内

    将自定义文本显示为与当前文章在同一类别内的上一篇文章的链接。此处不包括文章标题。“Previous in category”是自定义文本,可以根据您的要求进行更改。

    Previous in category

    <?php previous_post_link( '%link', __( 'Previous in category', 'textdomain' ), true ); ?> 
    
  • 示例5

    同一类别内,排除一个

    显示指向同一类别中上一篇文章的链接,只要它不在类别13中(类别ID#)。您可以将数字更改为要排除的任何类别。数组或逗号分隔的类别ID列表,其中不应列出上一篇文章。例如数组(1,5)或“1,5”。

    Previous in category

    <?php previous_post_link( '%link', 'Previous in category', true, '13' ); ?> 
    
  • 示例6

    在同一分类中

    显示指向同一分类项目中上一篇文章的链接。文章格式是一种分类法,因此以下内容将链接到具有相同文章格式的前一篇文章。

    Previous post in taxonomy

    <?php previous_post_link( '%link', 'Previous post in category', true, ' ', 'post_format' ); ?>