WordPress函数:get_bookmarks 获取友情链接 创建友情链接页面

追格官方小助手/ 2022年07月26日/ WordPress/ 浏览 3250

WordPress主题中,友情链接是一个必不可少的功能点。WordPress 自带友情链接功能,只是默认是关闭的。如何开启友情链接功能,可参考文章:WordPress怎么开启友情链接功能。友情链接开启后,就可以在后台管理友链了。


本文介绍的是,如何查询显示友请链接,这就需要用到 get_bookmarks 函数。get_bookmarks 主用于查询友情链接,而且函数内部自带缓存机制。


函数参数概览:


'orderby' (string) 排序方式。 接受 'id', 'link_id', 'name', 'link_name', 'url', 'link_url', 'visible', 'link_visible', 'rating', 'link_rating', 'owner', 'link_owner', 'updated', 'link_updated', 'notes', 'link_notes', 'description', 'link_description', 'length' ,'rand'。 此处 'length' 特指 'link_name' 的长度。 默认值 'name'。


'order' (string) 升序还是降序,即'ASC' 或者 'DESC'。 默认 'ASC'。


'limit' (int) 查询数量。 -1表示全部。 默认 -1。


'category' (string) 分类ID,支持多个,使用英文逗号分割。


'category_name' (string) 按分类名称查询。


'hide_invisible' (int|bool) 是否查询出隐藏数据。 默认 1|true,即不查出。


'show_updated' (int|bool) 是否查询最后更新时间。 默认 0|false,即不查出。


'include' (string) 包含-英文逗号分割的友情链接ID。


'exclude' (string) 排除-英文逗号分割的友情链接ID。


'search' (string) 按 SQL 通配符的方式查询,支持字段'link_url', 'link_name' 和 'link_description'。 默认:''。


使用举例:


$bookmarks = get_bookmarks( array(
    'orderby'        => 'name',
    'order'          => 'ASC',
    'category_name'  => '追格'
) );
 
// 循环打印查询出的数据
foreach ( $bookmarks as $bookmark ) { 
    printf( '<a class="relatedlink" href="%1$s">%2$s</a><br />', esc_attr( $bookmark->link_url ), $bookmark->link_name );
}

发表评论

暂无评论,抢个沙发...

客服 工单