WordPress获取单个友链信息标签:get_bookmark
WordPress模板标签get_bookmark返回单个友情链接的信息,而之前发表的get_bookmarks()函数则是返回一堆友情链接的信息,get_bookmark()函数需要用在The Loop主循环中,否则必须传递一个友情链接ID。
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;
函数返回值
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
)
)
函数使用示例
以下示例输出友情链接的名称:
<?php
$bookmark = get_bookmark(8);
echo $bookmark->link_name;
?>
扩展阅读
get_bookmark()函数位于:wp-includes/bookmark.php
相关函数: