wp_list_bookmarks是用来显示友情链接的,如果你想做一个显示友情链接的页面,你要用到它,如果你想要实现首页的随机链接啊什么的,你也要用到它。貌似说有一个类似的函数get_links。但是事实上wp_list_bookmarks要强大的多。

wp_list_bookmarks使用很简单

1
<?php wp_list_bookmarks( $args ); ?>

但是里面可以设定的参数就好多了,下面详细解释各个参数:

1
categorize
1
 
1
(boolean) Bookmarks必须在指定的类别中显示(TRUE)或者不必在指定的类别中显示(FALSE),默认为TRUE.
1
*  1 (True -
1
default
1
)
1
*  0 (False)
1
category
1
 
1
(string) 用逗号分开列表上将要显示的类别ID,如果没有特别规定,拥有bookmarks的所有类别都会显示,默认为 (all Categories).
1
exclude_category
1
 
1
(string) 将要显示bookmarks的类别的名称,如果没有特别规定,拥有bookmarks的所有的类别都会显示,默认为(no categories excluded).
1
category_name
1
 
1
(string) 将要显示bookmarks的类别的名称,如果没有特别规定,拥有bookmarks的所有的类别都会显示,默认为 (all Categories).
1
category_before
1
 
1
(string) 每个类别之前放置的文本,默认为
1
'<li id="[category id]">'
1
category_after
1
 
1
(string) 每个类别之前放置的文本,默认为
1
'</li>'
1
class
1
 
1
(string) 每个类别li从属的
1
class
1
,默认为
1
'linkcat'
1
category_orderby
1
 
1
(string) 给类别分类的参数,默认为‘name’,有效的参数值:
1
 
1
*
1
'name'
1
(Default)
1
 
1
*
1
'id'
1
 
1
*
1
'slug'
1
 
1
*
1
'count'
1
 
1
*
1
'term_group'
1
(not used yet)
1
category_order
1
 
1
(string) 类别顺序,category_orderby参数升序或者降序,有效的参数值:
1
 
1
* ASC (Default)
1
 
1
* DESC
1
title_li
1
 
1
(string)   链接列表标头的文本,默认为‘__(’Bookmarks’)’,显示”Bookmarks”(__(”)用作本地化目的),只当类别设置为0的时候,才 会使用(否则会使用类别名代替),如果验证通过了零(0)值,不显示标头,而且列表不会包裹在<ul>,</ul>标签内部.
1
title_before
1
 
1
(string) 如果’categorize’是TRUE,每个类别描述之前放置的文本,默认为
1
'<h2>'
1
.
1
title_after
1
 
1
(string) 如果’categorize’是TRUE,每个类别描述之后放置的文本,默认为
1
'</h2>'
1
.
1
show_private
1
 
1
(boolean) 如果类别被规定为保密的,类别是否应该显示,忽视管理设置,并且显示保密的类别(TRUE)还是不显示保密的类别(FALSE),默认为FALSE.
1
 
1
* 1 (True)
1
 
1
* 0 (False -
1
default
1
)
1
include
1
 
1
(string) 用逗号分开列表上的bookmark的ID数字,并且将其包含在输出中,例如, ‘
1
include
1
=1,3,6′指的是返回或者
1
echo
1
bookmark ID1,3,和6.如果使用了包含字符串,便忽视了category,category_name,和exclude参数.默认为 (all Bookmarks).
1
exclude
1
 
1
(string) 删除列表上用逗号分开的bookmark ID 数字.例如,’exclude=4,12′指的是bookmark ID 为4和12的bookmark不会返回或者echod,默认为 (exclude nothing).
1
orderby
1
 
1
(string) 给bookmark分类的参数,默认为‘name’,除非你验证通过了参数” (
1
empty
1
),在这种情况下,设置为‘id’,有效的选项:
1
 
1
*
1
'id'
1
 
1
*
1
'url'
1
 
1
*
1
'name'
1
 
1
*
1
'target'
1
 
1
*
1
'description'
1
 
1
*
1
'owner'
1
- User who added bookmark through bookmarks Manager.
1
 
1
*
1
'rating'
1
 
1
*
1
'updated'
1
 
1
*
1
'rel'
1
- bookmark relationship (XFN).
1
 
1
*
1
'notes'
1
 
1
*
1
'rss'
1
 
1
*
1
'length'
1
- The length of the bookmark name, shortest to longest.
1
 
1
*
1
'rand'
1
- Display bookmarks in random order.
1
 
1
order
1
 
1
(string) 分类顺序,根据参数的升序或者降序,有效的参数值:
1
 
1
* ASC (Default)
1
 
1
* DESC
1
limit
1
 
1
(integer) 最多显示的bookmarks的数目,默认为 -1 (all bookmarks).
1
before
1
 
1
(string) 每个bookmark之前放置的文本,默认为
1
'<li>'
1
.
1
after
1
 
1
(string) 每个bookmark之后放置的文本,默认为
1
'</li>'
1
.
1
link_before
1
 
1
(string) 每个bookmark之前放置的文本, 包含hyperlink,没有默认设置. (2.7版本以上才有啊,哈哈,提前公布吧)
1
link_after
1
 
1
(string) 每个bookmark之后放置的文本,没有默认设置. (2.7版本以上才有啊,哈哈,提前公布吧)
1
category_before
1
 
1
(string) 每个类别之前放置的文本,默认为
1
'<li>'
1
拥有适当的id 和
1
class
1
.
1
category_after
1
 
1
(string) 每个类别之后放置的文本,默认为
1
'</li>'
1
.
1
between
1
 
1
(string) 每个bookmark/image 和各自的描述之间放置的文本,默认为
1
'\n'
1
(换行).
1
show_images
1
 
1
(boolean) 关于bookmarks的图像应该显示(TRUE) 或者不显示(FALSE),默认为 TRUE.
1
 
1
* 1 (True -
1
default
1
)
1
 
1
* 0 (False)
1
show_description
1
 
1
(boolean) 描述应该显示(TRUE) 或者不应该显示 (FALSE),当show_images是FALSE,或者没有定义一个图像的时候,是有效的,默认为FALSE.
1
 
1
* 1 (True)
1
 
1
* 0 (False -
1
default
1
)
1
show_rating
1
 
1
(boolean) 等级级别stars/字符应该显示(TRUE)或者不应该显示 (FALSE),默认为FALSE.
1
 
1
* 1 (True)
1
 
1
* 0 (False -
1
default
1
)
1
show_updated
1
 
1
(boolean) 最后更新的时间应该显示(TRUE)或者不应该显示(FALSE),默认为 FALSE.
1
 
1
* 1 (True)
1
 
1
* 0 (False -
1
default
1
)
1
hide_invisible
1
 
1
(boolean) 即时bookmark的可视设置为否定的,也应该显示这个bookmark,遵从管理设置(TRUE)或者不遵从管理设置(FALSE),默认为 TRUE.
1
 
1
* 1 (True -
1
default
1
)
1
 
1
* 0 (False)
1
echo
1
 
1
(boolean) 显示(TRUE)或者PHP返回 (FALSE),默认为 TRUE.
1
 
1
* 1 (True -
1
default
1
)
1
 
1
* 0 (False)

文章转自http://014.cc/249,有兴趣的可以去他那看看。