检索书签列表。
首先尝试根据参数的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的值,返回符合搜索字符的结果。