WordPress获取友情链接数据标签：get_bookmarks

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

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 class="relatedlink" 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()