WordPress分页函数详解
一、子页面函数(单篇文章分页)
函数一:wp_link_pages
功能说明
如果一篇文章中包括几处《 !–nextpage–》 标签,就会将这篇文章分成若干页,并显示文章子页面的链接。
用法:
<?php wp_link_pages(‘参数’); ?>
示例
默认用法:
<?php wp_link_pages(); ?>
显示为:
Pages:1 2 3
显示一长串子页面的链接列表:
- <?php wp_link_pages(‘before=<p>&after=</p>&next_or_number=number&pagelink=page %’); ?>
- <?php wp_link_pages(‘before=’<p>本文导航:’&after=’</p>’&nextpagelink=’<strong>继续下一页</strong>’&previouspagelink=’<strong>返回上一页</strong>&next_or_number=unmber’); ?>
显示为:
page 1 page 2 page 3
对子页面的链接装入DIV(id=page-links)引用 CSS
<?php wp_link_pages(‘before=<div id="page-links">&after=</div>’); ?>
详细参数说明
before (字符串)所有链接前面显示的文字,默认为
Pages
after (字符串)所有链接后面显示的文字,默认为
link_before (字符串)链接前面显示的文字,默认为空,只在wordpress版本为2.7以上才有效
link_after (字符串)链接后面显示的文字,默认为空,只在wordpress版本为2.7以上才有效
next_or_number (字符串)是否显示子页面序号所显示的格式,l默认参数number,即显示(不显示页面序号参数为next,next参数只在Wordpress 1.5以上版本有效)。
nextpagelink (字符串)下一子页面的链接所显示的文字,默认为Next page(只在WordPress 1.5及以上有效)
previouspagelink(字符串)返回上一子页面的链接所显示的文字,默认为Previous page(只在WordPress 1.5及以上有效)
pagelink (字符串)子页面序号的格式,默认参数为%,%这个字符表示子页面数字序号,例如Page %会生成”Page 1″, “Page 2″等链接和文字。
more_file (字符串)指向当前子页面的文字
函数二:link_pages(即将失效)
说明:功能和wp_link_pages一样。已经被wp_link_pages取代,前段时间测试Wordpress2.6调用正常,不过在后续的版本中可能会被停用,故不做特别说明。
二、分页函数(多篇文章分页)posts_nav_link
功能说明
在支持翻页的主页面、目录页面、归档页面显示翻页的链接,例如页码、上一页和下一页的链接。
特别说明的是如果想在单独的日志页面显示上一篇、下一篇的日志链接请使用 next_post_link 和previous_post_link函数
用法:
<?php posts_nav_link(‘sep’,'prelabel’,'nxtlabel’); ?>
示例
默认用法:
<?php posts_nav_link(); ?>
会显示下面的样子,« Previous Page — Next Page »
示例二:
<div style="text-align:center;">
<?php posts_nav_link(‘ · ‘, ‘previous page’, ‘next page’); ?>
</div>
显示下下面的样子previous page · next page且居于页面中央。
示例三:
<?php posts_nav_link(‘ ‘, ‘<img src="images/prev.jpg" />’, ‘<img src="images/next.jpg" />’); ?>
显示两个小图标,图标分别指向上一篇日志和和下一篇日志的链接。
示例四:
<?php posts_nav_link(‘ or ‘, ‘You can go back
to the previous page’, ‘you can go
forward to the next page’); ?>
自定义链接显示的文字和链接之前的字符,上面的代码会在显示为
You can go back to the previous page or you can go forward to the next page
详细参数说明
sep (字符串)链接之前的字符
prelabel (字符串)上一篇日志链接显示的的文字
nxtlabel (字符串)下一篇日志链接显示的的文字
三、More标签函数 the_excerpt
《!—more–》标签是 WordPress一个非常有用的特性。它允许你选择截断点,然后在首页上只显示截断点前面的文字。
但是我们需要显示的日志的函数是类似
<?php the_excerpt(__(‘Read more’));?>
的样子,这里的“Read more”可以替换成您想要的文字,说到这里我们也简单提一下,the_content与the_excerpt的区别,the_content函数显示的截断内容是预先在后台撰写日志页面摘要部分手动添加的,而the_excerpt则可以自动识别文章中的more标签,不过the_content函数可以显示更多的信息,例如图片、表格等等,而the_excerpt则只能截断文字内容而忽略文本的格式。至于如何选择就看个人爱好了。
————————————————————————–