说明

该函数返回一个书签（收藏链接）数组。该模板标签允许用户直接查找书签信息。

用法

<?php get_bookmarks( $args ); ?> 

默认用法

<?php $args = array(
‘orderby’ => ‘name’,
‘order’ => ‘ASC’,
‘limit’ => -1,
‘category’ => ,
‘category_name’ => ,
‘hide_invisible’ => 1,
‘show_updated’ => 0,
‘include’ => ,
‘exclude’ => ,
‘search’ => ); ?>

参数

orderby

（字符串）以什么顺序排列书签。默认值为’name’，除非你传递”（空）值，这时orderby的值将被设为’id’。有效值包括：

• ‘id’
• ‘url’
• ‘name’ ——默认
• ‘target’
• ‘description’
• ‘owner’ —— 通过书签管理器添加书签的用户
• ‘rating’
• ‘updated’
• ‘rel’ ——XFN
• ‘notes’
• ‘rss’
• ‘length’ ——书签名称的长度，从最短的到最长的长度。
• ‘rand’ —— 以任意顺序显示书签

order

（字符串）排序所依标准，升序或降序。有效值包括：

• ASC——默认
• DESC

limit

（整数）需要展示的数千的最大数量。默认值为-1（所有书签）。

category

（字符串）书签分类编号列表，用逗号隔开

category_name

（字符串）即将被检索的书签分类的分类名称。覆盖分类参数。

hide_invisible

（布尔型）若该参数值为TRUE，检索link_visible值设为’Y’的书签。

• 1（True）——默认值
• 0（False）

show_updated

（布尔型）若该值为TRUE，结果中会额外插入一个”link_category”的列，该列中包含的值与”link_updated”相同，但为unix时间标记格式。可用于PHP日期函数。

• 1 （True）
• 0（False）——默认值

Include

（字符串）输出结果中包含的数字书签编号列表，各编号用逗号隔开。例如 ‘include=1,3,6’ 表示返回或响应编号为1、3、6的数千。若使用了include字符串，category, category_name与exclude都将被忽略。默认值为(all Bookmarks)（所有书签）。

exclude

（字符串）输出结果中需要排除的数字书签编号列表，各编号用逗号隔开。例如，’exclude=4,12’表示不返回或不响应编号为4和12的书签。默认值为 (exclude nothing)（不排除任何书签）。

search

（字符串）搜索link_url, link_name或 link_description等搜索字符串。默认值为.

示例

——创建一个名为“Related Sites”的链接分类

——创建一些链接，使链接隶属于“Related Sites”分类

在网页中使用以下代码来检索链接：

<?php
$bm = get_bookmarks( array(
‘orderby’ => ‘name’,
‘order’ => ‘ASC’,
‘limit’ => -1,
‘category’ => null,
‘category_name’ => ‘Related Sites’,
‘hide_invisible’ => 1,
‘show_updated’ => 0,
‘include’ => null,
‘exclude’ => null,
‘search’ => ‘.’));
foreach ($bm as $bookmark){
echo “<a id=’relatedlinks’ href='{$bookmark->link_url}’ target=_blank>
{$bookmark->link_name}
</a><br /><br />”;
}
?>

历史记录

始见于2.1.0版本

源文件

get_bookmarks()位于 wp-includes/functions.php中。

相关资源

wp_list_bookmarks, get_bookmarks, get_bookmark

分类：中文手册