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

Description

Parameters

$cat_namestringoptional

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

$orderbystringoptional

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'

$limitintoptional

Limit to X entries. If not specified, all entries are shown. Default -1.Default: -1

Return

array

Uses · 3

• _deprecated_function()Marks a function as deprecated and inform when it has been used.
• get_term_by()Gets all term data from database by term field and data.
• get_linkobjects()Gets an array of link objects associated with category n.

Source

View on Trac ↗View on GitHub ↗

467function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {468	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );469 470	$cat_id = -1;471	$cat = get_term_by('name', $cat_name, 'link_category');472	if ( $cat )473		$cat_id = $cat->term_id;474 475	return get_linkobjects($cat_id, $orderby, $limit);476}

History

Introduced in 1.0.1. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/deprecated.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.