WordPress函数：get_bookmarks 获取友情链接 创建友情链接页面

WordPress主题中，友情链接是一个必不可少的功能点。WordPress 自带友情链接功能，只是默认是关闭的。如何开启友情链接功能，可参考文章：WordPress怎么开启友情链接功能。友情链接开启后，就可以在后台管理友链了。

本文介绍的是，如何查询显示友请链接，这就需要用到 get_bookmarks 函数。get_bookmarks 主用于查询友情链接，而且函数内部自带缓存机制。

函数参数概览：

'orderby' (string) 排序方式。 接受 'id'， 'link_id'， 'name'， 'link_name'， 'url'， 'link_url'， 'visible'， 'link_visible'， 'rating'， 'link_rating'， 'owner'， 'link_owner'， 'updated'， 'link_updated'， 'notes'， 'link_notes'， 'description'， 'link_description'， 'length' ，'rand'。 此处 'length' 特指 'link_name' 的长度。 默认值 'name'。

'order' (string) 升序还是降序，即'ASC' 或者 'DESC'。 默认 'ASC'。

'limit' (int) 查询数量。 -1表示全部。 默认 -1。

'category' (string) 分类ID，支持多个，使用英文逗号分割。

'category_name' (string) 按分类名称查询。

'hide_invisible' (int|bool) 是否查询出隐藏数据。 默认 1|true，即不查出。

'show_updated' (int|bool) 是否查询最后更新时间。 默认 0|false，即不查出。

'include' (string) 包含-英文逗号分割的友情链接ID。

'exclude' (string) 排除-英文逗号分割的友情链接ID。

'search' (string) 按 SQL 通配符的方式查询，支持字段'link_url'， 'link_name' 和 'link_description'。 默认：''。

使用举例：

$bookmarks = get_bookmarks( array(
    'orderby'        => 'name',
    'order'          => 'ASC',
    'category_name'  => '追格'
) );
 
// 循环打印查询出的数据
foreach ( $bookmarks as $bookmark ) { 
    printf( '<a class="relatedlink" href="%1$s">%2$s</a><br />', esc_attr( $bookmark->link_url ), $bookmark->link_name );
}