WordPress函数解析：get_bookmarks

函数简介

检索书签列表。

首先尝试根据参数的MD5哈希从缓存中检索。 如果失败，则查询将从参数构建并执行。 结果将存储到缓存中。

函数用法

get_bookmarks(string|array $args = ”)

函数参量

<?php
$args = array(
‘orderby’ => ‘name’,
‘order’ => ‘ASC’,
‘limit’ => -1,
‘category’ => ”,
‘category_name’ => ”,
‘hide_invisible’ => 1,
‘show_updated’ => 0,
‘include’ => ”,
‘exclude’ => ”,
‘search’ => ”
);
?>

orderby

字符串值，默认值：name

指定排序的方式，可用的值如下：

link_id：按照友情链接的ID排序；
url：按照链接排序；
name：按照名称排序；
owner：按照添加书签的用户排序；
rating：按照评论排序；
visible：按照可见度排序；
length：按照长度排序；
rand：随机顺序；

order

字符串值，默认值：ASC

升序或降序排列：

ASC：升序排列；
DESC：降序排列；
limit

整数型，默认值：-1

指定返回链接的数量，默认为返回所有链接。

category

字符串值，默认为空

以逗号分隔的友情链接分类ID，指定返回哪些分类的链接，默认返回所有分类的链接。

category_name

字符串值，默认为空

友情链接分类名称，指定返回哪个分类的链接。

hide_invisible

布尔值，默认值：true

是否隐藏私密链接，true表示隐藏。

show_updated

布尔值，默认值：false

如果为true，将额外返回link_category_f输出link_updated的值，但是以时间戳的形式。

include

字符串值，默认为空

以逗号分隔的友情链接ID，将返回这些ID的链接信息。

exclude

字符串值，默认为空

以逗号分隔的友情链接ID，返回结果中将排除这些ID的链接。

search

字符串值，默认为空

搜索link_url、link_name、link_description的值，返回符合搜索字符的结果。