WordPress获取友情链接数据标签:get_bookmarks
文 / @UTHEME
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.tiezhushuo.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="%s">%s</a></li>', $bookmark->link_url, $bookmark->link_name ); } ?>
扩展阅读
get_bookmarks()函数位于:wp-includes/bookmark.php
相关函数:
- get_bookmark()
- get_bookmark_field()
- wp_list_bookmarks()

相关文章
-
WordPress插件:All in One WP Security & Firewall 怎么样(附:AIOWPS拦截垃圾评论设置教程) 2023-01-26 21:51:51
-
在 PHP 中如何通过一行代码就交换两个变量的值 2023-01-26 00:18:31
-
WordPress主题:Pin Premium (WordPress仿Pinterest样式瀑布流主题) 2023-01-25 23:36:43
-
免费WordPress主题:Maupassant(WordPress中文博客主题) 2023-01-25 23:31:29
-
WordPress响应式图片(Responsive Image)功能关闭:取消WordPress图片宽带和高度参数 2023-01-24 10:49:32
-
wordpress报错:修复MySQL 1064错误问题 错误原因和解决方法 2023-01-24 10:42:04
-
WordPress 实现静态化搜索结果页面的方法 2023-01-24 00:41:44
-
WP Rocket – 强大的WordPress缓存加速优化插件(附:WP Rocket插件设置过程与七折优惠码) 2023-01-24 00:41:44
-
get_permalink、get_the_permalink和the_permalink有啥区别? 2023-01-24 00:41:08
-
为什么选用WordPress搭建独立站? 2023-01-23 20:25:21