快乐心情

今天看了看友情链接 想手动改变下方式，于是熟悉下了wp_list_bookmarks这个函数，这个函数用在Blogroll，是在wordpress2.1版本时启用的，替代了原来的get_links_list() 和 get_links()两个函数，用法：

<?php wp_list_bookmarks("各类参数"); ?>

各类参数用&分开，默认参数列表有：

<?php $default = array(
'orderby' => 'name',
'order' => 'ASC',
'limit' => -1,
'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>'
);
?>

参数详细说明：

categorize
布尔型，用于设置连接是否按照各自的分类显示：

• 1 （默认，根据链接的分类显示）
• 0 （不按照分类，显示全部）

category

字符串型，后面就直接 “=链接分类ID号“，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。

category_name

字符串型，如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。

category_before

字符串型，位于链接分类之前的文字或代码。默认的设置是：

<li id="[category id]" class="linkcat">

category_after
字符串型，位于链接分类之后的文字或代码。默认的设置是：

</li>

category_before和category_after结合起来就如同了下面的样式:

<li id="[category id]" class="linkcat">
单个链接分类下的链接列表
</li>

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 后台链接设置界面下的那些参数来进行排序：

• ‘id’
• ‘url’
• ‘name’
• ‘target’
• ‘description’
• ‘owner’
• ‘rating’
• ‘updated’
• ‘rel’ – 按设定的关系排列
• ‘notes’
• ‘rss’
• ‘length’ – 连接名称的长度设定
• ‘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 (不允许)

上面就是所有参数的详细介绍，下面列几个实例：

显示所有链接和链接标题并按分类显示：

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

随机显示ID为4的友情链接并显示链接标题：

<?php wp_list_bookmarks('title_li=&orderby=rand&category=4'); ?>

随机显示10条链接：

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

声明：转载原创文章时请注明：
    文章转载自:快乐心情, 原文地址:wp_list_bookmarks 链接显示函数详解