说明
该标签主要用在独立文章的固定链接页面上,该标签显示从时间顺序上早于当前文章的“上一篇”文章。
该标签必须在WordPress主循环(loop)中。
用法
<?php previous_post_link('format', 'link', in_same_cat,
'excluded_categories'); ?>
示例
默认用法
将上一篇(按照发表文章的时间顺序)文章的标题作为链接文本,文本后带有一个向左的尖箭头(<<)。默认情况下,该标签的工作方式类似于previous_post()。
<?php previous_post_link(); ?>
以粗体的文章标题作为链接文本
以由“strong”标签包围(通常会将文本显示为粗体)的上一篇(时间顺序)文章标题作为链接文本。
<?php previous_post_link('<strong>%link</strong>'); ?>
在同一分类目录下,显示文章标题外的其它文字为链接文本
自定义文字,将其作为同一分类目录下当前文章的上一篇文章链接。不使用文章标题作为链接文本。本例中假设“Next post in category”(XX分类中下一篇文章)为自定义文字,你也可以使用自己喜欢的内容作为自定义文字。
<?php previous_post_link('%link', 'Previous in category', TRUE); ?>
在同一分类目录下,除某一个分类目录外
只要分类目录ID不为13,则显示该分类目录下当前文章的上一篇文章链接。你可以将13替换为任何你希望排除的分类目录ID。如果要排除多个分类目录,请用 " and "分隔各分类目录ID。
<?php previous_post_link('%link', 'Previous in category', TRUE, '13'); ?>
参数
format
(字符串)链接的格式字符串。用该参数控制链接前后内容。字符串中的'%link'会被声明为'link'的内容(见下一个参数)取代。'Go to %link' 将生成"Go to <a href=…" ,在其中加上相应的HTML标签,生成最终结果。默认值为 '%link »'。
link
(字符串)所显示的链接文本。默认为上一篇文章的标题('%title')。
in_same_cat
(布尔型)指明上一篇文章是否与当前文章在同一分类目录中。如果该参数值为TRUE,只显示当前文章所属分类目录下的文章。有效值包括:
- TRUE
- FALSE(默认值)
excluded_categories
(字符串)上一篇文章所不属于的分类目录的数值型ID。用and分隔多个分类ID,如'1 and 5 and 15'。无默认值。
注释
分类:中文手册