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

相关函数:

个赞
扫码关注背字根

一个热爱Web开发的大男孩