说明

该标签主要用在独立文章的固定链接页面上，该标签显示从时间顺序上早于当前文章的“上一篇”文章。

该标签必须在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 &raquo;’。

link

（字符串）所显示的链接文本。默认为上一篇文章的标题（’%title’）。

in_same_cat

（布尔型）指明上一篇文章是否与当前文章在同一分类目录中。如果该参数值为TRUE，只显示当前文章所属分类目录下的文章。有效值包括：

• TRUE
• FALSE（默认值）

excluded_categories

（字符串）上一篇文章所不属于的分类目录的数值型ID。用and分隔多个分类ID，如’1 and 5 and 15’。无默认值。

注释

参见next_post_link()。

分类：中文手册