get_linkobjectsbyname()

最后更新于：2021-11-26 09:15:55

Gets an array of link objects associated with category $cat_name.

参数

$cat_name

(string) (Optional) The category name to use. If no match is found, uses all. Default ‘noname’.

Default value: “noname”

$orderby

(string) (Optional) The order to output the links. E.g. ‘id’, ‘name’, ‘url’, ‘description’, ‘rating’, or ‘owner’. 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 value: ‘name’

$limit

(int) (Optional) Limit to X entries. If not specified, all entries are shown.

Default value: -1

响应

(array)

源文件

文件: gc-includes/deprecated.php

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);
}