wordpress / latest / functions / get_linkobjectsbyname.html

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

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

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

Description

$links = get_linkobjectsbyname( ‘fred’ ); foreach ( $links as $link ) { echo ‘

  • ‘ . $link->link_name . ‘
  • ‘; }

    See also

    Parameters

    $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

    Return

    array

    Source

    File: wp-includes/deprecated.php. View all references

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

    Uses

    Uses Description

    Changelog

    Version Description
    2.1.0 Use get_bookmarks()
    1.0.1 Introduced.

    © 2003–2022 WordPress Foundation
    Licensed under the GNU GPLv2+ License.
    https://developer.wordpress.org/reference/functions/get_linkobjectsbyname