Warning: This function has been deprecated. Use get_bookmarks() instead.
get_linkobjectsbyname( string $cat_name = "noname", string $orderby = 'name', int $limit = -1 )
Gets an array of link objects associated with category $cat_name.
Description Description
$links = get_linkobjectsbyname( ‘fred’ ); foreach ( $links as $link ) { echo ‘
‘; }
See also See also
Parameters Parameters
- $cat_name
-
(string) (Optional) The category name to use. If no match is found uses all.
Default value: "noname"
- $orderby
-
(string) (Optional) The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'. Or maybe owner. If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which 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
Return Return
(array)
Source Source
File: wp-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);
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 2.1.0 | Use get_bookmarks() |
| 1.0.1 | Introduced. |