模板标签-previous_post_link()

2条评论

说明

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

该标签必须在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()