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的值，返回符合搜索字符的结果。