描述
另见
参数
- $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' ); ?>