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="%s">%s</a></li>', $bookmark->link_url, $bookmark->link_name );
	}
?>

扩展阅读

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

相关函数：

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