【函数介绍】
wp_list_bookmarks()是用来获取友情链接的函数。
注：目前很多获取友链的函数都是 get_links_list()或者是get_links()，但未来获取友情链接将被wp_list_bookmarks()函数取代，相较而言wp_list_bookmarks()函数的功能会更强大些。
【使用方法】
【默认使用】
'name',
'order' => 'ASC',
'limit' => -1,
'category' => ,
'exclude_category' => ,
'category_name' => ,
'hide_invisible' => 1,
'show_updated' => 0,
'echo' => 1,
'categorize' => 1,
'title_li' => __('Bookmarks'),
'title_before' => '',
'title_after' => '
',
'category_orderby' => 'name',
'category_order' => 'ASC',
'class' => 'linkcat',
'category_before' => '
',
'category_after' => ''
);
在默认情况下该函数将显示如下内容:
友链的标题为默认标题
包含所有分类的链接
按照链接名称排序
如果包含图像，则显示之
在图像和文字之间有空格
显示链接的描述
不显示链接分级
显示所有的链接
【参数说明】
categorize
(布尔型)不应在他们分配的类别内显示书签。
1(True)-默认
0(False) False
category
(字符串）以逗号分隔数值显示类别 Id 的列表。如果没有指定，显示所有类别的书签。默认值为 (所有类别)。
exclude_category
(字符串）要从显示中排除数字类别 Id 的逗号分隔列表。默认值为 （不排除类别）。
category_name
(字符串）将显示其书签的类别的名称。如果没有指定，显示所有类别的书签。默认值为 (所有类别)。
category_before
(字符串）放置在每个类别之前的文本。默认值为''.category_after
(字符串）每个类别后放置文本。默认值为.
class
(字符串）每个类别李会对它的类。默认值为’linkcat’ 。
category_orderby
(字符串）若要按类别排序的值。有效的选项：
'name' – Default
'id'
'slug'
'count'
'term_group' (not used yet)
category_order
(字符串）排序次序升序或降序的 category_orderby 参数。有效的值：
ASC -默认
DESC
title_li
(字符串）链接列表的标题文本。
默认值为'__('Bookmarks')'，其中显示 "Bookmarks" (the __('') 用于本地化。
只有进行分类时使用都设置为 0 [false] （其他类别名称，将使用相反）。
如果 'title_li' 设置为 null (0) 值，则不显示标题，则列表将不会结束与 （一定要传递给 0 [false]，则此选项才生效的分类选项） 的标签。
title_before
(字符串）将文本放置在每个类别说明之前，如果 '分类' 1 [true]，或在文本中定义"title_li"如果 '分类' 是 0 [false]。默认值为.
title_after
(字符串）将文本放置每个类别的描述后，如果 '分类' 1 [true] 或文本定义在"title_li"如果 '分类' 是 0 [false]。默认值为' '.
show_private
(布尔)应即使类别被认为是私人显示一个类别。忽略的管理员设置和显示私人类别 (TRUE) 或不显示 (虚假的私人类别).
1（True）
0(False)-默认
include
(字符串）以逗号分隔的数字书签 Id 要包含在输出中的列表。例如，’ 包括 = 1，3，6′ 意味着返回或回显书签 Id 1、 3 和 6。如果使用包含字符串，则将忽略的类别、 category_name，和排除的参数。默认值为 （所有书签）。exclude(字符串）以逗号分隔数字书签 Id 来排除的列表。例如，’ 排除 = 4，12′ 意味着书签 Id 4 和 12 将不会返回或回响。默认值为 （不排除）。orderby(字符串）要对书签进行排序的值。这可以用逗号分隔的值列表。除非你的 ‘ ”值传递 （空），在这种情况下，它将设置为id中将默认的名称。有效的选项：
‘id’ （使用 ‘ link_id’ 的 WP 3.2 和更高版本)
‘url’
‘name’ -默认
‘target’
‘description’
‘owner’ -添加书签书签管理器通过用户。
‘rating’
‘updated’注： link_updated 字段不会跟踪的本地修改。它跟踪链接无论指向 pingomatic 的远程请求通过更新时。
‘rel’ -书签关系 (新华财经)。
‘notes’
‘rss’
‘length’ -的书签的名称，最长最短长度。
‘rand’-随机显示书签。
order
(字符串）书签显示按升序或降序 ‘orderby’ 参数中定义的排序顺序。有效的值：
ASC -默认
DESC
limit
(整数）显示书签的最大数目。默认值为-1 （所有书签）。
before
(字符串）放置在每个书签之前的文本。默认值为.
after
(字符串）放置后每个书签的文本。默认值为.
link_before
(字符串）每个书签、 超链接代码内的文本之前放置文本。没有设置的默认值。
link_afte
r(字符串）每个书签的文本后放置文本。没有设置的默认值。（此参数添加了与版本 2.7)之间(字符串）每个书签/图像和它的描述之间放置文本。默认值为'n' （换行符）。show_images
(布尔)应为书签的图像显示 (TRUE) 还是不 (FAUSE).
1(True)-默认
0( False)
show_description
(布尔)描述应显示或不显示 (TRUE) (FALSE)。Show_images是虚假的或未定义图像时有效。
1（True）
0(False)-默认
show_name
(布尔)显示链接的文本时 (TRUE)。当为TRUE时show_images的作品。（此参数添加了与版本 2.7)
1（True）
0(False)-默认
show_rating
(布尔)应评级星星/字符显示或不显示 (TRUE) (FAUSE).
1（True）
0(False)-默认
show_updated
(布尔)上次更新时间戳应显示或不显示 (TRUE) (FALSE)。
请注意，link_updated 不会跟踪的本地修改。它跟踪链接无论指向 pingomatic 的远程请求通过更新时。
1（True）
0(False)-默认
hide_invisible
(布尔)应书签显示即使有可见的设置是号管理员设置 (TRUE) 遵守或不会没有遵守管理设置 （FAUSE).
1(True)-默认
0( False)
echo
(布尔)显示书签 (TRUE) 或返回他们使用 php (FAUSE).
1(True)-默认
0(False)
【使用示例】
简单的列表
显示”链接”的标题和裹在
标记的项目的所有书签。标题被包在 h2 标记。
无标题的简单列表
显示所有链接上面一样，但不包括默认的标题。
特定类别按 URL 进行排序
显示书签的类别 ID 2 在 span 标记中，使用图像的书签，并不显示说明，按照书签 URL 进行排序。
<?php wp_list_bookmarks('categorize=0&category=2before=after=show_images=1show_description=0&orderby=url'); ?>;
显示评级和时间戳
显示带有描述的新行的排序列表中的所有书签、 不使用图像的书签，按照排序书签 id、 链接级别和最后更新时间戳 （注意上次更新的时间戳不跟踪的本地修改。它跟踪链接无论指向 pingomatic 的远程请求通过更新时。）
<?php wp_list_bookmarks('between=
show_images=0&orderby=idshow_rating=1show_updated=1'); ?>;替换图像标题
从主题文件夹，而不是纯文本中使用的图像。
<?php wp_list_bookmarks('categorize=0title_before=title_after=title_li=![blogroll]()
'); ?>
