描述
另见
参数
- $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 | 开始引入 |
使用示例
文章标题作为链接，在相同的自定义分类中
显示指向同一自定义分类项目中上一篇文章的链接。您有一个称为 Buildings 的自定义文章类型和一个称为 neighbour 的自定义分类法
Previous Title in Neighborhood<?php previous_post_link( '%link', '%title', true, ' ', 'neighborhood' ); ?>
粗体文章标题作为链接
显示与上一篇按时间顺序排列的文章标题的链接，标题用“strong”标标包装（通常将文本设置为粗体）。
Previous Post Title<?php previous_post_link( '<strong>%link</strong>' ); ?>
默认用法
显示带有左角引号（«）的链接，后跟上一篇文章的文章标题（按时间顺序排列的文章日期顺序）。
« Previous Post Title<?php previous_post_link(); ?>
文本作为链接，没有文章标题，在同一类别内
将自定义文本显示为与当前文章在同一类别内的上一篇文章的链接。此处不包括文章标题。“Previous in category”是自定义文本，可以根据您的要求进行更改。
Previous in category<?php previous_post_link( '%link', __( 'Previous in category', 'textdomain' ), true ); ?>
同一类别内，排除一个
显示指向同一类别中上一篇文章的链接，只要它不在类别13中（类别ID#）。您可以将数字更改为要排除的任何类别。数组或逗号分隔的类别ID列表，其中不应列出上一篇文章。例如数组（1，5）或“1，5”。
Previous in category<?php previous_post_link( '%link', 'Previous in category', true, '13' ); ?>
在同一分类中
显示指向同一分类项目中上一篇文章的链接。文章格式是一种分类法，因此以下内容将链接到具有相同文章格式的前一篇文章。
Previous post in taxonomy<?php previous_post_link( '%link', 'Previous post in category', true, ' ', 'post_format' ); ?>