WordPress模板标签get_bookmark返回单个友情链接的信息，而之前发表的get_bookmarks()函数则是返回一堆友情链接的信息，get_bookmark()函数需要用在The Loop主循环中，否则必须传递一个友情链接ID。
1 | get_bookmark(integer|object $bookmark, string $output = OBJECT, string $filter = 'raw') |
函数参数
$bookmark
整数或对象，默认值：当前友情链接
指定一个友情链接的ID或包含友情链接信息的对象，将返回该链接的信息
$output
字符串值，默认值：OBJECT
指定返回的数据格式，可选的值如下：
- OBJECT：对象；
- ARRAY_A：升序排列的数组；
- ARRAY_N：降序排列的数组；
$filter
字符串值，默认值：raw
是否使用过滤钩子，默认不使用，可用的值如下：
- raw：不使用钩子；
- edit：钩子名称 edit_$field；
- db：钩子名称 pre_$field；
- 其他值：钩子名称 $field；
函数返回值
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | stdClass Object ( [link_id] => 8 [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] => [link_category] => Array ( [0] => 2 ) ) |
函数使用示例
以下示例输出友情链接的名称：
1 2 3 4 | <?php $bookmark = get_bookmark(8); echo $bookmark->link_name; ?> |
扩展阅读
get_bookmark()函数位于：wp-includes/bookmark.php
相关函数：
- get_bookmark_field()
- get_bookmarks()
- wp_list_bookmarks()
原文链接：https://xiaohost.com/2383.html，转载请注明出处。
