模板标签-next_post_link()

6条评论

说明

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

该标签必须在WordPress主循环(loop)中。

用法

<?php next_post_link('format', 'link', 'in_same_cat', 'excluded_categories'); ?> 

示例

默认用法

将下一篇(按照发表文章的时间顺序)文章的标题作为链接文本,文本后带有一个向右的尖箭头(>>)。默认情况下,该标签的工作方式类似于next_post()。

<?php next_post_link(); ?> 

以粗体的文章标题作为链接文本

以“strong”标签包围(通常会将文本显示为粗体)的下一篇(时间顺序)文章标题作为链接文本。

<?php next_post_link('<strong>%link</strong>'); ?> 

在同一分类目录下,不显示文章标题为链接文本

自定义文字,将其作为同一分类目录下当前文章的下一篇文章链接。不使用文章标题。本例中假设“Next post in category”(XX分类中下一篇文章)为自定义文字,你也可以使用自己喜欢的内容作为自定义文字。

<?php next_post_link('%link', 'Next post in category', TRUE); ?> 

在同一分类目录下,除某一个分类目录外

只要分类目录ID不为13,则显示该分类目录下当前文章的下一篇文章链接。你可以将13替换为任何你希望排除的分类目录ID。如果要排除多个分类目录,请用 " and "分隔各分类目录ID。

<?php next_post_link('%link', 'Next post 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'。无默认值。

在WordPress 2.2(仅限于WordPress 2.2)中,多个分类ID用逗号而非and隔开;如'1, 5, 15'。无默认值。

注释

参见previous_post_link。