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  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()