WordPress开发 – wp_list_bookmarks() 详解

参考WordPress官方文档：

https://codex.wordpress.org/Function_Reference/wp_list_bookmarks#List_.26_Dropdown_Functions

想做个性化的友情链接，搜索引擎优化中，首页和内页的权重是不一样，但友情链接在wordpress大部分模版中都是在侧边栏书香显示。如果侧边栏很宽，或者友情链接很多，或者只在首页显示友情链接，那在内部页面友情链接的这个经常变化的长度就不好和页面其他的长度配合，进而影响到了整个网页的美观。重庆SEO研究一下在wordpress中将友情链接横向现实在首页底部，那样所有问题就都解决了；在研究怎么把这个功能实现之前，首先要研究的当然是友情链接的输出函数wp_list_bookmarks（）

调用方法

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

默认参数

 $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'     => '
',
    'title_after'      => '
',
    'category_orderby' => 'name',
    'category_order'   => 'ASC',
    'class'            => 'linkcat',
    'category_before'  => '
',
    'category_after'   => '
' ); 
?>

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、调用当前的友情链接

 wp_list_bookmarks(); ?>

2、随机显示10条链接：

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

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

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

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

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

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

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

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

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

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

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

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

 wp_list_bookmarks('categorize=0&title_before=&title_after=&title_li="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

来源于，WP大学：

https://www.wpdaxue.com/wp_list_bookmarks.html

wp_list_bookmarks()使用示例

简单的链接列表

显示所有链接，标题为“Bookmarks”，各链接项包围在

标签中，标题则用

标签。 wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

没有标题的简单列表

按上一个例子的条件显示所有链接，但不包括默认标题。

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

显示某个分类下的所有链接

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

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

显示链接等级和时间标记

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

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

用图片取代标题

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

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

小结：

1.总的来说，要用好wp_list_bookmarks()函数，需要自己熟练掌握参数的用法，重要的是多多实践。

2.如果你英文还行，建议阅读英文版：Function Reference/wp list bookmarks