WordPress友链函数 wp_list_bookmarks 函数详解

在较早的WP中用 get_links 函数实现友情链接,目前这个函数已经被新函数取代了,那就是：wp_list_bookmarks。该函数的特点是只有一个参数，但功能超级强大，这归因于它有众多的可选参数.
不显示图片链接的代码是：
1
< ?php wp_list_bookmarks('title_li=&categorize=0&show_images=0'); ?>
这个函数又是比较强大的一个WP标签。wp_list_bookmarks 这个函数也是为Blogroll服务的，它有很多参数，参数和参数之前用”&”分隔。
categorize
布尔型，用于设置连接是否按照各自的分类显示：
1 （默认，根据链接的分类显示）
0 （不按照分类，显示全部）
category
字符串型，后面就直接 “=链接分类ID号”，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。
category_name
字符串型，如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。
category_before
字符串型，位于链接分类之前的文字或代码。默认的设置是：
category_after
字符串型，位于链接分类之后的文字或代码。默认的设置是：
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条链接：
1
< ?php wp_list_bookmarks('orderby=rand&limit=10'); ?>