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

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

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

    See also


    Parameters

    $cat_name

    (Optional) The category name to use. If no match is found, uses all.<br> Default 'noname'.

    Default value: "noname"

    $orderby

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

    Default value: 'name'

    $limit

    (Optional) Limit to X entries. If not specified, all entries are shown.<br>

    Default value: -1


    Return

    (array)


    Source

    File: wp-includes/deprecated.php

    function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
    	_deprecated_function( __FUNCTION__, 'WP-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);
    }
    


    Changelog

    Changelog
    Version Description
    2.1.0 Use get_bookmarks()
    1.0.1 Introduced. This function has been deprecated. Use get_bookmarks() instead.