WordPress获取友情链接数据标签：get_bookmarks

WordPress模板标签get_bookmarks用于获取友情链接数据，将返回所有友情链接的信息。

get_bookmarks( array|string $args = '' )

函数参数

$args

数组或字符串值

get_bookmarks()函数$args参数默认的值如下：

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

函数返回值

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] =>
)
)

函数使用示例

<?php
$bookmarks = get_bookmarks( array(
'orderby'        => 'name',
'order'          => 'ASC',
));
foreach ( $bookmarks as $bookmark ) {
printf( '<li><a class="relatedlink" href="https://www.ztjun.com/%s" rel="external nofollow" >%s</a></li>', $bookmark->link_url, $bookmark->link_name );
}
?>

扩展阅读

get_bookmarks()函数位于：wp-includes/bookmark.php

相关函数：

• get_bookmark()
• get_bookmark_field()
• wp_list_bookmarks()