get_linkobjectsbyname

函数


get_linkobjectsbyname ( $cat_name = "noname", $orderby = 'name', $limit = -1 )
参数
  • (string)
    $cat_name
    Optional. The category name to use. If no match is found, uses all. Default ‘noname’.
    Required:
    Default: “noname”
  • (string)
    $orderby
    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.
    Required:
    Default: ‘name’
  • (int)
    $limit
    Optional. Limit to X entries. If not specified, all entries are shown. Default -1.
    Required:
    Default: -1
返回值
  • (array)
相关
  • get_bookmarks()
定义位置
  • wp-includes/deprecated.php
    , line 465
引入
1.0.1
弃用
2.1.0

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

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

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

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