WordPress开发手册:get_linkobjectsbyname()

函数原型

get_linkobjectsbyname( string $cat_name = "noname", string $orderby = ‘name’, int $limit = -1 ): array

函数描述

是否弃用

Warning: This function has been deprecated. Use get_bookmarks() instead.

函数参数

$cat_name
string
Optional

The category name to use. If no match is found, uses all.
Default 'noname'.

Default: "noname"

$orderby
string
Optional

The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. Default 'name'.
If you start the name with an underscore, the order will be reversed.
Specifying 'rand' as the order will return links in a random order.

Default: 'name'

$limit
int
Optional

Limit to X entries. If not specified, all entries are shown.

Default: -1

函数返回值

函数位置

函数源码

function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );

	$cat_id = -1;
	$cat = get_term_by('name', $cat_name, 'link_category');
	if ( $cat )
		$cat_id = $cat->term_id;

	return get_linkobjects($cat_id, $orderby, $limit);
}

源码链接

WordPress
Github

变更日志