最新消息:点击查看大S的省钱秘笈

WordPress友情链接 wp_list_bookmarks 函数详解

WordPress Slyar 278浏览 0评论

文章作者:姜南(Slyar) 文章来源:Slyar Home (www.slyar.com) 转载请注明,谢谢合作。

唔,今天突然发现很多人不晓得这个函数,而这个函数又是比较强大的一个,于是乎我就写写。。。

wp_list_bookmarks 这个函数也是为Blogroll服务的,比以前的函数 get_links_list() 和 get_links() 更加强大,它有很多参数,参数和参数之前用"&"分隔。详见全文。

wp_list_bookmarks 函数的默认参数是:

'orderby' => 'name'
'order' => 'ASC'
'limit' => -1
'category' => ''
'category_name' => ''
'hide_invisible' => 1
'show_updated' => 0
'echo' => 1
'categorize' => 1
'title_li' => __('Bookmarks')
'title_before' => '<h2>'
'title_after' => '</h2>'
'category_orderby' => 'name'
'category_order' => 'ASC'
'class' => 'linkcat'
'category_before' => '<li id="%id" class="%class">'
'category_after' => '</li>'

下面我来一一介绍每个参数的用途:

categorize

布尔型,用于设置连接是否按照各自的分类显示:
1 (默认,根据链接的分类显示)
0 (不按照分类,显示全部)

category

字符串型,后面就直接 "=链接分类ID号",那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。

category_name

字符串型,如果后面 "=某个链接分类的名称" 那么就会在该链接分类前显示分类的名称,如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。

category_before

字符串型,位于链接分类之前的文字或代码。默认的设置是:<li id="[category id]" class="linkcat">

category_after

字符串型,位于链接分类之后的文字或代码。默认的设置是:</li>

class

字符串型,每一个链接的分类都会有一个 "class" 属性(从上面的代码就能看出),默认是:linkcat

category_orderby

字符串型,链接分类的排序方式,按照名词或者ID。
'name' (默认)
'id'

category_order

字符串型,链接分类的升降序排列方式:
ASC (默认)
DESC

title_li

字符串型,链接标题的头文字或代码,默认是:Bookmarks,并且它控制连接是否按照列表的方式排列。

title_before 和 title_after

顾名思义,它们就是连接标题头前后的文字或代码,默认是 h2 标签

show_private

布尔型,是否显示私有链接。
1 (是)
0 (不是 - 默认)

include

字符串型,输出指定 ID 的 Blogroll 的分类链接,各个 ID 之间用半角的 "," 分开。默认显示所有的 Blogroll 分类。

exclude

字符串型,将指定 ID 的 Blogroll 分类链接从整个链接列表中排除,各个 ID 之间用半角的 "," 分开。默认是什么都不排除。

orderby

字符串型,Blogroll 的排列方式(默认是根据名称排序,除非将这个值留空),即根据我们在 WP 后台链接设置界面下的那些参数来进行排序:
1.'id’
2. 'url’
3. 'name’
4. 'target’
5. 'description’
6. 'owner’
7. 'rating’
8. 'updated’
9. 'rel’ - 按设定的关系排列
10. 'notes’
11. 'rss’
12. 'length’ - 连接名称的长度设定
13. 'rand’ - 随机排列显示

order

字符串型,设置升降序的排列方式
ASC (默认)
DESC

limit

整型,设置输出链接条数的最大值。默认值是"-1",输出全部。

between

字符串型,每个连接、图片和描述之间的文字或代码,默认是 "n" 换行。

show_images

布尔型,是否允许显示 Blogroll 下链接的对应图片。
1 (允许 - 默认)
0 (不允许)

show_description

布尔型,是否允许显示每个链接的描述。
1 (允许)
0 (不允许 - 默认)

show_rating

布尔型,是否允许显示链接的等级。
1 (允许)
0 (不允许 - 默认)

show_updated

布尔型,是否允许显示最近更新后的时间戳。
1 (允许)
0 (不允许 - 默认)

hide_invisible

布尔型,是否显示所有的链接,甚至是被管理员设为不可见的链接,默认允许显示。
1 (允许 - 默认)
0 (不允许)

例如:

随机显示10条链接:

<?php wp_list_bookmarks('orderby=rand&limit=10'); ?>

随机显示分类ID为1的链接:

<?php wp_list_bookmarks('orderby=rand&category=1'); ?>

剩下的大家可以自己发挥了,呵呵。

转载请注明:Slyar Home » WordPress友情链接 wp_list_bookmarks 函数详解

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

网友最新评论 (26)

  1. 谢谢分享,看了相关参数后,容易多了!
    梦轩丽人3年前 (2014-04-21)回复
  2. 就是想问下样式的问题。。比如我要在显示描述 加个span 标记。就是显示网站的名字是在span里面的。这个要怎么弄。。看了很多都不明白
    超傻的谢单单4年前 (2012-11-05)回复
    • 原来是这样。我突然醒悟了
      超傻的谢单单4年前 (2012-11-05)回复
  3. good
    漂泊云间4年前 (2012-10-31)回复
  4. 请问如果我想显示除掉1以外,所有链接怎么办呢?
    Reuel5年前 (2012-06-28)回复
  5. Tanks!正好帮助我解决了限制显示数量的问题
    贺昌5年前 (2011-09-18)回复
  6. 赞一个 很不错 学习了
    明戈6年前 (2011-05-25)回复
  7. 很好的技术文章……
    期待的日子6年前 (2011-05-09)回复
  8. 写的蛮好的,现在会用了,谢谢!
    小星6年前 (2011-03-01)回复
  9. 文章不错!顶一下....
    star6年前 (2010-10-29)回复
  10. 楼主写的文章非常通俗易懂,收藏了,谢谢。
    华大启明6年前 (2010-10-04)回复
  11. 写得真不错呀!
    XXXX6年前 (2010-09-09)回复
  12. 灰常感谢,用上了。
    fly3q7年前 (2010-07-10)回复
  13. 非常棒的解释,有关友链的说明文章很多甚至还停留在版本wordpress2.1,而官网早已把get_links列入不赞成使用函数.... 本来是对具体参数有些疑问,这样就全部解决了,非常感谢~
    xuejia7年前 (2010-06-21)回复
  14. 不错。谢谢,对模板编写有帮助。
    五行网7年前 (2010-03-06)回复
  15. 想输出带 & 的怎么输出来啊……
    zx7年前 (2010-01-30)回复
  16. 不错 我也就行了修改
    cyg7年前 (2009-12-21)回复
  17. 我的主题是用的get_links,如何换成你介绍的这个强大一点的?
    邵希杰7年前 (2009-10-13)回复
  18. 学习到了,谢谢博主
    bolo7年前 (2009-07-19)回复
  19. 我也用上了!
    Lxhome8年前 (2009-06-09)回复
  20. pack了,不错~
    Mobile 2.08年前 (2008-09-17)回复
  21. 赞一个,我也换成这个函数了。
    牧狼羊8年前 (2008-08-21)回复