WordPress模板标签get_bookmarks用于获取友情链接数据，将返回所有友情链接的信息。
1 | get_bookmarks( array|string $args = '' ) |
函数参数
$args
数组或字符串值
get_bookmarks()函数$args参数默认的值如下：
1 2 3 4 5 6 7 8 9 10 11 12 | $args = array( 'orderby' => 'name', 'order' => 'ASC', 'limit' => -1, 'category' => '', 'category_name' => '', 'hide_invisible' => 1, 'show_updated' => 0, 'include' => '', 'exclude' => '', 'search' => '' ); |
get_bookmarks()函数$args参数可用的值如下：
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的值，返回符合搜索字符的结果。
函数返回值
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | Array ( [0] => stdClass Object ( [link_id] => 16 [link_url] => https://www.beizigen.com/ [link_name] => 悟空搜 [link_image] => [link_target] => _blank [link_description] => 开发运营笔记 [link_visible] => Y [link_owner] => 88891 [link_rating] => 0 [link_updated] => 0000-00-00 00:00:00 [link_rel] => [link_notes] => [link_rss] => ) ) |
函数使用示例
1 2 3 4 5 6 7 8 9 | <?php $bookmarks = get_bookmarks( array( 'orderby' => 'name', 'order' => 'ASC', )); foreach ( $bookmarks as $bookmark ) { printf( '<li><a class="relatedlink" href="{5cc1b29162d549a8071384de182cc9fc6e6a0fd85e7907f22fd9e18cff4269c3}s">{5cc1b29162d549a8071384de182cc9fc6e6a0fd85e7907f22fd9e18cff4269c3}s</a></li>', $bookmark->link_url, $bookmark->link_name ); } ?> |
扩展阅读
get_bookmarks()函数位于：wp-includes/bookmark.php
相关函数：
- get_bookmark()
- get_bookmark_field()
- wp_list_bookmarks()
原文链接：https://xiaohost.com/2384.html，转载请注明出处。
