WordPress获取单个友链信息标签：get_bookmark

作者: 站长 上传时间: 浏览: N/A 下载: N/A 格式: N/A 评分: N/A

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

相关函数：

  • get_bookmark_field()
  • get_bookmarks()
  • wp_list_bookmarks()