WordPress友情链接函数wp_list_bookmarks使用方法举例详解

友情链接对搜索引擎优化的作用是非常重要的，首页和内容页的权重不一样，通常将友情链接放在首页底部，或者将友情链接放在侧边栏，全站显示或只在首页显示，对友情链接需要做个性化的输出，要使用到wp_list_bookmarks（）函数，既能解决美观问题，又能起到优化页面，增加页面权重的作用。

调用方法

<h3>友情链接：</h3>
<ul><?php wp_list_bookmarks($args); ?></ul>

默认参数

<?php $args = array(
    'orderby'          => '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'     => '<h2>',
    'title_after'      => '</h2>',
    'category_orderby' => 'name',
    'category_order'   => 'ASC',
    'class'            => 'linkcat',
    'category_before'  => '<li id=%id class=%class>',
    'category_after'   => '</li>' ); 
?>

orderby 字符串型，Blogroll 的排列方式（默认是根据名称排序，除非将这个值留空）
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 (不允许)

应用举例

1.调用当前的友情链接

<?php wp_list_bookmarks(); ?>

2.随机显示10条链接：

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

3.显示所有链接，但不包括默认标题（去掉“书签”这个标题）

<?php wp_list_bookmarks('title_li=&categorize=0'); ?>

4.显示所有链接，标题为“Bookmarks”，各链接项包围在li标签中，标题则用h2标签。

<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

5.显示所有链接，但不包括默认标题。

<?php wp_list_bookmarks('title_li=&categorize=0'); ?>

6.显示ID为2的链接分类下的所有链接，使用链接图片，不显示链接说明，按URL排列链接。

<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>

7.以数字编号列表形式显示所有链接，各链接下另起一行填写链接说明，不适用链接图片，按ID排列链接，显示链接等级和最新更新的时间。

<ol>
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
</ol>

8.从主题目录中选择一个图片代替普通文本作为链接列表标题。

<?php wp_list_bookmarks('categorize=0&title_before=&title_after=&title_li=<img src="'.get_bloginfo("stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>

小结

1、wp_list_bookmarks函数的用法和wp_list_categories极为类似 。

2、参数太多，使用灵活，但未必是你想要的，还可以使用 wpdb和get_results读取数据库打造个性友情链接。

3、官方原文 https://codex.wordpress.org/Function_Reference/wp_list_bookmarks